Skip to content

ENABLE_API.md

Latest commit

 

History

History
100 lines (70 loc) · 2.26 KB

ENABLE_API.md

File metadata and controls

100 lines (70 loc) · 2.26 KB
Raw

启用 Clash External Controller 指南

问题

NTHUCC 客户端默认没有启用 External Controller，导致无法通过 API 控制节点切换。

解决方案

方案一：使用 Clash Verge（推荐）

我注意到你的系统中有 clash-verge-service.exe（Windows）或 Clash Verge 进程（macOS/Linux）在运行。Clash Verge 是一个更现代的 Clash 客户端，原生支持 External Controller。

  1. 下载 Clash Verge

  2. 导入订阅

    • 打开 Clash Verge
    • 设置 -> 订阅
    • 添加订阅地址（从你的 VPN 服务商获取）

  3. 启用 External Controller

    • 设置 -> Clash 内核
    • External Controller: 127.0.0.1:9090
    • Secret: (留空或设置密码)
    • 保存并重启

方案二：修改 NTHUCC 配置

如果你想继续使用 NTHUCC，需要手动修改配置文件。

步骤 1: 找到配置文件

NTHUCC 的配置可能在以下位置：

# Windows
C:\Users\<用户名>\AppData\Roaming\nthucc\
C:\Users\<用户名>\.config\clash\

# macOS
~/Library/Application Support/com.clash.verge/
~/.config/clash/

# Linux
~/.config/clash/

步骤 2: 查找 Clash 配置

运行以下命令查找：

python scripts/find_clash_config.py

步骤 3: 编辑配置文件

在配置文件中添加：

# External Controller
external-controller: 127.0.0.1:9090
secret: ""

步骤 4: 重启 NTHUCC

保存配置后，完全退出并重启 NTHUCC 客户端。

方案三：使用 Clash Premium 核心

  1. 下载 Clash Premium

  2. 创建配置文件

    python scripts/setup_clash_standalone.py

  3. 运行 Clash

    clash -d config_directory

验证配置

配置完成后，运行测试脚本：

python test_connection.py

如果看到 "[SUCCESS] All tests passed!"，说明配置成功。

常见问题

Q: 端口被占用

A: 修改 config.yaml 中的端口号，例如改为 9091

Q: 无法访问 API

A: 检查防火墙设置，确保允许本地连接

Q: 订阅地址无效

A: 从 NTHUCC 客户端重新获取订阅地址