Obico 服务器

这个仓库包含运行自托管 Obico 服务器所需的一切。

Obico 是一个由社区构建的开源智能 3D 打印平台，被全世界的创客、爱好者和工匠使用。

该项目中的 AI 故障检测基于深度学习模型。查看模型在真实数据上的工作原理。

安装并运行服务器

注意：有关更详细的说明，请参阅 Obico 服务器指南。

先决条件

Obico 服务器只需要一台电脑即可运行。即使是过去 10 年内的旧电脑也足够了。Nvidia GPU 是可选的，但可以大大增加功耗并提升服务器可处理的打印机数量。

详细的硬件最低规格。

软件要求

在开始安装服务器之前，需要安装以下软件：

• Docker 和 Docker-compose。但你不需要了解 Docker 或 Docker-compose 的工作原理。
  • 安装 Docker（Windows、Ubuntu、Fedora、CentOS、Mac）。**重要提示：**如果你的服务器安装了旧版本的 Docker，请按照这些链接中的说明升级到最新版本，否则可能会遇到各种奇怪的问题。
  • 安装 Docker-compose。你需要 Docker-compose V2.0 或更高版本。
• git（如何安装）。

电子邮件发送

你还需要一个启用了 SMTP 访问的电子邮件账户（Gmail 无法使用。自 2022 年 5 月 30 日起，Google 已移除允许 SMTP 访问的选项）。其他网络邮件如 Yahoo 应该可以使用，但我们没有尝试过。

获取代码并启动服务器

1. 获取代码：

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

2. 运行它！根据你使用的操作系统，执行以下任一命令：

   • 如果你使用 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

3. 去喝杯咖啡吧。第 2 步将花费 15-30 分钟。

4. 没有第 4 步。启动 Obico 就是这么简单（感谢 Docker 和 Docker-compose）。

在同一台电脑上打开 "http://localhost:3334"。瞧 - 你的自托管 Obico 服务器现在已经启动并运行了！

服务器配置

新安装后，Obico 服务器只能在本地主机上工作。你需要配置其 IP 地址。方法如下：

获取服务器的 IP 地址

推荐阅读：使用 .local 地址连接到你的服务器

这指的是分配给运行 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 管理员

1. 在 http://your_server_ip:3334/admin/ 打开 Django 管理页面。

注意：如果浏览器提示"无法连接到服务器"，请再等几分钟。Web 服务器容器可能仍在启动。

2. 使用用户名 root@example.com，密码 supersecret 登录。登录后，你可以选择（但强烈建议）使用此链接更改管理员密码：http://your_server_ip:3334/admin/app/user/1/password/。

配置 Django 站点

1. 在同一浏览器窗口中，访问 http://your_server_ip:3334/admin/sites/site/1/change/。将"域名"更改为 your_server_ip:3334。不要加 "http://"、"https://" 前缀或末尾的 "/"，否则将无法工作。注意：由于 Django 站点的特殊性，删除原始站点并添加新站点是不行的。

2. 点击"保存"。是的，Django 并不像大多数人想象的那么智能。;)

注意：如果你使用反向代理，"域名"需要设置为 reverse_proxy_ip:reverse_proxy_port。详情请参阅使用反向代理。

就是这样！你现在拥有了一个功能齐全的 Obico 服务器，你的 OctoPrint 可以与之通信。我们希望设置服务器的过程不会让你感到困难。

配置客户端使用自托管 Obico 服务器

• Obico for OctoPrint 插件。
• Obico 移动应用。

为 Obico 做贡献

感到兴奋吗？想要贡献？看看如何做。

在启动和运行 Obico 服务器时遇到困难？

浏览并搜索 Obico 服务器指南网站。如果你在那里找不到答案，可以咨询 Discord 或提出问题。

感谢

BrowserStack 慷慨地赞助了一个免费许可证，使我能够在不同的浏览器/版本上测试 Obico 网络摄像头流。 Moonraker 提供了提取 G 代码元数据的源代码。