TheSpaghettiDetective/obico-server

这是什么？

核心功能

• 01自托管服务端，打印数据与摄像头视频保存在本地
• 02基于深度学习的 AI 打印故障检测
• 03通过 Obico 插件对接 OctoPrint 与 Klipper 打印机
• 04使用 Docker Compose 部署，可选 Nvidia GPU 加速
• 05支持通过额外的 Compose 配置使用 RK3588 NPU 加速

适用场景

• 在局域网内监控家用 3D 打印机，避免视频上传到云端
• 为 OctoPrint 或 Klipper 打印任务运行 AI 故障检测
• 为创客空间或小型打印机群搭建私有 Obico 实例

快速上手

1. 1

   从 GitHub 克隆 release 分支

   git clone -b release https://github.com/TheSpaghettiDetective/obico-server.git
2. 2

   使用 Docker Compose 启动服务器（Linux）

   cd obico-server && sudo docker compose up -d
3. 3

   首次启动需等待 15-30 分钟，然后在浏览器中打开 http://localhost:3334

使用前须知

• !需要安装 Docker 和 Docker Compose V2 或更高版本，并需要一个开启 SMTP 的邮箱账户（Gmail 不可用）。
• !README 中公开了默认管理员账号和密码，部署后必须修改管理员密码。
• !首次使用前需要配置服务器 IP 和 Django 站点域名，OctoPrint 才能连接。

收录于专题

标签

常见问题

obico-server 是什么？

开源智能 3D 打印平台 Obico 的可自托管服务端，支持 OctoPrint 与 Klipper 打印机的 AI 故障检测。 Obico Server 是开源 3D 打印监控平台 Obico 的自托管后端。部署后，OctoPrint 或 Klipper 打印机可以连接到你自己控制的服务器，打印数据和摄像头视频流都保存在本地硬件上，而不必依赖托管服务。

obico-server 可以免费使用吗？用的什么许可证？

obico-server 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

obico-server 还在维护吗？

活跃维护中。obico-server 最近一次提交是在 2026年11月6日。

obico-server 适合用来做什么？

在局域网内监控家用 3D 打印机，避免视频上传到云端 为 OctoPrint 或 Klipper 打印任务运行 AI 故障检测 为创客空间或小型打印机群搭建私有 Obico 实例

obico-server 怎么安装和运行？

从 GitHub 克隆 release 分支: git clone -b release https://github.com/TheSpaghettiDetective/obico-server.git 使用 Docker Compose 启动服务器（Linux）: cd obico-server && sudo docker compose up -d 首次启动需等待 15-30 分钟，然后在浏览器中打开 http://localhost:3334

在哪里获取 obico-server？

源代码和安装说明在 GitHub 上：https://github.com/TheSpaghettiDetective/obico-server