Compare commits

..
4 Commits
Author SHA1 Message Date
im0o b43a2f0a64 feat: 加 Patchbay 安装入口
Patchbay 是网页编辑 mihomo 配置的工具,独立仓库、独立发布链路。这里只做
入口:拉它的 install.sh 下来执行,装、更新、卸载的逻辑都在那边,不复制过来。

- 菜单 p 项和 patchbay 子命令,二级菜单为安装/更新、检查更新、服务控制、卸载
- 不直接 bash <(curl ...):先下到临时文件过一遍 bash -n 再以 root 执行。
  上游推坏了、或者中间设备塞回来一个门户登录页,那条写法会直接跑掉
- MIHOMO_MIRROR / MIHOMO_BIN / MIHOMO_CONF_DIR 原样透传(名字本来就相同),
  -y 跟 ASSUME_YES 走,--purge 跟 PURGE 走,check 的退出码按 0/10/1 解读
- 状态显示只读 version.txt 和 systemd 单元状态,版本和服务定义归它自己管
- 卸载 mihomo 不连带删除它,和 Sub-Store 同样处理

顺手把 Sub-Store 的服务控制菜单抽成通用的 unit_ctl_menu,两边共用,行为没变。
2026-08-12 16:14:36 +08:00
im0o a576846946 docs: 补上多开入站端口的配置片段
砍掉入站端口菜单时留了一句「请用手动编辑配置」,但没说该写什么,
等于一个悬空指引。补上 listeners 的最小可用片段和 IN-NAME 的用法。
2026-08-09 23:14:22 +08:00
im0o c9b410c65e 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
im0o ce8623ccb9 fix: 没有入站端口时不该报「第 N 行出错」
进「配置管理 → 入站端口」而配置里一条入站都没有时,脚本会连报两次
错误然后退出。

cfg_listener_list 末尾是 grep 管道,grep 无匹配时退出码为 1,配上
pipefail 就把整个函数判为失败,触发 ERR trap。"没有入站"是正常状态,
不是错误,末尾补 || true。

