md5.pw - 用户贡献 [zh]

CLIProxyAPI Docker 部署教程

2026-05-09T10:46:07Z

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…”

# 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 回调 | ✅ 必须 |

部署https中转服务教程

2025-12-23T09:44:55Z

Lusky0：创建页面，内容为“== 为什么要做https转发 == 因为公司业务在美国，服务器已经使用很久，迁移非常麻烦，现在正好有瓦工稳定机器故想到这个解决方案，可能不是最优，但是目前满足我的业务稳定分享给大家，如有不足欢迎大佬们指点。 == 部署Nginx == ==== 宿主机先创建这些文件 ==== <pre> /home/docker/nginx/nginx.conf /home/docker/nginx/conf.d /home/docker/nginx/log /home/docker/nginx/html /home/…”

== 为什么要做https转发 ==
因为公司业务在美国，服务器已经使用很久，迁移非常麻烦，现在正好有瓦工稳定机器故想到这个解决方案，可能不是最优，但是目前满足我的业务稳定分享给大家，如有不足欢迎大佬们指点。

== 部署Nginx ==
==== 宿主机先创建这些文件 ====
<pre>
/home/docker/nginx/nginx.conf
/home/docker/nginx/conf.d
/home/docker/nginx/log
/home/docker/nginx/html
/home/docker/nginx/ssl
/home/docker/letsencrypt
</pre>

==== 安装docker ====
<pre>
curl -fsSL https://get.docker.com -o install-docker.sh
sudo sh install-docker.sh
</pre>

===== 启动脚本startNginx.sh =====
<pre>
sudo docker run \
-p 80:80 \
-p 443:443 \
-p 8081:8081 \
--name nginx \
-v /home/docker/nginx/nginx.conf:/etc/nginx/nginx.conf \
-v /home/docker/nginx/conf.d:/etc/nginx/conf.d \
-v /home/docker/nginx/log:/var/log/nginx \
-v /home/docker/nginx/html:/usr/share/nginx/html \
-v /home/docker/nginx/ssl:/etc/nginx/ssl \
-v /home/docker/letsencrypt:/var/www/letsencrypt \
-d nginx
</pre>

==== 证书自动续期ssl_auto.sh ====
<pre>
#!/bin/bash

# ==============================
# 智能 SSL 自动管理脚本
# - 每日检查证书剩余天数
# - ≤30 天自动续期
# - webroot 模式（不中断服务）
# ========== 运行模式 ==========
DRY_RUN=false # true = 测试模式（不真正续期）
# ==============================

NGINX_CONTAINER="nginx"
WEBROOT="/home/docker/letsencrypt"
SSL_DIR="/home/docker/nginx/ssl"
RENEW_BEFORE_DAYS=30

DOMAINS=(
"xxxxx"
)

echo "============================"
echo " 🔐 SSL 自动检查启动 $(date)"
echo "============================"

mkdir -p "$WEBROOT/.well-known/acme-challenge/"

need_restart_nginx=false

for DOMAIN in "${DOMAINS[@]}"; do
CERT_PATH="/etc/letsencrypt/live/$DOMAIN/fullchain.pem"

echo ""
echo "👉 检查域名：$DOMAIN"

# 如果证书不存在，直接申请
if [ ! -f "$CERT_PATH" ]; then
echo "⚠ 未发现证书，立即申请"
renew=true
else
# 获取过期时间
expire_date=$(openssl x509 -enddate -noout -in "$CERT_PATH" | cut -d= -f2)
expire_ts=$(date -d "$expire_date" +%s)
now_ts=$(date +%s)

days_left=$(( (expire_ts - now_ts) / 86400 ))

echo "📅 剩余有效期：$days_left 天"

if [ "$days_left" -le "$RENEW_BEFORE_DAYS" ]; then
echo "⏰ 低于 $RENEW_BEFORE_DAYS 天，需要续期"
renew=true
else
echo "✅ 证书仍然有效，跳过"
renew=false
fi
fi

# if [ "$renew" = true ]; then
# echo "🔄 正在申请/续期：$DOMAIN"

# certbot certonly \
# --webroot -w "$WEBROOT" \
# -d "$DOMAIN" \
# --non-interactive \
# --agree-tos \
# -m admin@$DOMAIN

# if [ $? -ne 0 ]; then
# echo "❌ 续期失败：$DOMAIN"
# continue
# fi

if [ "$renew" = true ]; then
echo "🔄 正在申请/续期：$DOMAIN"

CERTBOT_ARGS=(
certonly
--webroot -w "$WEBROOT"
-d "$DOMAIN"
--non-interactive
--agree-tos
-m admin@$DOMAIN
)

if [ "$DRY_RUN" = true ]; then
CERTBOT_ARGS+=(--dry-run)
echo "🧪 DRY-RUN 模式：仅测试，不会真正更新证书"
fi

certbot "${CERTBOT_ARGS[@]}"

