沐念云
146 lines
2.9 KiB
Markdown
146 lines
2.9 KiB
Markdown
# 下游推送域名修复插件
|
|
|
|
用于你站点名下代理用户的地址变更后，可通过本插件直接批量更换推送代理新地址。
|
|
|
|
## 插件信息
|
|
|
|
| 项目 | 内容 |
|
|
| --- | --- |
|
|
| 插件名称 | 下游推送域名修复 |
|
|
| 插件标识 | `DownstreamDomainFix` |
|
|
| 插件目录 | `downstream_domain_fix` |
|
|
| 作者 | 沐念云 |
|
|
| 版本 | `1.0` |
|
|
|
|
## 功能说明
|
|
|
|
本插件用于批量修改指定客户名下服务器的下游推送地址。
|
|
|
|
当代理用户更换域名后，系统数据库中已保存的推送地址仍然可能是旧域名，导致上游向下游推送时请求失败，例如出现 `HTTP 404`。通过本插件可以按客户 ID 批量修复这些服务器的推送域名。
|
|
|
|
插件会更新数据库中：
|
|
|
|
```text
|
|
shd_host.stream_info
|
|
```
|
|
|
|
字段内 JSON 的：
|
|
|
|
```text
|
|
downstream_url
|
|
```
|
|
|
|
## 适用场景
|
|
|
|
- 代理站更换域名
|
|
- 上游推送下游失败
|
|
- 数据库中保存的下游推送地址仍是旧地址
|
|
- 需要按客户 ID 批量修复该客户名下所有服务器的推送地址
|
|
|
|
## 安装方式
|
|
|
|
将插件目录上传到系统插件目录：
|
|
|
|
```text
|
|
public/plugins/addons/
|
|
```
|
|
|
|
然后进入后台插件管理页面，找到并安装：
|
|
|
|
```text
|
|
下游推送域名修复
|
|
```
|
|
|
|
## 使用方法
|
|
|
|
进入插件后台菜单：
|
|
|
|
```text
|
|
修复推送域名
|
|
```
|
|
|
|
填写以下信息：
|
|
|
|
| 字段 | 说明 | 示例 |
|
|
| --- | --- | --- |
|
|
| 客户ID | 需要批量修复的客户 ID，对应 `shd_host.uid` | `8888` |
|
|
| 指定推送域名 | 新的代理站地址 | `https://www.baidu.com` |
|
|
|
|
点击：
|
|
|
|
```text
|
|
开始修复
|
|
```
|
|
|
|
插件会自动处理该客户名下符合条件的服务器。
|
|
|
|
## 处理规则
|
|
|
|
插件只会处理满足以下条件的服务器：
|
|
|
|
1. `shd_host.uid` 等于输入的客户 ID
|
|
2. `stream_info` 不为空
|
|
3. `stream_info` 中存在完整的下游推送信息：
|
|
- `downstream_url`
|
|
- `downstream_token`
|
|
- `downstream_id`
|
|
|
|
插件会跳过以下服务器：
|
|
|
|
- 没有下游推送信息的服务器
|
|
- 下游推送信息不完整的服务器
|
|
- 当前推送域名已经等于目标域名的服务器
|
|
|
|
## 修改内容
|
|
|
|
插件实际修改的是：
|
|
|
|
```text
|
|
shd_host.stream_info.downstream_url
|
|
```
|
|
|
|
不会修改：
|
|
|
|
- 产品信息
|
|
- 客户信息
|
|
- 订单信息
|
|
- 服务器状态
|
|
- `downstream_token`
|
|
- `downstream_id`
|
|
|
|
## 域名填写说明
|
|
|
|
填写站点根地址即可，例如：
|
|
|
|
```text
|
|
https://www.baidu.com
|
|
```
|
|
|
|
## 处理结果
|
|
|
|
执行后页面会显示：
|
|
|
|
- 匹配服务器数量
|
|
- 成功更新数量
|
|
- 跳过数量
|
|
- 每台服务器的处理结果
|
|
|
|
结果表格包含：
|
|
|
|
- Host ID
|
|
- 主机名
|
|
- 主 IP
|
|
- 状态
|
|
- 原推送域名
|
|
- 新推送域名
|
|
- 处理结果
|
|
|
|
## 注意事项
|
|
|
|
- 执行前建议先备份数据库。
|
|
- 请确认客户 ID 正确，避免修改错误客户名下的服务器。
|
|
- 本插件只修改本地数据库中的推送域名，不主动调用上游接口。
|
|
- 修改完成后，上游后续推送会读取新的 `downstream_url`。
|
|
|
|
|