适用条件与独立目录

面向会使用终端的 Linux/macOS 用户；Windows 可使用对应可执行文件，但下列 shell 命令不能直接原样粘贴进 PowerShell。先按官方发行页选择系统和 CPU 架构匹配的稳定核心，解压后确认命令路径。暂时不要建立开机服务。

先查看当前核心的实际版本和参数；不涉及订阅下载
mihomo -v
mihomo -h

取得完整 YAML，先保存原件

先登录 Roxi 账户复制自己的第三方订阅链接。下文路径只替换原链接中的 /sub/ 部分一次，保留域名、个人标识及全部查询参数；不要把“个人标识”当真值，也不要把官网首页或登录页当订阅。已有对应格式的专用链接时直接使用。

将 /sub/clash/个人标识 的响应保存为 config.yaml，放在单独的工作目录。保留下载原件，只修改副本；不要把 Base64 节点列表改成 .yaml 后缀冒充配置。配置会包含凭据和可能需要下载的规则资源，应保存在自己的账户目录中。

把第一次运行限制在本机

先检查并修改副本里已有的同名键，不要在文件末尾追加重复键。Roxi 的路由配置可能开启局域网或透明代理入口，不能默认认为只会监听本机。下面只列接管与监听相关设置，保留实际节点、组、规则和 DNS 上游。

修改既有键；这只是配置片段，不能替换整份 YAML
mixed-port: 17890
port: 0
socks-port: 0
redir-port: 0
tproxy-port: 0
allow-lan: false
bind-address: 127.0.0.1
external-controller: ""
tun:
  enable: false

还要检查 listeners 等独立入站，以及 dns.listen；首次不需要的独立入站应在副本中停用。DNS 若需监听，应绑定本机未占用的高位端口，避免 53 端口和已有 DNS 服务冲突。不要为了让未知监听启动成功直接使用 sudo。

检查通过后再前台启动

在 config.yaml 所在独立目录执行；检查失败会阻止后续启动
mihomo -t -d "$PWD" -f "$PWD/config.yaml" && \
  mihomo -d "$PWD" -f "$PWD/config.yaml"

-t 用于配置检查并退出；检查过程仍可能需要外部规则或数据文件。退出码为零不等于任意节点可用。前台运行时保留终端，遇到错误先读完整错误字段和资源地址；不自动循环重启，也不覆盖旧配置。

用明确的端口观察一次请求

另开终端；目标换成实际网站，端口需与刚才的 mixed-port 一致
curl --noproxy "" --proxy http://127.0.0.1:17890 \
  --connect-timeout 10 --max-time 30 --output /dev/null \
  --write-out "HTTP %{http_code}\n" https://example.com/

该命令只让这一次 curl 使用本地代理，不会替你设置整台机器的系统代理。结合核心日志确认请求和实际出站；若规则命中 DIRECT，这次结果只能证明直连路径。检查当前策略组与规则，不能把任意 HTTP 响应都称为代理成功。

停止与下一次更新

  1. 在核心终端按 Ctrl+C，确认进程退出；本例没有设置系统代理，其他软件的代理设置仍需分别恢复。
  2. 新订阅先保存为另一个文件，做同样的监听检查和 -t 检查，验证后再换用。配置检查失败或节点为空时保留当前可用文件。
  3. 只有前台请求、规则和退出都验证后，再按官方服务文档考虑后台托管，避免将未验证配置设成自动启动。

只分享脱敏后的失败阶段、字段名和日志摘要。订阅 URL、二维码、节点认证信息和导出的配置都可能包含凭据，不要发送到公开群或公共转换网站。本文依据官方资料与项目接口整理，未进行真机连接实测。