Obico 服务器
这个仓库包含运行自托管 Obico 服务器所需的一切。
Obico 是一个由社区构建的开源智能 3D 打印平台,被全世界的创客、爱好者和工匠使用。
该项目中的 AI 故障检测基于深度学习模型。查看模型在真实数据上的工作原理。
安装并运行服务器
注意:有关更详细的说明,请参阅 Obico 服务器指南。
先决条件
Obico 服务器只需要一台电脑即可运行。即使是过去 10 年内的旧电脑也足够了。Nvidia GPU 是可选的,但可以大大增加功耗并提升服务器可处理的打印机数量。
软件要求
在开始安装服务器之前,需要安装以下软件:
- Docker 和 Docker-compose。但你不需要了解 Docker 或 Docker-compose 的工作原理。
- git(如何安装)。
电子邮件发送
你还需要一个启用了 SMTP 访问的电子邮件账户(Gmail 无法使用。自 2022 年 5 月 30 日起,Google 已移除允许 SMTP 访问的选项)。其他网络邮件如 Yahoo 应该可以使用,但我们没有尝试过。
获取代码并启动服务器
- 获取代码:
git clone -b release https://github.com/TheSpaghettiDetective/obico-server.git
-
运行它!根据你使用的操作系统,执行以下任一命令:
- 如果你使用 Linux:
cd obico-server && sudo docker compose up -d
- 如果你使用 Mac:
cd obico-server && docker-compose up -d
- 如果你使用 Windows:
cd obico-server; docker-compose up -d
- 如果你使用 Linux:
-
去喝杯咖啡吧。第 2 步将花费 15-30 分钟。
-
没有第 4 步。启动 Obico 就是这么简单(感谢 Docker 和 Docker-compose)。
在同一台电脑上打开 "http://localhost:3334"。瞧 - 你的自托管 Obico 服务器现在已经启动并运行了!
服务器配置
新安装后,Obico 服务器只能在本地主机上工作。你需要配置其 IP 地址。方法如下:
获取服务器的 IP 地址
这指的是分配给运行 Obico 服务器的计算机的局域网 IP 地址。
- 如果你使用 Linux:打开 WiFi 设置,选择当前连接的网络的"设置"。查找 IPv4 值。
- 如果你使用 Windows:选择当前连接的网络的"属性",然后查找 IPv4 值。
- 如果你使用 Mac:进入设置 > 网络。你会在 WiFi 状态下方找到 IPv4 值。
Obico 服务器需要有一个可被 OctoPrint 或 Klipper 访问的 IP 地址。它可以是私有 IP 地址(192.168.x.y 等),但 OctoPrint 和 Obico 服务器之间需要有一个路由。
还建议设置静态 IP 以避免 IP 变化带来的问题。请查阅你的 WiFi 路由器指南了解如何操作。
登录为 Django 管理员
- 在
http://your_server_ip:3334/admin/
打开 Django 管理页面。
注意:如果浏览器提示"无法连接到服务器",请再等几分钟。Web 服务器容器可能仍在启动。
- 使用用户名
root@example.com
,密码supersecret
登录。登录后,你可以选择(但强烈建议)使用此链接更改管理员密码:http://your_server_ip:3334/admin/app/user/1/password/
。
配置 Django 站点
-
在同一浏览器窗口中,访问
http://your_server_ip:3334/admin/sites/site/1/change/
。将"域名"更改为your_server_ip:3334
。不要加 "http://"、"https://" 前缀或末尾的 "/",否则将无法工作。注意:由于 Django 站点的特殊性,删除原始站点并添加新站点是不行的。 -
点击"保存"。是的,Django 并不像大多数人想象的那么智能。;)
注意:如果你使用反向代理,"域名"需要设置为 reverse_proxy_ip:reverse_proxy_port
。详情请参阅使用反向代理。
就是这样!你现在拥有了一个功能齐全的 Obico 服务器,你的 OctoPrint 可以与之通信。我们希望设置服务器的过程不会让你感到困难。
配置客户端使用自托管 Obico 服务器
为 Obico 做贡献
感到兴奋吗?想要贡献?看看如何做。
在启动和运行 Obico 服务器时遇到困难?
浏览并搜索 Obico 服务器指南网站。如果你在那里找不到答案,可以咨询 Discord 或提出问题。
感谢
BrowserStack 慷慨地赞助了一个免费许可证,使我能够在不同的浏览器/版本上测试 Obico 网络摄像头流。 Moonraker 提供了提取 G 代码元数据的源代码。