Files

34 lines
3.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 运维与安全说明
## 初始化和使用
先配置 `.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 尚无适配器或凭证配置;未进行真实外部服务联调。需要对应阶段补充完整适配器、凭证加密、连接测试、错误状态、幂等与测试报告。