2026年5月13日 (三) 00:45 Liam

2026-05-13T00:45:06Z

←上一版本		2026年5月12日 (二) 17:45的版本
第288行：		第288行：
	\| `51121` \| Antigravity OAuth 回调 \| ✅ 必须 \|		\| `51121` \| Antigravity OAuth 回调 \| ✅ 必须 \|
	\| `11451` \| 其他 OAuth 回调 \| ✅ 必须 \|		\| `11451` \| 其他 OAuth 回调 \| ✅ 必须 \|
			[[Category:500 常见应用指南 — Application Guides]]

Lusky0：创建页面，内容为“# CLIProxyAPI Docker 部署教程 > 环境：Debian 13 | Docker Compose | Nginx 反向代理 > 访问域名：`xxx.com` ------ ## 一、安装系统依赖 ```bash apt update && apt upgrade -y apt install -y git nginx curl # 安装 Docker bash <(curl -fsSL https://get.docker.com) systemctl enable --now docker ``` ------ ## 二、部署 CLIProxyAPI ### 2.1 克隆项目 ```bash git clone https://github.com/router-for-me/CLIProxyAPI.git cd CLIProxyAPI cp c…”

2026-05-09T10:46:07Z

创建页面，内容为“# CLIProxyAPI Docker 部署教程 > 环境：Debian 13 | Docker Compose | Nginx 反向代理 > 访问域名：`xxx.com` ------ ## 一、安装系统依赖 ```bash apt update && apt upgrade -y apt install -y git nginx curl # 安装 Docker bash <(curl -fsSL https://get.docker.com) systemctl enable --now docker ``` ------ ## 二、部署 CLIProxyAPI ### 2.1 克隆项目 ```bash git clone https://github.com/router-for-me/CLIProxyAPI.git cd CLIProxyAPI cp c…”

新页面

# CLIProxyAPI Docker 部署教程

> 环境：Debian 13 | Docker Compose | Nginx 反向代理
> 访问域名：`xxx.com`

------

## 一、安装系统依赖

```bash
apt update && apt upgrade -y
apt install -y git nginx curl

# 安装 Docker
bash <(curl -fsSL https://get.docker.com)
systemctl enable --now docker
```

------

## 二、部署 CLIProxyAPI

### 2.1 克隆项目

```bash
git clone https://github.com/router-for-me/CLIProxyAPI.git
cd CLIProxyAPI
cp config.example.yaml config.yaml
```

### 2.2 编辑配置文件

```bash
nano config.yaml
```

写入以下配置：

```yaml
port: 8317

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

request-retry: 3

quota-exceeded:
switch-project: true
switch-preview-model: true

api-keys:
- "your-api-key" # 客户端访问时使用的 Key，先随便填一个，后续可在面板修改

remote-management:
allow-remote: true
secret-key: "your-management-password" # 管理面板登录密码
```

> `api-keys` 不能留空，先填一个占位，进管理面板后再改。
> `secret-key` 首次启动后会自动 bcrypt 加密写回配置，用明文登录即可。

### 2.3 修改 docker-compose.yml

将 8317 和 8085 绑定到本地，OAuth 回调端口保持公网可达：

```bash
nano docker-compose.yml
```

找到 `ports` 部分，修改为：

```yaml
ports:
- "127.0.0.1:8317:8317" # 主 API，走 Nginx 反代
- "127.0.0.1:8085:8085" # 内部端口（实际未使用）
- "1455:1455" # OAuth 回调（Claude/Codex）
- "54545:54545" # OAuth 回调（Gemini CLI）
- "51121:51121" # OAuth 回调（Antigravity）
- "11451:11451" # OAuth 回调（其他）
```

### 2.4 启动服务

```bash
bash docker-build.sh
# 出现选项时输入 1 回车（使用预构建镜像，速度快）
```

或直接：

```bash
docker compose up -d
```

验证服务正常运行：

```bash
docker compose ps
ss -tlnp | grep 8317 # 应看到 127.0.0.1:8317
tail -f ./logs/main.log # 实时日志
```

------

## 三、配置防火墙

放行 OAuth 回调端口（API 端口由 Nginx 代理，无需放行）：

