sophiedeziel/tentacles

3D打印农场管理镜像

镜像概述和主要用途

该Docker镜像提供一站式3D打印农场管理解决方案，通过统一界面实现多台3D打印机的集中化管理。旨在简化3D打印集群的运维复杂度，提升设备利用率和生产效率，适用于需要同时管理多台打印机的场景。

核心功能和特性

• 集中监控：实时查看所有打印机运行状态、打印进度、温度曲线等关键参数
• 任务调度：智能分配打印任务至空闲设备，支持优先级排序和负载均衡
• 作业管理：全生命周期管理打印任务（创建/暂停/恢复/取消），支持GCode文件上传与预览
• 设备管理：统一配置打印机参数，支持设备分组管理和固件版本控制
• 异常预警：实时监测打印异常（断料、层移、过热等）并触发告警机制
• 数据统计：生成设备利用率、打印成功率、耗材消耗等运营报表
• 跨平台兼容：支持主流3D打印机品牌（如Prusa、Creality、Ultimaker等）

使用场景和适用范围

• 小型工作室：管理5-20台打印机的创意工作室，简化日常操作流程
• 教育机构：高校/职业院校3D打印实验室，方便教师监控学生打印任务
• 企业生产：中小规模3D打印生产基地，实现批量化生产的高效调度
• 创客空间：社区共享3D打印设备的管理平台，优化设备共享机制

使用方法和配置说明

前提条件

• Docker Engine 20.10.0+ 及 Docker Compose v2.0+
• 打印机与主机网络互通（支持有线/无线连接）
• 至少1GB可用内存，推荐2GB以上

快速启动

Docker Run 命令

bash
docker run -d \
  --name 3d-farm-manager \
  -p 8080:8080 \
  -v /local/data:/app/data \
  -e ADMIN_USER=admin \
  -e ADMIN_PWD=SecurePass123 \
  -e DB_TYPE=sqlite \
  3dprint/farm-manager:latest

参数说明：

• -p 8080:8080：映射Web管理界面端口
• -v /local/data:/app/data：持久化存储打印任务、设备配置等数据
• -e ADMIN_USER：管理员用户名（默认：admin）
• -e ADMIN_PWD：管理员密码（建议使用强密码）
• -e DB_TYPE：数据库类型（支持sqlite/mysql/postgresql，默认sqlite）

Docker Compose 配置

yaml
version: '3.8'
services:
  manager:
    image: 3dprint/farm-manager:latest
    container_name: 3d-farm-manager
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data
    environment:
      - ADMIN_USER=admin
      - ADMIN_PWD=SecurePass123
      - DB_TYPE=mysql
      - DB_HOST=db
      - DB_PORT=3306
      - DB_NAME=farm_db
      - DB_USER=dbuser
      - DB_PWD=dbpass123
    depends_on:
      - db
    restart: unless-stopped

  db:
    image: mysql:8.0
    volumes:
      - mysql-data:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=rootpass
      - MYSQL_DATABASE=farm_db
      - MYSQL_USER=dbuser
      - MYSQL_PASSWORD=dbpass123
    restart: unless-stopped

volumes:
  mysql-data:

启动命令：docker-compose up -d

访问与初始化

1. 启动后访问 http://<主机IP>:8080 进入管理界面
2. 使用配置的管理员账户登录（默认账户需首次登录后修改密码）
3. 在「设备管理」页面添加打印机：
   • 选择打印机型号与连接方式（USB/网络）
   • 配置通信参数（IP地址/端口/API密钥）
   • 执行连接测试验证设备可达性

高级配置

支持HTTPS

通过反向代理（如Nginx）配置SSL加密：

nginx
server {
    listen 443 ssl;
    server_name farm-manager.example.com;
    
    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;
    
    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

自定义端口映射

修改端口映射参数调整访问端口：

bash
-p 9000:8080  # 将容器8080端口映射到主机9000端口

数据备份

定期备份挂载的数据卷目录：

bash
tar -czf farm_backup_$(date +%Y%m%d).tar.gz /path/to/local/data

注意事项

• 确保打印机固件支持API通信（如Marlin固件需启用Octoprint兼容模式）
• 生产环境建议使用MySQL数据库替代默认SQLite，提升数据可靠性
• 网络环境需保障低延迟通信（建议打印机与主机有线连接）
• 定期更新镜像获取功能优化和安全补丁：docker pull 3dprint/farm-manager:latest