问题处理

cdnca 常见问题：按失败步骤处理安装失败、不能登录、忘记密码、节点不上线、网站打不开、结果不明与联系谁。

按出问题的环节查找。每一项先说怎么确认，再说怎么处理；确认不了或处理后仍不行，带上记录的信息联系对应的人。

先记下这些信息

终端最后会标出失败的步骤和原因，按主控安装：安装失败时里对应的步骤处理。不要默认重装系统；第 9 步（激活授权）及以后失败时也不要重复全新安装。

主控服务器的公网 IP 还没在授权中心登记，或登记的不是出口 IP。在“我的授权”里把主控 IP 改成服务器的出口 IP 后，重新执行同一条命令。

“不通过”是硬性条件（系统版本、架构、内存、端口占用等），必须处理；“警告”可以确认后继续，或在命令末尾加 --yes。

访问地址是否带了 /dashboard/login，非 443 端口时是否带了端口。终端打印的 Control plane URL 不带端口。
服务是否都在运行：systemctl is-active cdnca-control-api cdnca-agent-gateway cdnca-control-nats cdnca-control-web。
防火墙和云安全组是否放行 443 与 80；域名解析是否指向这台服务器。
用户名是否是安装时自己设置的（没有默认 admin 账号）。

本主控还有其他管理员时，请他在“系统管理 → 用户列表”为你“重置密码”。
唯一的平台管理员也无法登录时，按主控 root 恢复手册在主控服务器上以 root 执行 control-api recover-platform-admin。手册随安装包装在本机 /data/cdnca-native-root/cdnca/current/docs/platform-admin-recovery.md，也可从授权中心下载：https://auth.cdnca.com/downloads/platform-admin-recovery.md 。执行前按手册核对账号的内部信息；恢复会撤销该账号全部会话，不移除 MFA，也不吊销 API Key。不要自行修改数据库。

安装命令失败：看终端最后标出的失败步骤和 error 行，完整输出在 /var/log/cdnca-install-node-*.log；修复后重新执行同一条命令。
节点没出现在“待初始化”：确认命令来自本主控、节点授权额度没用完，节点能访问主控与网关端口。
节点连不上网关：防火墙与云安全组放行 TCP 443、80 和安装主控时告知的两个网关端口（注册、通道）；节点经 CDN 连网关时，CDN 对外 443，回源端口填网关注册端口。
一直“待初始化”：在节点列表点“初始化”。
线路分组里没有这台节点的 IP：节点已初始化、有可用 IP，且区域与分组一致。

现象	先检查
网站列表里 CNAME 显示“生成失败”	点它查看原因，常见是 DNS 配置或 CNAME 域名没配，按提示处理后“重新生成”（见添加网站）
域名解析不到平台	域名商处的 CNAME 记录、主机记录、同名记录冲突、TTL
访问报错或回源失败	源站地址和端口、回源协议与回源 Host、源站是否放行节点 IP
HTTPS 证书错误	证书是否覆盖全部域名、是否已生效、网站“HTTPS设置”是否已应用（见HTTPS 证书）
改了配置不生效	“系统管理 → 后台任务”里的发布任务结果
访客看到旧内容	刷新缓存（见刷新与预热）
正常访问被拦截	拉黑日志、WAF 日志里命中的规则（见处理误拦截）

先在主控刷新缓存，再检查日志目录；节点最低 2G 磁盘，缓存较多时请加大磁盘。

确认节点在线、时间同步正常（时钟偏差过大会被拒绝），再检查主控与节点之间的网关端口。统计数据有延迟，刚上线的节点稍等几分钟再看。

主控按授权租约续租，租约与宽限期内照常新建与发布；恢复连接后自动续租。已在运行的节点流量不依赖授权端。