Penpot 介绍与选型指南

目标：面向「自建设计与原型平台」的选型场景，讲清 Penpot（penpot.app，仓库 github.com/penpot/penpot）的产品定位、多服务架构、核心功能与同类竞品（Figma、Excalidraw 自建）的量化差异。本文全部数据来自联网溯源（官方仓库、官方文档站、官方定价页、shields.io 徽章），检索日期 2026-10-28，未做本地实测；部署、配置与命令的实测结论见本专栏系列 《Penpot Docker Compose 部署实战》、《Penpot 配置参数详解》 与 《Penpot 常用命令与运维实战》。

一、环境信息

本文为认知篇，不含本地实测环节。为便于核对事实时效，将本次溯源的环境与来源列明如下：

• 溯源日期：2026-10-28（Asia/Shanghai）。
• 对象仓库：https://github.com/penpot/penpot（README、Releases 页与仓库内 docker/images/docker-compose.yaml）。
• 官方文档站：用户与自托管文档 https://help.penpot.app/（Technical Guide 的 Configuration / Getting Started 章节）。
• 官网：https://penpot.app/（产品定位、功能与 Figma 对比专题页）。
• 竞品定价：Figma 官方定价页 https://www.figma.com/pricing/（2026-10-28 实查）。
• 社区活跃度取证：shields.io 徽章接口（img.shields.io/github/stars/penpot/penpot.json 等），未直连 api.github.com。
• 本文引用的所有第三方数据（星数、版本号、许可、定价、架构描述）均在来源处标注了获取日期；后续章节不再逐一重复，统一以 2026-10-28 为准。

二、软件概述

2.1 产品定位

Penpot 官网的自我描述是「The open-source design platform for teams that need scalable collaboration」——面向需要规模化协作的团队的开源设计平台。它覆盖 UI 设计、交互原型、设计系统与开发交付（Design-to-Code）完整链路，官网主视觉明确写着「BUILT FOR DESIGNERS, DEVELOPERS AND AI AGENTS」（为设计师、开发者和 AI 智能体构建），是当前开源生态里对标 Figma 最完整的作品。社区与官方对比专题（官网设有 Penpot vs Figma / Penpot vs Adobe XD / Penpot vs Canva / Penpot vs Sketch 页面）普遍将其定位为「Figma 的开源自托管替代品」。

Penpot 有两个关键差异点贯穿全部产品能力：

1. SVG 原生：Penpot 的文件格式基于开放标准（SVG + JSON），导出的代码是真实可用的 CSS/HTML/SVG，不依赖私有格式转换。官方对开发交付的表述是「Inspect and integrate code that actually matches design. Enjoy open standards like CSS, HTML, SVG and JSON as well as Penpot's open file format」。
2. 自托管功能完全免费：与 Figma 按编辑者席位收费不同，Penpot 无席位计费——云端版 design.penpot.app 免费开放全部功能，自托管版本同样免费且不限功能，商业支持通过可选的 Penpot Enterprise 提供。

关键身份信息（均取自官方仓库与官网，2026-10-28）：

💡 技术拓展：MPL-2.0 与同类设计工具所用许可证的差异值得自托管团队留意。

许可证	核心约束	对自建部署的影响	代表产品
MPL-2.0	文件级 copyleft：仅修改过的源文件须开源，可与专有代码组合	商用与二次开发友好度最高	Penpot
AGPL-3.0	网络分发同样触发开源义务，对外提供网络服务须开放源码	对外商用需谨慎评估；内部使用无影响	Excalidraw（白板部分 MIT，服务端 AGPL）
专有 SaaS	无开源义务，数据存于厂商云	无法自托管，数据主权受制于厂商	Figma、Sketch、Adobe XD

Penpot 采用 MPL-2.0，是三者中对「拿来自建 + 按需改造」最友好的许可证形态。

2.2 版本节奏与社区

• 发布节奏：以「分钟级」频率看，Penpot 保持高频迭代——2.18.5 于 2026-10-26 发布，develop 分支在此之后已有 816 个提交向 v2.19 推进（Releases 页与 commits-since 徽章实读，2026-10-28）。官方同时维护 Release Notes 与社区论坛（community.penpot.app）。
• 需要注意的滞后：官方自托管文档明确说明「Docker images are published shortly after the SaaS update」——即镜像发布略滞后于云端版，且官方论坛置顶帖建议自托管升级走小步快跑（small increments）而非跨大版本跳跃。
• 社区生态：官方提供用户指南（help.penpot.app/user-guide）、学习中心（Learning Center）、模板与组件库（Libraries & templates，默认从 GitHub 拉取）、插件体系（Plugins）与活跃的社区论坛；开发者生态侧有开放 API 与 MCP Server。

