运维与安全

日常检查

docker compose ps
docker compose logs --tail 200 remoteci
Invoke-RestMethod https://remoteci.example.com/api/health

同时在管理页面确认插件在线、手表连接数和最近一次课表同步时间。

SQLite 数据库包含账号、权限、会话和插件凭据。为避免复制到一半的数据库，建议短暂停止容器后备份整个数据目录：

docker compose stop remoteci
Copy-Item -Recurse .\data ".\backup\data-$(Get-Date -Format yyyyMMdd-HHmmss)"
docker compose start remoteci

备份文件与生产数据库具有同等敏感性，应加密保存并限制访问。

不要在容器运行时直接覆盖 SQLite 文件。

服务端、插件和手表使用三种不同的升级方式：

服务端：管理员登录 WebUI 后，在“系统配置 → 系统更新”选择正式版或 Beta 渠道并点击“检查更新”。正式版排除预发布，Beta 同时包含正式版和预发布；启用强制更新后可重新下载并覆盖同一版本，但不会降级。Docker 会就地替换后由 restart: unless-stopped 重新启动；Windows 与裸机 Linux 会启动独立更新器，等待旧进程退出和文件锁释放后再替换实际程序集目录并自动重启。更新前会核对包内服务端版本与 release 标签。Visual Studio 或 dotnet run 的 Development 环境由构建工具管理，WebUI 会禁用在线覆盖更新，避免 release 写入源码目录。
插件：不做内置更新界面，由 ClassIsland 插件市场统一管理；每个 release 都附带 CIPX 与 checksums，指向 release 地址即可自动拉取新版本。
手表：连接 WebUI 后，在“设置 → 更新”选择正式版或 Beta 渠道；可强制重新下载并覆盖同一版本，但不能降级，且目标始终不得高于该 WebUI 版本；通过系统安装器覆盖安装时要求发布包与当前安装包签名一致。
飞牛 fnOS：WebUI 只显示“由fnOS应用商店管理”，检查和升级均由 fnOS 应用商店完成。

账号页的“修改密码”与“系统更新”是独立表单：检查或执行更新不会校验空密码字段，只有提交密码修改按钮时才会校验当前密码和新密码。

升级前应先备份数据库卷，且尽量让三端保持同一版本，避免协议版本不一致。

手动升级服务端时：

docker compose stop remoteci
# 先备份 remoteci-data 卷，再构建或拉取新镜像。
docker compose up -d
docker compose logs --tail 200 remoteci

公网入口仅开放 443，并启用有效 HTTPS 证书。
8080 只绑定到回环地址或受信任的容器网络。
初始密码至少 8 位，实际部署建议使用随机长密码。
不在 Compose 文件、截图或问题反馈中公开密码、令牌和配对码。
普通用户按最小权限分配，设备丢失后立即撤销会话。
“老师来了”（TeacherComing）单独保护快捷提醒；“发送与清除通知”（SendNotifications）保护自定义通知和清除提醒；“主界面与电源控制”（SystemControl）保护主界面显隐、音量与电源操作。
定期备份并实际演练恢复。
定期更新服务端镜像、插件和手表应用。