albarreto/octopi-armhf

octopi-armhf镜像文档

镜像概述

octopi-armhf是基于ARM架构的OctoPrint容器镜像，专为3D打印机远程管理设计。该镜像已在Raspberry Pi 2/3/4及TV Box设备（如TX3 Mini/Mini+、Q96 Max）上测试验证，提供稳定的3D打印管理环境。

核心功能与特性

• 核心组件：
  • OctoPrint 1.10.1（基于Python 3.10.14）
  • CuraEngine 15.04.6（路径：/opt/CuraEngine/build/CuraEngine）
  • Slic3d（路径：/usr/bin/slic3r）
  • ffmpeg（路径：/usr/bin/ffmpeg）
• 推荐插件：FullSlicer、BetterHeaterTimeout、Obico、UI Customizer、Navbar Temperature、MultiColors
• 基础系统：Ubuntu Debian Bullseye（更新于2025-01-06）

使用场景

• 3D打印机远程监控与管理
• 多OctoPrint实例共享STL文件存储
• 嵌入式设备（如树莓派、TV Box）上的3D打印控制中心

使用方法

基本启动命令

bash
docker run -it -p 5000:80 --name=octopi --restart=unless-stopped -d --device /dev/ttyUSB0 albarreto/octopi-armhf:latest

推荐启动命令（带数据持久化）

bash
sudo docker run -d -it \
  --name={CONTAINER_NAME} \
  --device /dev/{USB_PORT} \
  -p {PORT_NUMBER}:80 \
  -v ~/config/{CONTAINER_NAME}:/octoprint/ \
  -v ~/uploads:/octoprint/octoprint/uploads/ \
  --restart=unless-stopped \
    albarreto/octopi-armhf:latest

参数说明：

• {CONTAINER_NAME}：容器名称（自定义，如"octopi-printer1"）
• {USB_PORT}：3D打印机连接的USB端口（如"ttyUSB0"或"ACM0"）
• {PORT_NUMBER}：主机映射端口（如"5000"）
• -v ~/config/{CONTAINER_NAME}:/octoprint/：挂载配置目录，实现数据持久化
• -v ~/uploads:/octoprint/octoprint/uploads/：共享STL文件目录，支持多OctoPrint实例共用模型文件

访问方式

容器启动后，通过以下地址访问OctoPrint界面：

Octoprint access: http://{docker ip}:{PORT_NUMBER}

（将{docker ip}替换为Docker主机IP，{PORT_NUMBER}替换为启动时指定的映射端口）

已知问题与解决方法

• 端口自动检测问题：容器运行时需手动选择打印机端口（如/dev/ACM0）和波特率（推荐***），自动检测功能暂不可用。

联系信息

技术支持：***（支持英文和葡萄牙语）