两次报错是同一根因的两次现身:第一次在 $() 子 shell 里,只杀掉子 shell;
第二次是外层赋值继承了非零码,才真正终止脚本。
2026-08-09 18:57:26 +08:00
2 changed files with 599 additions and 503 deletions
+60 -53
View File
@@ -15,12 +15,16 @@
| 脚本缓存 | `/var/lib/mihomo-up/` | | 脚本缓存 | `/var/lib/mihomo-up/` |
| 内核备份 | `/var/backups/mihomo/` | | 内核备份 | `/var/backups/mihomo/` |
(可选装的 Sub-Store 在 `/opt/sub-store`、Patchbay 在 `/opt/patchbay`,卸载 mihomo 都不会动它们)
除此之外它不碰你系统里的任何东西。 除此之外它不碰你系统里的任何东西。
## 环境要求 ## 环境要求
- Linux + bash 4 以上 - Linux + bash 4 以上
- 依赖命令:`curl`、`gzip`、`install`、`awk`、`sed`(一般发行版自带) - 依赖命令:`curl`、`gzip`、`install`、`awk`、`sed`(一般发行版自带)
- 只有选装 Sub-Store 时才额外需要 `node` 和 `unzip`;脚本会检测并给出安装命令,不替你装
- 选装 Patchbay 需要 `tar` 和 `unzip`;它的运行时(bun)由它自己的安装脚本装一份私有副本,不碰系统
- 安装、升级、修改配置、卸载都需要 **root**。非 root 也能进菜单,会先提醒一句 - 安装、升级、修改配置、卸载都需要 **root**。非 root 也能进菜单,会先提醒一句
- 没有 systemd 的机器(容器等)也能用:脚本跳过服务相关步骤,只管内核和配置,你自己 `mihomo -d /etc/mihomo` 启动起来 - 没有 systemd 的机器(容器等)也能用:脚本跳过服务相关步骤,只管内核和配置,你自己 `mihomo -d /etc/mihomo` 启动起来
@@ -50,22 +54,26 @@ sudo ./mihomo-up.sh config # 重新运行配置向导
sudo ./mihomo-up.sh rollback # 内核回滚到上一个备份 sudo ./mihomo-up.sh rollback # 内核回滚到上一个备份
sudo ./mihomo-up.sh uninstall # 卸载,会逐项问你配置和备份要不要删除 sudo ./mihomo-up.sh uninstall # 卸载,会逐项问你配置和备份要不要删除
sudo ./mihomo-up.sh shortcut # 只安装 / 刷新 mihomo-up 快捷命令 sudo ./mihomo-up.sh shortcut # 只安装 / 刷新 mihomo-up 快捷命令
sudo ./mihomo-up.sh substore # 安装 / 更新 Sub-Store(订阅聚合,可选)
sudo ./mihomo-up.sh patchbay # 安装 / 更新 Patchbay(网页编辑配置,可选)
``` ```
## 菜单里有什么 ## 菜单里有什么
``` ```
1. 一键安装 内核 + systemd + 配置,缺哪步补哪步 1. 一键安装 内核 + systemd + 配置,缺哪步补哪步
2. 检查更新 3. 升级内核 4. 安装指定版本内核 2. 检查更新 3. 升级内核 4. 装指定版本内核
5. 回滚内核 6. 查看内核备份 5. 回滚内核 6. 查看内核备份
7. 配置管理 订阅 / 端口 / 局域网 / 面板密钥 / 入站端口 / GEO / 导入 / 校验 / 编辑 / 备份 7. 配置管理 生成配置 / 改端口 / 看面板密钥 / 校验 / 手动编辑
8. 服务控制 启动 / 停止 / 重启 / 状态 / 最近日志 / 开机自启 / 重写服务文件 8. 服务控制 启动 / 停止 / 重启 / 状态 / 日志 / 开机自启
9. 卸载 9. Sub-Store 订阅聚合,可选,见下
p. Patchbay 网页编辑配置,可选,见下
u. 卸载 mihomo
``` ```
## 一键安装做了什么 ## 一键安装做了什么
1. **下载内核**:按机器架构从 GitHub Releases 下载对应的 `.gz` 并解压 1. **下载内核**:按机器架构从 GitHub Releases 取对应的 `.gz` 并解压
2. **校验内核**:新二进制必须能执行,且 `-v` 自报的版本号和目标一致,否则不写入磁盘 2. **校验内核**:新二进制必须能执行,且 `-v` 自报的版本号和目标一致,否则不写入磁盘
3. **准备配置**:没有 `config.yaml` 就运行配置向导;已经有了就保持不动,只问一句要不要重做 3. **准备配置**:没有 `config.yaml` 就运行配置向导;已经有了就保持不动,只问一句要不要重做
4. **写入服务**:按 [MetaCubeX 官方文档](https://wiki.metacubex.one/startup/service/)的推荐写 `mihomo.service`。已存在且内容不同的话,旧文件先备份成 `.bak-<时间戳>` 4. **写入服务**:按 [MetaCubeX 官方文档](https://wiki.metacubex.one/startup/service/)的推荐写 `mihomo.service`。已存在且内容不同的话,旧文件先备份成 `.bak-<时间戳>`
@@ -98,24 +106,19 @@ fork 之后想让快捷命令指向你自己那份,安装的时候加 `--scrip
## 配置向导问什么 ## 配置向导问什么
向导生成的是一份**最小可用配置**,够用,不臃肿: 向导生成的是一份**最小可用配置**,够用,不臃肿。它只认**一条**订阅地址——多个机场的聚合、节点改名、筛选去重,交给 Sub-Store 那类工具做(见下一节),脚本这边不重复造。
| 问题 | 说明 | | 问题 | 说明 |
|---|---| |---|---|
| 订阅链接 | 机场给的 http(s) 地址。**可以填多个**,一次一个,回车结束(最多 8 个) | | 订阅地址 | 机场给的,或 Sub-Store 输出的那条。写成 `proxy-providers`,每 24 小时自动更新 |
| 本地代理端口 | `mixed-port`,HTTP 和 SOCKS5 共用,默认 7890 | | 本地代理端口 | `mixed-port`,HTTP 和 SOCKS5 共用同一个端口,默认 7890 |
| 局域网共享 | `allow-lan`,开了同网段其它设备也能连(还要放行防火墙) | | 局域网共享 | `allow-lan`,开了同网段其它设备也能连(还要放行防火墙) |
| 管理接口 | 只允许本机 / 局域网公网可访问 / 不开启。面板和 API 都连这里 | | 管理接口 | 只允许本机 / 局域网公网可访问 / 不开启。面板和 API 都连这里 |
| 访问密钥 | 回车即自动生成随机串;管理接口开在 `0.0.0.0` 时务必设 | | 访问密钥 | 回车即自动生成随机串;管理接口开在 `0.0.0.0` 时务必设 |
| Web 面板 | 选是就写 `external-ui-url`,内核首次启动自己去下载 metacubexd | | Web 面板 | 选是就写 `external-ui-url`,内核首次启动自己去下载 metacubexd |
| 地区分组 | 留空=不拆。填 `HK JP US` 之类就按地区各建一个自动测速组 |
| 分流规则 | 三选一,见下面的表 | | 分流规则 | 三选一,见下面的表 |
多个订阅的节点会合并进同一组。每个订阅是一条独立的 `proxy-providers`,各自按 24 小时周期更新。 生成的分组是 `PROXY`(总开关,手动选,默认跟着 AUTO)和 `AUTO`(全部节点里自动挑延迟最低的)。
**地区分组**支持 `HK TW JP SG US KR UK DE FR`。每个地区一个 `url-test` 组,靠节点名里的关键词匹配,中英文和旗帜 emoji 都认。
注意:某个地区一个节点都没匹配上的话内核会拒绝启动,紧接着的校验会当场告诉你。
**分流规则**三选一,内网地址在哪种模式下都直连: **分流规则**三选一,内网地址在哪种模式下都直连:
@@ -127,69 +130,68 @@ fork 之后想让快捷命令指向你自己那份,安装的时候加 `--scrip
地区填两位 ISO 代码(`CN`、`US`、`JP`、`DE`…),小写自动转大写。 地区填两位 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` 规则集: 其中**多开入站端口**是最常被问到的一个,配置长这样:
```yaml
rules:
- RULE-SET,cn-domain,PROXY # 域名维度
- RULE-SET,cn-ip,PROXY,no-resolve # IP 维度兜底
- MATCH,DIRECT
```
**为什么必须有域名那份**:很多国内站挂着境外 CDN,域名解析出来的 IP 不在国内段,只靠 `GEOIP` 会整片漏掉。域名列表才是主力,IP 那条只兜住「直接连 IP、没有域名」的连接。
`.mrs` 是二进制规则集,只下载你要用的那一两个列表,不用拖整包 `geosite.dat`。下载走 `proxy: DIRECT`,因为你人在境外,直连最快。
有个限制脚本会当场告诉你:**只有 CN 有成体系的域名列表**。换成别的国家代码就只能按 IP 匹配,该地区挂境外 CDN 的站点会漏掉。
## 多开入站端口
一个端口对应一个出站——从 7801 进来的全走香港节点,从 7802 进来的全走日本。菜单「配置管理 → 入站端口」增删,写成 mihomo 的 `listeners`:
```yaml ```yaml
listeners: listeners:
- { name: in-7801, type: mixed, listen: 0.0.0.0, port: 7801, proxy: HK } - { name: in-7801, type: mixed, listen: 0.0.0.0, port: 7801, proxy: PROXY }
- { name: in-7802, type: mixed, listen: 0.0.0.0, port: 7802 } - { name: in-7802, type: mixed, listen: 0.0.0.0, port: 7802 }
``` ```
用法就是把代理地址指到不同端口: `type` 可以是 `mixed`(HTTP + SOCKS5 同口)、`http`、`socks`。写了 `proxy:` 就**完全跳过 rules**,这个端口的流量一律走那个策略组或节点;不写就照常按 `rules` 分流。
```bash 想按端口区分又保留分流,用入站规则代替 `proxy:`:
curl -x http://127.0.0.1:7801 https://example.com # 走 HK 组
curl -x http://127.0.0.1:7802 https://example.com # 按 rules 分流 ```yaml
rules:
- GEOIP,CN,DIRECT # 顺序重要,先放该直连的
- IN-NAME,in-7801,PROXY
- MATCH,DIRECT
``` ```
出站可以选任意一个已有策略组、`DIRECT`,或者「按 rules 分流」。 ## Sub-Store(可选)
**选了具体出站就完全跳过 rules**:这个端口的流量一律走它,包括本该直连的内网以外流量。脚本在你选完之后会提醒一次。想保留分流就选「按 rules」。 [Sub-Store](https://github.com/sub-store-org/Sub-Store) 是订阅聚合器:把多个机场和自建节点合成一条订阅地址,带 Web 界面,**能看到筛选后实际剩下哪些节点**。菜单第 9 项安装,它是独立服务,**不进一键安装,也不是用 mihomo 的前提**。
类型支持 `mixed`(HTTP + SOCKS5 同口)、`http`、`socks`。端口和主代理端口或其它入站冲突会被当场拒绝。 装完的用法是:在它的界面里加各个机场的订阅和自建节点 → 做一条「组合订阅」→ 复制它的 mihomo 格式输出地址 → 回本脚本「配置管理 → 生成配置」填进去。
## GEO 数据和规则集 **装法**:原生 Node + systemd,装到 `/opt/sub-store`。脚本**不替你装 Node**——装语言运行时是最容易搞坏服务器的操作,检测不到时它会打印你这个发行版的安装命令,你执行完再回来。另外需要 `unzip`。
`GEOIP`、`GEOSITE`、`RULE-SET` 规则都要靠数据文件才能匹配。内核缺文件时会自己去下载,但**下载失败是静默的**。 **更新**(菜单第 2 项)和内核升级用同一套闸门:下载到临时目录 → `node --check` 验后端、`unzip -t` 验前端 → 备份旧的 → 换上 → 起服务 → **起不来自动回滚**。任一步不过都不动现有版本。
失败的表现是:规则一条都匹配不上,流量全落到最后的 `MATCH`,看起来就像"配置没生效"——你会先去怀疑节点,而不是怀疑一个几天前静默失败的下载。 **安全上要知道的一件事**:Sub-Store 的后端 API **没有鉴权**,访问地址里那串随机路径就是唯一凭据,谁知道谁就能读走你所有订阅(里面带着机场账号)。所以脚本默认绑 `127.0.0.1`,装完打印现成的 SSH 隧道命令:
菜单「配置管理 → GEO / 规则集」把这件事变可见:列出配置目录里的 `geoip.dat`、`geosite.dat`、`*.mmdb` 和 `rules/*.mrs`,带大小和上次更新时间。几天没变就是没更新成功。 ```bash
ssh -L 3001:127.0.0.1:3001 用户名@你的服务器
# 然后本机浏览器打开脚本给你的那条 http://127.0.0.1:3001/?api=... 地址
```
「立即更新」优先走管理接口的 `POST /configs/geo`,**不用重启内核**。管理接口没开、或服务没在运行时,回退到删掉数据文件再重启服务重新下载(动手前会问你)。 要公网直连也可以,但要你明确选,脚本会警告一次。另外注意:把 Sub-Store 生成的订阅链接发给别人时,链接里就含着后端地址。
「自动更新 开/关」写的是 `geo-auto-update` 和 `geo-update-interval: 24`。 卸载 mihomo **不会**连带删除 Sub-Store——你的订阅数据在里面。要删就走菜单第 9 项里的卸载。
## 改配置的安全网 ## Patchbay(可选)
上面这些改动——换订阅、改端口、加入站、开关自动更新——都不用手写 YAML,也都走同一套保护。 [Patchbay](https://git.im0o.top/im0o/mihomo-patchbay) 是编辑 mihomo 配置的网页工具:在浏览器里改配置、校验、直接重载内核,省得 SSH 上去用 vi。菜单 `p` 项安装,它同样是独立服务,**不进一键安装**。
每次动手之前自动备份成 `config.yaml.bak-<时间戳>`,改完立刻用内核 `-t` 校验。**校验不过会问你要不要还原**,服务正在运行的话再问一句要不要重启生效。 **这里只是个入口**:装、更新、卸载全由 Patchbay 自己的 `install.sh` 完成,本脚本只负责把它拉下来执行(先过一遍 `bash -n`,语法不过就不以 root 运行),并把 `--mirror`、`-y` 和 `MIHOMO_BIN` / `MIHOMO_CONF_DIR` 原样传过去。所以 Patchbay 的版本、服务定义、环境变量都归它自己管,出问题去它的仓库反馈。
需要手写的复杂配置(DNS、TUN、自定义规则)请用菜单里的「手动编辑配置」,或者用「从 URL 导入完整配置」整份换掉——这两条路同样有备份、校验、还原兜底。 **前提**是 mihomo 已经装好、且配置里开了管理接口(`external-controller`)——Patchbay 靠管理接口读线路和触发重载。没开的话它会拒绝安装并告诉你先跑一遍配置向导。
装完只监听 `127.0.0.1:7580`,访问方式和访问令牌在安装结束时打印出来,用法和 Sub-Store 一样是 SSH 隧道:
```bash
ssh -N -L 7580:127.0.0.1:7580 用户名@你的服务器
# 然后本机浏览器打开 http://127.0.0.1:7580,填脚本给你的访问令牌
```
卸载 mihomo 同样**不会**连带删除 Patchbay,要删走菜单 `p` → 卸载。
## 升级和回滚 ## 升级和回滚
@@ -285,6 +287,11 @@ sudo ./mihomo-up.sh install --mirror https://ghfast.top/
| `/usr/local/bin/mihomo-up`(快捷命令) | `MIHOMO_UP_LAUNCHER` | | `/usr/local/bin/mihomo-up`(快捷命令) | `MIHOMO_UP_LAUNCHER` |
| `/var/lib/mihomo-up`(脚本缓存) | `MIHOMO_UP_CACHE` | | `/var/lib/mihomo-up`(脚本缓存) | `MIHOMO_UP_CACHE` |
| 仓库 raw 地址(快捷命令拉取源) | `MIHOMO_UP_URL` | | 仓库 raw 地址(快捷命令拉取源) | `MIHOMO_UP_URL` |
| `/opt/sub-store`(Sub-Store 目录) | `SUBSTORE_DIR` |
| `sub-store`(Sub-Store 服务名) | `SUBSTORE_SERVICE` |
| `/opt/patchbay`(Patchbay 目录) | `PATCHBAY_PREFIX` |
| `patchbay`(Patchbay 服务名) | `PATCHBAY_SERVICE` |
| Patchbay 仓库 raw 地址(安装脚本拉取源) | `PATCHBAY_INSTALL_URL` |
内核备份最多保留 3 份(脚本内常量 `KEEP=3`)。配置备份不自动清理,积累多了自己删除 `config.yaml.bak-*`。 内核备份最多保留 3 份(脚本内常量 `KEEP=3`)。配置备份不自动清理,积累多了自己删除 `config.yaml.bak-*`。
+539 -450
View File
File diff suppressed because it is too large Load Diff