CLOAK/deploy/baota/README.md

IPCLOAKAPI 宝塔一键部署说明

适用场景

在一台宝塔服务器上安装一次，之后新建的 PHP 网站可通过钩子自动接入 Cloak 流量判定（需在后台绑定域名与配置）。

三步安装（客户向）

第 1 步：上传并执行安装脚本

1. 将整个项目上传到服务器（或通过 Git 拉取）。
2. SSH 登录服务器，执行：

cd /path/to/cloaka
sudo bash deploy/baota/install_bt.sh

3. 按提示输入管理后台域名（例如 cloak-admin.你的域名.com）。脚本会把程序安装到 /www/cloaka（可改 --root）。

第 2 步：完成 Web 安装向导

浏览器打开：

https://cloak-admin.你的域名.com/install.php

填写 MySQL、后台密码、API 秘钥（CHECK_KEY），点击安装。

第 3 步：为每个业务站配置

对每个投流域名：

1. 先在宝塔：网站 → 添加站点 → 填写域名 → 申请 SSL（必须）。
2. 再在后台：dashboard.php → 站点域名 → 添加相同域名。
3. 新建或编辑配置 → 关联域名 选择该域名 → 填写仿品/正品链接 → 保存。

未添加域名时，广告链接默认使用当前访问后台的域名。

新建宝塔网站时会发生什么

安装脚本会在 /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：广告链接域名不对？
在编辑配置中选择正确的「关联域名」；未选择时使用后台当前访问域名。