linuxserver/kicad

linuxserver/kicad 镜像文档

镜像概述

linuxserver/kicad是一个基于Docker的镜像，用于快速部署和运行KiCad——一款跨平台、开源的电子设计自动化（EDA）套件。该镜像简化了KiCad的部署流程，无需本地安装依赖，可直接通过网页访问进行电路设计、PCB布局等电子设计工作。

核心功能与特性

• 跨平台支持：基于Docker容器化部署，兼容各类支持Docker的操作系统
• 开源套件：集成完整的KiCad电子设计工具链，支持 schematic 设计、PCB布局、Gerber文件生成等
• 网页访问：通过浏览器即可访问KiCad界面，无需本地安装图形界面
• 内置工具：包含mousepad文本编辑器，路径为/usr/bin/mousepad，方便编辑设计相关文档
• 数据持久化：支持配置文件和设计数据的持久化存储

使用场景

• 电子工程师、硬件开发者需要快速搭建KiCad设计环境
• 团队协作中统一设计工具版本，避免环境差异导致的问题
• 在服务器或无头系统（无图形界面）中运行KiCad进行远程设计

使用方法

基本部署命令

通过以下docker run命令快速启动镜像：

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

参数说明

环境变量（-e）

• PUID=1000：运行容器的用户ID，用于权限控制，建议设置为当前用户ID
• PGID=1000：运行容器的用户组ID，与PUID对应
• TZ=Etc/UTC：容器时区设置，如Asia/Shanghai（中国标准时间）、Europe/London等

端口映射（-p）

• 3000:3000：默认内部服务端口
• 3001:3001：网页访问端口，通过https://yourhost:3001/访问KiCad界面

卷挂载（-v）

• /path/to/config:/config：配置文件和设计数据的持久化目录，需替换为本地实际路径

其他配置

• --shm-size="1gb"：共享内存大小设置，建议至少1GB以保证图形界面流畅运行
• --restart unless-stopped：容器重启策略，异常退出时自动重启

访问方式

容器启动后，通过以下地址访问KiCad界面：

• [***]

内置文本编辑器

镜像中集成mousepad文本编辑器，可通过以下命令在容器内启动：

bash
docker exec -it kicad mousepad