约 15 分钟阅读

CLIProxyAPI 部署教程：VPS、域名、SSL 与远程调用完整配置

想要畅快使用 OpenClaw 却苦于没有 Token？买 API 太贵，免费的又极度不稳定？本教程将手把手带你利用免费 VPS 服务器，从零开始部署 CLIProxyAPI，并通过 Cloudflare 配置域名解析与 SSL 证书，实现完美反代，从此获得永久免费的 Token！

视频教程

本视频由 短裤AI分享 制作，时长约 41 分 47 秒。

视频核心内容速览

✅ 00:00 效果展示：为什么要部署 CLIProxyAPI？如何白嫖 OpenClaw？
✅ 01:30 第一步：SSH 连接服务器与 IP 解锁能力检测（附一键脚本）
✅ 03:15 第二步：一键脚本高速部署 CLIProxyAPI 及核心配置文件修改（划重点！）
✅ 05:40 第三步：配置 Systemd 守护进程与开机自启
✅ 07:10 第四步：防火墙设置（iptables/nft/ufw）与 8317 端口放行防坑指南
✅ 10:05 第五步：Cloudflare API Token 申请与 Certbot 自动签发 SSL 证书
✅ 13:20 第六步：Nginx 安装与反向代理配置（监听 443 转发 8317，支持 WebSocket）
✅ 16:45 最终测试：用自定义域名和免费 Token 成功运行 OpenClaw！

前置准备

默认已放开 22 端口，此时可以尝试用你的认证方式进行 SSH 连接。

第一步：检测 IP 解锁情况

首先使用下面的脚本测试 ChatGPT 等平台的解锁情况：

项目地址：IPQuality - GitHub

一键检测命令：

1 2	`sudo -i bash <(curl -Ls https://IP.Check.Place) -f`

如果 ChatGPT 显示解锁，即可继续操作，否则需要更换服务器或配置代理。

检测结果示例：

IP检测结果

第二步：部署 CLIProxyAPI

根据 CLIProxyAPI 官方文档在服务器上部署。

使用一键安装脚本

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

修改配置文件

服务器默认使用项目根目录的 YAML 配置文件（config.yaml）。可通过 --config 指定其他路径：

1	`./cli-proxy-api --config /path/to/your/config.yaml`

重要配置项：

我们需要修改配置文件的 remote-management.allow-remote 来允许远程访问（如果在自己电脑上部署则不需要）。同时，设置管理密钥（写明文即可，会自动转换成哈希）。

# 服务器绑定主机/接口，默认空字符串同时绑定 IPv4/IPv6。
# 使用 “127.0.0.1” 或 “localhost” 可限制仅本机访问。
host: “”

# 服务器端口
port: 8317

# TLS 设置：启用后使用提供的证书与私钥监听 HTTPS。
tls:
  enable: false
  cert: “”
  key: “”

# 管理 API 设置
remote-management:
  # 是否允许远程（非 localhost）访问管理接口。
  # 为 false 时仅允许 localhost，仍需管理密钥。
  allow-remote: true
 
  # 管理密钥。若填写明文，启动时会自动哈希后生效。
  # 所有管理请求（包括本地）都需要该密钥。
  # 留空则完全禁用管理 API（所有 /v0/management 路由返回 404）。
  secret-key: “123456”

第三步：配置 Systemd 守护进程

安装 service 文件到 systemd

1
2
3

cd ~/cliproxyapi
sudo cp -f cliproxyapi.service /etc/systemd/system/cliproxyapi.service
sudo systemctl daemon-reload

检查服务状态

1	`systemctl status cliproxyapi.service --no-pager`

启动并设置开机自启

1 2	`sudo systemctl enable --now cliproxyapi.service systemctl status cliproxyapi.service --no-pager`

查看日志

1	`sudo journalctl -u cliproxyapi.service -e --no-pager`

第四步：防火墙配置与端口放行

在 GCP 面板或服务器上放行端口。使用 iptables 命令操作。

放行 8317 端口

