octo-server

环境要求

• Go 语言环境（README 使用 go build 编译，未指定具体版本）
• MySQL 兼容的数据库实例
• 本地运行的 WuKongIM 实例（默认开发配置要求）
• 已准备好的配置文件 configs/tsdd.yaml

安装与启动步骤

1. 1克隆仓库

   把 octo-server 源码拉到本地，README 的 Quickstart 第一步就是克隆官方仓库。

   git clone https://github.com/Mininglamp-OSS/octo-server.git

   复制

2. 2进入项目目录

   切换到克隆下来的源码目录，后续编译和启动都在这里执行。

   cd octo-server

   复制

3. 3编译服务

   用 Go 直接编译出可执行文件 octo-server，README 未说明版本要求，建议使用较新的 Go。

   go build -o octo-server .

   复制

4. 4准备运行依赖

   默认开发配置需要本地 WuKongIM 实例和 MySQL 兼容数据库，请先启动它们并确认连接信息正确。

5. 5检查配置文件

   确认仓库自带的 configs/tsdd.yaml 模板已按你的数据库和 WuKongIM 地址改好，再用于启动。

6. 6启动服务

   以 tsdd.yaml 为配置启动 octo-server，进程正常运行即代表后端已起来。

   ./octo-server --config ./configs/tsdd.yaml

   复制

关键配置

如何确认成功

执行启动命令后进程持续运行且无报错，客户端可通过 REST 与 WebSocket 接口连上服务。

常见问题

注意事项

• README 未给出端口号、数据库名、默认账号等细节，请查阅仓库内 QUICKSTART.md 与 configs/tsdd.yaml 模板。
• 旧版 docker/octo/ 和 docker/tsdd/ 的 Compose 编排已废弃，官方推荐统一使用 octo-deployment 仓库。
• 本项目采用 Apache 2.0 许可，可自托管部署。
• octo-server 是 OCTO 平台后端，前端与管理端分别为 octo-web、octo-admin。