Compare commits
3
Commits
main
...
06a42149c6
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
06a42149c6 | ||
|
|
a275e76206 | ||
|
|
afa5ae42f1 |
@@ -1,101 +1,224 @@
|
|||||||
# mihomo-up
|
# mihomo-up
|
||||||
|
|
||||||
一个 bash 脚本,用来在 Linux 服务器上**检查、安装、升级、回滚 [mihomo](https://github.com/MetaCubeX/mihomo) 内核**(Clash.Meta 的继任者,MetaCubeX 维护的代理核心)。可以直接跑交互菜单,也可以用子命令接进 cron / CI。
|
一个 bash 脚本,在 Linux 服务器上安装好、配置好、管起来 [mihomo](https://github.com/MetaCubeX/mihomo) 内核(Clash.Meta 的继任者,MetaCubeX 维护的代理内核)。
|
||||||
|
|
||||||
脚本只管内核二进制本身:它**不会**替你创建 systemd 服务、生成配置文件或设置订阅,这些需要你自己先准备好。
|
一条命令从零到能用:下载内核 → 写入 systemd 服务 → 用向导生成 `config.yaml` → 启动。之后修改订阅、更换端口、升级、回滚、卸载也都在同一个菜单里。
|
||||||
|
|
||||||
## 特性
|
安装完成后,这台机器上会多出这几样东西——**卸载时它们全都能一键清掉**:
|
||||||
|
|
||||||
- **双模式**:终端下无参数运行进入交互菜单;被管道/cron 调用时自动退化为安静的 `check`
|
| | 默认位置 |
|
||||||
- **两道安全闸门**:替换前先验证新二进制能运行且版本号对得上,再用新二进制 `-t` 校验你现有的配置,任一失败就中止、不动任何文件
|
|---|---|
|
||||||
- **自动备份与回滚**:替换前把旧版备份到 `/var/backups/mihomo/`(保留最近 3 份);升级后服务起不来会自动回滚并重启旧版
|
| 内核二进制 | `/usr/local/bin/mihomo` |
|
||||||
- **curl 一键运行友好**:交互输入读 `/dev/tty`,`bash <(curl ...)` 管道方式运行菜单照样能按键
|
| 配置文件 | `/etc/mihomo/config.yaml` |
|
||||||
- 支持 amd64 / arm64 / armv7,amd64 可指定微架构变体(v1/v2/v3/compatible)
|
| systemd 服务 | `/etc/systemd/system/mihomo.service` |
|
||||||
|
| 快捷命令 | `/usr/local/bin/mihomo-up` |
|
||||||
|
| 脚本缓存 | `/var/lib/mihomo-up/` |
|
||||||
|
| 内核备份 | `/var/backups/mihomo/` |
|
||||||
|
|
||||||
|
除此之外它不碰你系统里的任何东西。
|
||||||
|
|
||||||
## 环境要求
|
## 环境要求
|
||||||
|
|
||||||
- Linux + bash
|
- Linux + bash 4 以上
|
||||||
- 依赖命令:`curl`、`gzip`、`install`、`awk`(一般发行版自带)
|
- 依赖命令:`curl`、`gzip`、`install`、`awk`、`sed`(一般发行版自带)
|
||||||
- 升级操作需要 **root**(要写 `/usr/local/bin` 并重启服务)
|
- 安装、升级、修改配置、卸载都需要 **root**。非 root 也能进菜单,会先提醒一句
|
||||||
- 服务的启停依赖 systemd 中名为 `mihomo` 的 service;没有的话脚本只替换二进制、跳过重启
|
- 没有 systemd 的机器(容器等)也能用:脚本跳过服务相关步骤,只管内核和配置,你自己 `mihomo -d /etc/mihomo` 启动起来
|
||||||
|
|
||||||
|
交互输入读的是 `/dev/tty` 而不是标准输入,所以 `bash <(curl ...)` 这种 stdin 已被占用的运行方式,菜单照样能按键。
|
||||||
|
|
||||||
## 快速开始
|
## 快速开始
|
||||||
|
|
||||||
**交互菜单**:
|
**交互菜单**(推荐,首次安装和日常维护都用它):
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
bash <(curl -fsSL https://git.im0o.top/im0o/mihomo-up/raw/branch/main/mihomo-up.sh)
|
bash <(curl -fsSL https://git.im0o.top/im0o/mihomo-up/raw/branch/main/mihomo-up.sh)
|
||||||
```
|
```
|
||||||
|
|
||||||
|
菜单第 1 项就是一键安装。运行完你会拿到:本机的 HTTP/SOCKS5 代理端口、一个 Web 面板地址和它的访问密钥、一个开机自启的 systemd 服务。
|
||||||
|
|
||||||
|
还会拿到一个 `mihomo-up` 命令——**以后直接输入它就能进菜单**,不用再翻上面这条 URL。
|
||||||
|
|
||||||
**命令行**:
|
**命令行**:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
chmod +x mihomo-up.sh
|
chmod +x mihomo-up.sh
|
||||||
|
|
||||||
./mihomo-up.sh check # 只查不改:当前版本 vs 最新版本
|
sudo ./mihomo-up.sh install # 一键安装:内核 + systemd + 配置向导 + 启动
|
||||||
sudo ./mihomo-up.sh update # 升级到最新版
|
./mihomo-up.sh check # 只查询不改动:当前版本 vs 最新版本
|
||||||
sudo ./mihomo-up.sh update --version v1.19.28 # 装指定版本
|
sudo ./mihomo-up.sh update # 只更换内核二进制,配置和服务定义不动
|
||||||
sudo ./mihomo-up.sh rollback # 回滚到上一个备份
|
sudo ./mihomo-up.sh config # 重新运行配置向导
|
||||||
./mihomo-up.sh list # 查看本地备份
|
sudo ./mihomo-up.sh rollback # 内核回滚到上一个备份
|
||||||
|
sudo ./mihomo-up.sh uninstall # 卸载,会逐项问你配置和备份要不要删除
|
||||||
|
sudo ./mihomo-up.sh shortcut # 只安装 / 刷新 mihomo-up 快捷命令
|
||||||
```
|
```
|
||||||
|
|
||||||
菜单里另有:校验配置文件、服务控制(启停/状态/最近日志)等入口。
|
## 菜单里有什么
|
||||||
|
|
||||||
|
```
|
||||||
|
1. 一键安装 内核 + systemd + 配置,缺哪步补哪步
|
||||||
|
2. 检查更新 3. 升级内核 4. 安装指定版本内核
|
||||||
|
5. 回滚内核 6. 查看内核备份
|
||||||
|
7. 配置管理 更换订阅 / 修改端口 / 局域网共享 / 面板密钥 / 导入配置 / 校验 / 编辑 / 备份还原
|
||||||
|
8. 服务控制 启动 / 停止 / 重启 / 状态 / 最近日志 / 开机自启 / 重写服务文件
|
||||||
|
9. 卸载
|
||||||
|
```
|
||||||
|
|
||||||
|
## 一键安装做了什么
|
||||||
|
|
||||||
|
1. **下载内核**:按机器架构从 GitHub Releases 下载对应的 `.gz` 并解压
|
||||||
|
2. **校验内核**:新二进制必须能执行,且 `-v` 自报的版本号和目标一致,否则不写入磁盘
|
||||||
|
3. **准备配置**:没有 `config.yaml` 就运行配置向导;已经有了就保持不动,只问一句要不要重做
|
||||||
|
4. **写入服务**:按 [MetaCubeX 官方文档](https://wiki.metacubex.one/startup/service/)的推荐写 `mihomo.service`。已存在且内容不同的话,旧文件先备份成 `.bak-<时间戳>`
|
||||||
|
5. **安装快捷命令**:问一句,可以拒绝。它是什么见「快捷命令 `mihomo-up`」一节
|
||||||
|
6. **启动服务**:`daemon-reload` → `enable`(开机自启)→ `restart`,启动不了就提示你看 `journalctl`
|
||||||
|
|
||||||
|
每一步都是「缺什么补什么」:已经安装过的机器再运行一遍,不会覆盖你现有的配置。
|
||||||
|
|
||||||
|
安装完成后会打印一段总结:代理端口怎么用、面板地址和密钥是什么、日志怎么看。
|
||||||
|
|
||||||
|
## 快捷命令 `mihomo-up`
|
||||||
|
|
||||||
|
一键安装会往 `/usr/local/bin/mihomo-up` 放一个启动器。它**不是脚本本体,而是每次执行都去拉取最新脚本再运行**——你更新了仓库,机器上下次输入 `mihomo-up` 就自动用上新版,不需要谁去手动更新。
|
||||||
|
|
||||||
|
```bash
|
||||||
|
mihomo-up # 进菜单,参数原样透传
|
||||||
|
mihomo-up check --json # 子命令照样能用,退出码也透传
|
||||||
|
```
|
||||||
|
|
||||||
|
和纯粹的"每次重新下载"不同的是,它会把拉到的脚本落一份缓存到 `/var/lib/mihomo-up/`,并在这两种情况下回落到缓存:
|
||||||
|
|
||||||
|
- **拉取失败**(网络断了、仓库挂了)。这条对代理管理脚本尤其要紧:你最需要它的时候,往往正是代理挂了、网络不正常的时候,那时候还得能进菜单重启服务、看日志。
|
||||||
|
- **拉到的东西没通过 `bash -n` 语法检查**(上游推了个坏版本,或者中间设备塞回来一个门户登录页)。宁可用旧的,也不以 root 执行来路不明的半个脚本。
|
||||||
|
|
||||||
|
抓取带 5 秒连接 / 20 秒总超时,网络卡住不会让菜单一直转着等。
|
||||||
|
|
||||||
|
fork 之后想让快捷命令指向你自己那份,安装的时候加 `--script-url <你的 raw 地址>`,或者设环境变量 `MIHOMO_UP_URL`。
|
||||||
|
|
||||||
|
> **cron 里别用它**:每次执行都联网拉取脚本,等于给定时任务多加一个失败点。定时任务直接指向缓存那份 `/var/lib/mihomo-up/mihomo-up.sh`,或者你自己固定的副本。
|
||||||
|
|
||||||
|
## 配置向导问什么
|
||||||
|
|
||||||
|
向导生成的是一份**最小可用配置**,够用,不臃肿:
|
||||||
|
|
||||||
|
| 问题 | 说明 |
|
||||||
|
|---|---|
|
||||||
|
| 订阅链接 | 机场给的 http(s) 地址,写成 `proxy-providers`,每 24 小时自动更新一次 |
|
||||||
|
| 本地代理端口 | `mixed-port`,HTTP 和 SOCKS5 共用,默认 7890 |
|
||||||
|
| 局域网共享 | `allow-lan`,开了同网段其它设备也能连(还要放行防火墙) |
|
||||||
|
| 管理接口 | 只允许本机 / 局域网公网可访问 / 不开启。面板和 API 都连这里 |
|
||||||
|
| 访问密钥 | 回车即自动生成随机串;管理接口开在 `0.0.0.0` 时务必设 |
|
||||||
|
| Web 面板 | 选是就写 `external-ui-url`,内核首次启动自己去下载 metacubexd |
|
||||||
|
| 分流规则 | 全部走代理(默认),或者指定某个国家/地区直连、其余走代理 |
|
||||||
|
|
||||||
|
生成的分组是 `PROXY`(手动选,默认跟着 AUTO)和 `AUTO`(自动挑延迟最低的)。规则里内网地址一律直连。
|
||||||
|
|
||||||
|
选了「指定国家/地区直连」会额外写一条 `GEOIP,<两位国家代码>,DIRECT`,代码填 `CN`、`US`、`JP`、`DE` 都行,小写会自动转大写。
|
||||||
|
|
||||||
|
**修改配置不用手写 YAML**:菜单「配置管理」能直接更换订阅、修改端口、开关局域网共享、改面板密钥。
|
||||||
|
|
||||||
|
每次改动之前自动备份成 `config.yaml.bak-<时间戳>`,改完立刻用内核 `-t` 校验。**校验不过会问你要不要还原**,服务正在运行的话再问一句要不要重启生效。
|
||||||
|
|
||||||
|
需要手写的复杂配置(DNS、TUN、自定义规则)请用菜单里的「手动编辑配置」,或者用「从 URL 导入完整配置」整份换掉——这两条路同样有备份、校验、还原兜底。
|
||||||
|
|
||||||
|
## 升级和回滚
|
||||||
|
|
||||||
|
`update` 只更换内核二进制,不动你的配置和服务定义。替换前有两道闸门,任一不过就中止:
|
||||||
|
|
||||||
|
1. 新二进制能运行起来,且 `-v` 自报的版本号和目标一致
|
||||||
|
2. 用**新版本**去 `-t` 校验你**现有的**配置
|
||||||
|
|
||||||
|
第二道是为了挡住「新内核不认旧配置」这种升完才发现的问题。配置本来就有毛病、但你只想更换内核时,加 `--skip-conf-check` 跳过它。
|
||||||
|
|
||||||
|
替换前旧内核备份到 `/var/backups/mihomo/`(保留最近 3 份)。升级后服务启动不了会**自动回滚**到旧版并重启,然后提示你看 `journalctl -u mihomo -n 50`。
|
||||||
|
|
||||||
|
任何一步失败都不会留下半个系统:要么没动,要么已回滚。
|
||||||
|
|
||||||
|
## 卸载会删什么
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo ./mihomo-up.sh uninstall # 逐项确认
|
||||||
|
sudo ./mihomo-up.sh uninstall --purge # 全部删除,不询问
|
||||||
|
```
|
||||||
|
|
||||||
|
直接删掉:内核二进制、`mihomo.service` 及其备份、`mihomo.service.d/` drop-in 目录、快捷命令和它的缓存。systemd 那边会先 stop 再 disable,然后 `daemon-reload` + `reset-failed` 把状态清干净。
|
||||||
|
|
||||||
|
会单独问你的两项:配置目录 `/etc/mihomo`(订阅、节点选择记录、面板文件都在里面)、内核备份目录 `/var/backups/mihomo`。留着的话下次重新安装能直接接上。
|
||||||
|
|
||||||
## 在 cron / CI 里用
|
## 在 cron / CI 里用
|
||||||
|
|
||||||
|
无参数运行时,脚本会看 stdin 是不是终端:是就进菜单,被管道或 cron 调用就安静地运行 `check`。
|
||||||
|
|
||||||
`check` 的退出码专为脚本化设计:
|
`check` 的退出码专为脚本化设计:
|
||||||
|
|
||||||
| 退出码 | 含义 |
|
| 退出码 | 含义 |
|
||||||
|---|---|
|
|---|---|
|
||||||
| 0 | 已是最新 |
|
| 0 | 已是最新 |
|
||||||
| 10 | 有新版(或未安装) |
|
| 10 | 有新版(或还没安装) |
|
||||||
| 1 | 出错 |
|
| 1 | 出错 |
|
||||||
|
|
||||||
例子——有新版时自动升级:
|
例子——有新版就自动升级:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
mihomo-up.sh check && exit 0
|
mihomo-up.sh check && exit 0
|
||||||
[ $? -eq 10 ] && mihomo-up.sh update -y
|
[ $? -eq 10 ] && mihomo-up.sh update -y
|
||||||
```
|
```
|
||||||
|
|
||||||
加 `--json` 会额外输出一行机器可读的 JSON,方便接入监控:
|
加 `--json` 会额外输出一行机器可读的 JSON:
|
||||||
|
|
||||||
```json
|
```json
|
||||||
{"current":"v1.19.27","latest":"v1.19.28","outdated":true}
|
{"current":"v1.19.27","latest":"v1.19.28","outdated":true}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## GitHub 直连不通时
|
||||||
|
|
||||||
|
内核、版本号、Web 面板都从 GitHub 下载。机器直连 GitHub 失败或太慢时,用 `--mirror` 指定一个反代前缀,脚本会把它拼在所有 GitHub 地址前面:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo ./mihomo-up.sh install --mirror https://ghfast.top/
|
||||||
|
```
|
||||||
|
|
||||||
|
带 `--mirror` 运行配置向导时,生成的配置里会额外写上走同一个镜像的 `geox-url`,免得内核首次启动下载 GeoIP 数据库时卡住。
|
||||||
|
|
||||||
## 选项一览
|
## 选项一览
|
||||||
|
|
||||||
| 选项 | 作用 |
|
| 选项 | 作用 |
|
||||||
|---|---|
|
|---|---|
|
||||||
| `-y, --yes` | 非交互确认,全部默认同意 |
|
| `-y, --yes` | 非交互确认,所有询问都当作同意 |
|
||||||
| `-n, --dry-run` | 只打印会做什么,不实际执行 |
|
| `-n, --dry-run` | 只打印会做什么,不实际改动 |
|
||||||
| `--force` | 即使版本相同也重装(`install` 子命令等价于 `update --force`) |
|
| `--force` | 版本相同也重新安装 |
|
||||||
| `--version <v>` | 指定版本,如 `v1.19.28` |
|
| `--version <v>` | 指定内核版本,如 `v1.19.28` |
|
||||||
| `--no-restart` | 装完不启动服务 |
|
| `--no-restart` | 安装完成后不启动服务 |
|
||||||
|
| `--purge` | `uninstall` 时连配置目录和备份一起删除 |
|
||||||
|
| `--skip-conf-check` | 升级时不用新版本预校验现有配置 |
|
||||||
| `--json` | `check` 时额外输出一行 JSON |
|
| `--json` | `check` 时额外输出一行 JSON |
|
||||||
| `--arch <a>` | 覆盖自动识别的架构:`amd64` / `arm64` / `armv7` |
|
| `--arch <a>` | 覆盖自动识别的架构:`amd64` / `arm64` / `armv7` |
|
||||||
| `--variant <v>` | amd64 微架构变体:`v1` / `v2` / `v3` / `compatible` |
|
| `--variant <v>` | amd64 微架构变体:`v1` / `v2` / `v3` / `compatible` |
|
||||||
| `--bin <path>` | 二进制路径,默认 `/usr/local/bin/mihomo` |
|
| `--mirror <url>` | GitHub 反代前缀,用法见上一节 |
|
||||||
|
| `--script-url <u>` | 快捷命令每次去拉的脚本地址(fork 后指到你自己那份) |
|
||||||
|
| `--bin <path>` | 内核路径,默认 `/usr/local/bin/mihomo` |
|
||||||
| `--conf-dir <dir>` | 配置目录,默认 `/etc/mihomo` |
|
| `--conf-dir <dir>` | 配置目录,默认 `/etc/mihomo` |
|
||||||
|
| `--service <name>` | systemd 服务名,默认 `mihomo` |
|
||||||
|
| `-v` | 打印脚本自身版本 |
|
||||||
|
|
||||||
## 默认值与环境变量
|
## 默认值与环境变量
|
||||||
|
|
||||||
|
命令行选项优先级最高,其次是环境变量,最后是下面这些默认值:
|
||||||
|
|
||||||
| 默认值 | 环境变量 |
|
| 默认值 | 环境变量 |
|
||||||
|---|---|
|
|---|---|
|
||||||
| `/usr/local/bin/mihomo` | `MIHOMO_BIN` |
|
| `/usr/local/bin/mihomo` | `MIHOMO_BIN` |
|
||||||
| `/etc/mihomo` | `MIHOMO_CONF_DIR` |
|
| `/etc/mihomo` | `MIHOMO_CONF_DIR` |
|
||||||
| `mihomo`(systemd 服务名) | `MIHOMO_SERVICE` |
|
| `mihomo`(systemd 服务名) | `MIHOMO_SERVICE` |
|
||||||
| `/var/backups/mihomo` | `MIHOMO_BACKUP_DIR` |
|
| `/var/backups/mihomo` | `MIHOMO_BACKUP_DIR` |
|
||||||
|
| 空(不用镜像) | `MIHOMO_MIRROR` |
|
||||||
|
| `/usr/local/bin/mihomo-up`(快捷命令) | `MIHOMO_UP_LAUNCHER` |
|
||||||
|
| `/var/lib/mihomo-up`(脚本缓存) | `MIHOMO_UP_CACHE` |
|
||||||
|
| 仓库 raw 地址(快捷命令拉取源) | `MIHOMO_UP_URL` |
|
||||||
|
|
||||||
备份最多保留 3 份(脚本内常量 `KEEP=3`)。
|
内核备份最多保留 3 份(脚本内常量 `KEEP=3`)。配置备份不自动清理,积累多了自己删除 `config.yaml.bak-*`。
|
||||||
|
|
||||||
## 升级时发生了什么
|
## 参考
|
||||||
|
|
||||||
1. 从 GitHub Releases 下载对应架构的 `.gz` 包并解压
|
systemd 服务写法来自 [MetaCubeX 官方文档](https://wiki.metacubex.one/startup/service/)。
|
||||||
2. **闸门 1**:新二进制必须能执行,且 `-v` 报告的版本号与目标一致
|
|
||||||
3. **闸门 2**:若存在 `config.yaml`,用新二进制 `-t` 校验现有配置,失败即中止
|
|
||||||
4. 备份旧二进制 → 停服务 → 安装新版 → 启动服务
|
|
||||||
5. 启动失败则**自动回滚**到刚才的备份并重启,最后提示你查 `journalctl -u mihomo -n 50`
|
|
||||||
|
|
||||||
任何一步失败都不会留下半个新系统:要么没动,要么已回滚。
|
一键安装和卸载的思路参考了 [ForLoveIcu/mihomo-for-linux-install](https://github.com/ForLoveIcu/mihomo-for-linux-install) 和 [nelvko/clash-for-linux-install](https://github.com/nelvko/clash-for-linux-install)。
|
||||||
|
|||||||
+924
-110
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user