数据、部署与恢复
区分本机与远程部署,理解密钥、历史清除和恢复的实际边界。
本机与远程
本机单用户通过 wrok-bot-server --local 运行。远程服务仍监听loopback,必须经同机TLS反向代理提供HTTPS。配置 WROK_BOT_PUBLIC_URL 与 WROK_BOT_TLS_PROXY_SECRET;后者要求64位小写十六进制字符,应安全生成并仅供代理与服务端使用。
代理丢弃客户端传入的 x-wrok-bot-proxy-secret、x-forwarded-proto、x-forwarded-host,再写入唯一的共享秘密、https和公共URL的精确authority(包括明确配置的端口)。只转发实际通过HTTPS到达的请求。只配置公共URL不构成授权。
数据与密钥
PostgreSQL数据、应用密钥、凭据Vault及发行身份彼此关联。已有数据缺少密钥时不能生成一个新密钥冒充恢复。不要在排障中删除锁、替换数据库或混用另一个安装的数据目录。
历史与成果
关闭历史、排空在途运行、清除历史正文、删除成果和恢复是不同操作。当前主线已经有相应的有限实现,但不能据此声称完整GUI入口或全部恢复旅程已验收。先确认目标、权限、在途状态和保存范围,再使用对应入口。
备份与恢复
桌面完整PostgreSQL恢复已有主线交付,仍有双账户平台演练及系统凭据检查待完成。只有匹配发行版本、已验证的备份产物和对应恢复流程可作为恢复依据。不要把测试fixture或单独复制的数据库目录当正式可恢复备份。
日志与隐私
分享诊断时保留版本、错误及必要状态,去掉凭据、个人会话和私有文档。安全机制返回未知或未就绪时,应查明原因,不通过放宽前端或关闭后端校验获得“可用”状态。