Claude Relay Service 部署指南

完整的 Claude Relay Service 部署教程，支持脚本、Docker 和手动部署。

🚀 系统要求

最低配置

CPU：1核心
内存：512MB（推荐 1GB）
硬盘：30GB 可用空间
操作系统：Ubuntu/Debian、CentOS/RedHat、Arch Linux、macOS
网络：能访问到 Anthropic API（建议 US 地区机器）

费用估算

服务器：轻量云服务器，一个月 30-60 块
Claude 订阅：看你怎么分摊了
其他：域名（可选）

🚀 脚本部署（推荐）

推荐使用管理脚本进行一键部署，简单快捷，自动处理所有依赖和配置。

快速安装

bash

curl -fsSL https://pincc.ai/manage.sh -o manage.sh && chmod +x manage.sh && ./manage.sh install

脚本功能

✅ 一键安装：自动检测系统环境，安装 Node.js 18+、Redis 等依赖
✅ 交互式配置：友好的配置向导，设置端口、Redis 连接等
✅ 自动启动：安装完成后自动启动服务并显示访问地址
✅ 便捷管理：通过 crs 命令随时管理服务状态

管理命令

bash

crs install   # 安装服务
crs start     # 启动服务
crs stop      # 停止服务
crs restart   # 重启服务
crs status    # 查看状态
crs update    # 更新服务
crs uninstall # 卸载服务

安装示例

bash

$ crs install

# 会依次询问：
安装目录 (默认: ~/claude-relay-service):
服务端口 (默认: 3000): 8080
Redis 地址 (默认: localhost):
Redis 端口 (默认: 6379):
Redis 密码 (默认: 无密码):

# 安装完成后自动启动并显示：
服务已成功安装并启动！

访问地址：
  本地 Web: http://localhost:8080/web
  公网 Web: http://YOUR_IP:8080/web

管理员账号信息已保存到: data/init.json

🐳 Docker 部署

使用 Docker Hub 镜像

🚀 使用官方镜像，自动构建，始终保持最新版本

第一步：下载构建docker-compose.yml文件的脚本并执行

bash

curl -fsSL https://pincc.ai/crs-compose.sh -o crs-compose.sh && chmod +x crs-compose.sh && ./crs-compose.sh

第二步：启动

bash

docker-compose up -d

环境变量说明

必填项

JWT_SECRET: JWT密钥，至少32个字符
ENCRYPTION_KEY: 加密密钥，必须是32个字符

可选项

ADMIN_USERNAME: 管理员用户名（不设置则自动生成）
ADMIN_PASSWORD: 管理员密码（不设置则自动生成）
LOG_LEVEL: 日志级别（默认：info）

管理员凭据获取方式

查看容器日志
bash
```
docker logs claude-relay-service
```
查看挂载的文件
bash
```
cat ./data/init.json
```

使用环境变量预设

bash

# 在 .env 文件中设置
ADMIN_USERNAME=cr_admin_custom
ADMIN_PASSWORD=your-secure-password

📦 手动部署

第一步：环境准备

Ubuntu/Debian 用户：

bash

# 安装 Node.js
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# 安装 Redis
sudo apt update
sudo apt install redis-server
sudo systemctl start redis-server

CentOS/RHEL 用户：

bash

# 安装 Node.js
curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
sudo yum install -y nodejs

# 安装 Redis
sudo yum install redis
sudo systemctl start redis

第二步：下载和配置

bash

# 下载项目
git clone https://github.com/Wei-Shaw/claude-relay-service.git
cd claude-relay-service

# 安装依赖
npm install

# 复制配置文件（重要！）
cp config/config.example.js config/config.js
cp .env.example .env

第三步：配置文件设置

编辑 .env 文件：

bash

# 这两个密钥随便生成，但要记住
JWT_SECRET=你的超级秘密密钥
ENCRYPTION_KEY=32位的加密密钥随便写

