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 → 320px
  • 导航菜单一行 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
  • .env 含数据库/管理员密码等敏感信息,禁止提交
S
Description
epay 部署配置与补丁
Readme
618 KiB
0 Stars 1 Watchers 0 Forks
Latest
2026-11-02 16:00:04 +08:00
Languages
PHP 98.9%
Hack 1.1%