如何通过 Docker 搭建 FreeCAD CAD 工作站

适用说明

适用终端：绿联云 PC 客户端（Windows/macOS）。

适用版本： NAS 固件 1.17.0.0034 及更高版本。

本文档描述仅供参考，实际界面与操作路径可能因系统或应用版本的迭代而略有差异，请以实际使用界面为准.

简介

FreeCAD 是一款开源的通用参数化三维 CAD 建模软件，遵循 LGPL 许可协议。它主要面向机械工程和产品设计场景，也可用于建筑设计、有限元分析、3D 打印等相关任务。

绿联 NAS 支持通过 Docker 部署 FreeCAD，部署完成后，可在浏览器中访问 FreeCAD Web 界面，实现远程 CAD 建模和文件查看。

FreeCAD GitHub 地址：https://github.com/linuxserver/docker-freecad

创建 Compose 项目

1. 打开 Docker 应用，在左侧栏点击“项目”，随后点击右侧页面的“创建”。

2. 在创建项目页面中，自定义项目名称。

系统会默认在共享文件夹的 docker 文件夹内，创建一个以项目名称命名的文件夹。

Compose 配置文件会存放在该项目文件夹内，也可按需手动修改路径。

3. 填入 Compose 配置。

4. 点击“立即部署”。

系统会自动拉取镜像，并在镜像拉取完成后部署项目。

Compose 配置示例

可参考以下配置创建 FreeCAD 项目：

services:

  freecad:

    image: linuxserver/freecad:latest

    container_name: freecad

    ports:

      - 3000:3000

      - 3001:3001

    environment:

      - PUID=1000

      - PGID=1000

      - TZ=Asia/Shanghai

    volumes:

      - ./config:/config

    shm_size: "1gb"

    restart: always

参数说明

TZ：用于设置容器时区。

/config：用于存放 FreeCAD 的配置文件和运行数据。其中 ./config 表示项目目录下的 config 文件夹。

shm_size：用于设置容器可使用的共享内存大小。

镜像拉取失败怎么办

如果部署时镜像拉取失败，可查看项目部署日志。

如果日志中出现以下内容，通常表示 Docker Hub 镜像拉取异常：

https://registry-1.docker.io/v2/

可配置镜像加速器或镜像代理后重新部署。具体操作可参考绿联 NAS Docker 镜像加速器相关教程。

访问 FreeCAD Web 界面

Compose 部署完成后，在浏览器地址栏输入https://NAS的IP:3001即可访问 FreeCAD Web 界面。

注意：

● 这里需要使用 HTTPS 协议，该镜像默认使用自签名证书。

● NAS 的 IP 地址可在系统顶部栏的小组件中查看。

浏览器提示“不安全”怎么办

由于 FreeCAD 镜像默认使用自签名证书，浏览器可能提示：

● 不是私密连接

● 连接不安全

● 证书不受信任

这些是正常现象，可点击页面中的“高级”，然后选择“继续前往”，进入 FreeCAD 页面。

不同浏览器的提示文案可能略有差异，请以实际页面显示为准。

首次进入 FreeCAD 后如何设置

进入 FreeCAD 后，可根据使用习惯调整界面设置。

在初始化页面中，可设置以下内容：

● 界面语言

● 主题

● 导航样式

● 单位

如需切换语言，可点击“Language”下拉菜单，选择需要的显示语言。

设置完成后，点击“完成”关闭设置窗口。

导入工程文件

FreeCAD 不支持直接读取或导出 DWG 格式文件，因为 DWG 是 Autodesk 的专有闭源格式，存在版权限制。

如需在 FreeCAD 中打开 CAD 文件，可先使用 CAD 软件将 DWG 文件转换为 DXF 格式，再导入 FreeCAD。

操作步骤如下：

1. 打开 NAS 的 文件管理。

2. 找到 FreeCAD Compose 项目的配置文件夹。

3. 进入以下路径后，进入“config”＞“Desktop”文件夹，将需要导入的 DXF 文件上传到该文件夹。

4. 上传后回到 FreeCAD Web 界面，点击顶部栏“文件”＞“打开”。

