rootIPCLOAKAPI 宝塔一键部署说明
适用场景
在一台宝塔服务器上安装一次，之后新建的 PHP 网站可通过钩子自动接入 Cloak 流量判定（需在后台绑定域名与配置）。
三步安装（客户向）
第 1 步：上传并执行安装脚本
- 将整个项目上传到服务器（或通过 Git 拉取）。
- SSH 登录服务器，执行：
cd /path/to/cloaka
sudo bash deploy/baota/install_bt.sh
- 按提示输入管理后台域名（例如
cloak-admin.你的域名.com）。脚本会把程序安装到/www/cloaka（可改--root）。
第 2 步：完成 Web 安装向导
浏览器打开：
https://cloak-admin.你的域名.com/install.php
填写 MySQL、后台密码、API 秘钥（CHECK_KEY），点击安装。
第 3 步：为每个业务站配置
对每个投流域名：
- 先在宝塔：网站 → 添加站点 → 填写域名 → 申请 SSL（必须）。
- 再在后台：
dashboard.php→ 站点域名 → 添加相同域名。 - 新建或编辑配置 → 关联域名 选择该域名 → 填写仿品/正品链接 → 保存。
未添加域名时，广告链接默认使用当前访问后台的域名。
新建宝塔网站时会发生什么
安装脚本会在 /www/server/panel/hook/ 注册 cloaka_post_site.sh：
- 为新站点 Nginx 配置追加 Cloak 路由片段（请求走
/www/cloaka/ip_check.php）。 - 尝试在数据库
cloak_site_domains登记该域名（需已完成 install.php）。
手动绑定已有站点
编辑站点 Nginx 配置，在 server { } 内追加（注意修改 PHP 版本路径）：
# BEGIN IPCLOAKAPI
# 内容见 /www/cloaka/deploy/baota/nginx/cloaka-site.conf.installed
# END IPCLOAKAPI
或重新运行：
sudo CLOAK_ROOT=/www/cloaka bash /www/cloaka/deploy/baota/hook/post_site.sh 站点域名 /www/wwwroot/站点域名
升级
sudo bash deploy/baota/install_bt.sh --upgrade --source /path/to/new/cloaka
不会覆盖 cong.php、.install.lock 及 check_config/*_config.php。
目录说明
| 路径 | 说明 |
|---|---|
/www/cloaka |
程序主目录（默认） |
deploy/baota/nginx/cloaka-site.conf |
业务站 Nginx 模板 |
deploy/baota/nginx/cloaka-admin.conf |
管理站 Nginx 补充 |
deploy/baota/hook/post_site.sh |
建站后钩子 |
常见问题
Q：访问业务站 502？
检查 cloaka-site.conf.installed 中 PHP include 路径是否与站点 PHP 版本一致（安装脚本会按 82/83/81 检测）。
Q：配置不生效？
确认后台已为该域名关联配置，且 check_config/配置名_config.php 存在。
Q：广告链接域名不对？
在编辑配置中选择正确的「关联域名」；未选择时使用后台当前访问域名。