linuxserver/orcaslicer 镜像文档

镜像概述和主要用途

Orca Slicer 是一款开源的FDM打印机切片软件，基于Bambu Studio开发（原名为BambuStudio-SoftFever），而Bambu Studio则衍生自Prusa Research的PrusaSlicer，其根源可追溯至Alessandro Ranellucci及RepRap社区开发的Slic3r。

本镜像由LinuxServer.io团队维护，提供容器化部署方案，便于用户在各种环境中快速运行Orca Slicer，专注于3D打印模型的切片处理，生成打印机可执行的G代码。

核心功能和特性

• 定期应用更新：及时同步上游Orca Slicer版本更新
• 灵活用户映射：通过PUID/PGID实现容器内用户与宿主机用户权限映射
• 自定义基础镜像：基于s6 overlay构建，提供可靠的进程管理
• 高效系统更新：每周基础系统更新，通过共享层减少存储空间占用、 downtime及带宽消耗
• 持续安全更新：定期修复安全漏洞，保障运行环境安全

支持的架构

本镜像通过Docker manifest实现多平台支持，拉取lscr.io/linuxserver/orcaslicer:latest即可自动匹配对应架构。也可通过标签指定特定架构：

使用场景和适用范围

• 3D打印爱好者个人使用，在容器化环境中管理切片任务
• 创客空间或小型工作室，通过集中部署提供多人共享切片服务
• 开发测试环境，快速搭建隔离的Orca Slicer运行实例
• 需要通过Web界面远程访问切片功能的场景

详细使用方法和配置说明

访问地址

应用部署后可通过以下地址访问：
[***]

基础部署示例

Docker Compose（推荐）

yaml
---
services:
  orcaslicer:
    image: lscr.io/linuxserver/orcaslicer:latest
    container_name: orcaslicer
    environment:
      - PUID=1000               # 用户ID，通过`id your_user`获取
      - PGID=1000               # 组ID，通过`id your_user`获取
      - TZ=Etc/UTC              # 时区，如Asia/Shanghai
    volumes:
      - /path/to/config:/config # 配置文件存储路径，需宿主机目录权限匹配PUID/PGID
    ports:
      - 3000:3000               # HTTP端口（默认自签名证书，建议仅内部使用）
      - 3001:3001               # HTTPS端口（推荐使用）
    shm_size: "1gb"             # 可选，设置共享内存大小，避免浏览器崩溃
    restart: unless-stopped

Docker Run

bash
docker run -d \
  --name=orcaslicer \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 3000:3000 \
  -p 3001:3001 \
  -v /path/to/config:/config \
  --shm-size="1gb" \  # 可选
  --restart unless-stopped \
  lscr.io/linuxserver/orcaslicer:latest

参数说明

环境变量

运行参数

安全注意事项

[!WARNING] 本容器提供宿主机系统的特权访问，禁止直接暴露到互联网，需确保在可信网络中使用并采取适当安全措施。

1. HTTPS必要性：现代浏览器功能（如WebCodecs视频编码）需HTTPS环境，默认使用自签名证书，反向代理时需禁用证书验证。
2. 认证机制：默认无认证，CUSTOM_USER和PASSWORD仅提供基础HTTP认证，适合本地可信网络；公网暴露需搭配反向代理（如SWAG）实现强认证。
3. 容器权限：Web界面包含带无密码sudo权限的终端，任何访问者可在容器内获取root权限，需严格控制访问来源。

高级配置

语言支持

通过LC_ALL环境变量设置界面语言，例如：

• 中文：-e LC_ALL=zh_CN.UTF-8
• 日文：-e LC_ALL=ja_JP.UTF-8
• 德文：-e LC_ALL=de_DE.UTF-8

GPU加速

DRI3加速（Intel/AMD/Nouveau）

适用于开源GPU驱动，需挂载设备并可选指定GPU节点：

bash
docker run -d \
  --name=orcaslicer \
  -e PUID=1000 -e PGID=1000 -e TZ=Asia/Shanghai \
  -e DRINODE=/dev/dri/renderD128 \  # 可选，指定GPU设备
  -p 3001:3001 \
  -v /path/to/config:/config \
  --device /dev/dri:/dev/dri \  # 挂载GPU设备
  lscr.io/linuxserver/orcaslicer:latest

Nvidia GPU支持

需宿主机安装Nvidia驱动并配置Nvidia运行时：

bash
# 配置Nvidia运行时为默认
sudo nvidia-ctk runtime configure --runtime=docker --set-as-default
sudo systemctl restart docker

# Docker Compose配置示例
services:
  orcaslicer:
    image: lscr.io/linuxserver/orcaslicer:latest
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: 1
              capabilities: [compute,video,graphics,utility]

应用管理

容器内应用安装有两种方式：

1. PRoot Apps（持久化，推荐）
   安装到用户$HOME目录，容器重建后保留：

   bash
   # 进入容器终端
   docker exec -it orcaslicer /bin/bash
   # 安装应用（如FileZilla）
   proot-apps install filezilla
   

2. Native Apps（非持久化）
   通过universal-package-install mod安装系统包（容器重建后丢失）：

   yaml
   environment:
     - DOCKER_MODS=linuxserver/mods:universal-package-install
     - INSTALL_PACKAGES=libfuse2|git  # 需安装的包，用|分隔
   

维护与更新

查看容器状态

bash
# 进入容器终端
docker exec -it orcaslicer /bin/bash

# 实时查看日志
docker logs -f orcaslicer

# 查看容器版本
docker inspect -f '{{ index .Config.Labels "build_version" }}' orcaslicer

更新镜像

Docker Compose

bash
# 拉取最新镜像
docker-compose pull orcaslicer
# 重启容器
docker-compose up -d orcaslicer

Docker Run

bash
# 拉取最新镜像
docker pull lscr.io/linuxserver/orcaslicer:latest
# 停止并删除旧容器
docker stop orcaslicer && docker rm orcaslicer
# 用原参数启动新容器（配置通过挂载目录持久化）
docker run [原参数] lscr.io/linuxserver/orcaslicer:latest

支持架构与兼容性

• 支持系统：x86-64架构Linux系统，内核版本≥4.15
• 不支持架构：arm64（见支持架构）
• 兼容性提示：老旧内核或libseccomp版本需添加--security-opt seccomp=unconfined以允许必要系统调用。