feat: add SMS verification registration with UniSMS provider
- Add phone field to user model with index and helper methods - Implement SMS provider interface with UniSMS (合一短信) implementation - Add SMS verification code sending endpoint with rate limiting (1/60s) - Support SMS registration in Register() (mutually exclusive with email) - Add SMS configuration to admin settings (provider, keys, signature, template) - Display phone number in admin user list contact column - Add i18n translations for all SMS-related messages (zh-CN, en, zh-TW) - Add Claude Code skills: sync-upstream, migrate-server - Update CLAUDE.md with git conventions and deployment guide Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
175
.claude/commands/migrate-server.md
Normal file
175
.claude/commands/migrate-server.md
Normal file
@@ -0,0 +1,175 @@
|
||||
# Migrate Server - 服务器迁移指南
|
||||
|
||||
帮助将 new-api 服务从老服务器迁移到新服务器,包括代码部署、数据库迁移和配置同步。
|
||||
|
||||
## 执行步骤
|
||||
|
||||
### 1. 收集信息
|
||||
先向用户确认以下信息:
|
||||
- 老服务器 IP / 访问方式
|
||||
- 新服务器 IP / 访问方式
|
||||
- 当前使用的数据库类型(SQLite / MySQL / PostgreSQL)
|
||||
- 当前部署方式(Docker Compose / 直接部署)
|
||||
- 是否使用 Redis
|
||||
- 是否有自定义域名需要迁移
|
||||
|
||||
### 2. 老服务器 - 备份数据
|
||||
|
||||
#### 2.1 数据库备份
|
||||
|
||||
**如果使用 SQLite:**
|
||||
```bash
|
||||
# 找到 SQLite 数据库文件(通常在项目根目录或 data/ 目录下)
|
||||
# 停止服务防止写入
|
||||
docker compose stop # 或 systemctl stop new-api
|
||||
|
||||
# 复制数据库文件
|
||||
cp /path/to/new-api.db /backup/new-api.db
|
||||
|
||||
# 或者使用 sqlite3 导出
|
||||
sqlite3 /path/to/new-api.db .dump > /backup/new-api-dump.sql
|
||||
```
|
||||
|
||||
**如果使用 MySQL:**
|
||||
```bash
|
||||
# 导出完整数据库
|
||||
mysqldump -u root -p --single-transaction --routines --triggers new_api > /backup/new-api-mysql.sql
|
||||
|
||||
# 或者如果 MySQL 在 Docker 中
|
||||
docker exec <mysql_container> mysqldump -u root -p<password> new_api > /backup/new-api-mysql.sql
|
||||
```
|
||||
|
||||
**如果使用 PostgreSQL:**
|
||||
```bash
|
||||
# 导出完整数据库
|
||||
pg_dump -U postgres -d new_api -F c -f /backup/new-api-pg.dump
|
||||
|
||||
# 或者如果在 Docker 中
|
||||
docker exec <pg_container> pg_dump -U postgres -d new_api -F c > /backup/new-api-pg.dump
|
||||
```
|
||||
|
||||
#### 2.2 配置备份
|
||||
```bash
|
||||
# 备份环境变量文件
|
||||
cp .env /backup/.env
|
||||
|
||||
# 备份 Docker Compose 配置
|
||||
cp docker-compose.yml /backup/docker-compose.yml
|
||||
|
||||
# 备份其他配置文件(如果有)
|
||||
cp -r config/ /backup/config/ 2>/dev/null
|
||||
```
|
||||
|
||||
#### 2.3 Redis 数据备份(如果使用)
|
||||
```bash
|
||||
# Redis 数据通常不需要迁移(缓存会自动重建)
|
||||
# 但如果需要:
|
||||
redis-cli BGSAVE
|
||||
cp /var/lib/redis/dump.rdb /backup/redis-dump.rdb
|
||||
```
|
||||
|
||||
### 3. 传输备份到新服务器
|
||||
```bash
|
||||
# 使用 scp 传输
|
||||
scp -r /backup/ user@new-server:/path/to/backup/
|
||||
|
||||
# 或使用 rsync
|
||||
rsync -avz /backup/ user@new-server:/path/to/backup/
|
||||
```
|
||||
|
||||
### 4. 新服务器 - 部署准备
|
||||
|
||||
#### 4.1 安装基础环境
|
||||
```bash
|
||||
# Docker + Docker Compose(推荐)
|
||||
curl -fsSL https://get.docker.com | sh
|
||||
apt install docker-compose-plugin # 或 docker compose v2
|
||||
|
||||
# 或者直接部署需要 Go 1.22+ 和 Node.js/Bun
|
||||
```
|
||||
|
||||
#### 4.2 拉取代码
|
||||
```bash
|
||||
git clone https://git.586vip.cn/huangzhenpc/newapi-yx-diy.git
|
||||
cd newapi-yx-diy
|
||||
git checkout dev-v0.11.0-alpha.9 # 或目标分支
|
||||
```
|
||||
|
||||
#### 4.3 恢复配置
|
||||
```bash
|
||||
# 恢复环境变量
|
||||
cp /path/to/backup/.env .env
|
||||
|
||||
# 恢复 Docker Compose 配置(如有定制)
|
||||
cp /path/to/backup/docker-compose.yml docker-compose.yml
|
||||
```
|
||||
|
||||
### 5. 新服务器 - 恢复数据库
|
||||
|
||||
**如果使用 SQLite:**
|
||||
```bash
|
||||
# 直接复制数据库文件到项目目录
|
||||
cp /path/to/backup/new-api.db ./data/new-api.db
|
||||
# GORM AutoMigrate 会在启动时自动添加新字段(如 Phone)
|
||||
```
|
||||
|
||||
**如果使用 MySQL:**
|
||||
```bash
|
||||
# 先启动 MySQL 容器
|
||||
docker compose up -d mysql
|
||||
|
||||
# 等待 MySQL 完全启动
|
||||
sleep 10
|
||||
|
||||
# 导入数据
|
||||
docker exec -i <mysql_container> mysql -u root -p<password> new_api < /path/to/backup/new-api-mysql.sql
|
||||
```
|
||||
|
||||
**如果使用 PostgreSQL:**
|
||||
```bash
|
||||
# 先启动 PostgreSQL 容器
|
||||
docker compose up -d postgres
|
||||
|
||||
# 等待 PostgreSQL 完全启动
|
||||
sleep 5
|
||||
|
||||
# 创建数据库(如果不存在)
|
||||
docker exec <pg_container> createdb -U postgres new_api
|
||||
|
||||
# 导入数据
|
||||
docker exec -i <pg_container> pg_restore -U postgres -d new_api < /path/to/backup/new-api-pg.dump
|
||||
```
|
||||
|
||||
### 6. 新服务器 - 启动服务
|
||||
```bash
|
||||
# Docker Compose 部署
|
||||
docker compose up -d
|
||||
|
||||
# 检查服务状态
|
||||
docker compose ps
|
||||
docker compose logs -f --tail=50
|
||||
```
|
||||
|
||||
### 7. 验证
|
||||
|
||||
向用户确认以下检查项:
|
||||
- [ ] 服务是否正常启动(访问 `/api/status`)
|
||||
- [ ] 管理员账号能否正常登录
|
||||
- [ ] 用户数据是否完整
|
||||
- [ ] 渠道配置是否正常
|
||||
- [ ] API 密钥是否可用
|
||||
- [ ] 如果有自定义域名,DNS 是否已切换
|
||||
|
||||
### 8. 切换流量
|
||||
- 更新 DNS 记录指向新服务器
|
||||
- 或更新反向代理(Nginx/Caddy)配置
|
||||
- 老服务器保留一段时间作为回退方案
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. **GORM AutoMigrate**:新版本可能有新的数据库字段(如 `phone`),启动时 GORM 会自动添加,不需要手动执行迁移脚本
|
||||
2. **环境变量**:确保 `.env` 中的数据库连接字符串指向正确的地址
|
||||
3. **数据一致性**:迁移前停止老服务器的写入,避免数据不一致
|
||||
4. **Redis**:Redis 缓存数据不需要迁移,服务启动后会自动重建
|
||||
5. **密钥安全**:传输过程中注意保护敏感信息(数据库密码、API 密钥等)
|
||||
6. **回退方案**:保留老服务器至少 1 周,确认新服务器稳定后再关闭
|
||||
Reference in New Issue
Block a user