宝塔面板官方文档

管理反向代理的 IP 黑白名单

管理反向代理站点的 IP 黑白名单。

POST

https://your-panel.example.com:8888/mod/proxy/com/{action}/stype

更新于 2026年7月10日查看 Markdown

Path parameters

actionstringrequired
具体操作名称，参见下方原始接口文档。

Request bodyX-WWW-FORM-URLENCODEDrequired

request_timestringrequired
Unix 时间戳。
request_tokenstringrequired
按 API 概览生成的签名。
site_namestringrequired
站点名称
ipsstringrequired
IP 列表，多个用换行符分隔。支持 CIDR 格式如 10.0.0.0/8

Returns

default

接口响应，业务状态见下方详细说明。

各操作详细说明

add_ip_limit / del_ip_limit管理反向代理的 IP 黑白名单

管理反向代理站点的 IP 黑白名单。

路由：POST /mod/proxy/com/{action}/stype

add_ip_limit — 添加 IP 限制

输入参数

参数名称	必选	类型	描述
site_name	是	string	站点名称
ips	是	string	IP 列表，多个用换行符分隔。支持 CIDR 格式如 `10.0.0.0/8`

说明：IP 限制作用于指定 proxy_path 上。若未指定 proxy_path，则作用于全局。

del_ip_limit — 删除 IP 限制

输入参数

参数名称	必选	类型	描述
site_name	是	string	站点名称
ip_type	是	string	类型：`black` 或 `white`
ip	是	string	要删除的 IP 地址

示例

add_ip_limit 请求

curl -X POST ".../mod/proxy/com/add_ip_limit/stype" \
  -d "site_name=example.com&ips=192.168.1.100%0A10.0.0.0/8"

del_ip_limit 请求

curl -X POST ".../mod/proxy/com/del_ip_limit/stype" \
  -d "site_name=example.com&ip_type=black&ip=192.168.1.100"

响应

{"code": 0, "status": true, "msg": "设置成功！"}

管理反向代理的 IP 黑白名单

curl --request POST \
  --url "https://your-panel.example.com:8888/mod/proxy/com/<action>/stype" \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "request_time=<Unix时间戳>" \
  --data-urlencode "request_token=<按 API 概览生成的签名>" \
  --data-urlencode "site_name=<site_name>" \
  --data-urlencode "ips=<ips>"

Response example

{
  "code": 0,
  "status": true,
  "msg": "设置成功！"
}