refactor: 砍掉非刚需功能，修若干静默失败，新增 Sub-Store 模块

订阅的聚合、改名、筛选交给 Sub-Store 承担，脚本收窄为「管内核 + 管服务 + 生成一份最小可用配置」。1579 → 1542 行，但配置相关的多行 YAML 手术全部消失。砍掉: - 入站端口 listeners 全套、多订阅与订阅管理菜单、GEO 菜单、地区分组、局域网开关、备份还原菜单、URL 导入；管理接口那项改成只读显示密钥 - 配置菜单从 11 项减到 5 项，剩下的 YAML 改写只有顶层单键修: - ERR trap 在写操作里其实是失效的: `func || true` 会关掉整个函数体的 errexit 且无法在内部恢复。所以改为逐条显式检查，并给所有写操作补 require_root —— die 的 exit 是当前唯一还能可靠中止的机制 - cfg_set 用 sed 替换会损坏数据: 替换文本里 & 代表整条匹配，值含 & 时旧行会被塞进新值；| 和 \ 还会被改写成 &。改用 awk 整行重建，值走环境变量传入（-v 会解释转义序列，吃掉反斜杠） - 订阅地址含 # 时会被正则截断，导致列表与改写的计数口径不一致、改错行、静默丢订阅。改用 awk 取最后一个标记位置来切 - cfg_backup 的 cp 失败仍返回 0 并吐出不存在的路径，让「改坏了就还原」整条链路空转 - do_update 里 install 失败被吞掉，然后拿旧二进制启动并报升级成功 - svc_state 的 list-unit-files|grep -q 撞 SIGPIPE + pipefail，装了也判为未装 - svc_enabled 对 disabled 单元输出两行 - latest_version 缺 --max-time，网络被挂住时菜单无限等 - 向导端口输错直接 die 掉整个菜单；重启失败没有任何提示新增 Sub-Store（可选，不进一键安装）: - 原生 Node + systemd，装到 /opt/sub-store；不替你装 Node，只检测并给命令 - 更新走和内核升级同款闸门: node --check 验后端、unzip -t 验前端，备份 → 换上 → 起服务，起不来自动回滚 - 后端 API 无鉴权，随机路径就是唯一凭据，故默认绑 127.0.0.1 并打印 SSH 隧道命令 - 卸载 mihomo 不连带删除它，订阅数据在里面验证: 三场景 × 9 项严格回归（保留 set -Eeuo pipefail 和 ERR trap）全过；三种规则模式生成的配置用 PyYAML 解析通过；含 # 的订阅地址往返无损； cfg_set 对 & | \ 五种输入均原样写入；两个 Sub-Store 资产地址经 API 确认存在。
2026-08-09 22:22:18 +08:00
parent ce8623ccb9
commit c9b410c65e
2 changed files with 463 additions and 535 deletions
@@ -15,12 +15,15 @@
 | 脚本缓存 | `/var/lib/mihomo-up/` |
 | 内核备份 | `/var/backups/mihomo/` |

+（可选装的 Sub-Store 另在 `/opt/sub-store`，卸载 mihomo 不会动它）
+
 除此之外它不碰你系统里的任何东西。

 ## 环境要求

 - Linux + bash 4 以上
 - 依赖命令：`curl`、`gzip`、`install`、`awk`、`sed`（一般发行版自带）
+- 只有选装 Sub-Store 时才额外需要 `node` 和 `unzip`；脚本会检测并给出安装命令，不替你装
 - 安装、升级、修改配置、卸载都需要 **root**。非 root 也能进菜单，会先提醒一句
 - 没有 systemd 的机器（容器等）也能用：脚本跳过服务相关步骤，只管内核和配置，你自己 `mihomo -d /etc/mihomo` 启动起来

@@ -50,22 +53,24 @@ sudo ./mihomo-up.sh config        # 重新运行配置向导
 sudo ./mihomo-up.sh rollback      # 内核回滚到上一个备份
 sudo ./mihomo-up.sh uninstall     # 卸载，会逐项问你配置和备份要不要删除
 sudo ./mihomo-up.sh shortcut      # 只安装 / 刷新 mihomo-up 快捷命令
