Appearance
实例配置说明
具有用户管理权限的管理员可从「管理后台 → 实例配置」进入页面。首次登录时也会提示配置;可以先使用产品,之后再返回填写。
保存方式
- 访问地址使用单独的「保存地址」按钮。
- 对象存储使用本卡片的「验证并保存存储配置」按钮;「测试连接」只验证,不保存。
- 执行记录保留使用保留天数旁的「确认」按钮单独保存,保存后停留在当前页。
- 邮件、文本 AI、图片 AI分别使用各自卡片的保存按钮;只保存当前卡片,保存后停留在当前页。
- 页面底部的「进入产品」只进入产品,不提交尚未保存的配置。
- 保存后无需重启服务。密码和 API Key 不会回显;字段提示「已配置」时,留空会保留原值,勾选「清除已保存的密码/API Key」才会清除。
访问地址
这是团队成员访问 CueCast 的地址,用于生成邀请和执行结果通知中的链接。填写浏览器可访问的完整地址,例如:
text
http://192.168.1.10:31790
https://cuecast.example.com只填写协议、域名或 IP,以及可选端口,不包含 /dashboard 等路径、查询参数或账号密码。
保存此地址不会自动配置域名解析、HTTPS 证书、反向代理、防火墙或端口映射。请先完成这些配置,并从成员的电脑确认新地址可以访问。
修改地址后的操作
- 管理员确认新地址可访问,在「实例配置」填写并点击「保存地址」。
- 所有成员使用新地址打开 CueCast;协议、域名或端口变化后,可能需要重新登录。
- 每位使用扩展的成员打开 Chrome 工具栏中的 CueCast 扩展,在「实例地址」填写新地址并保存,再刷新 CueCast 页面。
扩展保存地址前会验证 CueCast 实例。相同实例换址可继续使用;如果地址属于另一个实例,扩展会要求确认切换。团队只换地址时不需要重新安装扩展。
新下载的扩展会自动使用新地址吗?
会。 从私有部署实例页面下载扩展时,下载包会带上下载当时「实例配置」中的访问地址,作为首次安装的默认地址。管理员保存新地址后,后续下载立即使用新地址,无需重启或重新构建。
| 情况 | 扩展使用的地址 |
|---|---|
| 从实例页面下载后首次安装,当前浏览器尚未保存实例地址 | 下载时实例配置中的访问地址 |
| 当前浏览器已经保存过实例地址 | 优先使用该浏览器保存的地址 |
| 管理员修改实例配置中的访问地址 | 不会自动同步到其他成员的扩展;成员需分别修改 |
| 直接使用离线部署包附带的原始扩展 ZIP | 默认 http://127.0.0.1:31790,需手动填写实例地址 |
例如管理员将地址改为 https://cuecast.example.com 后,新成员从实例页面下载并首次安装扩展,默认就会连接这个地址。以前下载的 ZIP 不会跟随变更;已安装扩展有保存地址时,重新下载并更新也不会覆盖它,需要手动修改。
127.0.0.1 指向使用者自己的电脑。团队部署时,请将实例访问地址配置为所有成员都能访问的服务器 IP 或域名。
上述地址设置仅适用于私有部署扩展。云服务扩展连接云服务,不显示实例地址设置。
对象存储
默认使用安装包内置的 MinIO,无需填写云服务账号。执行历史的状态、耗时、错误等记录保存在 MySQL;执行截图、录制原图和上传文件使用对象存储。
需要使用阿里云 OSS 时,在「存储方式」选择「阿里云 OSS」,填写:
| 字段 | 如何填写 |
|---|---|
| Bucket | 已创建的私有 Bucket 名称,如 my-cuecast-bucket |
| Endpoint | OSS 区域服务地址,如 oss-cn-hangzhou.aliyuncs.com;不含 Bucket、路径或端口,仅通过 HTTPS 连接 |
| AccessKey ID | 具有此 Bucket 对象读、写、删除权限的账号 ID |
| AccessKey Secret | 对应密钥;加密保存,不回显。同一 Bucket、Endpoint 和账号留空可保留已存密钥,变更其中任一项需重新填写 |
先点击「测试连接」,再点击「验证并保存存储配置」。两种操作都会创建临时对象,检查上传、读取、内容校验和删除;验证失败时不会切换当前配置。若缺少删除权限,可能留下 .cuecast-connection-test/ 下的临时对象,可在修复权限后清理。连接从 CueCast 后端发起,使用内网 Endpoint 时,部署服务器必须能访问对应 OSS 内网。
保存后无需重启,新上传文件使用新配置;已有文件不自动迁移,继续按原存储位置读取和清理。切换回内置 MinIO 也不会迁移已写入 OSS 的文件。产品保留旧存储配置供历史文件使用,请勿删除旧 Bucket、文件或撤销旧账号权限;密钥轮换时,重新填写同一 Bucket 和 Endpoint 并验证保存即可更新其凭据。
存储方式与「执行记录保留」相互独立;换用 OSS 不改变自动清理期限。界面当前支持内置 MinIO 与阿里云 OSS,不提供历史文件批量迁移或删除旧存储配置的入口。完整备份会包含仍被数据库引用的外部文件,详见备份与恢复。
执行记录保留
| 配置 | 说明 |
|---|---|
| 默认值 | 60 天 |
| 可填写范围 | 0~36500 的整数,单位为天 |
0 | 永久保留,关闭按时间自动清理 |
大于 0 | 自动清理超过该天数的执行结果、计划执行记录和截图 |
后台默认每日运行清理任务,保存配置时不会立即执行一次清理。修改后的设置用于后续清理任务;缩短期限同样适用于已有记录,删除后无法恢复。需要保留的数据请先备份。
此设置不删除用例和录制步骤。已有环境配置在尚未保存页面设置时仍可作为初始值;页面保存后优先使用页面设置。
邮件服务
用于找回密码、邮箱验证和已启用的邮件通知。邮件服务器需要能从 CueCast 所在服务器连接,不能只在管理员的浏览器中可访问。
| 字段 | 如何填写 |
|---|---|
| 启用邮件服务 | 准备使用邮件功能时勾选 |
| SMTP 主机 | 邮件服务商提供的主机名,如 smtp.example.com;不加 https://、路径或端口 |
| 端口 | 与服务商要求的连接加密方式对应 |
| 连接加密 | SSL/TLS 为连接时即启用 TLS,常见端口为 465;STARTTLS 为连接后升级为 TLS,常见端口为 587;不加密 按邮件服务器要求配置 |
| SMTP 用户名 | 通常为发件账号;以服务商提供的信息为准 |
| 发件邮箱 | 收件人看到的发件地址,需被邮件服务器允许使用 |
| SMTP 密码 | 邮件服务商要求的密码或 SMTP 授权码,不一定是邮箱网页登录密码 |
测试方法:先保存邮件服务卡片的配置,再点击「发送测试邮件到我的邮箱」。收件人为当前管理员账号绑定的邮箱;如果该账号尚未绑定邮箱,需要先完成绑定。
收不到邮件时,检查主机、端口、加密方式、账号授权、服务器网络及垃圾邮件目录。仅点击测试邮件按钮不会保存尚未提交的修改。
文本 AI
为文本类 AI 辅助功能提供模型服务。不需要使用时可以保持关闭。
| 字段 | 如何填写 |
|---|---|
| 启用 AI | 使用文本模型时勾选,启用前需填写 API Key |
| OpenAI 兼容接口地址 | 服务的 API 基础地址,如 https://models.example.com/v1;产品会追加 /chat/completions,不要重复填写该后缀 |
| 模型名称 | 服务商实际提供、且当前账号有权限使用的模型标识;按服务商要求准确填写 |
| API Key | 对应该模型服务的访问密钥;已配置时留空保留原值 |
页面的预填模型名称只是默认值,是否可用取决于所接服务和账号权限。地址、模型和 Key 需要来自同一套可用服务;服务必须可从 CueCast 服务器访问。
图片 AI(可选)
为需要图片理解的功能提供视觉模型服务。可以与文本 AI 使用不同的服务和 Key;模型需支持图片输入。
| 字段 | 如何填写 |
|---|---|
| 启用图片识别 | 使用视觉模型时勾选,启用前需填写 API Key |
| 接口地址 | 所选接口格式对应的 API 基础地址,不填写完整的单次调用地址 |
| 模型名称 | 当前服务提供的视觉模型标识 |
| 接口格式 | 选择 OpenAI 兼容 或 DashScope 原生,必须与接口地址及服务支持的协议一致 |
| API Key | 对应该视觉服务的访问密钥;已配置时留空保留原值 |
OpenAI 兼容 格式会在基础地址后追加 /chat/completions;DashScope 原生 格式会追加 /services/aigc/multimodal-generation/generation。切换格式时需要同时核对接口地址,不能只切换下拉框。
保存配置只校验配置格式,不表示模型服务一定可调用。可通过实际使用对应 AI 功能验证连接、模型权限和返回结果。启用外部模型后,相关测试上下文或图片可能发送到所配置的服务,请使用团队认可的服务。
配置的备份与恢复
页面设置保存在实例中,服务密钥加密保存。完整备份包含数据库及实例密钥,请一起保管;恢复时当前实例的访问地址按备份与恢复说明处理。
浏览器扩展的地址保存在各成员的浏览器中,不会随服务器配置自动同步,也不属于服务器完整备份中的成员浏览器配置。
