CRS 官方提供了一键部署脚本，自动处理所有依赖安装和配置， 是上手最快、最推荐的安装方式。整个流程约 5-10 分钟。
脚本部署 vs Docker 部署
| 对比项 | 一键脚本（推荐） | Docker Compose |
|---|---|---|
| 安装难度 | ⭐ 极简，一条命令 | ⭐⭐ 需了解 Docker |
| 依赖管理 | 自动安装 Node.js + Redis | 需要先装 Docker |
| 管理命令 | crs start/stop/update | docker compose up/down |
| 隔离性 | 直接跑在系统上 | 容器隔离 |
| 适合场景 | 个人 VPS，快速上手 | 已有 Docker 环境 |
| 更新便捷 | crs update 一键 | docker compose pull && up |
结论：没有特殊需求，选脚本部署最省事。
准备工作
服务器要求
操作系统：Ubuntu 20.04+ / Debian 11+ / CentOS 8+ / Arch Linux / macOS
CPU：1 核心以上
内存：512MB 最低（建议 1GB）
硬盘：30GB 可用空间
网络：必须能访问 api.anthropic.com（不能用阿里云/腾讯云海外机器）
网络测试（部署前先检查）
bash
# 测试是否能访问 Claude API
curl -I https://api.anthropic.com
# 返回 200/403 都说明网络通，返回连接超时说明被拦截
# 如果被拦截，换其他服务商的机器（Vultr/DigitalOcean/搬瓦工等）第一步：一键安装
bash
curl -fsSL https://pincc.ai/manage.sh -o manage.sh && chmod +x manage.sh && ./manage.sh install这条命令会：
- 下载 manage.sh 脚本
- 添加执行权限
- 运行安装流程
安装过程（交互式配置向导）
安装脚本会依次询问以下配置：
=== CRS 安装向导 ===
安装目录 (默认: ~/claude-relay-service):
▶ [直接回车使用默认，或输入自定义路径]
服务端口 (默认: 3000):
▶ 3000 [如果 3000 被占用改成 8080 等]
Redis 地址 (默认: localhost):
▶ [直接回车]
Redis 端口 (默认: 6379):
▶ [直接回车]
Redis 密码 (默认: 无密码):
▶ [直接回车，或输入自定义密码]
脚本自动完成的工作：
- 检测操作系统版本
- 安装 Node.js 18+（如果未安装）
- 安装并启动 Redis
- 克隆 CRS 代码仓库
- 安装 npm 依赖
- 构建前端界面
- 生成随机管理员账号密码
- 注册
crs全局命令 - 自动启动服务
安装完成输出示例
✅ 服务已成功安装并启动！
访问地址：
本地 Web: http://localhost:3000/web
公网 Web: http://123.45.67.89:3000/web
管理员账号信息已保存到: ~/claude-relay-service/data/init.json
查看账号：cat ~/claude-relay-service/data/init.json
快捷命令已注册：
crs start 启动服务
crs stop 停止服务
crs restart 重启服务
crs status 查看状态
crs update 更新到最新版本
crs uninstall 卸载服务
第二步：查看管理员账号
bash
cat ~/claude-relay-service/data/init.json输出示例：
json
{
"adminUsername": "cr_admin_a1b2c3",
"adminPassword": "xK9mP2nQ...",
"createdAt": "2026-03-16T12:00:00Z"
}记下这个账号密码，用于登录管理面板。
第三步：访问管理面板
浏览器打开：http://你的服务器IP:3000/web
如果无法访问，检查防火墙是否放行端口：
bash# Ubuntu/Debian sudo ufw allow 3000 sudo ufw reload # CentOS/RHEL sudo firewall-cmd --permanent --add-port=3000/tcp sudo firewall-cmd --reload
第四步：添加 Claude OAuth 账户
登录管理面板后，点击「Claude 账户」标签：
- 点击「添加账户」
- （可选）配置静态代理 IP（多账号时建议每个账号用不同 IP）
- 点击「生成授权链接」
- 在弹出的新标签页中用你的 Claude 账号登录并授权
- 授权完成后复制页面上的 Authorization Code
- 回到管理面板，粘贴 Code，点击确认完成添加
💡 国内用户：这一步需要能访问 claude.ai 的网络环境（需要梯子）。 建议在本地电脑开代理完成授权，服务器本身不需要代理。
建议添加 2-3 个账户，开启智能轮换，稳定性更好。
第五步：创建 API Key
点击「API Keys」标签 → 「创建新 Key」：
| 字段 | 说明 |
|---|---|
| 名称 | 标识这个 Key 的用途，如「张三的 Key」 |
| 速率限制 | 每分钟最多多少请求（建议 20-50） |
| 并发限制 | 同时最多几个请求（建议 3-5） |
| 模型限制 | 可选，限制只能用特定模型 |
| 客户端限制 | 可选，只允许 ClaudeCode / Gemini-CLI 等 |
创建后复制 Key，发给对应的使用者。
第六步：配置 Claude Code 客户端
使用者在自己的电脑上执行：
bash
# macOS / Linux
echo 'export ANTHROPIC_BASE_URL="http://服务器IP:3000/api/"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API-Key"' >> ~/.zshrc
source ~/.zshrc
# Windows PowerShell（永久生效）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "http://服务器IP:3000/api/", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API-Key", "User")
# 验证
claude -p "你好，这是测试"crs 命令行工具完整用法
安装完成后，crs 命令可在任意目录使用：
bash
crs install # 全新安装 CRS
crs start # 启动服务（后台运行）
crs stop # 停止服务
crs restart # 重启服务（配置变更后用）
crs status # 查看服务状态和端口
crs update # 更新到最新版本（自动停止→更新→重启）
crs uninstall # 完全卸载（会询问是否保留数据）crs status 输出示例
=== CRS 服务状态 ===
状态：✅ 运行中
PID：12345
端口：3000
内存使用：128MB
运行时长：3天 14小时 22分钟
版本：v1.1.260
Redis 状态：✅ 正常
已添加账户：3 个（2 个可用，1 个冷却中）
今日请求数：1,247 次
crs update 更新流程
bash
crs update
# 自动执行：
# 1. 停止当前服务
# 2. git pull 拉取最新代码
# 3. npm install 更新依赖
# 4. npm run build:web 重新构建前端
# 5. 重启服务
# 完成后显示新版本号⚠️ 重要：请保持 CRS 为最新版本，v1.1.248 及以下存在严重安全漏洞。 建议每周执行一次
crs update。
常见安装问题
问题：crs: command not found
bash
# 重新加载 PATH
source ~/.bashrc
# 或
source ~/.zshrc
# 手动检查安装位置
which crs
ls ~/claude-relay-service/manage.sh问题：Redis 启动失败
bash
# 检查 Redis 状态
sudo systemctl status redis-server # Ubuntu/Debian
sudo systemctl status redis # CentOS
# 手动启动
sudo systemctl start redis-server
sudo systemctl enable redis-server # 设为开机启动
# 重新安装 Redis（Ubuntu）
sudo apt remove redis-server
sudo apt install redis-server问题：端口被占用
bash
# 查看占用 3000 端口的进程
lsof -i :3000
# 或
ss -tlnp | grep 3000
# 改用其他端口（重新运行安装向导）
crs uninstall # 先卸载
./manage.sh install # 重新安装，端口填 8080问题：Node.js 版本不够
bash
node --version # 需要 >= 18
# 用 nvm 升级（最稳妥）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20
nvm alias default 20
# 再次运行安装
./manage.sh install后续维护建议
bash
# 1. 每周更新一次
crs update
# 2. 定期检查状态
crs status
# 3. 备份重要数据
tar -czf crs-backup-$(date +%Y%m%d).tar.gz ~/claude-relay-service/data/
# 4. 查看服务日志
tail -f ~/claude-relay-service/logs/app.log来源：CRS GitHub 项目 - https://github.com/Wei-Shaw/claude-relay-service