+sudo ./mihomo-up.sh substore      # 安装 / 更新 Sub-Store（订阅聚合，可选）
 ```

 ## 菜单里有什么

 ```
 1. 一键安装        内核 + systemd + 配置，缺哪步补哪步
-2. 检查更新        3. 升级内核      4. 安装指定版本内核
+2. 检查更新        3. 升级内核      4. 装指定版本内核
 5. 回滚内核        6. 查看内核备份
-7. 配置管理        订阅 / 端口 / 局域网 / 面板密钥 / 入站端口 / GEO / 导入 / 校验 / 编辑 / 备份
-8. 服务控制        启动 / 停止 / 重启 / 状态 / 最近日志 / 开机自启 / 重写服务文件
-9. 卸载
+7. 配置管理        生成配置 / 改端口 / 看面板密钥 / 校验 / 手动编辑
+8. 服务控制        启动 / 停止 / 重启 / 状态 / 日志 / 开机自启
+9. Sub-Store       订阅聚合，可选，见下
+u. 卸载 mihomo
 ```

 ## 一键安装做了什么

-1. **下载内核**：按机器架构从 GitHub Releases 下载对应的 `.gz` 并解压
+1. **下载内核**：按机器架构从 GitHub Releases 取对应的 `.gz` 并解压
 2. **校验内核**：新二进制必须能执行，且 `-v` 自报的版本号和目标一致，否则不写入磁盘
 3. **准备配置**：没有 `config.yaml` 就运行配置向导；已经有了就保持不动，只问一句要不要重做
 4. **写入服务**：按 [MetaCubeX 官方文档](https://wiki.metacubex.one/startup/service/)的推荐写 `mihomo.service`。已存在且内容不同的话，旧文件先备份成 `.bak-<时间戳>`
@@ -98,24 +103,19 @@ fork 之后想让快捷命令指向你自己那份，安装的时候加 `--scrip

 ## 配置向导问什么

-向导生成的是一份**最小可用配置**，够用，不臃肿：
+向导生成的是一份**最小可用配置**，够用，不臃肿。它只认**一条**订阅地址——多个机场的聚合、节点改名、筛选去重，交给 Sub-Store 那类工具做（见下一节），脚本这边不重复造。

 | 问题 | 说明 |
 |---|---|
-| 订阅链接 | 机场给的 http(s) 地址。**可以填多个**，一次一个，回车结束（最多 8 个） |
-| 本地代理端口 | `mixed-port`，HTTP 和 SOCKS5 共用，默认 7890 |
+| 订阅地址 | 机场给的，或 Sub-Store 输出的那条。写成 `proxy-providers`，每 24 小时自动更新 |
+| 本地代理端口 | `mixed-port`，HTTP 和 SOCKS5 共用同一个端口，默认 7890 |
 | 局域网共享 | `allow-lan`，开了同网段其它设备也能连（还要放行防火墙） |
 | 管理接口 | 只允许本机 / 局域网公网可访问 / 不开启。面板和 API 都连这里 |
 | 访问密钥 | 回车即自动生成随机串；管理接口开在 `0.0.0.0` 时务必设 |
 | Web 面板 | 选是就写 `external-ui-url`，内核首次启动自己去下载 metacubexd |
-| 地区分组 | 留空＝不拆。填 `HK JP US` 之类就按地区各建一个自动测速组 |
 | 分流规则 | 三选一，见下面的表 |

-多个订阅的节点会合并进同一组。每个订阅是一条独立的 `proxy-providers`，各自按 24 小时周期更新。
-
-**地区分组**支持 `HK TW JP SG US KR UK DE FR`。每个地区一个 `url-test` 组，靠节点名里的关键词匹配，中英文和旗帜 emoji 都认。
-
-注意：某个地区一个节点都没匹配上的话内核会拒绝启动，紧接着的校验会当场告诉你。
+生成的分组是 `PROXY`（总开关，手动选，默认跟着 AUTO）和 `AUTO`（全部节点里自动挑延迟最低的）。

 **分流规则**三选一，内网地址在哪种模式下都直连：

