Files
opencode f037f47e27 后台侧栏加宽至 352px,菜单名完整显示不再省略
- epay-ui.css:侧栏 22rem,菜单行高自适应、允许换行、取消 text-overflow:ellipsis
- head.php:资源版本 v=20261021c -> 20261021d 强制刷新缓存
- README:更新侧栏说明,补充单文件挂载 inode 注意事项
2026-11-13 17:12:46 +08:00

11 KiB
Raw Permalink Blame History

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