三、核心架构

3.1 多服务架构（以官方 2.18 编排为准）

Penpot 官方 Docker Compose 编排（仓库 docker/images/docker-compose.yaml，2026-10-28 取自 main 分支）共定义 8 个服务，职责划分如下：

💡 技术拓展：自托管设计平台的「无状态应用 + 外置状态」架构并非 Penpot 独有，三种常见形态对比——

形态	应用层	状态层	典型代表
单体 + SQLite	单进程二进制	内嵌文件库	小型自托管工具（Excalidraw 自建多为纯静态）
多服务 + 关系库	前后端/导出分离	PostgreSQL + Redis/Valkey	Penpot、Plane、GitLab
SaaS 私有云	厂商托管	厂商托管	Figma

Penpot 属于中间形态：无状态服务（frontend/backend/exporter/admin-console/mcp）可按官方高可用文档水平扩展，状态收敛到 PostgreSQL 与 Valkey 两处，用户上传对象另有独立的对象存储层（文件系统或 S3，见 《Penpot 配置参数详解》）。

3.2 数据与存储体系

• 文件数据：设计文件的业务数据存 PostgreSQL（官方仅支持 PostgreSQL，自托管文档建议 15 及以上版本）；2.11.0 起 PENPOT_FILE_DATA_BACKEND 可选 legacy-db/db/storage 三种文件数据存放后端。
• 对象存储：用户上传的资产（图片、SVG clip 等）走「可插拔」存储后端——默认文件系统（PENPOT_OBJECTS_STORAGE_BACKEND: fs），可切换 AWS S3 或任何 S3 兼容服务（含 MinIO，官方文档明确「These settings are equally useful if you have a Minio storage system」）。
• 协作通知：Valkey（Redis 协议）承担 WebSocket 通知协调与导出任务状态存储。
• 外部资源代理：默认从 GitHub 拉取库与模板、从 Google 拉取 Google Fonts；纯内网（air-gapped）环境可用 enable-air-gapped-conf 旗标关闭这些外部请求（代价是库/模板面板与 Google 字体不可用）。

3.3 认证与集成体系

Penpot 的认证体系覆盖四类方式（官方 Configuration 文档，2026-10-28）：

• 邮箱/密码：默认启用，配合 SMTP 做注册与邀请验证；
• OAuth/OIDC：Google、GitHub、GitLab 与通用 OIDC（1.5.0 起）——回调地址固定为 https://<域名>/api/auth/oidc/callback，自托管团队接 SSO 时按此配置；
• LDAP：1.x 起内置（enable-login-with-ldap 旗标 + 一组 PENPOT_LDAP_* 变量）；
• MCP 接入：2.18 编排内置 penpot-mcp 服务，面向 AI 智能体暴露设计文件上下文（官网设 Penpot MCP Server 专题页）。

四、功能特性

综合官网功能页与官方用户指南，Penpot 当前（2.18.x）的功能版图分五大块：

1. UI 设计：矢量绘制、组件与变体、CSS Grid 与 Flex 布局（官方明确这是「rules-based」的响应式布局，直接映射到真实 CSS 语义）、网格/标尺/参考线、线框与高保真混合工作流。
2. 交互原型：画板间原型连线与交互动作，可在线演示。
3. 设计系统：组件、原生 Design Tokens（设计令牌，官网设独立专题）、共享库（团队级组件库），支持从模板库起步。
4. 开发交付：代码检查面板输出 CSS/HTML/SVG/JSON，开放文件格式，配合 Dev-facing 的检视能力做 design-to-code。
5. 协作与 AI：多人实时协作（光标、评论、演示视图）、插件体系、内建 MCP Server 供 AI 智能体读写设计内容（官方宣传的 AI Workflows 场景：code-to-design、design-to-code、design-to-design）。

另有面向管理员的能力：2.18 新增 Admin Console（实例级用户与项目管理）、webhooks 与 access tokens（旗标开启）、匿名遥测（默认关闭，enable-telemetries 自愿开启）。

五、快速开始（最小可用示例）

以下为官方自托管文档（help.penpot.app/technical-guide/getting-started/docker，2026-10-28 查询）给出的最小部署路径，命令按官方原文引用；本文未做本地实测，逐条实测回显见 《Penpot Docker Compose 部署实战》：

# 获取官方编排文件（官方文档原文命令）
wget https://raw.githubusercontent.com/penpot/penpot/main/docker/images/docker-compose.yaml

# 启动（官方文档原文命令；默认使用 DockerHub 最新镜像）
docker compose -p penpot -f docker-compose.yaml up -d

# 启动完成后监听 http://localhost:9001（官方文档说明）