```bash
# ufw
ufw allow 1455/tcp
ufw allow 54545/tcp
ufw allow 51121/tcp
ufw allow 11451/tcp
```

------

## 四、配置 Nginx

### 4.1 创建站点配置

先只写 HTTP 块，等 certbot 申请完证书后再补 HTTPS：

```bash
cat > /etc/nginx/sites-available/xxx.com << 'EOF'
server {
listen 80;
listen [::]:80;
server_name xxx.com;

location / {
return 301 https://$host$request_uri;
}
}
EOF
```

### 4.2 启用站点

```bash
ln -s /etc/nginx/sites-available/xxx.com /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
```

### 4.3 申请 HTTPS 证书

```bash
apt install -y certbot python3-certbot-nginx
certbot --nginx -d xxx.com
systemctl enable --now certbot.timer
```

### 4.4 替换为完整配置

certbot 申请成功后，覆盖写入完整的 Nginx 配置：

```bash
cat > /etc/nginx/sites-available/xxx.com << 'EOF'
# HTTP → 强制跳转 HTTPS
server {
listen 80;
listen [::]:80;
server_name xxx.com;

location / {
return 301 https://$host$request_uri;
}
}

# HTTPS 主配置
server {
listen 443 ssl;
listen [::]:443 ssl;
server_name xxx.com;

ssl_certificate /etc/letsencrypt/live/xxx.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/xxx.com/privkey.pem;
include /etc/letsencrypt/options-ssl-nginx.conf;
ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;

# 主 API
location / {
proxy_pass http://127.0.0.1:8317;
proxy_http_version 1.1;

proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;

# SSE 流式响应必须关闭缓冲
proxy_buffering off;
proxy_cache off;

proxy_read_timeout 300s;
proxy_connect_timeout 75s;
}
}
EOF
nginx -t && systemctl reload nginx
```

------

## 五、访问管理面板

浏览器打开：

```
https://xxx.com/management.html
```

- **服务器地址**：自动填入 `https://xxx.com`
- **管理密钥**：填写 `config.yaml` 中 `secret-key` 的值

------

## 六、添加 OAuth 认证

在服务器上执行对应命令生成认证链接：

```bash
cd ~/CLIProxyAPI

# Claude
docker compose exec cli-proxy-api /CLIProxyAPI/CLIProxyAPI -no-browser --claude-login

# Gemini CLI
docker compose exec cli-proxy-api /CLIProxyAPI/CLIProxyAPI -no-browser --login

# OpenAI Codex
docker compose exec cli-proxy-api /CLIProxyAPI/CLIProxyAPI -no-browser --codex-login

# Qwen
docker compose exec cli-proxy-api /CLIProxyAPI/CLIProxyAPI -no-browser --qwen-login
```

复制输出的 `ssh` 隧道命令，**在本地电脑终端**执行（替换实际 SSH 端口）：

```bash
ssh -p 你的SSH端口 -R 1455:localhost:1455 root@服务器IP
```

然后在服务器终端复制授权链接 → 本地浏览器打开 → 登录授权 → 认证文件自动保存。

------

## 七、客户端使用

| 项目 | 值 |
| ------------ | -------------------------------------- |
| API Endpoint | `https://xxx.com` |
| API Key | `config.yaml` 中 `api-keys` 里设置的值 |

------

## 八、常用运维命令

```bash
cd ~/CLIProxyAPI

# 查看运行状态
docker compose ps

# 实时日志
tail -f ./logs/main.log

# 重启服务
docker compose restart

# 升级到最新版
docker compose pull && docker compose up -d

# 停止服务
docker compose down
```

------

## 各端口说明

| 端口 | 用途 | 是否公网 |
| ------- | ----------------------- | ---------------- |
| `8317` | 主 API 服务 | 否（Nginx 代理） |
| `8085` | 内部端口 | 否 |
| `1455` | Claude/Codex OAuth 回调 | ✅ 必须 |
| `54545` | Gemini CLI OAuth 回调 | ✅ 必须 |
| `51121` | Antigravity OAuth 回调 | ✅ 必须 |
| `11451` | 其他 OAuth 回调 | ✅ 必须 |

CLIProxyAPI Docker 部署教程 - 版本历史

2026年5月13日 (三) 00:45 Liam