keyglitch/docker-slic3r-prusa3d

docker-prusaslicer

镜像概述

本镜像跟踪https://github.com/prusa3d/PrusaSlicer%E9%A1%B9%E7%9B%AE%EF%BC%8C%E5%BD%93%E4%B8%8A%E6%B8%B8%E5%8F%91%E5%B8%83%E7%89%88%E6%9C%AC%E6%A0%87%E7%AD%BE%E6%97%B6%E4%BC%9A%E8%A7%A6%E5%8F%91Docker Hub构建。仓库中包含Dockerfile及相关支持脚本，用于容器化运行PrusaSlicer 3D打印切片软件。

核心功能与特性

• 容器化部署：无需本地安装依赖，通过Docker容器隔离运行环境，避免系统依赖冲突
• 持久化配置：切片设置通过卷（volume）持久化存储，避免重复配置
• 本地文件访问：支持挂载本地目录，方便导入3D模型文件和导出切片结果
• 自动版本跟踪：自动跟踪PrusaSlicer上游版本发布，确保使用最新稳定版
• 简化操作：提供便利脚本封装docker run命令，降低使用门槛

使用场景

• 3D打印爱好者需要快速运行PrusaSlicer，避免本地安装复杂依赖
• 开发者在不同系统间保持一致的切片环境
• 需要隔离运行PrusaSlicer，避免对主机系统造成影响的场景

使用方法

基本运行命令

从Docker Hub拉取并运行镜像：

bash
docker run -v /tmp/.X11-unix:/tmp/.X11-unix \
  -v $PWD:/Slic3r/3d:z \
  -v slic3rSettings:/home/slic3r \
  -e DISPLAY=$DISPLAY \
  --rm keyglitch/docker-slic3r-prusa3d

参数说明

• /tmp/.X11-unix挂载：用于容器访问主机X11显示服务，实现图形界面输出
• 当前目录挂载：$PWD:/Slic3r/3d:z 将当前工作目录挂载到容器内/Slic3r/3d路径，:z 选项可根据需要改为:rw（读写）或:ro（只读）
• 设置卷挂载：slic3rSettings:/home/slic3r 将切片软件设置持久化存储到slic3rSettings卷中
• DISPLAY环境变量：-e DISPLAY=$DISPLAY 传递主机显示环境变量，确保图形界面正常显示
• --rm选项：容器退出后自动清理，避免残留容器文件

常见问题解决

Fedora用户SELinux问题

Fedora系统的SELinux可能阻止容器内的slic3r访问X服务，可通过查看/var/log/messages或/var/log/audit/audit.log日志确认，并根据日志提示执行相关命令解决。

X权限访问错误

尝试访问X服务时可能出现权限错误，临时解决方法：

bash
xhost local:root

注意：此为临时修复，主机重启后需重新执行。

错误示例

权限问题典型错误输出：

No protocol specified
19:13:54: Error: Unable to initialize GTK+, is DISPLAY set properly?
Failed to initialize wxWidgets at /Slic3r/slic3r-dist/lib/site_perl/5.22.0/Slic3r/GUI/2DBed.pm line 10.
Compilation failed in require at /Slic3r/slic3r-dist/lib/site_perl/5.22.0/Slic3r/GUI/2DBed.pm line 10.
BEGIN failed--compilation aborted at /Slic3r/slic3r-dist/lib/site_perl/5.22.0/Slic3r/GUI/2DBed.pm line 10.
Compilation failed in require at /Slic3r/slic3r-dist/lib/site_perl/5.22.0/Slic3r/GUI.pm line 9.
BEGIN failed--compilation aborted at /Slic3r/slic3r-dist/lib/site_perl/5.22.0/Slic3r/GUI.pm line 9.
Compilation failed in require at (eval 87) line 1.

本地构建

若Docker Hub上的镜像版本过时或需自定义构建，可通过以下步骤本地构建：

1. 获取最新版本：getLatestSlic3rRelease.sh脚本会通过GitHub API自动获取最新非AppImage版本
2. 执行构建：

bash
docker build -t docker-slic3r-prusa3d .

构建过程示例输出：

Sending build context to Docker daemon 73.73 kB
Step 1 : FROM debian:stretch
[ .. 输出截断 ..]

便利脚本

提供https://raw.githubusercontent.com/davidk/docker-slic3r-prusa3d/master/slic3r.sh%E5%B0%81%E8%A3%85%E4%B8%8A%E8%BF%B0%60docker run`命令，简化运行流程，脚本中还包含用于查看持久化卷内容的注释代码段。

使用示例

1. 安装脚本：

bash
# 确认本地bin目录在PATH中
echo $PATH
# 示例输出：/usr/local/bin:/usr/bin:/bin:/usr/local/sbin:/usr/sbin:/home/user/.local/bin:/home/user/bin

# 复制脚本到本地bin目录
cp slic3r.sh /home/user/.local/bin/slic3r

# 添加执行权限
chmod +x /home/user/.local/bin/slic3r

2. 运行PrusaSlicer：

bash
slic3r