提交

2026-09-11 21:03:53 +08:00
1 parent 195c89e6b7
commit d294ecad84
@@ -0,0 +1,83 @@
+# v1.1.0 内网部署步骤（192.168.200.24）
+
+> 依据：`200.24-小程序部署前信息调查.md`  
+> 目标：增量更新 backend + web（含 `/oa-h5/`），写入微信生产配置，**不改**数据卷与端口映射。
+
+## 链路（不改映射）
+
+```text
+用户/微信
+  → https://xwyd.zkxw.cn （39.102.214.125 Nginx 整站反代）
+  → http://112.30.112.8:60001
+  → http://192.168.200.24:8112  （Docker web 容器）
+```
+
+- 内网映射 `60001→8112`：**不修改**
+- 公网网关：现为整站 `proxy_pass`，**通常不用改**；升级后验收 `/oa-h5/` 即可
+
+## 现网目录
+
+```text
+/opt/zkxw/zkxw-docker-deploy-v1.0.0/deploy/docker
+```
+
+当前镜像：`zkxw-backend:v1.0.0` / `zkxw-web:v1.0.0`  
+`COMPOSE_PROFILES=full`，`HTTP_PORT=8112`，`MINIO_BASE_URL=/minio/zkxw`
+
+## 发版方（有源码的机器）
+
+```bash
+cd <仓库根目录>
+./scripts/package-docker-deploy.sh v1.1.0
+# 得到 dist/zkxw-docker-deploy-v1.1.0.tar.gz
+```
+
+将 tar 交给用户，由用户上传到 `192.168.200.24`。
+
+## 内网机操作清单
+
+```bash
+# ——— 1. 解压并 load 镜像 ———
+cd /opt/zkxw
+tar -xzf /path/to/zkxw-docker-deploy-v1.1.0.tar.gz
+docker load -i zkxw-docker-deploy-v1.1.0/images/zkxw-app-images.tar
+docker images | grep zkxw-
+
+# ——— 2. 备份并编辑现网 .env ———
+cd /opt/zkxw/zkxw-docker-deploy-v1.0.0/deploy/docker
+cp -a .env ".env.bak.$(date +%Y%m%d%H%M%S)"
+
+# 修改/追加（密码等原样保留）：
+# ZKXW_BACKEND_IMAGE=zkxw-backend:v1.1.0
+# ZKXW_WEB_IMAGE=zkxw-web:v1.1.0
+# WXPAY_MINI_APPID=wx2b139581f4c855e4
+# WXPAY_SECRET=<生产小程序 Secret>
+# WX_MP_APPID=wxe576b24f873f47cb
+# WX_MP_SECRET=<生产服务号 Secret>
+# WX_MP_NOTIFY_ENABLED=false
+
+# ——— 3. 滚动应用（不动 mysql/redis/minio 数据）———
+docker compose up -d backend web
+docker compose ps
+
+# ——— 4. 本机验收 ———
+curl -sI http://127.0.0.1:8112/ | head -5
+curl -sI http://127.0.0.1:8112/oa-h5/ | head -5
+curl -s http://127.0.0.1:8112/health
+```
+
+## 公网验收（任意可访问机器）
+
+```bash
+curl -skI https://xwyd.zkxw.cn/ | head -5
+curl -skI https://xwyd.zkxw.cn/oa-h5/ | head -5
+curl -sk https://xwyd.zkxw.cn/health
+```
+
+若本机 `8112/oa-h5/` 正常而公网 404：检查 `39.102.214.125` 上 `xwyd.zkxw.cn.conf` 是否仍为整站反代到 `112.30.112.8:60001`（不要做成仅 `/` 白名单）。
+
+## 微信相关说明
+
+- 模板消息总开关：`WX_MP_NOTIFY_ENABLED=false`（模板未就绪保持关闭）
+- 小程序原生包（`mobile-h5`）需另行用微信开发者工具上传，不在本 Docker tar 内
+- H5 构建已写入生产服务号 AppID：`VITE_WX_MP_APPID=wxe576b24f873f47cb`