启动失败端口占用与GLIBC报错的排查

按症状对号入座，每条都给「原因加动作」。

启动就报 GLIBC 版本错误

报错形如「lib64/libc.so.6: version GLIBC_2.28 not found」或「accept: function not implemented」：老系统（老 CentOS、老 Debian）的 glibc 太旧。

解法：不要动系统库，去官方发布页换 musl 版本的二进制，见手动部署。

端口被占用 / 打不开 5244

• 先确认服务真的在跑：systemctl status、docker ps、或看进程。
• 端口冲突：改配置文件里的监听端口（后台「设置 → 站点」也显示端口相关项），防火墙/安全组同步放行。
• Docker 用户检查 -p 映射是否真的把 5244 映射出来了。

一键脚本装完没反应

• Linux：确认用的是 amd64/arm64 架构；重跑官方脚本看报错输出。
• Windows：必须管理员终端；杀毒软件可能拦 NSSM 注册服务，先加白名单。

升级后打开报错

• 报「failed get storage: can't find storage with rawPath: /」：不是坏了，是还没添加任何存储，登录后台加存储即可。
• 从 v2 跨到 v3：数据不互通，存储要重新添加，见升级更新。
• Docker 升级完还是旧版：镜像加速器缓存问题，见Docker 部署。

服务反复退出

• 看 data/log 目录下的日志文件定位；
• 换 --debug 参数前台跑一次，报错会直接打在终端（注意脱敏），见命令行工具；
• Windows 用 VBS 启动没反应属正常（隐藏窗口），直接浏览器访问验证。

页面一直「正在加载存储」

某个失效存储拖住了启动，用命令停掉它再重启，完整流程见挂载报错。