修复容器重启后补丁丢失问题

- docker-compose.prod.yml:修正 volumes 缩进(YAML 之前无法解析),
  补齐 epay-ui.css/epay-ui.js/head.php/test.php 挂载(容器创建早于挂载配置,从未生效)
- 重建 php 容器后 entrypoint 从 staging 同步补丁,后台全屏布局/侧栏/测试支付页恢复正常
- README:补充'重启变回原样'的机制说明与维护规范
This commit is contained in:
opencode committed 2026-11-13 17:07:11 +08:00
1 parent 868bdbf544
commit 1754f067f3
2 files changed
+20 -1

No files matched your search

+18 -1
View File
@@ -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 用镜像原文件覆盖了工作目录。补齐挂载并重建容器后恢复。
+2
View File
@@ -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