Appearance
常见问题与诊断
运行实例脚本前,先进入实际安装目录;默认为 cd ~/cuecast。
重启服务
在默认安装目录执行:
bash
cd ~/cuecast
docker compose --env-file .env -f compose.yml -p cuecast restart
./scripts/verify.sh若 .env 中的 CUECAST_PROJECT_NAME 不是 cuecast,将命令中的 -p cuecast 改为实际值。若容器已通过保留数据卸载删除,改用 ./install.sh --force 重建并启动。
提示 Docker daemon 不可用
先运行 docker info。如果命令不存在,安装 Docker Engine 或 Docker Desktop;如果无法连接,启动 Docker 并确认当前用户有权连接。再运行 docker compose version 确认 Compose V2 可用。然后按下文“安装中断后如何继续”操作。
服务未就绪或页面打不开
运行:
bash
./scripts/verify.sh
./scripts/logs.sh确认 31790 端口未被占用、服务器防火墙允许所需访问,且安装时填写的地址可从用户浏览器访问。MySQL 与 MinIO API 不默认映射到宿主机;不要为排障随意开放它们的内部端口。
安装中断后如何继续
保留现有目录、.env 和 Docker 数据卷,先解决错误,再在原目录运行 ./install.sh。已有实例只需重启时使用上面的 Compose 命令;不要在另一个目录重复初始化同名项目。
升级后页面加载失败或登录后没有跳转
升级后,旧标签页可能仍引用上一版本的页面资源。产品会尝试自动刷新一次;如果仍提示加载失败,请刷新页面后重新登录。持续失败时,确认升级已完成,并联系实例管理员检查服务是否可访问。
扩展无法连接到中台
确认浏览器能打开 CueCast 页面,扩展配置的地址与「实例配置」中的访问地址一致。检查扩展是否启用、是否已刷新页面,以及地址从 IP 切换为域名后是否重新登录。
生成诊断包
bash
./scripts/diagnostics.sh诊断包默认生成于安装目录 diagnostics/。它不包含 .env、数据库或对象文件,但服务日志仍可能包含业务 URL 或错误文本;外发前请按团队要求检查并脱敏。需要帮助时,可通过官网“获取技术支持”入口联系支持团队。
