CLASH_SETUP.md

配置 Clash External Controller

要使用本项目，需要先启用 Clash 的 External Controller 功能。

方法一：通过 NTHUCC 客户端配置

1. 打开 NTHUCC 客户端
2. 找到设置或配置选项
3. 查找 "External Controller" 或"外部控制"相关设置
4. 启用并设置端口（默认 9090）

方法二：手动修改 Clash 配置文件

如果客户端不支持直接配置，可以手动修改 Clash 配置文件。

1. 找到 Clash 配置文件

通常位于：

• macOS: ~/Library/Application Support/io.github.clash-verge-rev.clash-verge-rev/ 或 ~/.config/clash/config.yaml
• Windows: C:\Users\<用户名>\.config\clash\config.yaml
• Linux: ~/.config/clash/config.yaml

2. 编辑配置文件

在配置文件中添加或修改以下内容：

# External Controller
external-controller: 127.0.0.1:9090
# 如果需要密码保护
secret: ""

3. 重启 Clash

保存配置后，重启 NTHUCC 客户端使配置生效。

验证配置

在浏览器中访问：

http://127.0.0.1:9090/proxies

如果返回 JSON 数据，说明配置成功。

常见问题

Q: 无法连接到 Clash API

A: 检查：

1. Clash 客户端是否正在运行
2. External Controller 是否已启用
3. 端口号是否正确（默认 9090）
4. 防火墙是否阻止了连接

Q: 返回 401 Unauthorized

A: 说明设置了密码，需要在 config.yaml 中配置 secret 字段

Q: 找不到配置文件

A: 可以通过以下方式查找：

# macOS / Linux
find ~ -name "config.yaml" -path "*/clash*" 2>/dev/null

# Windows
dir /s config.yaml
# 或者在 NTHUCC 安装目录搜索

# 或使用项目自带脚本（跨平台）
python scripts/find_clash_config.py

推荐配置

# config.yaml
clash:
  host: "127.0.0.1"
  port: 9090
  secret: ""  # 如果 Clash 设置了密码，填写在这里

proxy:
  host: "127.0.0.1"
  port: 7897  # NTHUCC 使用的代理端口