# WAF 与 API 访问:为什么 AI 编程客户端会被 403
> 2026-10-22 由真实工单沉淀(成员 `chenghongchang` 反馈「拿 apikey 请求 403」)。
## 现象
```
POST https://api.wangjinding.com/v1/chat/completions
Authorization: Bearer wjd-...
User-Agent: WorkBuddy/5.8.3 → HTTP 403
```
同一把 Key 用 `curl`(`content: "hi"`)请求**完全正常 200**,模型、网关、渠道都没问题。
## 根因
`api.wangjinding.com` 前面挂着 **1Panel 的 WAF(1pwaf)**,它会检查**请求体内容**:
| 请求体里出现 | 结果 |
|---|---|
| `` | 403(命中 XSS 规则)|
| `../../etc/passwd` | 403(命中路径穿越规则)|
| `system("ls -la")` | 403(命中命令执行规则)|
| 普通文本 | 200 |
AI 编程客户端(WorkBuddy / Cursor / 各类 CLI)把**用户代码**原样塞进 prompt,
代码里天然带 `../`、`system(`、` system(\"ls\")"}],"max_tokens":5}'
# 2) /v1/ 之外必须仍然拦截(这是安全底线,别把 WAF 整个关掉)
curl -s -o /dev/null -w '%{http_code}\n' https://api.wangjinding.com/.env # 期望 403
curl -s -o /dev/null -w '%{http_code}\n' https://api.wangjinding.com/etc/passwd # 期望 403
```
## ⚠️ 持久化注意
线上这套 WAF 配置由 **阿里云那台的 1Panel 主控**通过 agent 下发。
直接改文件**立刻生效**,但如果在面板里保存一次 WAF 设置,这条白名单**可能被覆盖**。
**建议在面板里也加一遍**:`网站 → api.wangjinding.com → WAF → 白名单 → URL 白名单 → ^/v1/`。
之后如果又出现 403,先按本文「判断依据」确认是不是 WAF,再补规则即可。
## 给调用方的配置口径
```
Base URL : https://api.wangjinding.com/v1
API Key : wjd-...(成员自己的 Key)
Model : deepseek-v4.1-flash ← 注意不要写 opencode/deepseek-v4.1-flash(会 400 未知模型)
或 wjd ← 虚拟 id,由管理员在网关里映射到具体模型
```