常见问题与排查¶

先看这三条¶

kaze check      # 对着面板检查配置,会直接指出问题
kaze status     # 看是否在运行
kaze log        # 看最近日志

配置检查没过：kaze check 的输出会说明哪一项不对。
对接信息错：确认 type、node_id、webapi_url、webapi_key（也可写作 panel_url、panel_key）和面板一致。V2board 还要 server_type。正确的样子：
```
type=xboard
node_id=1                              # 面板节点列表里的 ID
webapi_url=https://panel.example.com   # 浏览器打开面板用的地址
webapi_key=xxxxxxxxxxxx                # 系统配置 → 节点配置 → 通讯密钥
```
用 kaze check 可以直接对着面板检查，会告诉你哪一项不对。 - 端口被占用：日志里会写 address already in use。换端口或停掉占用的程序。 - 证书问题：开了 TLS 的协议必须有证书。自动申请要求域名解析到本机且 80 端口可达，见 TLS 证书。

启动日志里会明确写出哪条规则 / 哪个字段不支持、为什么。kaze log 搜一下即可。kaze 不会静默失效。

节点套了 CDN 或中转时，要先让 kaze 拿到真实 IP，见中转与 CDN 真实 IP。否则所有用户看起来来自同一个 IP。

同一面板的节点写在一个 node_id 里，一个进程全带起来，不同协议也可以混；第二个面板再装一个实例（--name b）。见[一台机器多节点、多协议]（features/multinode.md）和一台机器多个面板。

kaze license

输出会说明原因：授权码绑定在别的面板、协议未覆盖、已过期、连不上授权服务器，或程序被篡改。每种状态的含义和处理见[授权说明 → 日志里的授权状态]（license.md#日志里的授权状态）。

Hysteria2 客户端填了带宽时按该速率发送（Brutal）；没填时用 BBR 自动探测线路速度。TUIC 在面板编辑节点时把「拥塞控制」选为 bbr 即可（Xboard：节点管理 → 编辑节点 → 高级协议配置 → TUIC；V2board / PPanel 在节点的协议设置里）。

弱网下仍然慢，可以让用户在客户端填上真实带宽。

屏蔽 BT、屏蔽内网不影响这些。如果分流规则把这类流量指向 HTTP 代理出口：HTTP 代理不转发 UDP，UDP 会被丢弃（不会直连，以免暴露节点 IP），纯 UDP 的游戏和语音就会不通，改用其它类型的出口即可。落地机是 Shadowsocks 时，确认落地机开了 UDP。见分流与出口。

kaze geo

带上 kaze log 的输出和 kaze check 的结果反馈。日志里不含密钥明文（会打码），可以直接贴。