@@ -127,69 +127,32 @@ fork 之后想让快捷命令指向你自己那份，安装的时候加 `--scrip

 地区填两位 ISO 代码（`CN`、`US`、`JP`、`DE`…），小写自动转大写。

-生成的分组是 `PROXY`（总开关，手动选，默认跟着 AUTO）、`AUTO`（全部节点里自动测速），加上你要的那几个地区组。
+**模式 3（回国）**不用 `GEOIP`，而是生成两条 `.mrs` 规则集：域名维度打头，IP 维度兜底。原因是很多国内站挂着境外 CDN，域名解析出来的 IP 不在国内段，只靠 `GEOIP` 会整片漏掉。只有 `CN` 有成体系的域名列表，填别的国家代码时脚本会当场告诉你只能按 IP 匹配、会漏掉什么。

-## 回国 / 分区代理
+**改配置的安全网**：每次改动之前自动备份成 `config.yaml.bak-<时间戳>`（只留最近 10 份），改完立刻用内核 `-t` 校验。**校验不过会问你要不要还原**，服务正在运行的话再问一句要不要重启生效。配置文件权限是 `0640`，因为密钥就明文存在里面。

-上面的模式 3 是反过来的：命中的地区走代理，其余直连。适合人在境外、只想让国内站点走国内节点。
+复杂配置（DNS、TUN、自定义规则、多开入站端口）请用「手动编辑配置」，它同样有备份、校验、还原兜底。

-它不用 `GEOIP`，而是生成两条 `.mrs` 规则集：
+## Sub-Store（可选）

-```yaml
-rules:
-  - RULE-SET,cn-domain,PROXY           # 域名维度
-  - RULE-SET,cn-ip,PROXY,no-resolve    # IP 维度兜底
-  - MATCH,DIRECT
-```
+[Sub-Store](https://github.com/sub-store-org/Sub-Store) 是订阅聚合器：把多个机场和自建节点合成一条订阅地址，带 Web 界面，**能看到筛选后实际剩下哪些节点**。菜单第 9 项安装，它是独立服务，**不进一键安装，也不是用 mihomo 的前提**。

-**为什么必须有域名那份**：很多国内站挂着境外 CDN，域名解析出来的 IP 不在国内段，只靠 `GEOIP` 会整片漏掉。域名列表才是主力，IP 那条只兜住「直接连 IP、没有域名」的连接。
+装完的用法是：在它的界面里加各个机场的订阅和自建节点 → 做一条「组合订阅」→ 复制它的 mihomo 格式输出地址 → 回本脚本「配置管理 → 生成配置」填进去。

-`.mrs` 是二进制规则集，只下载你要用的那一两个列表，不用拖整包 `geosite.dat`。下载走 `proxy: DIRECT`，因为你人在境外，直连最快。
+**装法**：原生 Node + systemd，装到 `/opt/sub-store`。脚本**不替你装 Node**——装语言运行时是最容易搞坏服务器的操作，检测不到时它会打印你这个发行版的安装命令，你执行完再回来。另外需要 `unzip`。

-有个限制脚本会当场告诉你：**只有 CN 有成体系的域名列表**。换成别的国家代码就只能按 IP 匹配，该地区挂境外 CDN 的站点会漏掉。
+**更新**（菜单第 2 项）和内核升级用同一套闸门：下载到临时目录 → `node --check` 验后端、`unzip -t` 验前端 → 备份旧的 → 换上 → 起服务 → **起不来自动回滚**。任一步不过都不动现有版本。

-## 多开入站端口
-
-一个端口对应一个出站——从 7801 进来的全走香港节点，从 7802 进来的全走日本。菜单「配置管理 → 入站端口」增删，写成 mihomo 的 `listeners`：
-
-```yaml
-listeners:
-  - { name: in-7801, type: mixed, listen: 0.0.0.0, port: 7801, proxy: HK }
-  - { name: in-7802, type: mixed, listen: 0.0.0.0, port: 7802 }
-```
-
-用法就是把代理地址指到不同端口：
+**安全上要知道的一件事**：Sub-Store 的后端 API **没有鉴权**，访问地址里那串随机路径就是唯一凭据，谁知道谁就能读走你所有订阅（里面带着机场账号）。所以脚本默认绑 `127.0.0.1`，装完打印现成的 SSH 隧道命令：

 ```bash