if [ $? -ne 0 ]; then
echo "❌ 续期失败：$DOMAIN"
# 这里之后你可以接邮件/钉钉告警
continue
fi

echo "✅ certbot 执行成功：$DOMAIN"

# dry-run 模式不做后续动作
if [ "$DRY_RUN" = true ]; then
echo "🧪 DRY-RUN 模式：跳过证书复制与 Nginx 重启"
continue
fi

echo "✅ 续期成功：$DOMAIN"

# 复制到 nginx ssl 目录
cp -f /etc/letsencrypt/live/$DOMAIN/fullchain.pem \
$SSL_DIR/$DOMAIN.pem
cp -f /etc/letsencrypt/live/$DOMAIN/privkey.pem \
$SSL_DIR/$DOMAIN.key

chmod 644 $SSL_DIR/$DOMAIN.pem
chmod 600 $SSL_DIR/$DOMAIN.key

need_restart_nginx=true
echo "📦 证书已更新到 Nginx 目录"
fi
done

# 如有证书更新才重启 nginx
if [ "$need_restart_nginx" = true ]; then
echo ""
echo "🔄 重启 Nginx 容器"
docker restart $NGINX_CONTAINER
echo "✅ Nginx 重启完成"
else
echo ""
echo "ℹ️ 无证书变更，无需重启 Nginx"
fi

echo ""
echo "🎉 SSL 检查完成"
</pre>

