CLI Proxy API VPS 一键安装与 GUI 启用指南（非 Docker）

一、在 VPS 上一键安装 CLI Proxy API#

先通过 SSH 登录你的 Linux VPS，然后直接执行官方推荐的一键安装命令：

1
curl -fsSL https://raw.githubusercontent.com/brokechubb/cliproxyapi-installer/refs/heads/master/cliproxyapi-installer | bash

安装完成后，先检查服务状态：

1
systemctl --user status cli-proxy-api

如果你希望它开机自动启动，再执行：

1
systemctl --user enable cli-proxy-api

二、打开配置文件#

默认配置文件一般在：

1
~/.cli-proxy-api/config.yaml

直接编辑它：

1
nano ~/.cli-proxy-api/config.yaml

如果你习惯用 vi，也可以这样：

1
vi ~/.cli-proxy-api/config.yaml

三、修改 config.yaml 启用 GUI#

把配置文件改成类似下面这样，重点是 remote-management 这一段：

1
port: 8317
2

3
auth-dir: "~/.cli-proxy-api"
4

5
request-retry: 3
6

7
quota-exceeded:
8
  switch-project: true
9
  switch-preview-model: true
10

11
api-keys:
12
  - "ABC-123456"
13

14
remote-management:
15
  allow-remote: true
16
  secret-key: "MGT-123456"
17
  disable-control-panel: false

这几项的作用分别是：

• port: 8317：服务监听端口
• api-keys：代理接口使用的访问密钥
• remote-management.allow-remote: true：允许远程访问 GUI
• remote-management.secret-key：GUI 登录密码
• disable-control-panel: false：启用内置控制面板

注意两点：

• api-keys 和 remote-management.secret-key 不是同一个东西
• 如果你的配置文件里已经有这些字段，直接修改原值，不要重复写两份同名配置

四、重启服务让配置生效#

改完配置后，执行重启：

1
systemctl --user restart cli-proxy-api

然后再次确认服务状态：

1
systemctl --user status cli-proxy-api

如果你想实时看日志，可以执行：

1
journalctl --user -u cli-proxy-api -f

五、浏览器访问 GUI#

服务重启完成后，在浏览器打开：

1
http://你的服务器IP:8317/management.html

如果你已经绑定了域名，也可以这样访问：

1
http://你的域名:8317/management.html

打开后输入你在配置文件里设置的管理密码，例如：

1
MGT-123456

这样就可以进入 GUI 管理页面。

六、CLI Proxy API 的 GUI 图片#

下面这张是官方 GUI 界面截图：

如果你是远程 VPS 访问场景，浏览器访问的就是主程序内置的：

1
/management.html

七、补充：CC 配置 GPT-5.4 1M 对话#

如果你已经把 CLI Proxy API 跑起来了，还想在 CC 里开启 GPT-5.4 的大上下文对话，可以把下面这段补到对应配置中：

1
model = "gpt-5.4"
2
model_reasoning_effort = "xhigh"
3
model_context_window = 1047576
4
model_auto_compact_token_limit = 105197
5
web_search = "live"
6

7
[features]
8
multi_agent = true
9

10
[agents]
11
max_threads = 4

这几项可以这样理解：

• model = "gpt-5.4"：切换到 GPT-5.4
• model_reasoning_effort = "xhigh"：开启更高推理强度
• model_context_window = 1047576：把上下文窗口开到接近 1M
• model_auto_compact_token_limit = 105197：超过阈值后自动压缩上下文
• web_search = "live"：启用实时联网搜索
• multi_agent = true：开启多代理能力
• max_threads = 4：最多并行 4 个代理线程

如果你本地已经配置好了接口地址和密钥，这一段加进去后，就可以直接用于 GPT-5.4 的长上下文对话场景。

八、常见问题#

1
sudo ufw allow 8317/tcp

1
remote-management:
2
  secret-key: "MGT-123456"

1
systemctl --user restart cli-proxy-api

九、最短操作版#

如果你只想快速完成部署，直接按下面执行：

1
curl -fsSL https://raw.githubusercontent.com/brokechubb/cliproxyapi-installer/refs/heads/master/cliproxyapi-installer | bash
2
nano ~/.cli-proxy-api/config.yaml
3
systemctl --user restart cli-proxy-api

然后浏览器打开：

1
http://你的服务器IP:8317/management.html

输入你设置的：

1
MGT-123456

到这里就完成了：VPS 一键安装 -> 修改配置启用 GUI -> 重启生效 -> 浏览器进入管理页面。

十、参考资料#

• 官方 GUI 教程：https://help.router-for.me/cn/hands-on/tutorial-6
• 配置选项文档：https://help.router-for.me/cn/configuration/options
• 基础配置文档：https://help.router-for.me/cn/configuration/basic
• GUI 仓库：https://github.com/router-for-me/Cli-Proxy-API-Management-Center
• 主程序仓库：https://github.com/router-for-me/CLIProxyAPI