2026 彩虹易支付完整部署指南 epay

[up主专用，视频内嵌代码贴在这]

---

2026 彩虹易支付完整部署指南

（基于活跃维护开源版本 · 宝塔面板快速部署）

项目简介

彩虹易支付（Rainbow Epay / Epay）是一款经典的开源免签约聚合支付系统，由郑州追梦网络科技有限公司开发并开源。
它帮助个人/小型项目快速接入支付宝、微信支付、QQ钱包、网银、京东支付等多种主流渠道，无需企业资质、无需复杂签约，广泛用于数字商品、虚拟服务、接单平台等场景。

核心亮点：

• 完全开源，可自行审计代码安全
• 支持多支付通道一键切换 + 插件扩展
• 部署门槛低，宝塔面板几分钟搞定
• 社区活跃，持续维护（2025年后仍有更新）

---

靠谱收款方对接：

---

推荐源码下载（2025-2026最新活跃版）

首选下载地址（强烈推荐）：
https://github.com/v03413/Epay

• 该仓库为彩虹易支付的活跃维护分支，最近更新至2025年11月，包含多项优化（如转账统计、订单重试、API限制等）
• Stars ≈ 27+，Forks ≈ 14+，代码完整，适合直接用于生产环境
• 配套USDT插件推荐：https://github.com/v03413/BEpusdt （支持TRC20动态汇率、Docker部署）

其他分支（如2024.5.1旧版）可能已停止更新，建议优先使用 v03413/Epay。

环境要求

• PHP：8.0+（强烈推荐 PHP 8.3）
• MySQL：5.7+
• Web服务器：Nginx 1.18+（推荐）或 Apache
• 操作系统：Linux（宝塔面板 CentOS / Ubuntu 等均可）
• 其他扩展：fileinfo、openssl、gd、curl、mbstring 等（宝塔一键安装）

详细部署步骤

1. 服务器与域名准备

• 登录宝塔面板 → 网站 → 添加站点
• 域名示例：pay.yourdomain.com
• 根目录：默认 /www/wwwroot/你的域名
• 立即申请并开启免费SSL（Let’s Encrypt），全站强制HTTPS（支付回调必须HTTPS）

2. 下载并上传源码

1. 访问 https://github.com/v03413/Epay
2. 点击绿色 Code 按钮 → Download ZIP
3. 在宝塔 文件 管理器中，将压缩包上传到站点根目录并解压（覆盖所有文件）
4. 目录权限建议：文件夹 755，文件 644（宝塔默认合理）

3. 浏览器访问安装向导

浏览器打开：https://你的域名
系统自动跳转到安装页面 → 环境检测

• 所有项显示绿色√ → 点击“下一步”

4. 配置数据库

• 先在宝塔 → 数据库 → 创建一个空数据库（UTF8MB4编码）
• 填写信息：
  • 主机：localhost 或 127.0.0.1
  • 数据库名、用户名、密码
  • 表前缀：默认 ep_（可自定义）
• 点击“安装”，等待数据表自动创建（几秒完成）

5. 安装完成 & 进入站点

成功后点击“进入网站”，即可看到支付首页。

6. 设置 Nginx 伪静态（必做！否则链接404）

宝塔 → 该站点 → 伪静态 → 选择 Nginx → 粘贴以下规则 → 保存：

location / {
    if (!-e $request_filename){
        rewrite ^/([a-zA-Z0-9\-\_]+)\.html$ /index.php?mod=$1 last;
    }
    rewrite ^/pay/(.*)$ /pay.php?s=$1 last;
}

location ^~ /plugins { deny all; }
location ^~ /includes  { deny all; }

7. 登录管理后台

地址：https://你的域名/admin

默认凭证（首次登录必须立即修改）：

• 用户名：admin
• 密码：admin（或查看源码 config.php 中的默认值）

登录后：

• 修改密码
• 设置站点名称、密钥
• 配置静态资源CDN（建议留空或用国内加速）

支持的支付通道（默认集成）

• 支付宝（电脑/手机/当面付/APP）
• 微信支付（扫码/JSAPI/H5）
• QQ钱包
• 快捷网银
• 京东支付
• PayPal（部分版本）

扩展方式：插件市场或手动添加（如 BEpusdt USDT通道）。

常见问题速查

Q1：前台/后台点击无反应或404？
A：最常见原因是静态资源用了失效的字节跳动CDN。
解决：后台 → 系统设置 → 静态资源CDN → 改为空 或 自有加速域名。

Q2：支付回调失败 / 签名验证错误？
A：检查

• 通道商户号/密钥是否正确
• 网站必须HTTPS
• 回调域名是否与实际一致（return_url / notify_url）

Q3：想加USDT收款？
A：推荐对接 https://github.com/v03413/BEpusdt
插件安装后，在后台“支付通道” → 添加 → 选择BEpusdt类型 → 配置钱包地址即可。