Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Home

Jump to bottom
ね律こ edited this page Jun 1, 2026 · 12 revisions

⌨️ 命令一览

Usage: 
  clashctl COMMAND [OPTIONS]

Commands:
    on                    开启代理
    off                   关闭代理
    status                内核状况
    ui                    Web 面板
    secret                Web 密钥
    sub                   订阅管理
    upgrade               升级内核
    tun                   Tun 模式
    mixin                 Mixin 配置

Global Options:
    -h, --help            显示帮助信息

💡clashon 为 clashctl on 的简写形式，Tab 补全更方便！以下命令示例统一使用该风格。

优雅启停

$ clashon
😼 mihomo 已启动
😼 终端代理已启用

$ clashoff
😼 mihomo 已停止
😼 终端代理已关闭

❯ clashon -s
😼 mihomo 已运行

❯ clashoff -e
😼 终端代理已关闭
  • 默认同步管理代理服务与当前 Shell 代理环境变量，覆盖大多数使用场景。
  • 支持按需单独控制：
    • -s, --service-only：仅管理代理服务。
    • -e, --env-only：仅管理代理环境变量。

Web 控制台

$ clashui
╔═══════════════════════════════════════════════╗
║                😼 Web 控制台                  ║
║═══════════════════════════════════════════════║
║                                               ║
║     🔓 注意放行端口：9090                      ║
║     🏠 内网：http://192.168.0.1:9090/ui       ║
║     🌏 公网：http://8.8.8.8:9090/ui          ║
║     ☁️ 公共：http://board.zash.run.place      ║
║                                               ║
╚═══════════════════════════════════════════════╝

$ clashsecret mysecret
😼 密钥更新成功，已重启生效

$ clashsecret
😼 当前密钥：mysecret
  • 可通过浏览器打开 Web 控制台进行可视化操作，例如切换节点、查看日志等。
  • 默认使用 zashboard 作为控制台前端，如需更换可自行配置。
  • 若需将控制台暴露到公网，建议定期更换访问密钥，或通过 SSH 端口转发方式进行安全访问。

Mixin 配置

$ clashmixin
😼 查看 Mixin 配置

$ clashmixin -e
😼 编辑 Mixin 配置

$ clashmixin -c
😼 查看原始订阅配置

$ clashmixin -r
😼 查看运行时配置
  • 通过 Mixin 自定义的配置内容会与原始订阅进行深度合并，且 Mixin 具有最高优先级，最终生成内核启动时加载的运行时配置。
  • Mixin 支持以前置、后置、覆盖、注入的方式，对原始订阅中的规则、节点及策略组进行新增或修改。点击查看示例

升级内核

$ clashupgrade
😼 请求内核升级...
{"status":"ok"}
😼 内核升级成功
  • 升级过程由代理内核自动完成；如需查看详细的升级日志，可添加 -v 参数。
  • 建议通过 clashmixin 为 github 配置代理规则，以避免因网络问题导致请求失败。

管理订阅

$ clashsub -h
Usage: 
  clashsub COMMAND [OPTIONS]

Commands:
  add <url>       添加订阅
  ls              查看订阅
  del <id>        删除订阅
  use <id>        使用订阅
  update [id]     更新订阅
  log             订阅日志


Options:
  update:
    --auto        配置自动更新
    --convert     使用订阅转换
  • 支持添加本地订阅，例如：file:///root/clashctl/resources/config.yaml
  • 当订阅链接解析失败或包含特殊字符时，请使用引号包裹以避免被错误解析。
  • 自动更新任务可通过 crontab -e 进行修改和管理。

Tun 模式

$ clashtun
😾 Tun 状态：关闭

$ clashtun on
😼 Tun 模式已开启
  • 作用：实现本机及 Docker 等容器的所有流量路由到 clash 代理、DNS 劫持等。
  • 原理：clash-verge-rev、 clash.wiki。
  • 若订阅中的节点 server 使用域名，默认 mixin.yaml 已预置 proxy-server-nameserver，可避免开启 Tun + fake-ip 后节点域名被解析为 fake-ip 而导致代理握手失败；如使用自定义 DNS 配置，建议保留该项，并在必要时再配合 fake-ip-filter。
  • 注意事项：#100

🗑️ 卸载

bash uninstall.sh

📖 常见问题

👉 Wiki · FAQ

🔗 引用

Clone this wiki locally