如何在Docker无头Blender环境中导出bpy生成的3D输出？

一、调整Dockerfile适配动态执行用户bpy代码 #

原Dockerfile绑定了固定的script.py，需要修改为运行挂载的server.py，同时优化Xvfb启动逻辑，避免Blender在虚拟显示器未就绪时启动：

FROM ubuntu:22.04

RUN apt update && apt install -y \
    xvfb libgl1-mesa-glx libx11-xcb1 libxcb-dri3-0 libxcb-dri2-0 \
    libxcb-glx0 libxcb-present0 libxrender1 libxrandr2 libxcursor1 \
    libxkbcommon0 libxi6 libxxf86vm1 libasound2 libpulse0 \
    libopenal1 libvulkan1 x11-utils wget curl unzip xz-utils \
    mesa-utils && apt clean

RUN mkdir -p /tmp/.X11-unix && chmod 1777 /tmp/.X11-unix

RUN wget https://mirror.clarkson.edu/blender/release/Blender3.6/blender-3.6.5-linux-x64.tar.xz && \
    tar -xvf blender-3.6.5-linux-x64.tar.xz && \
    mv blender-3.6.5-linux-x64 /opt/blender && \
    ln -sf /opt/blender/blender /usr/local/bin/blender

WORKDIR /workspace

ENV OCIO=/opt/blender/3.6/datafiles/colormanagement/config.ocio

# 启动Xvfb并等待就绪，再运行用户挂载的server.py
CMD Xvfb :99 -screen 0 1920x1080x24 -ac & \
    export DISPLAY=:99 && \
    # 等待虚拟显示器初始化
    until xdpyinfo -display :99 >/dev/null 2>&1; do sleep 0.5; done && \
    blender --background --python /workspace/server.py

二、在用户bpy代码中配置与Blender界面一致的输出参数 #

要保证导出效果和界面预览一致，需要在server.py中明确设置以下关键参数：

1. 颜色管理匹配 #

确保色彩空间和Blender界面默认设置一致：

import bpy

# 设置颜色管理为Blender默认配置
bpy.context.scene.display_settings.display_device = 'sRGB'
bpy.context.scene.view_settings.view_transform = 'Filmic'
bpy.context.scene.sequencer_colorspace_settings.name = 'sRGB'

2. 渲染引擎与参数对齐 #

如果使用Cycles渲染，需匹配界面中的采样数、设备类型等：

# 设置Cycles渲染参数（和界面一致）
bpy.context.scene.render.engine = 'CYCLES'
bpy.context.scene.cycles.samples = 128  # 对应界面的采样数
bpy.context.scene.cycles.device = 'CPU'  # 或'GPU'，根据容器硬件配置调整
bpy.context.scene.cycles.use_denoising = True  # 开启降噪，和界面默认一致

3. 导出适合自定义查看器的格式（推荐glTF） #

glTF是通用3D格式，适合自定义查看器加载，导出时需包含所有必要资源：

# 导出glTF文件，确保材质、纹理、动画完整
bpy.ops.export_scene.gltf(
    filepath="/workspace/output.gltf",
    export_format='GLTF_EMBEDDED',  # 嵌入纹理，避免外部文件依赖
    export_apply=True,  # 应用所有修改器，和界面导出行为一致
    export_animations=True,  # 如果有动画需导出
    export_materials='EXPORT',  # 导出材质
    export_color_space='AUTO'  # 自动匹配颜色空间
)

三、Node.js服务器侧的优化处理 #

1. 设置临时目录权限：创建临时目录时赋予777权限，避免容器内无法读写：

const fs = require('fs');
const path = require('path');
const { execSync } = require('child_process');

// 创建临时目录
const tempDir = path.join(__dirname, 'temp', Date.now().toString());
fs.mkdirSync(tempDir, { recursive: true, mode: 0o777 });

// 写入用户bpy代码到server.py
const userBpyCode = '...'; // 客户端传入的代码
fs.writeFileSync(path.join(tempDir, 'server.py'), userBpyCode);

// 执行Docker命令
execSync(`docker run --rm -v ${tempDir}:/workspace blender-container`);

// 读取导出的文件返回给客户端
const outputFile = fs.readFileSync(path.join(tempDir, 'output.gltf'));
// 返回outputFile给客户端...

// 清理临时目录
fs.rmSync(tempDir, { recursive: true, force: true });

2. 捕获容器运行日志：添加日志捕获，方便排查导出失败问题：

const { exec } = require('child_process');

exec(`docker run --rm -v ${tempDir}:/workspace blender-container`, (error, stdout, stderr) => {
    if (error) {
        console.error(`容器运行错误: ${error.message}`);
        return;
    }
    if (stderr) {
        console.error(`Blender输出错误: ${stderr}`);
        return;
    }
    console.log(`Blender输出日志: ${stdout}`);
    // 后续处理导出文件
});

内容的提问来源于stack exchange，提问作者Saksham web