# 运维与安全说明 ## 初始化和使用 先配置 `.env` 再运行 `scripts/start.ps1`。没有默认管理员密码。引导流程锁定已有配置行,检查管理员是否已经存在,在事务中创建用户、角色关联与初始审计。多副本同时启动不会创建多个初始超级管理员。引导邮件与已有普通用户冲突时拒绝启动,防止自动提权。 用户注册后登录。项目页面保存需求、选择技术栈,可编辑和归档。账户页管理显示名称、密码、会话和登录记录。管理员通过单独管理导航管理用户、配置和审计。停用用户会撤销全部会话,不能停用自己或通过普通状态接口停用超级管理员。 ## 生产部署前必须完成的工作 当前只交付开发 Compose;后续生产部署需另建配置并在测试环境验证: - TLS 入口、可信代理清单与真实客户端 IP 的安全传递。当前后端不信任 X-Forwarded-For,Docker 网关下多个用户可能共享一个限流 IP。不要直接打开无限制 forwarded-header 信任。 - PostgreSQL 专用应用账户、最小权限迁移账户、数据库审计权限分离。当前账表审计是应用追加写入,尚未配置数据库级不可修改角色。 - 密钥托管、轮换、访问控制、日志与数据保留策略、可恢复的离线备份。 - Redis 高可用和容量;noeviction 防止验证码和限流键因内存淘汰悄然失效。Redis 不可用时认证不得降级为无验证。 - 会话令牌只能经 HTTPS 发送,禁止缓存 API 响应。sessionStorage 仍需依赖严格防 XSS;此处未使用 HTML 字符串渲染用户内容。 - 用户注册目前只支持图形验证码;邮箱真实性未确认。邮件 / 短信验证与密码找回必须在适配器完成后再开放。 - 图形验证码不是完整反机器人系统;公网运营还需要边界限流、异常检测和账户风控。 - 密码强度与请求限额当前为代码默认值;后台可配置策略是后续事项。 - 尚未实现法律文案管理、细粒度角色授权编辑、会话定时清理、登录日志检索与长期保留任务。 后台审计写入 actor、action、target、ip、变化详情和时间。当前成功变更被审计;权限拒绝、失败操作的独立审计、安全事件中心尚未完成。不要将当前状态作为生产安全验收通过。 ## 备份和恢复 `scripts/backup.ps1` 使用 pg_dump 自定义格式,Docker cp 避免 Windows PowerShell 管道破坏二进制备份。覆盖平台 PostgreSQL,不覆盖 S3 对象、容器卷或后续用户项目数据库。备份包含邮箱与密码摘要等敏感数据,需限制访问并进行离线加密。 恢复前先创建**独立测试数据库**,复制 dump 到数据库容器,再使用 `pg_restore --no-owner --no-privileges -U <账户> -d <测试数据库> <文件>`。不能对真实用户生产库盲目执行 `--clean`。验证用户、项目、角色和审计关联完整后,才制定正式维护窗口和生产恢复方案。本次未进行真实 PostgreSQL 备份恢复演练。 ## 后续基础设施边界 控制面不挂载 Docker Socket,不执行用户 shell。AI Worker 和 Kubernetes 隔离执行网关已提供,真实隔离集群仍待验收;正式构建发布、节点监控和调度服务尚未实现。不能将后端容器的 Docker 管理权限作为快捷实现。模型供应商已有加密配置和协议适配器;ESA、DNS、支付、SMTP、SMS 尚无适配器或凭证配置;未进行真实外部服务联调。需要对应阶段补充完整适配器、凭证加密、连接测试、错误状态、幂等与测试报告。