new-api/temp/DEPLOY_GUIDE.md

New-API 服务器部署指南

📦 部署准备

1. 提交所有修改

# 添加恢复的配置文件
git add docker-compose-custom.yml docker-compose-tq.yml controller/channel-billing.go temp/

# 提交完整的更新
git commit -m "完整更新：恢复所有自定义配置

✅ 已同步官方 v0.9.0-alpha.8
✅ 已恢复 Footer 自定义页脚
✅ 已恢复 Claude 穿透功能  
✅ 已恢复 Docker 自定义配置
✅ 已恢复 Channel 计费逻辑
✅ 已创建更新手册

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

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

# 推送到远程仓库
git push origin main

2. 服务器环境要求

• Docker & Docker Compose
• Go 1.19+ (如果需要本地编译)
• Node.js 16+ & Bun/npm (前端编译)

🚀 部署方案

方案1：Docker直接部署 (推荐)

1.1 拉取最新代码到服务器

# 在服务器上
cd /path/to/your/new-api
git pull origin main

1.2 使用你们的自定义配置启动

# 使用 docker-compose-custom.yml
docker-compose -f docker-compose-custom.yml down
docker-compose -f docker-compose-custom.yml up -d --build

# 或使用 docker-compose-tq.yml  
docker-compose -f docker-compose-tq.yml down
docker-compose -f docker-compose-tq.yml up -d --build

方案2：本地编译后部署

2.1 本地编译

# 前端编译
cd web
npm install  # 或 bun install
npm run build  # 或 bun run build

# 后端编译
cd ..
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags "-s -w" -o new-api

# 打包
tar -czf new-api-release.tar.gz new-api web/build/ docker-compose-custom.yml

2.2 服务器部署

# 上传到服务器
scp new-api-release.tar.gz user@server:/path/to/deploy/

# 服务器上解压
tar -xzf new-api-release.tar.gz

# 启动服务
docker-compose -f docker-compose-custom.yml up -d

📋 部署检查清单

✅ 功能验证

• 服务正常启动
• Web界面可访问
• Footer显示"听泉claude提供"
• Claude模型可正常调用
• 穿透功能工作正常
• 计费逻辑正确
• 新增功能测试

✅ 配置检查

• 数据库连接正常
• Redis连接正常
• 环境变量配置
• SSL证书有效
• 日志输出正常

🔧 常用维护命令

查看服务状态

docker-compose -f docker-compose-custom.yml ps
docker-compose -f docker-compose-custom.yml logs -f new-api

重启服务

docker-compose -f docker-compose-custom.yml restart

备份数据

# 数据库备份
docker exec -t new-api-mysql mysqldump -u root -p新密码 new-api > backup_$(date +%Y%m%d).sql

# 配置文件备份  
tar -czf config-backup-$(date +%Y%m%d).tar.gz docker-compose-custom.yml .env

查看资源使用

docker stats

🎯 版本更新流程

当需要后续更新时：

1. 本地更新：按照 temp/UPDATE_MANUAL.md 执行
2. 测试验证：本地启动测试所有功能
3. 服务器部署：

   git pull origin main
   docker-compose -f docker-compose-custom.yml up -d --build
   

4. 功能验证：检查上述清单

📞 故障排除

常见问题

问题1：服务启动失败

# 查看详细日志
docker-compose -f docker-compose-custom.yml logs --tail=100 new-api

# 检查端口占用
netstat -tulpn | grep :3000

问题2：Claude穿透不工作

• 检查 PassThroughRequestEnabled 设置
• 查看 relay/channel/claude/adaptor.go 是否包含穿透代码

问题3：前端显示异常

# 重新构建前端
docker-compose -f docker-compose-custom.yml exec new-api sh
cd web && npm run build
exit
docker-compose -f docker-compose-custom.yml restart

🔒 安全建议

1. 定期备份：数据库+配置文件
2. 监控日志：异常访问和错误
3. 更新依赖：定期更新Docker镜像
4. 访问控制：限制管理后台访问IP

---

📋 本次更新内容摘要

✅ 已完成

• 同步官方 v0.9.0-alpha.8 (3378个提交)
• 保留 Footer 自定义 ("听泉claude提供")
• 保留 Claude 穿透功能
• 恢复 Docker 自定义配置
• 恢复 Channel 计费逻辑修改
• 创建维护文档和部署脚本

🎯 关键文件

• web/src/components/layout/Footer.js - 自定义页脚
• relay/channel/claude/adaptor.go - Claude穿透
• controller/channel-billing.go - 计费逻辑
• docker-compose-custom.yml - 部署配置
• temp/UPDATE_MANUAL.md - 更新手册

现在可以安全地部署到生产服务器了！

---

部署手册 - 最后更新：2025-08-25