# X-Server Mobile 快速部署指南

## 一、服务器准备

### 1.1 安装必要软件

```bash
# 更新系统
apt-get update && apt-get upgrade -y

# 安装 certbot（SSL 证书）
apt-get install certbot -y

# 安装 rsync（文件同步）
apt-get install rsync -y
```

### 1.2 创建部署目录

```bash
mkdir -p /opt/x-server-mobile/{frontend,backend,logs,backup}
mkdir -p /opt/x-server-mobile/logs/{backend,nginx}
```

### 1.3 获取 SSL 证书

```bash
# 停止 OpenResty（如果占用 80 端口）
systemctl stop openresty

# 获取证书
certbot certonly --standalone -d xsm.hnxinyouhe.com

# 重新启动 OpenResty
systemctl start openresty
```

### 1.4 准备数据库

```bash
# 创建数据库用户
docker exec -it <mysql-container> mysql -uroot -p

# 在 MySQL 中执行：
CREATE USER 'xserver'@'%' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON xserver.* TO 'xserver'@'%';
FLUSH PRIVILEGES;

# 导入数据库（如果有备份）
docker exec -i <mysql-container> mysql -uxserver -pyour_password xserver < backup.sql
```

---

## 二、配置文件准备

### 2.1 环境变量

```bash
# 在项目根目录
cp deploy/.env.production.template .env.production

# 编辑填写实际配置
vi .env.production
```

### 2.2 更新 docker-compose.prod.yml

```yaml
# 修改以下配置为实际值：
- DB_HOST=1Panel-mysql-xxxx        # 实际 MySQL 容器名
- DB_PASSWORD=your_password         # 实际密码
- REDIS_HOST=1Panel-redis-xxxx      # 实际 Redis 容器名
- REDIS_PASSWORD=your_redis_password # 实际 Redis 密码
```

---

## 三、部署

### 3.1 方式一：使用部署脚本（推荐）

```bash
# 1. 构建前端
cd frontend
npm install
npm run build
cd ..

# 2. 执行部署脚本
./scripts/deploy.sh your-server-ip

# 脚本会自动完成：
# - 备份当前版本
# - 上传前端和后端
# - 重启容器
# - 重载 OpenResty
```

### 3.2 方式二：手动部署

```bash
# 1. 构建前端
cd frontend && npm run build && cd ..

# 2. 上传前端
rsync -avz --delete frontend/dist/ root@server:/opt/x-server-mobile/frontend/

# 3. 上传后端
rsync -avz --exclude='vendor' --exclude='runtime' backend/ root@server:/opt/x-server-mobile/backend/

# 4. 上传配置文件
scp deploy/docker-compose.prod.yml root@server:/opt/x-server-mobile/
scp deploy/nginx/x-server-mobile-prod.conf root@server:/tmp/

# 5. 登录服务器配置 OpenResty
ssh root@server
cp /tmp/x-server-mobile-prod.conf /usr/local/openresty/nginx/conf/conf.d/x-server-mobile.conf
openresty -t && openresty -s reload

# 6. 启动后端容器
cd /opt/x-server-mobile
docker-compose -f docker-compose.prod.yml up -d
```

---

## 四、验证部署

### 4.1 检查容器状态

```bash
docker ps | grep x-server
docker logs -f x-server-backend-prod
```

### 4.2 检查服务

```bash
# 检查前端
curl -I https://xsm.hnxinyouhe.com

# 检查 API
curl https://xsm.hnxinyouhe.com/api/v1/user/info \
  -H "Authorization: Bearer YOUR_TOKEN"
```

### 4.3 功能测试

- [ ] 登录页面正常访问
- [ ] 邮箱密码登录成功
- [ ] 飞书免登成功
- [ ] 审批列表正常显示
- [ ] 飞书卡片通知正常

---

## 五、常见问题

### Q1: 容器无法启动

```bash
# 查看详细日志
docker logs x-server-backend-prod

# 检查网络
docker network ls | grep 1panel
docker network inspect 1panel-network

# 检查环境变量
docker exec x-server-backend-prod env | grep DB_
```

### Q2: API 返回 500

```bash
# 查看后端日志
docker logs x-server-backend-prod --tail 50

# 检查数据库连接
docker exec x-server-backend-prod php -r "
var_dump(getenv('DB_HOST'));
var_dump(getenv('DB_DATABASE'));
"

# 进入容器调试
docker exec -it x-server-backend-prod bash
```

### Q3: SSL 证书问题

```bash
# 检查证书路径
ls -la /etc/letsencrypt/live/xsm.hnxinyouhe.com/

# 测试证书
openssl s_client -connect xsm.hnxinyouhe.com:443 -servername xsm.hnxinyouhe.com

# 手动续期
certbot renew --force-renewal
```

### Q4: 前端刷新 404

检查 OpenResty 配置中的 `try_files` 指令：
```nginx
location / {
    root /opt/x-server-mobile/frontend;
    try_files $uri $uri/ /index.html;  # 确保有这行
}
```

---

## 六、回滚

```bash
# 查看可用备份
ssh root@server "ls -la /opt/x-server-mobile/backup/"

# 执行回滚
./scripts/rollback.sh 20240227_150000
```

---

## 七、监控命令

```bash
# 实时日志
docker logs -f x-server-backend-prod

# 容器资源
docker stats x-server-backend-prod

# Nginx 访问日志
tail -f /opt/x-server-mobile/logs/nginx_access.log

# Nginx 错误日志
tail -f /opt/x-server-mobile/logs/nginx_error.log
```

---

## 八、更新部署

当代码有更新时：

```bash
# 1. 拉取最新代码
git pull

# 2. 构建前端
cd frontend && npm run build && cd ..

# 3. 部署
./scripts/deploy.sh your-server-ip
```

---

## 配置检查清单

部署前确认：

```bash
# 1. 检查环境变量
cat .env.production | grep -v "^#" | grep -v "^$"

# 2. 检查构建产物
ls -la frontend/dist/

# 3. 检查 OpenResty 配置
cat deploy/nginx/x-server-mobile-prod.conf | grep server_name

# 4. 测试 SSH 连接
ssh root@your-server "echo 'SSH OK'"
```

---

## 联系支持

如有问题，请参考完整文档：
- `DEPLOYMENT.md` - 完整部署文档
- `DEPLOYMENT_CHECKLIST.md` - 部署检查清单
- `PROJECT_ISSUES.md` - 问题汇总