mirror of https://github.com/Wei-Shaw/claude-relay-service.git synced 2026-01-22 16:43:35 +00:00

Files

shaw 5c83cf1d53 feat: 添加 Docker Hub 自动构建和改进部署体验

- 支持环境变量预设管理员账号密码
- 添加 docker-entrypoint.sh 自动初始化脚本
- 配置 GitHub Actions 自动构建多平台镜像（amd64, arm64）
- 添加版本标签管理和自动发布流程
- 集成 Trivy 安全漏洞扫描
- 更新文档说明 Docker Hub 使用方法
- 优化 Docker 部署用户体验

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-07-19 00:49:04 +08:00

15 KiB

Raw Blame History

Claude Relay Service

🔐 自行搭建Claude API中转服务，支持多账户管理

English • 中文文档 • 📸 界面预览

⚠️ 重要提醒

使用本项目前请仔细阅读：

🚨 服务条款风险: 使用本项目可能违反Anthropic的服务条款。请在使用前仔细阅读Anthropic的用户协议，使用本项目的一切风险由用户自行承担。

📖 免责声明: 本项目仅供技术学习和研究使用，作者不对因使用本项目导致的账户封禁、服务中断或其他损失承担任何责任。

💡 感谢 @vista8 的推荐！

如果你对Vibe coding感兴趣，推荐关注：

🐦 X: @vista8 - 分享前沿技术动态

📱 公众号: 向阳乔木推荐看

🤔 这个项目适合你吗？

🌍 地区限制: 所在地区无法直接访问Claude Code服务？
🔒 隐私担忧: 担心第三方镜像服务会记录或泄露你的对话内容？
👥 成本分摊: 想和朋友一起分摊Claude Code Max订阅费用？
⚡ 稳定性: 第三方镜像站经常故障不稳定，影响效率？

如果有以上困惑，那这个项目可能适合你。

适合的场景

✅ 找朋友拼车: 三五好友一起分摊Claude Code Max订阅，Opus爽用
✅ 隐私敏感: 不想让第三方镜像看到你的对话内容
✅ 技术折腾: 有基本的技术基础，愿意自己搭建和维护
✅ 稳定需求: 需要长期稳定的Claude访问，不想受制于镜像站
✅ 地区受限: 无法直接访问Claude官方服务

不适合的场景

❌ 纯小白: 完全不懂技术，连服务器都不会买
❌ 偶尔使用: 一个月用不了几次，没必要折腾
❌ 注册问题: 无法自行注册Claude账号
❌ 支付问题: 没有支付渠道订阅Claude Code

如果你只是普通用户，对隐私要求不高，随便玩玩、想快速体验 Claude，那选个你熟知的镜像站会更合适。

💭 为什么要自己搭？

现有镜像站可能的问题

🕵️ 隐私风险: 你的对话内容都被人家看得一清二楚，商业机密什么的就别想了
🐌 性能不稳: 用的人多了就慢，高峰期经常卡死
💰 价格不透明: 不知道实际成本

自建的好处

🔐 数据安全: 所有接口请求都只经过你自己的服务器，直连Anthropic API
⚡ 性能可控: 就你们几个人用，Max 200刀套餐基本上可以爽用Opus
💰 成本透明: 用了多少token一目了然，按官方价格换算了具体费用
📊 监控完整: 使用情况、成本分析、性能监控全都有

🚀 核心功能

📸 点击查看界面预览 - 查看Web管理界面的详细截图

基础功能

✅ 多账户管理: 可以添加多个Claude账户自动轮换
✅ 自定义API Key: 给每个人分配独立的Key
✅ 使用统计: 详细记录每个人用了多少token

高级功能

🔄 智能切换: 账户出问题自动换下一个
🚀 性能优化: 连接池、缓存，减少延迟
📊 监控面板: Web界面查看所有数据
🛡️ 安全控制: 访问限制、速率控制
🌐 代理支持: 支持HTTP/SOCKS5代理

📋 部署要求

硬件要求（最低配置）

CPU: 1核心就够了
内存: 512MB（建议1GB）
硬盘: 30GB可用空间
网络: 能访问到Anthropic API（建议使用US地区的机器）
建议: 2核4G的基本够了，网络尽量选回国线路快一点的（为了提高速度，建议不要开代理或者设置服务器的IP直连）

软件要求

Node.js 18或更高版本
Redis 6或更高版本
操作系统: 建议Linux

费用估算

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

📦 手动部署

第一步：环境准备

Ubuntu/Debian用户：

# 安装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用户：

# 安装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

第二步：下载和配置

# 下载项目
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 文件：

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

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

编辑 config/config.js 文件：

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

第四步：启动服务

# 初始化
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

🐳 Docker 部署（推荐）

使用 Docker Hub 镜像（最简单）

# 拉取镜像（支持 amd64 和 arm64）
docker pull yourusername/claude-relay-service:latest

# 使用 docker run 运行
docker run -d \
  --name claude-relay \
  -p 3000:3000 \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/logs:/app/logs \
  -e ADMIN_USERNAME=my_admin \
  -e ADMIN_PASSWORD=my_secure_password \
  yourusername/claude-relay-service:latest

