# 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 (前端编译)

## 🚀 部署方案

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

#### 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
```

**问题2：Claude穿透不工作**
- 检查 `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*