# 喜联云MC智能插件商户入驻教程

## 1. 注册与登录

打开 `account.php`。可以使用账号密码、手机号验证码或邮箱验证码注册和登录，也可以使用已经绑定的 QQ、微信登录。QQ/微信不会直接创建未注册账号；先完成手机号或邮箱注册，再在账号设置中绑定。

基础额度按自然月计算：短信 10 次、QQ/微信 20 次、邮件验证码 50 次。管理员可以在总后台修改商户额度、套餐有效期以及 QQ、微信、手机、邮箱登录开关。

发送手机或邮箱验证码不会刷新页面，按钮会显示 120 秒倒计时；同一 IP 在 120 秒内不能重复发送。极验配置完整时只需要完成极验，图形验证码仅作为未配置极验时的备用方式。

## 2. 绑定 Forge 服务器

1. 登录账号中心后进入商户控制台，打开“服务端”。
2. 下载服务端 jar，放到 Forge 1.20.1 服务端的 `mods` 目录。
3. 启动一次服务端，确认 Forge 版本为 1.20.1、Java 版本为 17。
4. 在游戏控制台或 OP 聊天中执行：

   `/xilian bind 商户号 密钥`

5. 玩家安装客户端 jar，进入服务器。客户端会自动从服务端获取后端地址和短时加密票据。

密钥只用于服务端签名，请不要发给玩家。管理员在后台重置商户密钥后，旧服务端必须重新绑定。

## 3. 绑定 QQ / 微信

注册成功后，账号中心会弹出绑定建议。选择 QQ 或微信，完成极验安全验证并在彩虹聚合页面授权。绑定成功后，登录页对应按钮即可直接使用。

## 4. 设置登录方式

商户控制台的“登录方式”可以分别开启 QQ、微信、手机验证码和 SMTP 邮箱验证码。全局彩虹登录、短信接口、SMTP 参数由网站管理员在 `admin.php` 配置。

## 5. 宝塔部署

1. 新建 PHP 8.1 或更高版本的网站，绑定 HTTPS 证书，并开启强制 HTTPS。
2. 上传 `phpserver` 目录内全部文件到网站根目录。
3. 确认 PHP 扩展启用：`pdo_mysql`、`curl`、`openssl`、`mbstring`、`fileinfo`、`session`。
4. 打开 `https://你的域名/install.php`，填写 MySQL 信息、网站地址和管理员账号密码。
5. 安装成功后立即删除 `install.php`，保留 `data/install.lock`。
6. 在彩虹聚合登录后台填写回调地址：`https://你的域名/callback.php`。
7. 打开 `admin.php`，填写 SMTP、支付和接口配置并保存。
8. 进入“系统配置”填写极验 `captchaId`、`captchaKey` 和校验地址；再进入“联调测试”提交极验测试，确认前端挑战和服务端二次校验都通过。
9. 进入“公告中心”发布官网公告。

## 6. 权限与 Nginx

网站文件使用 `644`，目录使用 `755`。只有 `data/` 需要 PHP 进程写权限，建议 `750` 或 `770`，所有者设为宝塔 PHP 运行用户。不要把全站设置为 `777`。

把 `nginx.conf.example` 里的禁止访问规则合并到宝塔网站配置，至少禁止 `/data/`、`install.php`、`config.php`、`database.php`、`lib.php`、`platform.php` 以及数据库、日志和压缩包下载。`data/` 已附带 `.htaccess`，但 Nginx 仍需使用 Nginx 规则。

## 7. 后台入口

- 统一账号：`/account.php`
- 总后台：`/admin.php`
- 商户中心：`/merchant.php`
- 健康检查：`/api.php?action=health`

总后台可以管理网站配置、商户、用户、商户额度、登录方式、公告、极验测试、短信测试、QQ/微信登录测试、SMTP 参数和易支付套餐。