Penpot 自托管怎么选：开源设计工具的 Docker、协作和开发交付思路

penpot/penpot 是一个开源设计工具，定位接近 Figma，但更强调开源、自托管、设计和代码协作。它适合想把设计资产、组件和交付流程掌握在自己手里的团队。

项目地址：

https://github.com/penpot/penpot

官网：

https://penpot.app

Penpot 适合谁

Penpot 适合这些场景：

1. 团队希望使用开源设计工具。
2. 公司不希望设计文件完全放在第三方 SaaS。
3. 设计和前端之间需要 Inspect Mode、设计系统和组件交付。
4. 想基于设计 tokens、components、variants 建立长期设计规范。

如果只是个人临时画图，直接用在线版会更省事。自托管更适合团队长期使用。

自托管入口

README 没有把完整 Docker Compose 贴在首页，而是指向官方 self-host 文档：

1

https://penpot.app/self-host

实际部署时建议按官方文档走 Docker 或 Kubernetes，而不是从网上复制旧 compose。Penpot 这类协作工具通常不只是一个容器，还会涉及数据库、对象存储、后台任务和邮件服务。

一个稳妥的自托管流程是：

1
2
3
4
5

# 1. 先阅读官方 self-host 文档
# 2. 准备域名、HTTPS、持久化目录和数据库
# 3. 使用官方推荐的 Docker / Kubernetes 方式启动
# 4. 创建管理员账号
# 5. 导入或创建团队空间

开发交付怎么用

Penpot 对开发者比较有用的是 Inspect Mode。设计师完成页面后，开发可以查看：

1. 尺寸和间距。
2. 颜色和字体。
3. 组件结构。
4. 设计 token。
5. 可复用组件和 variants。

这比截图标注更稳定，也更适合多人协作。

建议的团队流程

可以按这个方式落地：

1. 设计师在 Penpot 建立 design system。
2. 组件命名尽量和前端组件库一致。
3. 颜色、字号、间距用 token 管理。
4. 开发通过 Inspect Mode 查样式，不再靠口头描述。
5. 大版本前导出或备份设计文件。

注意点

Penpot 是协作系统，不是单文件工具。自托管时要考虑升级、备份、权限、邮件、HTTPS 和存储。建议先用测试环境跑一遍完整流程，再迁移团队正式设计资产。