Skip to content

常见问题与诊断 ​

运行实例脚本前,先进入实际安装目录;默认为 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 或错误文本;外发前请按团队要求检查并脱敏。需要帮助时,可通过官网“获取技术支持”入口联系支持团队。

回演 CueCast 产品文档