monisuo/DEPLOY_INSTRUCTIONS.md

🚀 生产环境部署指南

项目: Monisuo 虚拟货币模拟交易系统 版本: v1.0 日期: 2026-03-23

---

📋 部署前检查清单

• ✅ 前端构建完成（Flutter Web + Vue3）
• ✅ 后端代码已提交
• ✅ 数据库补丁已执行
• ✅ Git 已推送到远程仓库

---

🔧 部署步骤

Step 1: SSH 登录服务器

ssh root@8.155.172.147

Step 2: 进入项目目录

cd /path/to/monisuo
# 或者
cd /root/monisuo

Step 3: 拉取最新代码

# 查看当前状态
git status

# 拉取最新代码
git pull origin main

# 查看最新提交
git log --oneline -5

预期输出:

9269f70 build: 构建前端生产版本
ca34261 docs: 添加最终测试总结报告
5c8df49 fix: 完善资金充值/提现逻辑
c294f66 fix: 添加冷钱包表支持，修复充值功能

---

Step 4: 重启后端服务

方式A: 使用 systemd

# 重启服务
systemctl restart monisuo

# 查看状态
systemctl status monisuo

# 查看日志
journalctl -u monisuo -f

方式B: 使用脚本

# 停止旧服务
pkill -f monisuo-1.0.jar

# 启动新服务
nohup java -jar target/monisuo-1.0.jar --server.port=5010 > /var/log/monisuo/app.log 2>&1 &

# 查看日志
tail -f /var/log/monisuo/app.log

方式C: 使用 Docker

# 重新构建镜像
docker build -t monisuo:latest .

# 重启容器
docker-compose restart monisuo-backend

# 查看日志
docker-compose logs -f monisuo-backend

---

Step 5: 部署前端

Flutter Web

# 复制构建产物到 Web 服务器目录
cp -r flutter_monisuo/build/web/* /var/www/monisuo-web/

# 设置权限
chown -R www-data:www-data /var/www/monisuo-web/
chmod -R 755 /var/www/monisuo-web/

Vue3 管理后台

# 复制构建产物到 Web 服务器目录
cp -r monisuo-admin/dist/* /var/www/monisuo-admin/

# 设置权限
chown -R www-data:www-data /var/www/monisuo-admin/
chmod -R 755 /var/www/monisuo-admin/

---

Step 6: 配置 Nginx

前端配置

# /etc/nginx/sites-available/monisuo-web
server {
    listen 80;
    server_name your-domain.com;

    root /var/www/monisuo-web;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }

    # API 代理
    location /api/ {
        proxy_pass http://localhost:5010;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

管理后台配置

# /etc/nginx/sites-available/monisuo-admin
server {
    listen 80;
    server_name admin.your-domain.com;

    root /var/www/monisuo-admin;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }

    # API 代理
    location /admin/ {
        proxy_pass http://localhost:5010;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

重启 Nginx

# 测试配置
nginx -t

# 重启服务
systemctl restart nginx

# 查看状态
systemctl status nginx

---

Step 7: 验证部署

1. 检查后端服务

# 健康检查
curl http://localhost:5010/health

# 测试钱包接口
curl http://localhost:5010/api/wallet/default

# 预期返回
{
  "code": "0000",
  "msg": "成功",
  "data": {
    "id": 1,
    "name": "USDT-TRC20 主钱包",
    "address": "TRX1234567890abcdefghijklmnopqrstuvwxyz1234",
    "network": "TRC20"
  },
  "success": true
}

2. 检查前端访问

# 用户端
curl http://localhost/

# 管理后台
curl http://localhost/admin/

3. 运行完整测试

# 进入项目目录
cd /root/monisuo

# 运行测试脚本
./test_fund_flow.sh

---

🧪 功能测试

充值流程测试

1. 用户端操作

   • 访问用户端前端
   • 登录账户
   • 进入"资产"页面
   • 点击"充值"按钮
   • 输入充值金额（如 100 USDT）
   • 确认充值
   • 查看钱包地址
   • 点击"已打款"

2. 管理后台操作

   • 登录管理后台
   • 进入"订单管理"页面
   • 查看待审批订单
   • 点击"审批通过"或"审批驳回"
   • 填写备注（如驳回需填写原因）

3. 验证结果

   • 用户端查看订单状态
   • 查看资金账户余额变化

提现流程测试

1. 用户端操作

   • 进入"资产"页面
   • 点击"提现"按钮
   • 输入提现金额（如 50 USDT）
   • 输入提现地址
   • 输入联系方式
   • 确认提现

2. 管理后台操作

   • 查看待审批提现订单
   • 点击"确认打款"或"驳回"
   • 填写备注

3. 验证结果

   • 用户端查看订单状态
   • 查看资金账户余额变化

---

🐛 常见问题排查

问题1: 后端服务无法启动

# 检查端口占用
netstat -tunlp | grep 5010

# 检查日志
tail -f /var/log/monisuo/app.log

# 检查 Java 版本
java -version

问题2: 前端页面无法访问

# 检查 Nginx 状态
systemctl status nginx

# 检查文件权限
ls -la /var/www/monisuo-web/

# 检查 Nginx 配置
nginx -t

问题3: 数据库连接失败

# 检查数据库连接
mysql -u monisuo -p -h 8.155.172.147 monisuo

# 检查数据库表
SHOW TABLES;
SELECT * FROM cold_wallet;

问题4: 充值/提现功能异常

# 检查数据库数据
SELECT * FROM cold_wallet WHERE is_default=1 AND status=1;

# 检查订单数据
SELECT * FROM order_fund ORDER BY create_time DESC LIMIT 5;

# 检查用户资金账户
SELECT * FROM account_fund WHERE user_id=1;

---

📊 监控和日志

后端日志

# 实时日志
tail -f /var/log/monisuo/app.log

# 历史日志
cat /var/log/monisuo/app.log | grep ERROR

Nginx 日志

# 访问日志
tail -f /var/log/nginx/access.log

# 错误日志
tail -f /var/log/nginx/error.log

系统监控

# CPU 和内存
top

# 磁盘空间
df -h

# 网络连接
netstat -tunlp

---

✅ 部署完成检查

• 后端服务运行正常
• 前端页面访问正常
• 充值流程测试通过
• 提现流程测试通过
• 管理后台功能正常
• 日志记录正常
• 监控配置完成

---

📞 技术支持

如遇问题，请检查：

1. 日志文件

   • 后端: /var/log/monisuo/app.log
   • Nginx: /var/log/nginx/error.log

2. 配置文件

   • 后端: application-prod.yml
   • Nginx: /etc/nginx/sites-available/monisuo-*

3. 测试脚本

   • 充值测试: ./test_deposit_api.sh
   • 完整测试: ./test_fund_flow.sh

---

部署指南版本: v1.0 最后更新: 2026-03-23 22:00 状态: ✅ 准备就绪