零停机部署Penpot：Docker与Kubernetes实战指南

零停机部署Penpot：Docker与Kubernetes实战指南

【免费下载链接】penpot Penpot - The Open-Source design & prototyping platform 项目地址: https://gitcode.com/GitHub_Trending/pe/penpot

你是否还在为设计工具的部署繁琐而头疼？团队协作时文件同步困难？本文将带你通过Docker Compose和Kubernetes两种方式，在15分钟内完成Penpot（开源设计与原型平台）的生产级部署，解决数据安全、版本管理和团队协作三大痛点。读完本文你将获得：

• Docker Compose一键部署方案及配置优化
• Kubernetes高可用集群部署指南
• 性能调优与监控告警最佳实践
• 常见问题排查流程图

Docker Compose快速部署

环境准备

Penpot官方提供了完整的Docker Compose配置文件，位于docker/images/docker-compose.yaml。部署前需确保：

• Docker Engine ≥ 20.10
• Docker Compose ≥ 2.10
• 至少2GB内存和20GB磁盘空间

一键启动流程

1. 获取配置文件

   git clone https://gitcode.com/GitHub_Trending/pe/penpot
   cd penpot/docker/images
   

2. 启动服务栈

   docker compose up -d
   

   该命令会自动拉起6个容器：前端、后端、数据库、缓存、导出服务和邮件测试服务，架构如图所示：

   

3. 验证部署 访问 http://localhost:9001 ，出现登录界面即表示部署成功。默认管理员账户可通过日志获取：

   docker compose logs penpot-backend | grep "initial admin user"
   

生产环境优化

安全加固

• 生成密钥：取消docker/images/docker-compose.yaml中第136行注释，使用以下命令生成安全密钥：

  python3 -c "import secrets; print(secrets.token_urlsafe(64))"
  

• 启用HTTPS：配置Traefik反向代理，参考配置文件中第54-72行的Traefik服务定义，替换<DOMAIN_NAME>为实际域名

持久化配置

卷名	用途	备份建议
penpot_postgres_v15	数据库数据	每日全量+WAL日志
penpot_assets	设计文件存储	实时同步至对象存储

Kubernetes高可用部署

架构设计

生产环境推荐使用Kubernetes部署，官方提供Helm Chart支持。典型架构包含：

• 3个后端Pod（抗单点故障）
• 2个前端Pod（负载均衡）
• PostgreSQL集群（主从复制）
• Valkey集群（缓存与消息队列）

部署步骤

1. 添加Helm仓库

   helm repo add penpot https://penpotapp.github.io/helm-charts
   helm repo update
   

2. 创建自定义配置 创建values.yaml覆盖默认配置，关键参数：

   replicaCount: 3
   persistence:
     enabled: true
     size: 50Gi
   database:
     external: true
     host: postgres-proxy.example.com
   

3. 执行安装

   helm install penpot penpot/penpot -f values.yaml --namespace design --create-namespace
   

状态监控

通过Prometheus+Grafana监控关键指标，推荐仪表盘配置：

• 后端JVM内存使用（阈值：≥80%告警）
• 数据库连接数（阈值：≥100告警）
• 导出服务队列长度（阈值：≥50告警）

常见问题解决方案

性能优化

1. 资源调整

   • 后端容器内存限制设为2Gi（默认1Gi）
   • 数据库shared_buffers设为物理内存25%

2. 缓存策略 启用Valkey集群模式，配置文件位于docker/devenv/docker-compose.yaml第104-112行，调整以下参数：

   command: valkey-server --cluster-enabled yes --maxmemory 1G
   

故障排查

服务启动失败

1. 检查数据库连接：

   kubectl exec -it penpot-backend-0 -- psql -h penpot-postgres -U penpot
   

2. 查看初始化日志：

   docker compose logs penpot-backend | grep -i error
   

导出功能异常

流程图解故障排查路径：

总结与展望

本文详细介绍了Penpot的两种部署方案：Docker Compose适合小团队快速启动，Kubernetes适合企业级高可用需求。官方文档docs/technical-guide/getting-started/index.md还提供了Elestio和Truenas等部署选项。

未来版本将支持：

• 自动扩缩容配置
• 多区域备份策略
• 基于Istio的流量管理

建议收藏本文，关注项目README.md获取最新更新。如有部署问题，欢迎在社区论坛交流。

提示：生产环境务必定期备份docker/images/docker-compose.yaml和数据库，避免配置丢失导致服务不可用。

【免费下载链接】penpot Penpot - The Open-Source design & prototyping platform 项目地址: https://gitcode.com/GitHub_Trending/pe/penpot