# Redis配置
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=

编辑 config/config.js 文件：

javascript

module.exports = {
  server: {
    port: 3000, // 服务端口，可以改
    host: '0.0.0.0' // 不用改
  },
  redis: {
    host: '127.0.0.1', // Redis地址
    port: 6379 // Redis端口
  }
  // 其他配置保持默认就行
}

第四步：安装前端依赖并构建

bash

# 安装前端依赖
npm run install:web

# 构建前端（生成 dist 目录）
npm run build:web

第五步：启动服务

bash

# 初始化
npm run setup # 会随机生成后台账号密码信息，存储在 data/init.json
# 或者通过环境变量预设管理员凭据：
# export ADMIN_USERNAME=cr_admin_custom
# export ADMIN_PASSWORD=your-secure-password

# 启动服务
npm run service:start:daemon   # 后台运行

# 查看状态
npm run service:status

🎮 开始使用

1. 打开管理界面

浏览器访问：http://你的服务器IP:3000/web

管理员账号：

自动生成：查看 data/init.json
环境变量预设：通过 ADMIN_USERNAME 和 ADMIN_PASSWORD 设置
Docker 部署：查看容器日志 docker logs claude-relay-service

2. 添加Claude账户

这一步比较关键，需要OAuth授权：

点击「Claude账户」标签
如果你担心多个账号共用1个IP怕被封禁，可以选择设置静态代理IP（可选）
点击「添加账户」
点击「生成授权链接」，会打开一个新页面
在新页面完成Claude登录和授权
复制返回的Authorization Code
粘贴到页面完成添加

注意: 如果你在国内，这一步可能需要科学上网。

3. 创建API Key

给每个使用者分配一个Key：

点击「API Keys」标签
点击「创建新Key」
给Key起个名字，比如「张三的Key」
设置使用限制（可选）：
- 速率限制: 限制每个时间窗口的请求次数和Token使用量
- 并发限制: 限制同时处理的请求数
- 模型限制: 限制可访问的模型列表
- 客户端限制: 限制只允许特定客户端使用（如ClaudeCode、Gemini-CLI等）
保存，记下生成的Key

4. 配置 Claude Code

现在你可以用自己的服务替换官方API了：

Claude Code 设置环境变量：

bash

export ANTHROPIC_BASE_URL="http://127.0.0.1:3000/api/" # 根据实际填写你服务器的ip地址或者域名
export ANTHROPIC_AUTH_TOKEN="后台创建的API密钥"

使用 Claude Code：

bash

claude

🔧 日常维护

服务管理

bash

# 查看服务状态
npm run service:status

# 查看日志
npm run service:logs

# 重启服务
npm run service:restart:daemon

# 停止服务
npm run service:stop

监控使用情况

Web界面: http://你的域名:3000/web - 查看使用统计
健康检查: http://你的域名:3000/health - 确认服务正常
日志文件: logs/ 目录下的各种日志文件

升级指南

当有新版本发布时：

bash

# 1. 进入项目目录
cd claude-relay-service

# 2. 拉取最新代码
git pull origin main

# 3. 安装新的依赖（如果有）
npm install

# 4. 安装并构建前端
npm run install:web
npm run build:web

# 5. 重启服务
npm run service:restart:daemon

# 6. 检查服务状态
npm run service:status

注意事项：

升级前建议备份重要配置文件（.env, config/config.js）
查看更新日志了解是否有破坏性变更
如果有数据库结构变更，会自动迁移

🛠️ 生产环境部署建议

使用 Caddy 反向代理（自动 HTTPS）

1. 安装 Caddy

bash

# Ubuntu/Debian
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy

2. Caddy 配置

编辑 /etc/caddy/Caddyfile：

