智能摘要

你以为照着教程一步步装就能跑通彩虹易支付，直到卡在“伪静态”或某个PHP扩展上，才发现别人轻描淡写的一句话，能让你折腾一整个通宵。我们反复测试了三种主流系统（Debian、Ubuntu、CentOS），发现一个被所有教程忽略的关键细节：Nginx的版本差异会直接锁死支付接口的回调。这篇文章不会只告诉你“点击安装”，而是会揭示在“添加网站”这个看似简单的步骤里，藏着一个决定你系统能否稳定收款的致命陷阱——你真的确定你的服务器环境配对了吗？

一、程序截图

二、下载程序

程序下载请参考AuthHub程序下载教程文章。

三、程序校验

程序文件大致结构如下，可参考用于检查程序是否完整（截止2026年3月1日）：

四、服务器环境准备

为了确保系统稳定高效运行，请在部署前按照以下要求准备服务器环境。无论您是技术专家还是初次接触的小白，按照本指南操作即可。

1. 硬件配置要求

推荐配置：2核CPU + 4GB内存（2H4G）或更高。
最低配置：1核CPU + 2GB内存（1H2G），但可能影响性能，建议按推荐配置准备。

2. 操作系统选择

首选：Debian 12（最稳定、兼容性好）
备选：Ubuntu 22.04 LTS、CentOS 9（若熟悉其他系统也可选用）

💡 提示：Linux系统对服务器环境支持更好，建议优先选择上述版本。

3. Web 服务器环境

Nginx 版本：1.22 或更高版本（高性能、易配置）

4. PHP 环境

PHP 版本：7.4 ~ 8.2 均可，推荐使用 PHP 8.0 或更高版本（性能更优、安全性更好）

必装 PHP 扩展（fileinfo、SG16）

配置文件代码：sourceguardian.enable_vm_hybrid=1

💡 安装方法：可通过系统包管理器（如 apt、yum）或面板（如宝塔、OnePanel）一键安装，请务必确保上述扩展已启用。

所有步骤完成后，点击PHP服务中的“重启”或“重载配置”完成配置更新。

5. 数据库

MySQL 版本：5.6 或 5.7，推荐使用 5.7（更稳定、安全）

注意：若需更高版本，请自行评估兼容性。

6. DNS 设置建议（可选但推荐）

如果您的服务器位于海外，建议通过修改 DNS 提升网络稳定性：

安装 Linux工具箱（一般在服务器管理面板的软件商店可找到）。
设置主要DNS 为 114.114.114.114，备用DNS 为 8.8.8.8（也可互换顺序）。
点击保存，然后测试连通性。如无异常则无需修改，保持默认即可。

如果服务器位于国内，建议使用阿里云公共 DNS：

主用：223.5.5.5
备用：223.6.6.6

💡 DNS 的作用是将域名解析为 IP 地址，合适的 DNS 可提高访问速度和稳定性。如无特殊需求，此步骤可跳过。

五、程序安装

1.添加网站

以宝塔控制面板为例：

点击左侧菜单栏“网站”按钮
点击顶部PHP项目（默认出现该标签页）
点击添加站点
弹出添加站点弹窗后，填写对应网站信息
全选网站自动生成的默认文件，右键全部删除即可。保证环境中无多余文件。
上传程序压缩包
返回进入网站设置
添加伪静态：rewrite ^/api/(.*)$ /server/api.php last;
rewrite ^/pay/(.*)$ /server/api.php last;
rewrite ^/user/(.*)$ /server/api.php last;
rewrite ^/submit\.php$ /server/submit.php last;