root
e3fa7e86f3
新的文档结构：
docs/
├── README.md # 文档中心导航
├── modules/ # 模块文档
│ ├── auth/ # 认证模块
│ │ ├── README.md
│ │ ├── feishu-login.md
│ │ ├── feishu-qrcode.md
│ │ └── feishu-notification.md
│ ├── approval/ # 审批流程模块
│ │ └── README.md
│ ├── business-trip/ # 出差申请模块
│ │ └── README.md
│ └── user/ # 用户管理模块
│ └── README.md
└── guides/ # 指南文档
├── deployment.md
├── environment.md
├── git-workflow.md
└── ...
每个模块都有独立的 README.md 说明概述、API、关键文件等
288 lines
5.2 KiB
Markdown
288 lines
5.2 KiB
Markdown
# 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` - 问题汇总
|