1	`sudo iptables -A INPUT -p tcp --dport 8317 -j ACCEPT`

查看 iptables 规则

1	`sudo iptables -L -n -v`

删除指定规则

1	`sudo iptables -D INPUT <line-number>`

查看端口监听状态

1	`ss -lntp`

参数含义：

l：只看监听
n：数字显示端口
t：TCP
p：显示进程

配合 grep 筛选端口：

1	`ss -lntp \| grep 8317`

nft/ufw 防火墙处理

如果还是不能访问，需要检查 nft/ufw 问题。

查看规则集：

1	`sudo nft list ruleset`

INPUT 链顺序是按规则写入顺序匹配的。如果有下面这样的规则：

1	`counter packets 525 bytes 31692 reject with icmp type host-prohibited`

它的含义是：无条件拒绝所有走到这里的输入流量，等价于逻辑伪代码：

1
2
3

if (前面的规则都没匹配) {
    REJECT 所有包
}

如果我们的放行规则在这样的规则后面，就不会生效。我们可以删掉旧 reject：

1	`sudo nft delete rule ip filter INPUT handle 9`

然后在最后插入一条新的 reject：

1	`sudo nft add rule ip filter INPUT reject with icmp type host-prohibited`

这样顺序就正确了。

第五步：域名访问配置

使用 Cloudflare 托管服务，配合 Let’s Encrypt 实现 SSL 证书自动续期。假设你的域名为 bbb.aaa.com。

0）安装 Nginx

1 2	`sudo apt update sudo apt install -y nginx`

启动并设为开机自启：

1	`sudo systemctl enable --now nginx`

检查状态：

1	`systemctl status nginx`

1）Cloudflare 侧准备：创建 API Token

进入 Cloudflare → My Profile → API Tokens → Create Token

选模板：Edit zone DNS（或自定义）

权限最小化建议：

Permissions: Zone / DNS / Edit
Zone Resources: 仅选择 aaa.com 这个 zone

创建后复制 Token（只会显示一次）

2）服务器安装 certbot + cloudflare 插件

1 2	`sudo apt update sudo apt install -y certbot python3-certbot-dns-cloudflare`

3）保存 Cloudflare Token

1 2	`sudo mkdir -p /root/.secrets/certbot sudo nano /root/.secrets/certbot/cloudflare.ini`

写入（把 TOKEN 换成你的）：

1	`dns_cloudflare_api_token = YOUR_CLOUDFLARE_API_TOKEN`

权限必须收紧（不然 certbot 拒绝用）：

1	`sudo chmod 600 /root/.secrets/certbot/cloudflare.ini`

4）签发证书（DNS 验证）

sudo certbot certonly \
  --dns-cloudflare \
  --dns-cloudflare-credentials /root/.secrets/certbot/cloudflare.ini \
  -d bbb.aaa.com \
  --preferred-challenges dns-01

成功后证书会在：

/etc/letsencrypt/live/bbb.aaa.com/fullchain.pem
/etc/letsencrypt/live/bbb.aaa.com/privkey.pem

5）Nginx 配置反向代理

1	`sudo nano /etc/nginx/sites-available/cliproxyapi`

粘贴配置（替换域名为你的）：

server {
    listen 443 ssl http2;
    server_name bbb.aaa.com;

    ssl_certificate     /etc/letsencrypt/live/bbb.aaa.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/bbb.aaa.com/privkey.pem;

    ssl_protocols TLSv1.2 TLSv1.3;

    location / {
        proxy_pass http://127.0.0.1:8317; 

        proxy_http_version 1.1;
        proxy_set_header Host $host;

        # WebSocket 支持
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection “upgrade”;
                                
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

        proxy_read_timeout 300s;
    }
}

启用并重载：

1
2
3

sudo ln -s /etc/nginx/sites-available/cliproxyapi /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

6）自动续期配置

检查系统定时任务：

1	`systemctl list-timers \| grep certbot \|\| true`

Ubuntu 通常自带 certbot.timer。

续期后自动 reload nginx（添加 deploy hook）：

