TROUBLESHOOTING

常见故障

先看控制台概览的待处理，再看主控和节点的日志。

先看这三个地方

控制台概览的「待处理」；主控的 journalctl -u cdn-server；节点的 journalctl -u cdn-agent。节点的 OpenResty 错误日志在 /var/lib/cdn-agent/logs/error.log。

安装失败

401 和 403 是授权问题，脚本会转告授权站的原话；「无法从…下载」才是网络问题，检查能否访问 dl.allwaf.com:443。验签失败不要继续，核对公钥指纹。已有 PostgreSQL 低于 15 时先升级它或换干净的机器。已经装好的机器再跑 install.sh 会被拒绝，这是防止换掉主密钥，要更新用 upgrade。

节点连不上

主控地址是不是内网地址、防火墙和安全组放行了没有，在节点上 curl 主控地址的 /healthz。令牌 24 小时有效且只能用一次，过期了在控制台重新生成。新增节点被拒绝时看授权的节点数。

控制台进不去

管理员白名单配错或账号被锁时，在主控本机执行下面的命令。主控在反代后面却没配 CDN_TRUSTED_PROXIES 时，所有人的来源都是反代。http://域名:8080 打不开、浏览器自动跳 https 是 HSTS，改用 https 地址。

终端命令

sudo -i
set -a; . /etc/cdn-server/server.env; set +a
/opt/cdn-server/current/cdn-server security clear-ip-allowlist
/opt/cdn-server/current/cdn-server security unlock 用户名

访问日志不增长

看「数据库状态」的磁盘水位，超过 85% 暂停接收；再看「访问日志」的写入上限和网站的采样率。节点不再写 access.log，要看日志用控制台或日志投递。