当前黑名单

blacklist add 的工作原理

blacklist add 做两件事,不是一件:

  1. 写入 blacklist.txt 记录
  2. 从远端 config.yaml 的 sites 列表中立即删除该站点
# 添加黑名单
./manage.sh blacklist add "WOW公益站"

# 背后做了什么:
# 1. echo "WOW公益站" >> /root/cliproxyapi/blacklist.txt
# 2. sed 从 config.yaml 删除该站点配置
# 3. 重启 gateway 生效

blacklist remove 的陷阱

移除黑名单 ≠ 恢复站点。移除只是从 blacklist.txt 里删一行,远端 config.yaml 里该站点早就没了。想恢复必须:

# 第一步:移除黑名单记录
./manage.sh blacklist remove "WOW公益站"

# 第二步:重新同步或手动添加站点
./manage.sh sync-models
# 或者手动编辑 config.yaml 加回站点

# 第三步:重启
systemctl --user restart cliproxyapi

errors 命令 — 站点探活

errors 不只是看错误日志,它会主动对所有活跃站点(不在黑名单里的)发 /models 请求,逐个检查是否存活。

# 执行探活 + 查看错误
./manage.sh errors

# 输出示例:
# [OK]   cliproxy  - 200 (12 models)
# [FAIL] some-site - timeout (10s)
# [WARN] another   - 200 but empty response
# 
# Recent errors (last 50 lines):
# ...

探活判活标准

响应判定建议
200 + models 列表正常无操作
200 + 空 body异常加入黑名单,伪装成功最危险
401/403认证失效检查 key 或加黑名单
429限流暂不加黑名单,观察频率
5xx / timeout服务异常连续 3 次再加黑名单

HTTP 200 不代表成功。公益站返回 200 + 错误 body 是家常便饭,探活必须看内容,不能只看状态码。