官方文档同页给出的配套事实：

• 版本控制：推荐通过 PENPOT_VERSION 环境变量（写入 .env 或命令行）固定版本，如 PENPOT_VERSION=2.4.3；
• 密钥：PENPOT_SECRET_KEY 为会话/邀请派生主键，官方建议用 python3 -c "import secrets; print(secrets.token_urlsafe(64))" 生成 512 位随机串；
• 升级：docker compose -f docker-compose.yaml pull 拉新镜像后重新 up；
• 数据备份：默认两个数据卷——PostgreSQL 数据卷与用户资产卷，用 Docker 卷备份流程归档。

⚠️ 注意：官方默认编排自带 disable-email-verification disable-secure-session-cookies 等便利旗标，官方在编排注释中明确警告「if you're exposing Penpot to the internet, you should remove the flags 'disable-secure-session-cookies' and 'disable-email-verification'」。生产暴露前须复核旗标组合，详见 《Penpot 配置参数详解》。

六、适用场景与限制

6.1 适用场景

1. 数据主权敏感的设计团队：设计稿、组件库与用户资产全部落自家 PostgreSQL/对象存储，满足合规或内网要求；配合 enable-air-gapped-conf 可做到纯离线运行。
2. 预算敏感的多席位团队：Figma 按编辑者席位月付（见第七章对比表），Penpot 自托管零席位费，适合编辑者数量多的团队与教育场景。
3. 开发流程深度集成：SVG/JSON 开放格式 + 真实 CSS 语义 + MCP Server，适合把设计资产接入 CI、AI 工作流或内部工具链的工程团队。
4. SSO/LDAP 统一认证：OIDC/Google/GitHub/GitLab/LDAP 全覆盖，能并入企业既有账号体系。

6.2 限制与注意

1. 资源门槛高于轻量工具：官方自托管文档明示需要 Docker + 反向代理 + DNS 基础能力；多服务栈对内存有基本要求（《Penpot Docker Compose 部署实战》实测记录了真实资源占用）。
2. 仅支持 PostgreSQL：数据库选型无第二选项（官方原话「Penpot only supports PostgreSQL」）；2.18 起建议 15 及以上版本。
3. 镜像滞后于云端版：自托管镜像发布晚于 SaaS 更新，追新需求要接受数日级延迟。
4. 非 HTTPS 域名访问受限：官方明确非 localhost 且无 HTTPS 的部署需 disable-secure-session-cookies，且剪贴板等浏览器 API 在 HTTP 下工作不正常——生产必须上 TLS 反代。
5. Figma 文件不完全互通：官方提供 Figma 导入通道，但复杂特性（自动布局细节、部分插件效果）存在转换损耗，迁移前应做试点验证。

七、同类选型对比

三种典型路线的量化对比（Penpot 自托管 / Figma SaaS / Excalidraw 自建），价格与许可数据均于 2026-10-28 实查官方来源：

关键差异与选型建议：

• 三者并非同位竞品：Figma 与 Penpot 对位（完整设计平台），Excalidraw 是白板工具，不能替代 UI 设计与设计系统场景——把 Excalidraw 自建当「Figma 替代」是常见误判，它只覆盖示意/草图/流程图。
• 需要数据主权 + 零席位费 + SSO 集成的团队，Penpot 是当前唯一同时满足三者的设计平台：MPL-2.0 允许自由改造，OAuth/OIDC/LDAP 内置，自托管功能与云端完全一致。
• 已深度投入 Figma 生态（插件、企业工作流、FigJam 白板）的团队，迁移成本是主要考量——官方提供 Figma 导入通道但特性存在损耗，建议双轨试点而非一次性切换。
• 仅需要「团队随手画图」的轻量场景，自建 Excalidraw 成本远低于 Penpot 多服务栈，按需选择即可。

八、参考链接

• Penpot 官网：https://penpot.app/
• 官方仓库：https://github.com/penpot/penpot
• 自托管文档（Self-hosting Guide）：https://help.penpot.app/technical-guide/getting-started/
• Docker 部署文档：https://help.penpot.app/technical-guide/getting-started/docker/
• 配置文档（Configuration）：https://help.penpot.app/technical-guide/configuration/
• 官方编排文件：https://github.com/penpot/penpot/blob/main/docker/images/docker-compose.yaml
• GitHub Releases：https://github.com/penpot/penpot/releases
• 社区论坛：https://community.penpot.app/
• Penpot MCP Server 专题：https://penpot.app/penpot-mcp-server
• Figma 定价页（对比数据来源）：https://www.figma.com/pricing/
• shields.io 取证徽章：https://img.shields.io/github/stars/penpot/penpot.json（2026-10-28 读数 61,752）