5. 在文件选择页面中，进入config/Desktop，选择已上传的 DXF 文件，点击“打开”。

6. 选择导入方式，点击“OK”。

导入完成后，即可在 FreeCAD 中浏览和编辑该文件。

调用 NVIDIA 独立显卡 GPU

绿联 NAS 部分型号支持外接 NVIDIA 独立显卡。连接显卡后，可在 Docker 中调用 NVIDIA GPU，为 FreeCAD 提供图形渲染等硬件加速能力。

使用前，请先确认 NAS 已正确连接 NVIDIA 独立显卡，并已完成 NVIDIA 驱动和 NVIDIA Docker 工具包安装。

具体操作可参考Docker 如何调用 NVIDIA 独立显卡教程

Compose 配置示例

连接显卡后，建议重新创建一个新的 Compose 项目，避免旧项目配置与新的 GPU 配置产生冲突。

可参考以下配置创建 FreeCAD 项目：

services:

  freecad:

    image: lscr.io/linuxserver/freecad:latest

    environment:

      - PUID=1000

      - PGID=1000

      - TZ=Asia/Shanghai

      - PIXELFLUX_WAYLAND=true

      - AUTO_GPU=false

      - DRINODE=/dev/dri/renderD128

      - DRI_NODE=/dev/dri/renderD129

      - NVIDIA_VISIBLE_DEVICES=all

      - NVIDIA_DRIVER_CAPABILITIES=all

    volumes:

      - ./config:/config

    ports:

      - "3000:3000"

      - "3001:3001"

    devices:

      - /dev/dri:/dev/dri

    deploy:

      resources:

        reservations:

          devices:

            - driver: nvidia

              count: 1

              capabilities: [gpu, compute, video, graphics, utility]

    security_opt:

      - seccomp=unconfined

    shm_size: "4gb"

    restart: always

GPU 相关参数说明

TZ：用于设置容器时区。

/config：用于存放 FreeCAD 的配置文件和运行数据。

● 示例：./config:/config

● 其中 ./config 表示项目目录下的 config 文件夹。

shm_size：用于设置容器可使用的共享内存大小。

AUTO_GPU=false：关闭容器启动时的自动 GPU 侦测脚本，改为由你通过环境变量强制指定使用的显卡节点。

NVIDIA_VISIBLE_DEVICES=all：用于将宿主机中的 NVIDIA 显卡透传给容器。设置为 all 时，表示容器可使用所有可见的 NVIDIA 显卡。

NVIDIA_DRIVER_CAPABILITIES=all：用于开启 NVIDIA 驱动能力。设置为 all 时，表示开启计算、视频编解码、图形渲染等能力。

DRINODE 和 DRI_NODE：用于指定 Linux 直接渲染接口 DRI 节点路径。

● 示例：DRINODE=/dev/dri/renderD128，DRI_NODE=/dev/dri/renderD129

● 其中，renderD128 为 Intel 核显节点，renderD129 通常为 NVIDIA 独显节点。实际节点编号可能因设备环境不同而变化，请以 NAS 实际识别结果为准。

security_opt：该配置用于解除 Docker 默认 Seccomp 安全策略中的部分系统调用限制。

● 示例：security_opt:-seccomp=unconfined

● 部分图形渲染或 GPU 相关功能可能需要该配置才能正常运行。

更多参数可参考 linuxserver/freecad 的 GitHub 页面说明。

如何确认 FreeCAD 是否调用了独立显卡

完成部署并进入 FreeCAD 后，在 FreeCAD 页面中进行建模、视角切换等操作时，如果独立显卡已正常调用，可在 NAS 的任务管理器中看到 NVIDIA 显卡占用变化。

注意事项

● FreeCAD Web 页面需通过 HTTPS 访问，如果使用 http://NAS的IP:3001，可能无法正常打开页面。

● 首次部署需要拉取镜像，耗时与网络环境有关，如果下载较慢或失败，可先配置镜像加速器或镜像代理。

● 导入 CAD 文件前，建议确认文件格式是否为 FreeCAD 支持的格式，如需导入 DWG 文件，建议先转换为 DXF 格式。

帖子怎么没人

非常详细！