创建 hook：

1	`sudo vi /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh`

写入：

1 2	`#!/bin/sh systemctl reload nginx`

赋权：

1	`sudo chmod +x /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh`

测试续期：

1	`sudo certbot renew --dry-run`

看到成功即可。

Cloudflare 设置：

在 Cloudflare 中选择 Full (strict) 模式，开启 Always Use HTTPS（即使源站没开 80 也没关系，CF 边缘重定向）。

在服务器安全组/iptables 需要放行：443/tcp。

7）为 CLIProxyAPI 启用 TLS

可以在 WebUI 中配置，或在配置文件中直接修改：

证书文件路径： /etc/letsencrypt/live/bbb.aaa.com/fullchain.pem

私钥文件路径： /etc/letsencrypt/live/bbb.aaa.com/privkey.pem

修改 config.yaml：

# 服务器绑定主机/接口
host: “”

# 服务器端口
port: 8317

# TLS 设置
tls:
  enable: true
  cert: “/etc/letsencrypt/live/bbb.aaa.com/fullchain.pem”
  key: “/etc/letsencrypt/live/bbb.aaa.com/privkey.pem”

# 管理 API 设置
remote-management:
  allow-remote: true
  secret-key: “123456”

最终效果

配置完成后，你可以使用自定义域名访问 CLIProxyAPI，并通过注册机搞定 100 个 Codex 账号，实现 OpenClaw 自由！

最终效果

小白避坑指南

修改 config.yaml 时，千万记得把 allow-remote 改为 true，并设置一个你记得住的 secret-key
配置防火墙放行端口时，注意排查有没有冲突的 reject 规则
Cloudflare SSL/TLS 加密模式记得一定要设置为 Full (strict) 严格模式

参考链接

⚠️ 免责声明：本教程仅供网络优化与技术交流学习，请大家合理、合法使用相关网络技术。

M.'s Blog

技术分享与经验沉淀 | 撸起袖子加油干💪

CLIProxyAPI 部署教程：VPS、域名、SSL 与远程调用完整配置

视频教程

视频核心内容速览

前置准备

第一步：检测 IP 解锁情况

第二步：部署 CLIProxyAPI

使用一键安装脚本

修改配置文件

第三步：配置 Systemd 守护进程

安装 service 文件到 systemd

检查服务状态

启动并设置开机自启

查看日志

第四步：防火墙配置与端口放行

放行 8317 端口

查看 iptables 规则

删除指定规则

查看端口监听状态

nft/ufw 防火墙处理

第五步：域名访问配置

0）安装 Nginx

1）Cloudflare 侧准备：创建 API Token

2）服务器安装 certbot + cloudflare 插件

3）保存 Cloudflare Token

4）签发证书（DNS 验证）

5）Nginx 配置反向代理

6）自动续期配置

7）为 CLIProxyAPI 启用 TLS

最终效果

小白避坑指南

相关资源

GCP 免费服务器教程

社群与资源

eSIM 服务推荐

虚拟银行卡

参考链接

视频教程

视频核心内容速览

前置准备

第一步：检测 IP 解锁情况

第二步：部署 CLIProxyAPI

使用一键安装脚本

修改配置文件

第三步：配置 Systemd 守护进程

安装 service 文件到 systemd

检查服务状态

启动并设置开机自启

查看日志

第四步：防火墙配置与端口放行

放行 8317 端口

查看 iptables 规则

删除指定规则

查看端口监听状态

nft/ufw 防火墙处理

第五步：域名访问配置

0）安装 Nginx

1）Cloudflare 侧准备：创建 API Token

2）服务器安装 certbot + cloudflare 插件

3）保存 Cloudflare Token

4）签发证书（DNS 验证）

5）Nginx 配置反向代理

6）自动续期配置

7）为 CLIProxyAPI 启用 TLS

最终效果

小白避坑指南

相关资源

GCP 免费服务器教程

社群与资源

eSIM 服务推荐

虚拟银行卡

参考链接

相关推荐