petwash/快速部署指南.md

🚀 快速部署指南

三步完成部署

步骤 1: 初始化数据库

mysql -h 101.132.182.216 -P 3306 -u root -p

进入 MySQL 后执行:

SOURCE init-database.sql;

或者直接导入:

mysql -h 101.132.182.216 -P 3306 -u root -p < init-database.sql

步骤 2: 运行部署脚本

英文版 (推荐):

.\deploy.ps1

中文版:

.\deploy-cn.ps1

步骤 3: 验证部署

打开浏览器访问:

• Swagger 文档: http://localhost:5000/swagger
• 测试 API: http://localhost:5000/api/packages

常见问题

1. Docker 未安装

错误信息:

ERROR: Docker is not installed

解决方案:

• 下载并安装 Docker Desktop
• 安装后重启电脑
• 确保 Docker Desktop 正在运行

2. 无法连接数据库

错误信息:

Unable to connect to MySQL server

解决方案:

# 测试网络连接
ping 101.132.182.216

# 测试端口
telnet 101.132.182.216 3306

3. 端口被占用

错误信息:

Port 5000 is already in use

解决方案:

修改 docker-compose.yml 文件:

ports:
  - "5001:80"  # 改为其他端口

然后重新部署:

.\deploy.ps1

常用命令

# 查看容器状态
docker-compose ps

# 查看实时日志
docker-compose logs -f petwash-api

# 重启服务
docker-compose restart

# 停止服务
docker-compose down

# 重新构建并启动
docker-compose up -d --build

配置信息

MySQL 数据库:

• 服务器: 101.132.182.216
• 端口: 3306
• 数据库: petwash
• 用户: root
• 密码: (空)

API 服务:

• 地址: http://localhost:5000
• Swagger: http://localhost:5000/swagger
• 环境: Production

测试 API

获取套餐列表

curl http://localhost:5000/api/packages

获取订单列表

curl http://localhost:5000/api/orders

创建订单

curl -X POST http://localhost:5000/api/orders \
  -H "Content-Type: application/json" \
  -d '{"packageId": 1}'

部署脚本说明

deploy.ps1 (英文版)

• 适合国际化环境
• 无中文字符，兼容性好
• 推荐使用

deploy-cn.ps1 (中文版)

• 中文提示信息
• 更详细的步骤说明
• 适合中文用户

两个脚本功能完全相同，选择你喜欢的即可。

下一步

部署成功后，你可以:

1. 查看 Swagger 文档

   • 访问 http://localhost:5000/swagger
   • 测试所有 API 接口

2. 集成 WPF 客户端

   • 修改 WPF 应用的 API 地址
   • 指向 http://localhost:5000

3. 配置生产环境

   • 设置 MySQL 密码
   • 配置 HTTPS
   • 设置防火墙规则

获取帮助

• 详细文档: DOCKER_DEPLOYMENT.md
• 检查清单: PRE_DEPLOYMENT_CHECKLIST.md
• 快速参考: DOCKER_QUICK_REFERENCE.md

---

遇到问题？查看日志:

docker-compose logs --tail=100 petwash-api