From 1754f067f3d959eda50bf46c988e553257332cdc Mon Sep 17 00:00:00 2001 From: opencode Date: Fri, 13 Nov 2026 17:06:09 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E5=AE=B9=E5=99=A8=E9=87=8D?= =?UTF-8?q?=E5=90=AF=E5=90=8E=E8=A1=A5=E4=B8=81=E4=B8=A2=E5=A4=B1=E9=97=AE?= =?UTF-8?q?=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - docker-compose.prod.yml:修正 volumes 缩进(YAML 之前无法解析), 补齐 epay-ui.css/epay-ui.js/head.php/test.php 挂载(容器创建早于挂载配置,从未生效) - 重建 php 容器后 entrypoint 从 staging 同步补丁,后台全屏布局/侧栏/测试支付页恢复正常 - README:补充'重启变回原样'的机制说明与维护规范 --- README.md | 19 ++++++++++++++++++- docker-compose.prod.yml | 2 ++ 2 files changed, 20 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 34478c9..966ff30 100644 --- a/README.md +++ b/README.md @@ -235,5 +235,22 @@ WHERE name NOT REGEXP '[一-龥]' ## 日常维护 - 修改补丁:改 `patches/` 下对应文件 → 同步进容器(`docker cp`)→ 更新 `head.php` 的 `?v=` → 提交推送 -- 容器重建:`docker compose -f docker-compose.prod.yml up -d` +- 容器重建:`docker-compose -f docker-compose.prod.yml up -d`(本机为 v1 命令) - `.env` 含数据库/管理员密码等敏感信息,禁止提交 + +## ⚠️ 重要:为什么改完样式会"变回原样" + +容器**每次启动**都会执行 entrypoint 的 `rsync -a --delete /var/www/html-staging/ /var/www/html/`, +用镜像原始文件覆盖工作目录,因此: + +- **只允许改 `patches/` 下的文件**,且必须在 `docker-compose.prod.yml` 中挂载到 + `/var/www/html-staging/<对应路径>` +- 直接用 `docker cp` / 在容器内改 `/var/www/html/...` 的文件,重启后**必然被还原** +- 改完 compose 挂载后必须 `docker-compose up -d php` **重建容器**(不是 restart), + 挂载才会生效;重建时 entrypoint 会自动把补丁同步进工作目录 +- 新增补丁时最容易漏的是挂载行和 YAML 缩进(所有 `-` 项必须同缩进), + `docker-compose -f docker-compose.prod.yml config -q` 可先校验 + +2026-10-21 就发生过一次:容器重启后后台样式全回原版、测试支付页空白复现, +原因是 `epay-ui.*` / `head.php` / `test.php` 的挂载没生效(容器创建早于挂载配置), +entrypoint 用镜像原文件覆盖了工作目录。补齐挂载并重建容器后恢复。 diff --git a/docker-compose.prod.yml b/docker-compose.prod.yml index 2ad5f12..247084d 100644 --- a/docker-compose.prod.yml +++ b/docker-compose.prod.yml @@ -43,6 +43,8 @@ services: - ./patches/epay-ui.js:/var/www/html-staging/assets/dist/epay-ui.js:ro # 补丁:后台入口资源版本号(?v= 强制回源) - ./patches/head.php:/var/www/html-staging/admin/head.php:ro + # 补丁:测试支付页 paytype JSON 数组修复 + - ./patches/test.php:/var/www/html-staging/user/test.php:ro # 补丁:后台改密码存明文(与登录逻辑一致)+ 登录兼容历史 md5 存储 - ./patches/admin/set.php:/var/www/html-staging/admin/set.php:ro - ./patches/admin/login.php:/var/www/html-staging/admin/login.php:ro