-curl -x http://127.0.0.1:7801 https://example.com   # 走 HK 组
-curl -x http://127.0.0.1:7802 https://example.com   # 按 rules 分流
+ssh -L 3001:127.0.0.1:3001 用户名@你的服务器
+# 然后本机浏览器打开脚本给你的那条 http://127.0.0.1:3001/?api=... 地址
 ```

-出站可以选任意一个已有策略组、`DIRECT`，或者「按 rules 分流」。
+要公网直连也可以，但要你明确选，脚本会警告一次。另外注意：把 Sub-Store 生成的订阅链接发给别人时，链接里就含着后端地址。

-**选了具体出站就完全跳过 rules**：这个端口的流量一律走它，包括本该直连的内网以外流量。脚本在你选完之后会提醒一次。想保留分流就选「按 rules」。
-
-类型支持 `mixed`（HTTP + SOCKS5 同口）、`http`、`socks`。端口和主代理端口或其它入站冲突会被当场拒绝。
-
-## GEO 数据和规则集
-
-`GEOIP`、`GEOSITE`、`RULE-SET` 规则都要靠数据文件才能匹配。内核缺文件时会自己去下载，但**下载失败是静默的**。
-
-失败的表现是：规则一条都匹配不上，流量全落到最后的 `MATCH`，看起来就像"配置没生效"——你会先去怀疑节点，而不是怀疑一个几天前静默失败的下载。
-
-菜单「配置管理 → GEO / 规则集」把这件事变可见：列出配置目录里的 `geoip.dat`、`geosite.dat`、`*.mmdb` 和 `rules/*.mrs`，带大小和上次更新时间。几天没变就是没更新成功。
-
-「立即更新」优先走管理接口的 `POST /configs/geo`，**不用重启内核**。管理接口没开、或服务没在运行时，回退到删掉数据文件再重启服务重新下载（动手前会问你）。
-
-「自动更新 开/关」写的是 `geo-auto-update` 和 `geo-update-interval: 24`。
-
-## 改配置的安全网
-
-上面这些改动——换订阅、改端口、加入站、开关自动更新——都不用手写 YAML，也都走同一套保护。
-
-每次动手之前自动备份成 `config.yaml.bak-<时间戳>`，改完立刻用内核 `-t` 校验。**校验不过会问你要不要还原**，服务正在运行的话再问一句要不要重启生效。
-
-需要手写的复杂配置（DNS、TUN、自定义规则）请用菜单里的「手动编辑配置」，或者用「从 URL 导入完整配置」整份换掉——这两条路同样有备份、校验、还原兜底。
+卸载 mihomo **不会**连带删除 Sub-Store——你的订阅数据在里面。要删就走菜单第 9 项里的卸载。

 ## 升级和回滚

@@ -285,6 +248,8 @@ sudo ./mihomo-up.sh install --mirror https://ghfast.top/
 | `/usr/local/bin/mihomo-up`（快捷命令） | `MIHOMO_UP_LAUNCHER` |
 | `/var/lib/mihomo-up`（脚本缓存） | `MIHOMO_UP_CACHE` |
 | 仓库 raw 地址（快捷命令拉取源） | `MIHOMO_UP_URL` |
+| `/opt/sub-store`（Sub-Store 目录） | `SUBSTORE_DIR` |
+| `sub-store`（Sub-Store 服务名） | `SUBSTORE_SERVICE` |

 内核备份最多保留 3 份（脚本内常量 `KEEP=3`）。配置备份不自动清理，积累多了自己删除 `config.yaml.bak-*`。