完整更新:恢复所有自定义配置

 已同步官方 v0.9.0-alpha.8
 已恢复 Footer 自定义页脚
 已恢复 Claude 穿透功能
 已恢复 Docker 自定义配置 (端口3099)
 已恢复 Channel 计费逻辑增强
 已创建更新手册和部署脚本

关键配置:
- docker-compose-custom.yml: 使用3099端口,连接现有mysql/redis
- controller/channel-billing.go: 包含渠道状态报告功能
- temp/: 包含更新手册和自动化脚本

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
huangzhenpc
2025-08-25 14:24:11 +08:00
parent b25f1f8634
commit 8d4bdacca2
5 changed files with 679 additions and 0 deletions

197
temp/DEPLOY_GUIDE.md Normal file
View File

@@ -0,0 +1,197 @@
# New-API 服务器部署指南
## 📦 部署准备
### 1. 提交所有修改
```bash
# 添加恢复的配置文件
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 (前端编译)
## 🚀 部署方案
### 方案1Docker直接部署 (推荐)
#### 1.1 拉取最新代码到服务器
```bash
# 在服务器上
cd /path/to/your/new-api
git pull origin main
```
#### 1.2 使用你们的自定义配置启动
```bash
# 使用 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 本地编译
```bash
# 前端编译
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 服务器部署
```bash
# 上传到服务器
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证书有效
- [ ] 日志输出正常
## 🔧 常用维护命令
### 查看服务状态
```bash
docker-compose -f docker-compose-custom.yml ps
docker-compose -f docker-compose-custom.yml logs -f new-api
```
### 重启服务
```bash
docker-compose -f docker-compose-custom.yml restart
```
### 备份数据
```bash
# 数据库备份
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
```
### 查看资源使用
```bash
docker stats
```
## 🎯 版本更新流程
当需要后续更新时:
1. **本地更新**:按照 `temp/UPDATE_MANUAL.md` 执行
2. **测试验证**:本地启动测试所有功能
3. **服务器部署**
```bash
git pull origin main
docker-compose -f docker-compose-custom.yml up -d --build
```
4. **功能验证**:检查上述清单
## 📞 故障排除
### 常见问题
**问题1服务启动失败**
```bash
# 查看详细日志
docker-compose -f docker-compose-custom.yml logs --tail=100 new-api
# 检查端口占用
netstat -tulpn | grep :3000
```
**问题2Claude穿透不工作**
- 检查 `PassThroughRequestEnabled` 设置
- 查看 `relay/channel/claude/adaptor.go` 是否包含穿透代码
**问题3前端显示异常**
```bash
# 重新构建前端
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
---
## 📋 本次更新内容摘要
### ✅ 已完成
- [x] 同步官方 v0.9.0-alpha.8 (3378个提交)
- [x] 保留 Footer 自定义 ("听泉claude提供")
- [x] 保留 Claude 穿透功能
- [x] 恢复 Docker 自定义配置
- [x] 恢复 Channel 计费逻辑修改
- [x] 创建维护文档和部署脚本
### 🎯 关键文件
- `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*