🖥️
服务器基础环境
PHP {{ env.php_version }}
{{ env.php_ok ? '✓ 满足 8.1+ 要求' : '✗ 需要 PHP 8.1 或更高' }}
{{ env.autoload_ready ? '✓ vendor/ 已就绪' : '✗ 请执行 composer install' }}
{{ env.all_perms_ok ? '✓ runtime & .env 可写' : '✗ 目录权限不足' }}
{{ env.webman_process ? '✓ Webman 正在处理请求' : '✗ 检测到 PHP-FPM,请改用 Nginx 反代' }}
{{ loaded ? '✓' : '✗' }} {{ name }}
🚀 一键前置初始化(宝塔专用)
在宝塔终端进入项目目录,执行以下命令可自动完成:
Composer 安装 + 依赖安装 + 目录权限配置 + Supervisor 配置生成
bash setup.sh
脚本位于项目根目录,会自动检测缺失扩展并给出宝塔面板操作路径。完成后点击左上角「重新检测」刷新状态。
🔒 已检测到安装锁
当前站点已有 install.lock。安装向导仅用于全新空库;升级旧版请按 DEPLOYMENT.md 执行数据库补丁。
⚡
Redis 服务连通测试
(可先填好配置,安装时自动写入 .env)
{{ redisTestResult }}
⚠️
当前填写的是 HTTP 地址。强烈建议配置 HTTPS,否则支付回调安全性无法保障;生产环境请使用 https://。
安装完成后,你需要将此配置粘贴到 Nginx 的 server 块文件中,并执行 nginx -s reload 生效。
⚠️ 宝塔面板用户注意:下方配置中已提供宝塔证书路径与 Let's Encrypt 路径两个选项,请删除不适用的注释行,保留与你实际证书位置一致的路径。如不确定,打开宝塔 → 网站 → 该网站配置文件查看 ssl_certificate 所在行即可。
{{ nginxCheckResult.all_ok ? '✅' : '⚠️' }}
{{ nginxCheckResult.all_ok ? 'Nginx 反向代理配置正确,可以继续安装' : '检测到配置问题,请按提示修复后重新检测' }}
{{ item.ok ? '✅' : '❌' }}
{{ item.label }}
{{ item.detail }}
{{ nginxCheckError }}
{{ dbMsg }}
💡 没有建库权限?
请先在宝塔面板 → 数据库 → 添加数据库,填写数据库名
{{ form.db_name }},并将"用户名"绑定该数据库,再回来点击检测。
✅
安装成功!
数据库、随机密钥、管理员账号和安装锁均已写入。按以下步骤完成最后配置后即可登录后台。
🔄
重启 Webman 服务
{{ envLabels[envInfo.env_type] || '手动模式' }}
.env 配置已更新,Webman 常驻进程必须重启才能加载新配置。
systemctl restart cxpay-webman
systemctl status cxpay-webman
📋 建议创建 systemd 服务
执行以下命令进行手动重启(也可参考 DEPLOYMENT.md 配置 systemd 开机自启):
php start.php stop && php start.php start -d
🔧 宝塔面板重启
在宝塔面板 → 网站 → CXPAY 项目 → PHP 进程管理,点击"重启";或在终端中执行:
php start.php stop && php start.php start -d
docker compose restart cxpay-app
php start.php stop && php start.php start -d
💡 检测到 Supervisor,也可用 supervisorctl restart cxpay-webman 重启。
宝塔面板:网站 → 目标网站 → 配置文件,将下方内容全部替换粘贴后保存,再点击“重启 Nginx”。或下载 .conf 文件直接上传。
⚠️ 宝塔用户:配置中已列出宝塔证书路径与 Let's Encrypt 路径两个选项,请删除不适用的注释行,保留与你实际证书位置一致的路径。如不确定,打开宝塔原有配置文件查看 ssl_certificate 所在行即可。
前往管理后台 →
⚠️ 安全提醒:请妥善保存管理员密码;不要删除 install.lock;不要将 8787 端口直接暴露到公网。