Octop 入门：用户、代理与消息渠道共享的自托管助手
部署 Octop：持久状态与单进程控制平面
团队接入前规划备份、监听权限与恢复过程。
部署 Octop：持久状态与单进程控制平面知识学习CN编辑简报更新 2026-09-23
你将学会
- 登记全部持久状态
- 审阅服务边界
- 推广前演练恢复
开始前需要
- 基本 Python 与服务管理知识
- 隔离的试验环境
用只读状态台账，在启用能力前显示尚未验证的边界。
先看结论
- 备份必须符合真实布局。
- 配置类默认不自动备份。
- 本地恢复不能撤回消息。
登记全部持久状态
架构把控制数据库与各代理工作区分开，只备份数据库可能漏掉文档、技能或本地会话文件。应先核对实际后端布局再制定备份范围。
配置类默认关闭自动备份，默认备份选择也不包含聊天记录。这些默认值不能证明任何现有部署已经拥有完整可恢复副本。
审阅服务边界
README 提供系统服务入口和 Docker 打包，先选择一种运维方式，并记录包或镜像版本、持久卷、凭据位置以及实际监听设置。
启动代码组合领域服务、FastAPI 与 uvicorn。双监听 TLS 模式在这里强制单 worker 并关闭 reload，不能假定增加 worker 就实现安全横向扩展。
推广前演练恢复
恢复演练期间停止新的渠道与定时工作，在独立环境恢复兼容的数据库和工作区，再核对所有权与已知任务，之后才接收真实流量。
本系列没有执行备份恢复或生产部署。外部动作需要单独台账，恢复本地状态不能收回已经通过消息渠道发送出去的内容。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
登记数据库和工作区。
- 2
记录服务、监听和版本。
- 3
扩大访问前验证恢复演练。
可复制示例
yaml
deployment_record:
version: pinned
database: inventoried
workspaces: inventoried
listener: reviewed
restore_drill: required-before-rollout常见问题
只导出数据库就够吗？
不一定，工作区和其他内容可能在数据库之外。
worker 参数证明能横向扩展吗？
不能，需要核查单进程共享职责并测试具体拓扑。
资料来源
- Octop / README.md来源核查 2026-09-23
- Octop / docs/architecture.md来源核查 2026-09-23
- Octop / src/octop/config.py来源核查 2026-09-23
- Octop / src/octop/launch.py来源核查 2026-09-23