Appearance
安装私有部署版
先按运行环境准备 Docker。
1. 下载并安装
从官网下载页下载与 Docker 架构匹配的包。可选的同名 .sha256 文件应放在包旁边以做校验。在下载目录执行页面给出的命令;下面以 x86_64 为例,请将版本号替换为实际文件名:
bash
tar -xzf cuecast-vX.Y.Z-x86_64.tar.gz && ./cuecast-vX.Y.Z-x86_64/install.sh准确的文件名请看下载后的文件名称。实例默认安装到 ~/cuecast,与下载目录无关。已有实例请使用升级脚本,不要再次执行首次安装。
2. 完成安装向导
安装器会检查 Docker、架构和磁盘空间,然后引导填写访问地址及首个管理员账号。密码至少 8 位,包含字母和数字。确认信息后,安装器会导入镜像、启动服务并自动验证。
访问地址须能从使用者的浏览器打开,例如局域网地址 http://服务器内网IP:31790。Windows WSL2 用户应填写 Windows 浏览器可访问的地址,不要使用 WSL2 内部 IP。若 Docker Desktop 使用虚拟机磁盘,请同时确认其磁盘容量足够。
安装中断时,解决问题后在 ~/cuecast 运行 ./install.sh 继续;自动生成的管理员密码会在续装时再次显示。安装完成后要重新拉起服务,运行 ./install.sh --force。配置和密钥存于 ~/cuecast/.env,请妥善保管。
3. 登录并配置
打开安装结果显示的地址,用管理员账号登录。首次登录可在「实例配置」中按需设置访问地址、邮件和 AI 服务。启用外部 AI 服务时,相关测试上下文可能发送到所配置的服务。
用户名可在「个人资料」中修改;修改邮箱前需在「实例配置」启用邮件服务。若日后更换 IP、域名或端口,先确保新地址可访问,再到「实例配置」保存新地址。邀请和通知链接会立即使用新地址,无需修改 .env 或重启服务;切换域名后需重新登录,并更新浏览器扩展中的地址。
执行记录、计划执行记录和截图默认保留 60 天,可在「实例配置 → 执行记录保留」修改;0 表示永久保留。保存后无需重启,后台默认每日清理过期数据;缩短期限也适用于已有记录,删除后无法恢复。已有实例未保存页面设置时继续沿用原环境配置。
各字段的填写方法、保存方式及换址后的扩展设置,见实例配置说明。
4. 安装浏览器扩展
- 点击页面右上角的扩展状态,下载扩展 ZIP 并解压。
- 在 Chrome 打开
chrome://extensions/,开启“开发者模式”,点击“加载已解压的扩展程序”,选择含manifest.json的目录。 - 从实例页面下载的扩展首次安装时,默认使用下载时的实例访问地址。若浏览器已保存其他地址,在扩展中改成与平台一致的 CueCast 地址;刷新页面并确认扩展已就绪。
每位需要录制或回放的成员都应在自己的 Chrome 中安装扩展。安装完成后建议创建完整备份,并将备份复制到其他机器。
