生产环境部署指南

部署架构

┌─────────────────────────────────────────────────────────┐
│                        用户                              │
│                    ┌──────────────┐                      │
│                    │  微信小程序   │                      │
│                    └──────┬───────┘                      │
└──────────────────────────┼──────────────────────────────┘
                           │ HTTPS
┌──────────────────────────┼──────────────────────────────┐
│                     你的服务器                           │
│                    ┌──────────────┐                     │
│                    │  WordPress   │                     │
│                    │   + 插件      │                     │
│                    └──────────────┘                     │
└─────────────────────────────────────────────────────────┘

---

服务器要求

最低配置

• CPU: 1 核
• 内存: 1GB
• 带宽: 1Mbps
• 硬盘: 10GB

推荐配置

• CPU: 2 核+
• 内存: 2GB+
• SSD 硬盘
• 国内服务器（备案域名）

推荐服务商

• 阿里云 ECS
• 腾讯云 CVM
• 华为云 ECS

---

第一步：部署 WordPress

1. 安装宝塔面板（推荐）

# SSH 连接服务器
ssh root@你的服务器IP

# 安装宝塔
yum install -y bt && bt default

2. 安装 LNMP 环境

• 宝塔面板 → 软件商店 → 搜索 LNMP
• 一键安装（选择 PHP 8.0+）

3. 创建网站

• 宝塔面板 → 网站 → 添加站点
• 填写域名
• 数据库：MySQL 5.7+
• PHP 版本：8.0+

4. 安装 WordPress

• 下载 WordPress：https://wordpress.org/latest.zip
• 上传到网站目录
• 解压
• 访问域名完成安装

---

第二步：安装插件

方式一：后台上传

1. WordPress 后台 → 插件 → 上传插件
2. 上传 zm-coffee-api.zip
3. 启用

方式二：FTP 上传

1. 解压插件到本地
2. 上传到 wp-content/plugins/zm-coffee-api
3. 后台启用

---

第三步：配置 SSL 证书

宝塔自动申请

1. 宝塔面板 → 网站 → 找到你的站点
2. 点击 SSL
3. 选择 Let’s Encrypt
4. 申请免费证书
5. 开启 HTTPS 强制跳转

手动配置

如使用其他服务器，在 Web 服务器（Nginx/Apache）中配置 SSL。

---

第四步：配置域名

1. 域名备案

• 国内服务器必须备案
• 在服务商备案系统提交

2. DNS 解析

A 记录 @ 你的服务器IP
CNAME www 你的域名

---

第五步：配置小程序合法域名

1. 登录 微信公众平台
2. 开发 → 开发管理 → 开发设置
3. 配置服务器域名：

类型	域名
request 合法域名	https://你的域名.com
uploadFile 合法域名	https://你的域名.com
downloadFile 合法域名	https://你的域名.com

⚠️ 注意：域名必须已备案，且使用 HTTPS

---

第六步：更新小程序 API 地址

1. 修改 uniapp/src/utils/config.ts

   
   

   export const API_BASE_URL = 'https://你的域名.com/wp-json/zm-coffee-api/v1'
   

   
   

2. 重新编译

   
   

   npm run build:mp-weixin
   

   
   

3. 重新上传代码到微信开发者工具

   
   

---

第七步：提交审核发布

1. 上传代码

1. 微信开发者工具 → 上传
2. 填写版本号：1.0.0
3. 填写版本说明

2. 提交审核

1. 登录 微信公众平台
2. 管理 → 版本管理
3. 找到刚上传的版本
4. 点击 提交审核

3. 填写审核信息

• 版本说明：简要描述功能
• 功能页面：填写主要页面路径
• 测试账号：（可选）

4. 等待审核

• 一般 1-7 个工作日
• 审核通过后点击 发布

---

维护建议

定期更新

• WordPress 核心更新
• 插件更新
• PHP 版本更新

安全建议

• 使用强密码
• 开启防火墙
• 定期备份

备份策略

• 每日自动备份数据库
• 每周备份文件
• 异地备份

---

下一步

• ✅ 回到快速开始
• ❓ 常见问题