# 或使用 docker-compose（推荐）
# 创建 docker-compose.yml 文件：
cat > docker-compose.yml << 'EOF'
version: '3.8'
services:
  claude-relay:
    image: yourusername/claude-relay-service:latest
    container_name: claude-relay-service
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - REDIS_HOST=redis
      - ADMIN_USERNAME=${ADMIN_USERNAME:-}
      - ADMIN_PASSWORD=${ADMIN_PASSWORD:-}
    volumes:
      - ./logs:/app/logs
      - ./data:/app/data
    depends_on:
      - redis

  redis:
    image: redis:7-alpine
    container_name: claude-relay-redis
    restart: unless-stopped
    volumes:
      - redis_data:/data

volumes:
  redis_data:
EOF

# 启动服务
docker-compose up -d

从源码构建

# 1. 克隆项目
git clone https://github.com/your-repo/claude-relay-service.git
cd claude-relay-service

# 2. 设置管理员账号密码（可选）
# 方式一：自动生成（查看容器日志获取）
docker-compose up -d

# 方式二：预设账号密码
export ADMIN_USERNAME=cr_admin_custom
export ADMIN_PASSWORD=your-secure-password
docker-compose up -d

# 3. 查看管理员凭据
# 自动生成的情况下：
docker logs claude-relay-service | grep "管理员"

# 或者直接查看挂载的文件：
cat ./data/init.json

Docker Compose 配置

docker-compose.yml 已包含：

✅ 自动初始化管理员账号
✅ 数据持久化（logs和data目录自动挂载）
✅ Redis数据库
✅ 健康检查
✅ 自动重启

管理员凭据获取方式

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

使用环境变量预设

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

🎮 开始使用

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」
设置使用限制（可选）
保存，记下生成的Key

4. 开始使用Claude code

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

设置环境变量：

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

使用claude：

claude

🔧 日常维护

服务管理

# 查看服务状态
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/ 目录下的各种日志文件

常见问题处理

Redis连不上？

# 检查Redis是否启动
redis-cli ping

# 应该返回 PONG

OAuth授权失败？

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

API请求失败？

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

🛠️ 进阶

生产环境部署建议（重要！）

强烈建议使用nginx反向代理 + SSL证书

建议使用nginx反向代理并配置SSL证书：（以下为Nginx示例，如不想折腾可以选择安装面板进行操作，比如宝塔、1panel等）

1. 安装nginx和获取SSL证书

# Ubuntu/Debian
sudo apt install nginx

# 安装 acme.sh
curl https://get.acme.sh | sh
source ~/.bashrc

# 获取免费SSL证书（以Let's Encrypt为例）
acme.sh --issue -d your-domain.com --nginx
# 或者使用 standalone 模式
# acme.sh --issue -d your-domain.com --standalone

2. nginx配置示例

创建 /etc/nginx/sites-available/claude-relay 配置文件：

server {
    listen 80;
    server_name your-domain.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name your-domain.com;
    
    # SSL配置
    ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;
    
    # 安全头
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
    add_header X-Frame-Options DENY;
    add_header X-Content-Type-Options nosniff;
    
    # 反向代理配置
    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        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;
        proxy_cache_bypass $http_upgrade;
        
        # 超时设置
        proxy_connect_timeout 60s;
        proxy_send_timeout 60s;
        proxy_read_timeout 60s;
    }
}

3. 启用配置

# 启用站点
sudo ln -s /etc/nginx/sites-available/claude-relay /etc/nginx/sites-enabled/

# 测试配置
sudo nginx -t

# 重启nginx
sudo systemctl restart nginx

4. 更新服务配置

修改你的服务配置，让它只监听本地：

// config/config.js
module.exports = {
  server: {
    port: 3000,
    host: '127.0.0.1'  // 只监听本地，通过nginx代理
  }
  // ... 其他配置
}

安全优势：

🔒 数据加密: 所有API请求都通过HTTPS加密传输
🛡️ 隐藏端口: 不直接暴露服务端口，降低攻击面
🚀 更好性能: nginx的静态文件服务和缓存能力
📊 访问日志: nginx提供详细的访问日志和监控

💡 使用建议

账户管理

定期检查: 每周看看账户状态，及时处理异常
合理分配: 可以给不同的人分配不同的apikey，可以根据不同的apikey来分析用量

安全建议

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

🆘 遇到问题怎么办？

自助排查

查看日志: logs/ 目录下的日志文件
检查配置: 确认配置文件设置正确
测试连通性: 用 curl 测试API是否正常
重启服务: 有时候重启一下就好了

寻求帮助

GitHub Issues: 提交详细的错误信息
查看文档: 仔细阅读错误信息和文档
社区讨论: 看看其他人是否遇到类似问题

📄 许可证

本项目采用 MIT许可证。

⭐ 觉得有用的话给个Star呗，这是对作者最大的鼓励！

🤝 有问题欢迎提Issue，有改进建议欢迎PR

15 KiB Raw Blame History Unescape Escape