docs: 添加生产环境配置文档
This commit is contained in:
@@ -0,0 +1,202 @@
|
||||
# 生产环境配置文档
|
||||
|
||||
**版本**: 1.0.0
|
||||
**更新时间**: 2026-02-28
|
||||
**环境**: 生产环境
|
||||
|
||||
---
|
||||
|
||||
## 🌐 服务器信息
|
||||
|
||||
### SSH 连接
|
||||
```
|
||||
IP: 45.153.130.80
|
||||
用户: root
|
||||
密码: jRRAxCG28SMP
|
||||
```
|
||||
|
||||
### 项目路径
|
||||
```
|
||||
站点根目录: /opt/1panel/www/sites/uniservice-mobile.hnxinyouhe.com/index
|
||||
前端目录: /opt/1panel/www/sites/uniservice-mobile.hnxinyouhe.com/index
|
||||
项目代码目录: /opt/1panel/www/sites/uniservice-mobile.hnxinyouhe.com/index/server
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🗄️ 数据库配置
|
||||
|
||||
### MySQL
|
||||
```
|
||||
容器名: 1Panel-mysql-XyxS
|
||||
数据库: xserver
|
||||
用户名: xserver
|
||||
密码: NsNBSQm4b2b7SzhR
|
||||
端口: 3306
|
||||
```
|
||||
|
||||
### 常用命令
|
||||
```bash
|
||||
# 进入 MySQL 容器
|
||||
docker exec -it 1Panel-mysql-XyxS mysql -uxserver -pNsNBSQm4b2b7SzhR xserver
|
||||
|
||||
# 备份数据库
|
||||
docker exec 1Panel-mysql-XyxS mysqldump -uxserver -pNsNBSQm4b2b7SzhR xserver > backup.sql
|
||||
|
||||
# 查看表结构
|
||||
docker exec 1Panel-mysql-XyxS mysql -uxserver -pNsNBSQm4b2b7SzhR xserver -e "SHOW TABLES;"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔴 Redis 配置
|
||||
|
||||
```
|
||||
容器名: 1Panel-redis-pxdb
|
||||
密码: redis_FTzdM6
|
||||
端口: 6379
|
||||
```
|
||||
|
||||
### 常用命令
|
||||
```bash
|
||||
# 进入 Redis 容器
|
||||
docker exec -it 1Panel-redis-pxdb redis-cli -a redis_FTzdM6
|
||||
|
||||
# 查看所有 key
|
||||
docker exec 1Panel-redis-pxdb redis-cli -a redis_FTzdM6 KEYS '*'
|
||||
|
||||
# 清空缓存(慎用)
|
||||
docker exec 1Panel-redis-pxdb redis-cli -a redis_FTzdM6 FLUSHALL
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🐳 Docker 配置
|
||||
|
||||
### 网络
|
||||
```
|
||||
网络名: 1panel-network
|
||||
```
|
||||
|
||||
### 容器列表
|
||||
```bash
|
||||
# 查看所有容器
|
||||
docker ps
|
||||
|
||||
# 查看容器日志
|
||||
docker logs <container-name> -f --tail 100
|
||||
|
||||
# 重启容器
|
||||
docker restart <container-name>
|
||||
```
|
||||
|
||||
### 后端容器
|
||||
```bash
|
||||
# 重启后端
|
||||
docker restart x-server-backend
|
||||
|
||||
# 查看后端日志
|
||||
docker logs x-server-backend -f --tail 100
|
||||
|
||||
# 进入后端容器
|
||||
docker exec -it x-server-backend bash
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 调试命令
|
||||
|
||||
### 查看实时日志
|
||||
```bash
|
||||
# 后端日志
|
||||
docker logs x-server-backend -f --tail 50
|
||||
|
||||
# 查看消息日志
|
||||
docker exec 1Panel-mysql-XyxS mysql -uxserver -pNsNBSQm4b2b7SzhR xserver -e "
|
||||
SELECT id, action, order_id, user_id, message_id, status, created_at
|
||||
FROM feishu_message_log
|
||||
ORDER BY created_at DESC
|
||||
LIMIT 20;
|
||||
"
|
||||
```
|
||||
|
||||
### 测试接口
|
||||
```bash
|
||||
# 查看消息日志(带 debug 参数)
|
||||
curl "http://localhost:8787/debug/message-logs?debug=1&limit=50"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📋 调试计划
|
||||
|
||||
### 1. 审批逻辑调试
|
||||
- [ ] 创建测试数据
|
||||
- [ ] 测试提交申请
|
||||
- [ ] 测试单人审批
|
||||
- [ ] 测试会签(and_approve)
|
||||
- [ ] 测试或签(or_approve)
|
||||
- [ ] 测试重复操作防护
|
||||
- [ ] 验证状态流转
|
||||
|
||||
### 2. 消息逻辑调试
|
||||
- [ ] 测试消息发送
|
||||
- [ ] 验证 message_id 保存
|
||||
- [ ] 测试消息卡片更新(或签/单人)
|
||||
- [ ] 验证日志记录
|
||||
- [ ] 测试自审批场景
|
||||
- [ ] 测试抄送场景
|
||||
|
||||
### 3. 集成测试
|
||||
- [ ] 完整流程测试
|
||||
- [ ] 多用户并发测试
|
||||
- [ ] 异常场景测试
|
||||
|
||||
---
|
||||
|
||||
## 🚨 常见问题处理
|
||||
|
||||
### 后端无法启动
|
||||
```bash
|
||||
# 检查日志
|
||||
docker logs x-server-backend --tail 100
|
||||
|
||||
# 检查配置
|
||||
docker exec x-server-backend cat /app/.env
|
||||
|
||||
# 重启服务
|
||||
docker restart x-server-backend
|
||||
```
|
||||
|
||||
### 数据库连接失败
|
||||
```bash
|
||||
# 测试连接
|
||||
docker exec 1Panel-mysql-XyxS mysql -uxserver -pNsNBSQm4b2b7SzhR -e "SELECT 1;"
|
||||
|
||||
# 检查网络
|
||||
docker network inspect 1panel-network
|
||||
```
|
||||
|
||||
### 消息发送失败
|
||||
```bash
|
||||
# 查看日志表
|
||||
docker exec 1Panel-mysql-XyxS mysql -uxserver -pNsNBSQm4b2b7SzhR xserver -e "
|
||||
SELECT * FROM feishu_message_log
|
||||
WHERE status = 'failed'
|
||||
ORDER BY created_at DESC
|
||||
LIMIT 10;
|
||||
"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📝 维护记录
|
||||
|
||||
| 日期 | 操作 | 操作人 | 备注 |
|
||||
|------|------|--------|------|
|
||||
| 2026-02-28 | 初始化文档 | Claude | 创建配置文档 |
|
||||
|
||||
---
|
||||
|
||||
**维护人**: 开发团队
|
||||
**最后更新**: 2026-02-28
|
||||
Reference in New Issue
Block a user