LinuxServer.io 容器版 Bambu Studio 介绍

LinuxServer.io 容器特点

LinuxServer.io 团队提供的容器具有以下优势：

• 应用定期及时更新
• 简单的用户权限映射（PGID、PUID）
• 基于 s6 overlay 的自定义基础镜像
• 每周更新基础系统，通过共享层减少存储空间、 downtime 和带宽消耗
• 定期安全更新

关于 Bambu Studio

Bambu Studio 是一款开源、前沿且功能丰富的切片软件，支持项目化工作流、优化的切片算法和易用的图形界面，为用户提供流畅的 3D 打印体验。

支持的架构

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

应用设置

访问地址

应用启动后可通过以下地址访问：
`[***]

严格反向代理

默认使用自签名证书，通信协议为 https。若反向代理需验证证书，需禁用容器证书检查。

注意：现代桌面应用可能与 Docker 最新的系统调用限制冲突，可添加 --security-opt seccomp=unconfined 参数允许旧内核或 libseccomp 版本的主机运行容器。

安全注意事项

警告：本容器需要主机系统的特权访问，请勿直接暴露到互联网，需确保已正确配置安全措施。

• HTTPS 必需：WebCodecs 等现代浏览器功能依赖 HTTPS，HTTP 连接会导致视频/音频功能失效。
• 默认无认证：可通过 CUSTOM_USER 和 PASSWORD 环境变量启用基础 HTTP 认证（仅适用于可信局域网）。若需暴露到互联网，建议搭配 SWAG 等反向代理并启用强认证机制。
• 容器内权限：Web 界面包含无密码 sudo 权限的终端，任何访问者可在容器内获取 root 权限、安装软件或探测局域网。
• seccomp 配置：老旧硬件或系统可能需禁用 seccomp 安全限制（--security-opt seccomp=unconfined），但此举会降低容器安全性，仅在必要时使用。

环境变量与运行配置

本容器基于 Docker Baseimage Selkies，支持以下自定义选项：

可选环境变量

可选运行参数

多语言支持

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

• 中文：-e LC_ALL=zh_CN.UTF-8
• 日语：-e LC_ALL=ja_JP.UTF-8
• 韩语：-e LC_ALL=ko_KR.UTF-8
• 其他语言：fr_FR.UTF-8（法语）、de_DE.UTF-8（德语）等

GPU 加速配置

DRI3 开源驱动支持

适用于 Intel/AMD 开源驱动或 NVIDIA nouveau 驱动，通过以下参数挂载 GPU 设备：
--device /dev/dri:/dev/dri

可通过 DRINODE 指定具体 GPU 节点（如 /dev/dri/renderD128）。

NVIDIA 显卡支持

注意：Alpine 基础镜像不支持 NVIDIA。

通过 Zink 实现 OpenGL 支持，同时自动用于硬件加速视频编码（降低 CPU 负载）。需添加以下运行参数：

• --gpus all（或指定具体 GPU）
• --runtime nvidia

Docker Compose 配置示例：

yaml
services:  
  bambustudio:  
    image: lscr.io/linuxserver/bambustudio:latest  
    deploy:  
      resources:  
        reservations:  
          devices:  
            - driver: nvidia  
              count: 1  
              capabilities: [compute,video,graphics,utility]  

应用安装与管理

PRoot Apps（推荐，持久化）

原生安装的软件（如 apt-get install）在容器重建后会丢失，推荐使用 proot-apps 安装持久化应用：

bash
proot-apps install 应用名称  # 例如：proot-apps install filezilla  

支持的应用列表见 proot-apps 文档。

原生应用（非持久化）

通过 universal-package-install mod 安装系统包（容器重建后需重新安装）：

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

使用方法

Docker Compose（推荐）

yaml
---  
services:  
  bambustudio:  
    image: lscr.io/linuxserver/bambustudio:latest  
    container_name: bambustudio  
    environment:  
      - PUID=1000        # 用户ID（通过 `id 用户名` 获取）  
      - PGID=1000        # 组ID（同上）  
      - TZ=Etc/UTC       # 时区（如 Asia/Shanghai）  
      - DARK_MODE=true   # 可选，启用深色模式  
    volumes:  
      - /path/to/bambustudio/config:/config  # 配置文件持久化路径  
    ports:  
      - 3000:3000        # HTTP 端口（需反向代理）  
      - 3001:3001        # HTTPS 端口  
    shm_size: "1gb"      # 共享内存大小（桌面应用推荐）  
    restart: unless-stopped  

Docker Run 命令

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

参数说明

用户/组标识符（PUID/PGID）

挂载主机目录时，需确保目录所有者的 UID/GID 与容器内 PUID/PGID 一致，避免权限问题。通过以下命令获取当前用户的 UID/GID：

bash
id 用户名  
# 示例输出：uid=1000(用户) gid=1000(用户) groups=1000(用户)  

支持与更新

常用操作

• 容器内 Shell 访问：

  bash
  docker exec -it bambustudio /bin/bash  
  

• 实时查看日志：

  bash
  docker logs -f bambustudio  
  

• 查看容器版本：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' bambustudio  
  

更新容器

Docker Compose

bash
# 拉取最新镜像  
docker-compose pull bambustudio  
# 重启容器  
docker-compose up -d bambustudio  
# 清理旧镜像  
docker image prune  

Docker Run

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

版本历史

• 31.08.25：优化 AppImage 集成
• 14.08.25：基于 Ubuntu Noble 重建，支持*** AppImage
• 12.07.25：迁移至 Selkies 基础镜像，强制要求 HTTPS
• 29.07.24：添加必要字体和深色模式环境变量
• 15.11.23：初始发布

更多支持可通过 LinuxServer.io 社区、*** 或 GitHub 获取。