- epay-ui.css:侧栏 22rem,菜单行高自适应、允许换行、取消 text-overflow:ellipsis - head.php:资源版本 v=20261021c -> 20261021d 强制刷新缓存 - README:更新侧栏说明,补充单文件挂载 inode 注意事项
11 KiB
epay 部署仓库
彩虹易支付(88531 聚合支付平台,pay.88531.cn)的 Docker 部署配置、补丁与支付插件。
目录结构
docker-compose.prod.yml 生产编排(nginx / php / mysql / cron)
docker/ nginx.conf、php-custom.ini
patches/ 补丁文件(挂载到容器 staging,镜像升级自动同步)
plugins/ 支付插件源码
.env 环境变量(不入库)
部署
方式一:Docker 运行(最小启动)
不使用编排文件时,可用 docker run 逐个启动等价容器(先建网络与数据卷):
docker network create epay-network
# MySQL(对应 compose 的 mysql 服务)
docker run -d --name epay-mysql --network epay-network \
-e MYSQL_ROOT_PASSWORD=root_password \
-e MYSQL_DATABASE=epay \
-e MYSQL_USER=epay \
-e MYSQL_PASSWORD=epay_password \
-e TZ=Asia/Shanghai \
-v epay_mysql_data:/var/lib/mysql \
mysql:8.0 --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci --sql-mode= --default-time-zone=+08:00 --default-authentication-plugin=mysql_native_password
# PHP 应用(对应 compose 的 php 服务)
docker run -d --name epay-php --network epay-network \
-e TZ=Asia/Shanghai \
-e DB_HOST=epay-mysql -e DB_PORT=3306 -e DB_USER=epay -e DB_PASSWORD=epay_password -e DB_NAME=epay -e DB_PREFIX=pay \
-e ADMIN_PASSWORD=admin_password -e SITE_URL=http://localhost \
-v epay_app_data:/var/www/html \
-v ./plugins:/var/www/html/plugins \
-v epay_uploads:/var/www/html/assets/uploads \
-v epay_sessions:/var/lib/php/sessions \
ghcr.io/aliveranme/epay:latest
# Nginx(对应 compose 的 nginx 服务,只读共享 app_data)
docker run -d --name epay-nginx --network epay-network -p 80:80 \
-v ./docker/nginx.conf:/etc/nginx/conf.d/default.conf:ro \
-v epay_app_data:/var/www/html:ro \
nginx:alpine
docker run为最小等价启动(不含patches/补丁挂载与cron定时容器),生产环境推荐方式二。
方式二:Docker Compose部署
仓库根目录 docker-compose.prod.yml 完整内容(与仓库文件一致,含全部 ports / volumes / environment):
services:
nginx:
image: nginx:alpine
container_name: epay-nginx
restart: unless-stopped
ports:
- "${NGINX_PORT:-80}:80"
volumes:
- ./docker/nginx.conf:/etc/nginx/conf.d/default.conf:ro
- app_data:/var/www/html:ro
depends_on:
php:
condition: service_started
networks:
- epay-network
php:
image: ghcr.io/aliveranme/epay:latest
container_name: epay-php
restart: unless-stopped
environment:
TZ: Asia/Shanghai
DB_HOST: ${DB_HOST:-mysql}
DB_PORT: ${DB_PORT:-3306}
DB_USER: ${DB_USER:-epay}
DB_PASSWORD: ${DB_PASSWORD}
DB_NAME: ${DB_NAME:-epay}
DB_PREFIX: ${DB_PREFIX:-pay}
ADMIN_PASSWORD: ${ADMIN_PASSWORD}
SITE_URL: ${SITE_URL:-http://localhost}
# 部署自定义配置(可选):API 接口是否校验 timestamp,1=开启(默认),0=关闭(兼容不传 timestamp 的老平台)
API_TIMESTAMP_CHECK: ${API_TIMESTAMP_CHECK:-}
volumes:
- app_data:/var/www/html
- ./plugins:/var/www/html/plugins
- uploads:/var/www/html/assets/uploads
- sessions:/var/lib/php/sessions
# 补丁:is_public_url 白名单(容器重启/升级后由 entrypoint 从 staging 自动同步)
- ./patches/functions.php:/var/www/html-staging/includes/functions.php:ro
# 补丁:后台布局覆盖 CSS(全屏自适应/侧栏加宽/导航两列)
- ./patches/epay-ui.css:/var/www/html-staging/assets/dist/epay-ui.css:ro
# 补丁:侧栏当前菜单自动滚动脚本
- ./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
# 补丁:后台改密码存明文(与登录逻辑一致)+ 登录兼容历史 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
# 补丁:支付页轮询时主动向微信查单(异步回调延迟兜底),重启后由 staging 同步
- ./patches/getshop.php:/var/www/html-staging/getshop.php:ro
extra_hosts:
- "newapi.88531.cn:host-gateway"
- "ai.88531.cn:host-gateway"
- "pay.88531.cn:host-gateway"
networks:
- epay-network
mysql:
image: mysql:8.0
container_name: epay-mysql
restart: unless-stopped
environment:
MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
MYSQL_DATABASE: ${DB_NAME:-epay}
MYSQL_USER: ${DB_USER:-epay}
MYSQL_PASSWORD: ${DB_PASSWORD}
TZ: Asia/Shanghai
command:
- --character-set-server=utf8mb4
- --collation-server=utf8mb4_unicode_ci
- --sql-mode=
- --default-time-zone=+08:00
- --default-authentication-plugin=mysql_native_password
volumes:
- mysql_data:/var/lib/mysql
networks:
- epay-network
cron:
image: alpine:latest
container_name: epay-cron
restart: unless-stopped
depends_on:
nginx:
condition: service_started
environment:
CRON_KEY: ${CRON_KEY}
SITE_URL: ${SITE_URL:-http://nginx}
entrypoint: |
/bin/sh -c '
apk add --no-cache curl tzdata;
ln -snf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime;
echo "*/5 * * * * curl -s -o /dev/null -w \"%{http_code}\" $${SITE_URL}/cron.php?key=$${CRON_KEY}" > /etc/crontabs/root;
crond -f -l 2
'
networks:
- epay-network
volumes:
app_data:
uploads:
sessions:
mysql_data:
networks:
epay-network:
driver: bridge
启动 / 停止:
# 准备 .env(不入库),至少包含:
# MYSQL_ROOT_PASSWORD、DB_PASSWORD、ADMIN_PASSWORD、SITE_URL、CRON_KEY、NGINX_PORT
docker compose -f docker-compose.prod.yml up -d
# 查看状态 / 停止 / 重建
docker compose -f docker-compose.prod.yml ps
docker compose -f docker-compose.prod.yml down
docker compose -f docker-compose.prod.yml up -d --build
本次修改内容
1. 测试支付页空白修复(patches/test.php)
/user/test.php 由 React 渲染,服务端 paytype 数组键从商户渠道 ID 开始(非 0 起),
json_encode 输出为对象 {"1":{...}},前端 .map 调用抛错导致整页白屏。
修复:array_values() 重排索引,输出为 JSON 数组。
2. 后台通道名称乱码修复(数据库)
历史数据导入时 UTF-8 被按 cp1252 二次编码,pay_channel.name、pay_user.username
等字段存的是乱码(如 支付...)。MySQL 的 latin1 即 cp1252,用以下方式还原:
UPDATE pay_channel
SET name = CONVERT(CAST(CONVERT(name USING latin1) AS BINARY) USING utf8mb4)
WHERE name NOT REGEXP '[一-龥]'
AND CONVERT(CAST(CONVERT(name USING latin1) AS BINARY) USING utf8mb4) REGEXP '[一-龥]';
已修复:pay_channel.name(支付宝官方 / 微信官方支付)、
pay_user.username(New API 接入商户 / CardAuth 接入商户)。
已扫描全库其余文本列,无同类问题。
3. 后台 UI 全屏化(patches/epay-ui.js + patches/epay-ui.css)
- 去掉页面容器宽度限制:直接从构建产物 JS 中移除 9 处
max-w-[1440px]及 9 处max-w-3xl / 4xl / 5xl / [1200px]页面级容器类 (系统设置、通道密钥、TOTP、批量结算等页原本右侧留白) - CSS 末尾追加覆盖规则兜底(
.max-w-\[1440px\]{max-width:none}等) - 结果:顶栏、侧栏、内容区铺满整个浏览器窗口,宽屏自适应
4. 后台侧栏优化(patches/epay-ui.js + patches/epay-ui.css)
- 侧栏宽度 256px → 352px(22rem)
- 导航菜单一行 2 个(分组标题独占整行,隐藏右侧箭头)
- 菜单名完整显示,不截断、不用省略号:超长菜单名(如"渠道商户违规记录") 自动换行,行高自适应,图标固定顶部对齐
- 脚本自动把当前页面对应的菜单(
aria-current="page")滚动到侧栏可视区中间, 解决菜单多时点击后"回到顶部找不到当前项"的问题 - 移动端抽屉菜单保持单列
5. 缓存与版本策略
docker/nginx.conf:/assets/dist/epay-ui.css|js设为no-cache,改版及时生效patches/head.php:后台资源链接带?v=版本号,绕过浏览器与前置反代缓存 (升级补丁后修改此版本号即可强制全端更新)
6. 补丁持久化机制
补丁文件放在 patches/,由 docker-compose.prod.yml 挂载到
/var/www/html-staging/ 对应路径,容器启动时 entrypoint 将 staging 同步到工作目录,
镜像升级/容器重建后补丁不丢失。当前挂载:
| 补丁 | 目标路径 |
|---|---|
patches/functions.php |
includes/functions.php(is_public_url 白名单) |
patches/epay-ui.css |
assets/dist/epay-ui.css |
patches/epay-ui.js |
assets/dist/epay-ui.js |
patches/head.php |
admin/head.php |
patches/test.php |
user/test.php |
日常维护
- 修改补丁:改
patches/下对应文件 → 同步进容器(docker cp)→ 更新head.php的?v=→ 提交推送 - 容器重建:
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可先校验 - 不要用
sed -i等"替换 inode"的方式改单个挂载文件:单文件 bind mount 绑定的是 inode,sed -i会写入新 inode,容器内看到的还是旧内容。请在原文件上覆盖写入 (如编辑器保存、cat > 文件),或改完docker restart epay-php重新绑定
2026-10-21 就发生过一次:容器重启后后台样式全回原版、测试支付页空白复现,
原因是 epay-ui.* / head.php / test.php 的挂载没生效(容器创建早于挂载配置),
entrypoint 用镜像原文件覆盖了工作目录。补齐挂载并重建容器后恢复。