liwangsheng/freecad

FreeCAD Docker镜像文档

镜像概述

liwangsheng/freecad是一个提供FreeCAD Web访问能力的Docker镜像。FreeCAD是一款开源的计算机辅助设计（CAD）软件，该镜像通过容器化方式部署，允许用户通过浏览器访问FreeCAD功能，无需本地安装，同时支持本地目录挂载以实现设计文件的持久化存储。

核心功能与特性

• Web访问：通过HTTP端口提供FreeCAD的Web界面，无需本地安装CAD软件
• 文件持久化：支持挂载本地目录到容器内部，实现设计文件的存储与管理
• 便捷部署：通过简单的Docker命令即可快速启动服务，无需复杂配置

使用场景

• 个人CAD设计工作，尤其是在无法本地安装软件的环境中
• 教育场景下的CAD教学与实践
• 小型团队的轻量级CAD协作（需配合文件共享策略）
• 临时或移动环境中的CAD设计需求

使用方法与配置说明

基本部署命令

通过以下命令快速启动FreeCAD服务：

bash
docker run -d \
    --name freecad \
    -p 8055:8080 \  # 端口映射：主机8055端口映射到容器8080端口
    -v /root/playground/test/:/app/document \  # 目录挂载：本地目录映射到容器文档目录
    liwangsheng/freecad

参数说明

• -d：后台运行容器
• --name freecad：指定容器名称为"freecad"
• -p 8055:8080：端口映射，将主机的8055端口映射到容器内的8080端口，通过http://主机IP:8055访问服务
• -v /root/playground/test/:/app/document：目录挂载，将本地/root/playground/test/目录挂载到容器内的/app/document目录，用于存储设计文件

访问服务

服务启动后，通过浏览器访问 http://<主机IP>:8055 即可使用FreeCAD Web界面。

数据持久化

挂载的本地目录（如示例中的/root/playground/test/）将保存所有在FreeCAD中创建或修改的设计文件，确保容器重启后数据不丢失。建议根据实际需求替换为本地合适的目录路径。

注意事项

• 确保主机8055端口未被占用，如需使用其他端口，修改-p参数中的主机端口部分（如-p 8080:8080使用主机8080端口）
• 挂载目录需具有适当的读写权限，避免因权限问题导致文件操作失败
• 首次启动可能需要几分钟时间初始化服务，请耐心等待