==== Nginx.conf配置文件 ====
<pre>
server {
listen 80;
server_name xxx;

location /.well-known/acme-challenge/ {
alias /var/www/letsencrypt/.well-known/acme-challenge/;
try_files $uri =404;
}

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

upstream put_api_backend {
server xxxxx:443;
keepalive 100;
}

server {
listen 443 ssl;
server_name xxx;

ssl_certificate /etc/nginx/ssl/xxx.pem;
ssl_certificate_key /etc/nginx/ssl/xxx.key;

ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers HIGH:!aNULL:!MD5;

access_log /var/log/nginx/xxx.access.log;
error_log /var/log/nginx/xxx.error.log warn;

# ACME challenge（HTTPS 续期仍然需要）
location /.well-known/acme-challenge/ {
alias /var/www/letsencrypt/.well-known/acme-challenge/;
try_files $uri =404;
}

# API 中转
location /api {
proxy_pass https://put_api_backend;
proxy_ssl_server_name on;

proxy_http_version 1.1;
proxy_set_header Connection "";

proxy_set_header Host xxx;
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 https;

proxy_connect_timeout 5s;
proxy_read_timeout 30s;
proxy_send_timeout 30s;
}

# 其他路径拒绝
location / {
return 404;
}
}
</pre>

==== 重启Nginx ====
<pre>
docker exec -it nginx nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
root@ubuntu:/home/docker/nginx# docker exec -it nginx nginx -s reload
</pre>

测评

2025-12-21T02:45:23Z

Lusky0：创建页面，内容为“ == MageBox-Pro使用测评 == {| class="wikitable" |+ 机器配置 |- ! VPS !! SKU !! CPU !! RAM !! SSD !! Traffic !! IP !! 价格 |- | BandwagonHOST || NODESEEK-MEGABOX-PRO || 2C || 2G || 40G || 2T / 2.5Gbps || IPv4 / IPv6 || **$45.68/Annually** |} == 系统参数硬件性能 == thumb == Tdog — IPv4 质量测试 == {| class="wikitable" |+ tcp |- ! CM !! CU !! CT |- | thumb || File:2-1.webp|thum…”

== MageBox-Pro使用测评 ==

{| class="wikitable"
|+ 机器配置
|-
! VPS !! SKU !! CPU !! RAM !! SSD !! Traffic !! IP !! 价格
|-
| BandwagonHOST || NODESEEK-MEGABOX-PRO || 2C || 2G || 40G || 2T / 2.5Gbps || IPv4 / IPv6 || **$45.68/Annually**
|}

== 系统参数硬件性能 ==
[[File:Magebox配置信息.png|thumb]]

== Tdog — IPv4 质量测试 ==
{| class="wikitable"
|+ tcp
|-
! CM !! CU !! CT
|-
|
[[File:1-1.webp|thumb]]
||
[[File:2-1.webp|thumb]]
||
[[File:31.webp|thumb]]
|}

== Connectivity ==
[[File:41.webp|thumb]]

== 去程路由 ==
{| class="wikitable"
|+ 去程路由
|-
! 区域 !! CM !! CU !! CT
|-
| 北京 ||
[[File:51.webp|thumb]]
||
[[File:61.webp|thumb]]
||
[[File:71.webp|thumb]]
|-
| 上海 ||
[[File:81.webp|thumb]]
||
[[File:91.webp|thumb]]
||
[[File:101.webp|thumb]]
|-
| 广东 ||
[[File:111.webp|thumb]]
||
[[File:121.webp|thumb]]
||
[[File:131.webp|thumb]]
|}

== 回程路由 ==
{| class="wikitable"
|+ 回程路由
|-
! 区域 !! 北京 !! 上海 !! 广东
|-
| IPv4 ||
[[File:141.webp|thumb]]
||
[[File:151.webp|thumb]]
||
[[File:16.webp|thumb]]
|}

== 国内三网延迟 ==
{| class="wikitable"
|+ 国内三网延迟
|-
|
[[File:17.webp|thumb]]
|}

== IP 质量 ==
{| class="wikitable"
|+ IP 质量
|-
|
[[File:18.webp|thumb]]
|}

== 流媒体解锁 ==
{| class="wikitable"
|+ 流媒体解锁
|-
|
[[File:19.webp|thumb]]
|}

== 全网请求时间 ==
{| class="wikitable"
|-
|
[[File:20.webp|thumb]]
||
[[File:21.webp|thumb]]
||
[[File:22.webp|thumb]]
|-
|
[[File:23.webp|thumb]]
||
[[File:24.webp|thumb]]
||
[[File:25.webp|thumb]]
|}

== 心跳线 ==
[[File:26.webp|thumb|center]]

== Speedtest ==
{| class="wikitable"
|-
| [[File:27.webp|thumb]] ||
[[File:28.webp|thumb]]
|}

== Speedtest（本地电信 100M · Reality） ==
{| class="wikitable"
|-
! 多线程 !! 标题文本
|-
|
[[File:29.webp|thumb]]
||
[[File:30.webp|thumb]]
|}

== Cloudflare（本地电信 100M · Reality） ==
{| class="wikitable"
|-
|
[[File:32.webp|thumb]]
|}

== Fast（本地电信 100M · Reality） ==
{| class="wikitable"
|-
|
[[File:33.webp|thumb]]
|}

== Fiber （本地电信 100M · Reality） ==
{| class="wikitable"
|-
|
[[File:34.webp|thumb]]
|}

== YouTube（本地电信 100M · Reality） ==
{| class="wikitable"
|-
| [[File:35.webp|thumb]] || [[File:36.webp|thumb]]
|}

File:36.webp

2025-12-20T06:58:04Z

Lusky0：

File:35.webp

2025-12-20T06:57:40Z

Lusky0：

File:34.webp

2025-12-20T06:55:42Z

Lusky0：

File:33.webp

2025-12-20T06:54:41Z

Lusky0：

File:32.webp

2025-12-20T06:53:53Z

Lusky0：

File:30.webp

2025-12-20T06:52:25Z

Lusky0：

File:29.webp

2025-12-20T06:51:55Z

Lusky0：

File:28.webp

2025-12-20T06:49:40Z

Lusky0：

File:27.webp

2025-12-20T06:48:02Z

Lusky0：

File:26.webp

2025-12-20T06:45:22Z

Lusky0：

File:25.webp

2025-12-20T06:43:56Z

Lusky0：

File:24.webp

2025-12-20T06:43:31Z

Lusky0：

File:23.webp

2025-12-20T06:43:00Z

Lusky0：

File:22.webp

2025-12-20T06:42:31Z

Lusky0：

File:21.webp

2025-12-20T06:42:01Z

Lusky0：

File:20.webp

2025-12-20T06:41:31Z

Lusky0：

File:19.webp

2025-12-20T06:37:27Z

Lusky0：

File:18.webp

2025-12-20T06:36:27Z

Lusky0：

File:17.webp

2025-12-20T06:34:49Z

Lusky0：

File:16.webp

2025-12-20T06:32:50Z

Lusky0：

File:151.webp

2025-12-20T06:31:43Z

Lusky0：

151

File:141.webp

2025-12-20T06:23:54Z

Lusky0：

141

File:131.webp

2025-12-20T06:21:34Z

Lusky0：

131

File:121.webp

2025-12-20T06:21:00Z

Lusky0：

121

File:111.webp

2025-12-20T06:20:31Z

Lusky0：

111

File:101.webp

2025-12-20T06:19:58Z

Lusky0：

101

File:91.webp

2025-12-20T06:19:26Z

Lusky0：

File:81.webp

2025-12-20T06:18:55Z

Lusky0：

File:71.webp

2025-12-20T06:18:18Z

Lusky0：

File:61.webp

2025-12-20T06:17:48Z

Lusky0：

File:51.webp

2025-12-20T06:16:32Z

Lusky0：

File:41.webp

2025-12-20T06:13:21Z

Lusky0：

File:31.webp

2025-12-20T06:11:33Z

Lusky0：

File:2-1.webp

2025-12-20T06:10:57Z

Lusky0：

File:1-1.webp

2025-12-20T06:09:55Z

Lusky0：

File:Magebox配置信息.png

2025-12-20T06:05:15Z

Lusky0：

magebox配置信息

File:瓦工特价配置.jpg

2025-12-05T14:54:57Z

Lusky0：

mageboxpro清单