★ FEATURED ARTICLE 【免费下载链接】octo-server The Go backend powering OCTO — an open workplace built for humans × AI agents. REST WebSocket APIs, Lobster (AI agent) orchestration, and WuKongIM real-time messaging control plane.项目地址https://gitcode.com/gh_mirrors/oc/octo-server点击查看免费下载octo-server 是一个 Go 语言后端为 OCTO 平台提供 REST / WebSocket API、AI 智能体Lobster编排和 WuKongIM 即时消息控制平面。本文带你用 Docker Compose 在 5 分钟内一键搭建完整的 IM AI 工作台并附上本地构建二进制的备选方案。两种部署方案怎么选方案适用人群复杂度结果方案一Docker Compose 一键部署想快速体验 OCTO 的用户⭐server web admin WuKongIM MySQL Redis MinIO nginx 全家桶方案二本地 Go 构建后端开发者、需二次定制⭐⭐⭐单个octo-server二进制 / Docker 镜像对接你已有的 WuKongIM MySQL官方文档明确建议如果只是想试试 OCTO选方案一详见 QUICKSTART.md。方案一Docker Compose 一键部署推荐1. 环境准备部署前确保服务器已安装Docker与Docker Compose插件至少 4GB 空闲内存MySQL、Redis、MinIO、WuKongIM、octo-server 等十余个容器同机运行2. 获取部署仓库并初始化官方 OOTB开箱即用部署统一维护在Mininglamp-OSS/octo-deployment仓库中本仓库内旧的docker/octo/、docker/tsdd/组合已下线以该仓库为唯一事实来源。克隆后执行交互式初始化脚本它会引导你生成docker/.envgit clone https://github.com/Mininglamp-OSS/octo-deployment.git cd octo-deployment ./setup.sh # 交互式自动生成 docker/.env3. 一条命令启动整套服务cd docker docker compose up -d docker compose ps # 等待所有服务变为 (healthy)服务栈默认监听http://octo.local:28080由.env中的OCTO_DOMAIN与OCTO_HTTP_PORT控制浏览器打开即可开始使用。⚠️ 同一台主机上如果已跑过另一套 OCTO 栈请先阅读部署仓库的 docker README 中pre-flight章节再执行任何down -v操作避免误删数据卷。方案二本地构建 octo-server 二进制适合后端开发者基于本仓库做二次开发。1. 克隆仓库并编译前置依赖Go ≥ 1.25见 go.mod、一台可访问的 WuKongIM ≥ v2、MySQL 8、Redis 7可选 S3 兼容对象存储。git clone https://gitcode.com/gh_mirrors/oc/octo-server cd octo-server go build -o octo-server .注意go build ./...只编译检查、不产出可执行文件必须用-o octo-server .显式构建根 main 包。若出现missing go.sum entry报错参考 BUILDING.md 的跨仓库replace解决方式。2. 用 Dockerfile 构建容器镜像仓库内置 Dockerfilegolang:1.25多阶段构建 alpine:3.21运行时静态编译、时区Asia/Shanghai镜像体积极小。也可直接使用 Makefile 目标make build # 等价于 docker build -t octo-server .3. 修改配置文件复制模板 configs/tsdd.yaml 后按注释逐项填写你自己的基础设施地址核心字段包括db.mysqlAddr/db.redisAddr— MySQL 与 Redis 连接串wukongIM.apiURL/wukongIM.managerToken— 悟空IM 控制平面注意 YAML 键名是apiURL而非urlminio.*等对象存储段 — S3 端点、凭据与桶布局环境变量OCTO_DEFAULT_LANGUAGEzh-CN可让未携带语言头的客户端默认收到中文提示4. 启动并冒烟测试--config旗标必须写在子命令之前./octo-server --config /path/to/tsdd.yaml api # 冒烟检查返回 {status:ok} 即成功 curl http://localhost:8090/v1/ping部署后验证与首次体验1. 注册第一个用户浏览器打开 OCTO Web 页面或直接用 REST API 注册curl -X POST http://localhost:8090/v1/user/register \ -H Content-Type: application/json \ -d {phone:8613800000000,password:test1234,name:Admin}2. 接入 AI AgentLobster 数字分身安装守护进程需 Node.js ≥ 18npm install -g mininglamp-oss/octo-daemon在 OCTO Web 左侧栏打开Runtimes页面 → 点击→创建 Runtime按提示复制安装命令并执行守护进程会自动注册到服务端Runtime 随即出现在你的设备树中。3. 看看部署成果部署成功后你得到的是一套支持 PC / Web / iOS / Android 多端登录、群聊、文件传输的即时通讯 AI 工作台常见问题排查症状原因与解决端口冲突在docker/.env中覆盖OCTO_HTTP_PORT、OCTO_WEB_PORT等变量完整列表见部署仓库 READMEWuKongIM 不健康检查wk.yaml的tokenAuthOn/managerToken是否与 octo-server 的wukongIM.managerToken一致token 漂移是最常见原因Go 构建报missing go.sum entry参见 BUILDING.md 中跨仓库replace方案文件上传 403对象存储桶需配置浏览器直传 CORS 规则详见 configs/tsdd.yaml 中的 SigV4 / 预签名说明停止与重置docker compose down # 停止容器保留数据 docker compose down -v # 停止并删除数据卷破坏性操作慎用总结快速体验克隆octo-deployment→./setup.sh→docker compose up -d5 分钟拥有完整 IM AI 工作台二次开发go build -o octo-server .或make build产出二进制 / 镜像配合 configs/tsdd.yaml 对接自有基础设施完整上手流程见 QUICKSTART.md构建细节见 BUILDING.md部署完成后建议依次验证/v1/ping、用户注册、Web 登录、AI Runtime 接入四步全部通过即代表你的 octo-server 已可投产使用 赞分享【免费下载链接】octo-server The Go backend powering OCTO — an open workplace built for humans × AI agents. REST WebSocket APIs, Lobster (AI agent) orchestration, and WuKongIM real-time messaging control plane.项目地址https://gitcode.com/gh_mirrors/oc/octo-server点击查看免费下载相关推荐3分钟部署Parse ServerDocker Compose一键启动全服务指南3分钟部署Parse ServerDocker Compose一键启动全服务指南 你是否还在为手动配置Parse Server开发环境而头疼繁琐的依赖安装、后端认证鉴权5分钟跑通FIM OneDocker Compose一键部署企业级AI Agent平台完整指南5分钟跑通FIM OneDocker Compose一键部署企业级AI Agent平台完整指南 FIM One 是一款开源、可自托管的企业级 AI AgentSeata测试环境搭建Docker Compose一键部署Seata测试环境搭建Docker Compose一键部署 你是否还在为分布式事务测试环境的繁琐配置而烦恼手动安装数据库、配置服务参数、调试网络连接耗费大量后端微服务创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
