前言
在当前的大语言模型（LLM）应用开发与个人使用场景中，直接调用官方 API 往往面临网络环境受限、账户管理复杂以及非标准接口兼容性差等挑战。CLIProxyAPI 作为一种创新的解决方案，通过模拟命令行接口（CLI）的交互方式，将 OpenAI、Gemini、Claude、Codex 等服务的后端逻辑封装为标准的 API 接口，实现了对异构模型服务的统一代理。本文将结合实际部署案例，详细阐述如何在海外服务器环境构建这一系统，并通过 Docker 容器化技术部署 New API 进行二次分发与配额管理，最终在客户端（如 Cherry Studio）实现全模型的高效调用。
第一部分：基础设施准备与 CLIProxyAPI 的核心部署
构建逆向代理系统的首要前提是拥有一个网络环境纯净且能够稳定访问上游模型服务提供商（如 Google、OpenAI、Anthropic）的基础设施。
1.1 服务器选型与环境初始化
本次部署选用的是腾讯云提供的美国区域云服务器，配置为 2 核 CPU 与 2GB 内存。选择美国节点的核心原因在于大多数主流 LLM 服务商对 IP 地理位置有严格限制，美国原生 IP 或数据中心 IP 通常能获得最佳的连通性与响应速度。
在通过 SSH 协议连接至服务器终端后，我们首先面对的是纯净的 Linux 操作系统环境。为了确保后续软件的顺利安装，建议先执行系统包管理器的更新操作，并安装必要的网络工具（如 curl、wget）和文本编辑器（如 nano 或 vim）。
1.2 CLIProxyAPI 的自动化安装
CLIProxyAPI 项目提供了一键安装脚本，极大简化了二进制文件的下载与权限配置过程。该脚本通常托管在 GitHub 上，通过 curl 命令可以直接拉取并传输给 bash 解释器执行。
在终端输入以下安装命令：
curl -fsSL https://raw.githubusercontent.com/brokechubb/cliproxyapi-installer/refs/heads/master/cliproxyapi-installer | bash
该命令中的 -fsSL 参数确保了下载过程的静默模式（不输出进度条）、自动处理重定向以及强制使用 SSL 加密连接，保证了脚本获取的安全性与完整性。
脚本执行完毕后，控制台会输出安装成功的提示信息，并给出了后续的快速开始指引。安装程序自动创建了 /root/cliproxyapi 目录，并提示用户可以通过参数（如 --login、--claude-login）来初始化不同服务商的认证流程。这表明二进制文件已正确放置，且具备了执行权限。
1.3 核心配置文件 config.yaml 的深度定制
安装完成后，必须对默认配置文件进行调整以适应远程访问需求。进入程序目录：
cd /root/cliproxyapi
在该目录下，config.yaml 承载了服务监听、安全认证以及代理行为的关键参数。使用文本编辑器打开该文件。
首要修改的参数是 allow-remote。默认情况下，为了安全起见，该服务可能仅监听本地回环地址（127.0.0.1）。为了让外部客户端或同一内网下的其他服务（如后续的 New API）能够访问此代理，必须将此项设置为 true。
其次，安全认证机制至关重要。secret-key 字段定义了访问管理面板和 API 接口时的全局密钥。这是一个对称加密或简单的访问令牌机制，任何持有此 Key 的客户端都拥有对服务的控制权。因此，必须将其修改为一个高强度的自定义密码。
修改完成后，保存并退出编辑器。至此，基础配置工作已完成。
第二部分：系统服务化管理与故障排查
为了保证 CLIProxyAPI 能够在后台稳定运行，并在服务器重启后自动拉起，将其注册为 systemd 服务是标准且规范的操作流程。
2.1 初始启动尝试与 Systemd 服务注册
尝试使用 systemd 用户级命令启动服务：
systemctl --user enable cliproxyapi.service
如果系统提示无法找到服务单元文件或出现载入错误，这通常意味着安装脚本未自动创建系统级的 service 文件，或者文件路径不符合 systemd 的扫描规则。为了获得更高级别的权限管理与稳定性，推荐手动创建一个系统级的服务文件。
