x-server-mobile/docs/PRODUCTION_CONFIG.md

生产环境配置文档

版本: 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

常用命令

# 进入 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

常用命令

# 进入 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

容器列表

# 查看所有容器
docker ps

# 查看容器日志
docker logs <container-name> -f --tail 100

# 重启容器
docker restart <container-name>

后端容器

# 重启后端
docker restart x-server-backend

# 查看后端日志
docker logs x-server-backend -f --tail 100

# 进入后端容器
docker exec -it x-server-backend 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;
"

测试接口

# 查看消息日志（带 debug 参数）
curl "http://localhost:8787/debug/message-logs?debug=1&limit=50"

---

📋 调试计划

1. 审批逻辑调试

• 创建测试数据
• 测试提交申请
• 测试单人审批
• 测试会签（and_approve）
• 测试或签（or_approve）
• 测试重复操作防护
• 验证状态流转

2. 消息逻辑调试

• 测试消息发送
• 验证 message_id 保存
• 测试消息卡片更新（或签/单人）
• 验证日志记录
• 测试自审批场景
• 测试抄送场景

3. 集成测试

• 完整流程测试
• 多用户并发测试
• 异常场景测试

---

🚨 常见问题处理

后端无法启动

# 检查日志
docker logs x-server-backend --tail 100

# 检查配置
docker exec x-server-backend cat /app/.env

# 重启服务
docker restart x-server-backend

数据库连接失败

# 测试连接
docker exec 1Panel-mysql-XyxS mysql -uxserver -pNsNBSQm4b2b7SzhR -e "SELECT 1;"

# 检查网络
docker network inspect 1panel-network

消息发送失败

# 查看日志表
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