# IPCLOAKAPI 宝塔一键部署说明

## 适用场景

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

## 三步安装（客户向）

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

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

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

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

### 第 2 步：完成 Web 安装向导

浏览器打开：

```text
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 版本路径）：

```nginx
# BEGIN IPCLOAKAPI
# 内容见 /www/cloaka/deploy/baota/nginx/cloaka-site.conf.installed
# END IPCLOAKAPI
```

或重新运行：

```bash
sudo CLOAK_ROOT=/www/cloaka bash /www/cloaka/deploy/baota/hook/post_site.sh 站点域名 /www/wwwroot/站点域名
```

## 升级

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