your-domain.com {
    # 反向代理到本地服务
    reverse_proxy 127.0.0.1:3000 {
        # 支持流式响应（SSE）
        flush_interval -1

        # 传递真实IP
        header_up X-Real-IP {remote_host}
        header_up X-Forwarded-For {remote_host}
        header_up X-Forwarded-Proto {scheme}

        # 超时设置（适合长连接）
        transport http {
            read_timeout 300s
            write_timeout 300s
            dial_timeout 30s
        }
    }

    # 安全头部
    header {
        Strict-Transport-Security "max-age=31536000; includeSubDomains"
        X-Frame-Options "DENY"
        X-Content-Type-Options "nosniff"
        -Server
    }
}

3. 启动 Caddy

bash

# 测试配置
sudo caddy validate --config /etc/caddy/Caddyfile

# 启动服务
sudo systemctl start caddy
sudo systemctl enable caddy

Caddy 优势：

🔒 自动 HTTPS: 自动申请和续期 Let's Encrypt 证书
🛡️ 安全默认: 默认启用现代安全协议和加密套件
🚀 流式支持: 原生支持 SSE/WebSocket 等流式传输
📊 简单配置: 配置文件极其简洁，易于维护

🆘 常见问题

Redis连不上？

bash

# 检查Redis是否启动
redis-cli ping
# 应该返回 PONG

OAuth授权失败？

检查代理设置是否正确
确保能正常访问 claude.ai
清除浏览器缓存重试

API请求失败？

检查API Key是否正确
查看日志文件找错误信息
确认Claude账户状态正常

💡 安全建议

使用HTTPS: 强烈建议使用 Caddy 反向代理（自动HTTPS）
定期备份: 重要配置和数据要备份
监控日志: 定期查看异常日志
更新密钥: 定期更换 JWT 和加密密钥
防火墙设置: 只开放必要的端口（80, 443），隐藏直接服务端口

Claude Relay Service 部署指南 ​

🚀 系统要求 ​

最低配置 ​

推荐配置 ​

费用估算 ​

🚀 脚本部署（推荐） ​

快速安装 ​

脚本功能 ​

管理命令 ​

安装示例 ​

🐳 Docker 部署 ​

使用 Docker Hub 镜像 ​

第一步：下载构建docker-compose.yml文件的脚本并执行 ​

第二步：启动 ​

环境变量说明 ​

必填项 ​

可选项 ​

管理员凭据获取方式 ​

📦 手动部署 ​

第一步：环境准备 ​

第二步：下载和配置 ​

第三步：配置文件设置 ​

第四步：安装前端依赖并构建 ​

第五步：启动服务 ​

🎮 开始使用 ​

1. 打开管理界面 ​

2. 添加Claude账户 ​

3. 创建API Key ​

4. 配置 Claude Code ​

🔧 日常维护 ​

服务管理 ​

监控使用情况 ​

升级指南 ​

🛠️ 生产环境部署建议 ​

使用 Caddy 反向代理（自动 HTTPS） ​

🆘 常见问题 ​

Redis连不上？ ​

OAuth授权失败？ ​

API请求失败？ ​

💡 安全建议 ​

Claude Relay Service 部署指南

🚀 系统要求

最低配置

推荐配置

费用估算

🚀 脚本部署（推荐）

快速安装

脚本功能

管理命令

安装示例

🐳 Docker 部署

使用 Docker Hub 镜像

第一步：下载构建docker-compose.yml文件的脚本并执行

第二步：启动

环境变量说明

必填项

可选项

管理员凭据获取方式

📦 手动部署

第一步：环境准备

第二步：下载和配置

第三步：配置文件设置

第四步：安装前端依赖并构建

第五步：启动服务

🎮 开始使用

1. 打开管理界面

2. 添加Claude账户

3. 创建API Key

4. 配置 Claude Code

🔧 日常维护

服务管理

监控使用情况

升级指南

🛠️ 生产环境部署建议

使用 Caddy 反向代理（自动 HTTPS）

🆘 常见问题

Redis连不上？

OAuth授权失败？

API请求失败？

💡 安全建议