Skip to content

Releases

v0.2.3

Choose a tag to compare

@github-actions github-actions released this 27 Oct 09:24

Full Changelog: v0.2.1...v0.2.3

v0.2.1

Choose a tag to compare

@github-actions github-actions released this 21 Jul 08:25

Full Changelog: v0.2.0...v0.2.1

v0.2.0

Choose a tag to compare

@github-actions github-actions released this 20 Jul 05:32

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-userinfo
    • x-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

Choose a tag to compare

@WangZhongDian WangZhongDian released this 12 Jun 02:04
d6825cc

What's Changed

Full Changelog: v0.1.2...v0.1.3

What's Changed

Full Changelog: v0.1.2...v0.1.3

v0.1.2

Choose a tag to compare

@github-actions github-actions released this 14 May 09:03
01937ce

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

Choose a tag to compare

@WangZhongDian WangZhongDian released this 14 May 08:43
5a71a7a

What's Changed

  • Fix installation script and add environment cleanup command by @WangZhongDian in #1

New Contributors

Full Changelog: v0.1.0...v0.1.1

v0.1.0

Choose a tag to compare

@github-actions github-actions released this 14 May 08:08