phygitalism/freecad

FreeCAD with VNC Server (Debian) 镜像文档

镜像概述

本Docker镜像基于Debian系统构建，集成了FreeCAD（开源CAD设计软件）和VNC服务器。通过该镜像，用户可在任何支持VNC客户端的设备上远程访问FreeCAD的图形界面，无需在本地安装FreeCAD，简化了CAD设计环境的部署与访问流程。

核心功能与特性

• FreeCAD集成：包含完整的FreeCAD安装，支持2D草图绘制、3D建模、装配设计、工程图生成等CAD核心功能
• VNC服务器：内置VNC服务器，支持远程图形界面访问，无需本地图形环境
• Debian基础：基于稳定的Debian系统，软件依赖管理规范，运行环境可靠
• 轻量化设计：在保证功能完整的前提下优化镜像体积，便于快速部署

使用场景

• 远程CAD设计：在无图形界面的服务器或云环境中运行FreeCAD，通过本地VNC客户端访问
• 教育与培训：为学生或团队提供统一的FreeCAD环境，无需在每台设备单独安装
• 协作设计：多人通过VNC访问同一FreeCAD实例（需注意并发控制）
• 自动化工作流：结合脚本实现CAD设计的自动化处理与渲染

使用方法

基本运行命令

bash
docker run -d -p 5900:5900 --name freecad-vnc your-image-name

• -p 5900:5900：映射VNC默认端口（5900）到主机
• --name freecad-vnc：指定容器名称

自定义配置

可通过环境变量调整VNC服务器参数：

示例（带密码和自定义分辨率）：

bash
docker run -d -p 5900:5900 \
  -e VNC_PASSWORD=mysecretpassword \
  -e VNC_RESOLUTION=1920x1080 \
  --name freecad-vnc your-image-name

访问方法

1. 确保容器已启动：docker ps 确认容器状态为 Up
2. 使用VNC客户端（如RealVNC Viewer、TigerVNC等）连接到 主机IP:5900
3. 如设置了密码，输入环境变量 VNC_PASSWORD 指定的密码
4. 成功连接后即可使用FreeCAD图形界面

数据持久化

如需保存FreeCAD项目文件，可挂载本地目录到容器内FreeCAD工作目录：

bash
docker run -d -p 5900:5900 \
  -v /本地目录:/root/FreeCAD \
  --name freecad-vnc your-image-name

容器内FreeCAD默认工作目录为 /root/FreeCAD

注意事项

• 首次启动可能需要数秒时间初始化VNC环境
• 若需更高安全性，建议结合SSL/TLS加密VNC连接
• 高分辨率设置可能增加网络带宽占用，根据实际网络环境调整
• 容器内FreeCAD配置文件位于 /root/.FreeCAD，如需持久化配置可一并挂载该目录