Repository navigation
Releases
v0.2.3
Full Changelog: v0.2.1...v0.2.3
v0.2.1
v0.2.0
mihomo-tui v0.2.0
v0.2.0 是一次以订阅可靠性、守护进程权限、内核资源管理与规则可控性为重点的大版本更新。
本版本将订阅从“交给 mihomo 被动拉取”升级为由 mihomo-tui daemon 主动接管,并提供订阅池高可用、内核多版本管理、内置规则编辑以及更完整的 TUN 兼容能力。
✨ Features
订阅主动接管与订阅池
-
新增订阅池管理,支持多个订阅源组成一个可运行集合。
-
支持两种订阅池运行模式:
- 顺序主备:主订阅连续刷新失败后自动切换到备用订阅;
- 合并模式:多个可用订阅同时提供节点。
-
daemon 主动下载、校验并缓存订阅内容,mihomo 仅读取本地 provider 缓存。
-
保留最后一份有效订阅缓存;网络失败或订阅解析失败不会覆盖已有可用内容。
-
支持 URL、本地文件、粘贴内容和 CLI 标准输入导入:
mihomo-tui subscription import --url <URL> mihomo-tui subscription import --file <path> cat subscription.txt | mihomo-tui subscription import --stdin
-
支持通过当前本地 mihomo HTTP 代理刷新远程订阅。
-
首页展示当前运行订阅池、池成员、运行状态、异常状态和可用剩余额度。
订阅流量与有效期元数据
- 支持解析标准
subscription-userinfo响应头。 - 支持常见 CDN 元数据前缀,例如:
x-amz-meta-subscription-userinfox-obs-meta-subscription-userinfo
- 支持解析上传、下载、总额度、剩余额度、到期时间和刷新间隔。
- 默认订阅请求 User-Agent 包含
clash字符串,以兼容仅对 Clash 类客户端返回流量信息的订阅服务。 - 无法获得有效额度时明确显示“无法解析有效的订阅元数据”,不再误显示为
0 / 0。 - 支持从 mihomo provider 运行期 API 同步订阅元数据。
内核与外部资源管理
- 新增“资源管理”一级页面。
- 支持 mihomo 多版本仓库管理:
- 获取并缓存最近 Release 列表;
- 查看稳定版与预发布版;
- 下载指定版本;
- 显示下载进度;
- 切换已下载内核;
- 删除非当前使用版本。
- 内核下载自动根据当前系统和架构选择真实 Release 资产,并兼容
.gz/.zip。 - GitHub 请求失败时支持内置备用源回退与可读错误提示。
- 支持修改 GeoIP、GeoSite 外部资源的下载 URL。
- 支持查看外部资源的存在状态和文件大小。
内置规则管理
- 新增“内置规则”页面。
- 内置规则、内置
RULE-SET、SSH 直连保护和最终MATCH规则均纳入持久化管理。 - 支持:
- 启用/禁用普通内置规则及内置规则订阅;
- 编辑规则内容;
- 编辑内置规则订阅 URL、行为、格式、更新间隔和策略组;
- 上移/下移调整优先级;
- 恢复单条默认规则;
- 一键恢复全部默认内置规则。
- 自定义规则支持选择:
- 前置规则:优先于用户规则订阅和内置规则;
- 后置规则:位于内置规则之后、
MATCH之前。
- 内置规则页根据终端高度动态分页,避免小终端溢出、大终端空间浪费。
IPC、权限与可靠性
-
增强 root daemon + 普通用户 TUI 的 IPC 授权模型。
-
新增 operator 授权命令:
sudo mihomo-tui grant_operator <用户名>
-
配置提交新增版本控制与冲突检测,避免多客户端互相覆盖配置。
-
配置写入、运行时 reconcile、热重载与受控重启具备更明确的错误反馈。
-
守护进程仅向客户端返回脱敏后的订阅信息,不暴露订阅正文和凭证 URL。
TUN 与网络兼容性
-
改进 TUN 路由规则管理与清理逻辑。
-
修复 iptables-nft 环境下,专用链不存在时被误判为清理失败的问题。
-
保留并加强 Docker 映射端口外部访问的回程保护。
-
新增 TUN 路由诊断命令:
sudo mihomo-tui tun_diagnose
🐛 Fixes
- 修复普通用户 IPC 权限不足时无法读取内核下载进度的问题。
- 修复下载完成后 TUI 进度长期停留在
0%的状态同步问题。 - 修复更新检查依赖单一 GitHub latest API、硬编码资产文件名导致的失败问题。
- 修复安装覆盖正在运行的
/usr/local/bin/mihomo-tui时出现text file busy、需要重复执行安装的问题。 - 修复订阅文件/粘贴导入弹窗焦点错误和导入失败后内容丢失的问题。
- 修复设置页切换时触发重复保存与配置冲突的问题。
- 修复无权限保存配置时 TUI 先显示新值、与服务端实际配置不一致的问题。
- 修复删除订阅后订阅池成员、活动成员和降级状态无法同步的问题。
- 修复内置规则卡片仅显示空白边框,以及超出终端高度后无法访问的问题。
- 修复
iptables-nft专用链不存在时产生误导性 TUN 清理 WARN 日志。 - 修复订阅到期备注过长时污染首页显示的问题。
- 修复默认 Go User-Agent 无法从部分订阅服务获得额度信息的问题。
- 修复特定 mihomo 内核版本的 provider 节点测速兼容问题。
⚠️ Breaking Changes / Upgrade Notes
订阅配置自动迁移到订阅池
旧版的 subscriptions 配置会在首次加载时自动迁移:
- 所有已有订阅进入“默认订阅池”;
- 原订阅列表顺序成为主备优先级;
- 原活动订阅成为默认池的活动成员;
- 未设置活动订阅时,选择第一个可用订阅。
升级后,mihomo 不再直接拉取远程订阅 URL,而是读取 daemon 管理的本地缓存文件。
自定义规则配置结构变更
旧的:
custom_rules:
- DOMAIN,example.com,Auto会自动迁移为前置自定义规则。新配置支持:
pre_custom_rules: []
post_custom_rules: []
built_in_rules: []MATCH 现在由系统作为唯一且固定的末尾兜底规则维护:
- 不可禁用;
- 不可移动;
- 可以修改其目标策略组。
自定义规则中包含 MATCH,... 的配置会被拒绝,以避免规则提前终止造成后置规则失效。
Root daemon 用户需要重新登录以获得管理权限
使用 root systemd daemon 时,普通用户需要被授权为 operator:
sudo mihomo-tui grant_operator <用户名>授权后需重新登录桌面/SSH 会话,或临时执行:
newgrp mihomo-tui只读用户仍可查看脱敏状态,但不能导入订阅、刷新订阅、修改订阅池、下载/切换/删除内核版本或修改外部资源 URL。
内核文件位置变更
mihomo-tui 管理下载的内核现在按版本保存于私有版本仓库,旧 MihomoBinaryPath 会自动迁移为已安装版本记录。
系统 PATH 中用户自行安装的 mihomo 不会被覆盖或删除。
🔒 Security
- 订阅正文仅保存在 daemon 私有缓存目录。
- 订阅缓存目录使用
0700,缓存文件使用0600权限。 - IPC 与日志不会返回或记录完整订阅正文、订阅 token 或带凭证 URL。
- 外部资源 URL 与订阅导入等特权操作继续受到 daemon operator/root 权限控制。
总结
v0.2.0 将 mihomo-tui 从基础 TUI 配置工具升级为具备主动订阅接管、高可用订阅池、版本化内核管理、细粒度规则控制、严格 IPC 权限与更可靠 TUN 网络兼容性的守护进程管理平台。
Full Changelog: v0.1.2...v0.2.0
v0.1.3
What's Changed
- Dev by @WangZhongDian in #3
Full Changelog: v0.1.2...v0.1.3
What's Changed
- Dev by @WangZhongDian in #3
Full Changelog: v0.1.2...v0.1.3
v0.1.2
What's Changed
- Refactor code by removing test page and updating documentation by @WangZhongDian in #2
Full Changelog: v0.1.1...v0.1.2
v0.1.1
What's Changed
- Fix installation script and add environment cleanup command by @WangZhongDian in #1
New Contributors
- @WangZhongDian made their first contribution in #1
Full Changelog: v0.1.0...v0.1.1
v0.1.0
Full Changelog: https://github.com/WangZhongDian/mihomo-tui/commits/v0.1.0