Octop COS/S3 远程存储后端完整指南3 步把 Agent 工作区送上云【免费下载链接】OctopA smarter, self-hosted AI assistant — multi-user, multi-agent.项目地址: https://gitcode.com/GitHub_Trending/oct/OctopOctop是一个更聪明、可自托管self-hosted的多用户、多智能体 AI 助手。除了开箱即用的本地存储Octop 内置了COS/S3 远程存储后端能力在管理后台填入对象存储的密钥与桶信息就能把每个 Agent 的工作区文件SOUL.md、技能、工作文档等直接落到腾讯云 COS、AWS S3、MinIO 等云端对象存储上实现工作区上云、数据安全可备份、多机共享同一份 Agent 记忆。本文面向新手用通俗的方式讲清楚 Octop 远程存储后端支持哪些类型、如何一键配置 COS/S3、以及如何把它绑定给 Agent。为什么要把 Agent 工作区上云Agent 的人格和知识都以文件形式存放在工作区目录里默认落在服务器本地的~/.octop/agents/agent_id/。这带来三个常见痛点怕丢磁盘故障、误删、重装系统Agent 人设与积累的技能文件可能全部消失难迁移换服务器后Agent 的记忆需要手动搬运不好共享多台机器无法直接共享同一个 Agent 工作区。Octop 的远程存储后端把内容文件的读写通道从本地磁盘切换成云对象存储而Agent 看到的路径完全不变——这正是它设计上最聪明的地方只换 I/O 通道不换路径详见 docs/agent-backend-file-io.md。对 Agent 来说读写的依然是/SOUL.md、/skills/xxx/SKILL.md这样的路径背后却已经写到了云端。Octop 支持哪些远程存储类型Octop 在 dashboard/src/pages/Admin/Storage/useStorageBackends.tsx 中预置了 10 种存储类型对象存储相关的有 5 种类型说明典型用途COS腾讯云对象存储原生支持走 COS 协议国内自建、低延迟访问S3通用 S3 兼容协议AWS S3、MinIO、R2 等海外对象存储、自建 MinIOOSS阿里云对象存储阿里云用户OBS华为云对象存储华为云用户Custom自定义 S3 兼容端点私有对象存储网关此外还支持filesystem本地目录、shell、docker、opensandbox远程沙箱和postgres数据库等类型全部走同一套管理界面。类型到实际后端参数的映射逻辑见 src/octop/infra/backend/adapter.py。如何一键配置 COS 远程存储后端整个配置流程在 Web 管理后台完成无需碰代码进入存储管理页以管理员身份登录 Octop在左侧「管理」分组中找到存储菜单即 dashboard/src/pages/Admin/Storage/index.tsx 对应的页面选择预设类型页面分「我的存储」和「支持的类型」两个标签页在类型卡片上点击COS系统会自动锁定类型并带出该类型专属的字段表单填写 4 个必填项 1 个可选项Access KeySecretId形如AKIDxxxSecret KeySecretKey形如SKEYxxxBucket桶名如my-bucket-1250000000Region地域如ap-guangzhouEndpoint选填如cos.ap-guangzhou.myqcloud.comCOS 类型下可留空由 SDK 推导保存并探测Octop 会对配置执行一次真实的「写入→读取」回环探测连通性由 src/octop/infra/backend/probe.py 保证返回ok: true即代表密钥、桶名、权限全部正确。 小提示探测接口同时支持未保存的表单值直接试连/probe端点意味着你可以先探测、满意了再保存避免把坏配置写进数据库。所有 API 定义见 src/octop/api/routers/storage_backends.py。S3 / MinIO 兼容后端怎么配如果你的对象存储是AWS S3、MinIO或其他 S3 兼容服务选S3或Custom类型即可字段与 COS 类似但有一个关键差异Endpoint 建议显式填写。填写时如果不带协议前缀如minio.example.com:9000Octop 会自动补上https://前缀见 adapter.py 中endpoint_url的构造逻辑Region对 AWS S3 是必填的如us-east-1对 MinIO 可填任意占位值Custom 类型额外允许在config_json中透传其他 S3 客户端参数覆盖默认行为。一次探测通过 上传下载链路打通后续 Agent 的所有文件读写都会走这条云端通道。如何把存储后端绑定给 Agent配置好存储后端只是装好了硬盘还需要让 Agent 用上它。Octop 提供了两种优雅的方式见 src/octop/infra/backend/resolver.py① 命名引用named ref在 Agent 的config.backend中引用存储后端的名称例如把后端命名为my-cosAgent 配置一个指向my-cos的引用即可。名称变更或后端调整时所有引用它的 Agent 自动跟随无需逐个修改。② 组合路由composite更高级的玩法一个 Agent 可以同时挂多个后端按路径前缀路由——比如把/docs/目录映射到 S3其余文件留在本地filesystem。这让你可以热数据上云、冷数据留本地自由组合。在「专家」页面从模板新建 Agent 时就可以在配置里指定上述远程后端。整体架构上远程后端S3、COS 等在 Agent 启动时即完成挂载详见 docs/architecture.md。远程工作区如何查看与管理配置完成后管理后台对每个远程后端都提供了几样安心能力目录浏览/tree接口可以逐级浏览桶内目录树实现见 src/octop/infra/backend/browse.py随时确认 Agent 写进去的文件密钥脱敏列表和详情接口中secret_key永远不会返回access_key也只显示前 4 位加星号密钥安全有保障引用保护如果某个存储后端正被 Agent 引用删除操作会被直接拒绝并列出引用它的 Agent 名单防止删了存储、Agent 集体失联的意外一键测试对已保存的后端可再次发起/test探测密钥轮换后随手验证连通性。新手常见问题Q1配置远程后端后本地还会残留文件吗内容文件模板、SOUL、技能等会统一改走后端通道读写而 checkpoint、会话 JSONL、记忆数据库等本地产物仍保留在本地workspace_dir这是有意为之的设计见 docs/agent-backend-file-io.md 的范围说明。Q2COS 和 S3 类型怎么选用腾讯云 COS 就选COS原生协议字段最少其他对象存储AWS、MinIO、R2……一律选S3或Custom填对 Endpoint 即可。Q3密钥泄露怎么办直接在编辑表单中留空 Secret Key 表示不修改填入新值则覆盖建议为 Octop 单独创建最小权限的密钥只授予目标桶的读写权限。总结Octop 把Agent 工作区上云这件事做到了极简选类型 → 填四个字段 → 点一次探测COS/S3/OSS/OBS/MinIO 全部通吃。再配合命名引用和组合路由多用户团队可以轻松实现工作区集中备份、跨机迁移与多 Agent 共享。如果你的自托管 AI 助手还在担心磁盘故障或迁移成本这套远程存储后端值得第一个配置。【免费下载链接】OctopA smarter, self-hosted AI assistant — multi-user, multi-agent.项目地址: https://gitcode.com/GitHub_Trending/oct/Octop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考