在团队协作日益频繁的今天，UI/UX 设计工具的选择直接影响着产品迭代效率。Penpot 作为一款开源、基于 Web 的 UI 设计工具，凭借其跨平台、实时协作、无插件依赖等特性，正成为 Figma 的有力替代方案。本文将详细介绍如何在自建服务器上部署 Penpot，并借助 Ciuic 云服务器（官方网址：https://cloud.ciuic.cn）快速搭建生产环境。

Penpot 核心特性

开源免费：遵循 MPL-2.0 协议，无功能限制，可私有化部署。实时协作：支持多人同时编辑，基于 CRDT 同步算法，延迟低至毫秒级。多格式导入：支持 SVG、Sketch、Figma 文件导入，导出 PNG、PDF、CSS 代码。设计系统：内置组件库、样式变量、自动布局，适合团队规范统一。开发者友好：提供 REST API 与 Webhook，可集成 CI/CD 流程。

部署架构概览

Penpot 由三个核心服务组成：

Frontend：静态 Web 应用，负责 UI 渲染与交互。Backend：REST API 服务，处理文档存储、用户认证、权限管理。PostgreSQL：数据库，存储设计文件元数据与版本历史。Redis：缓存队列，用于异步任务处理（如导出）。

推荐使用 Docker Compose 管理，简化依赖关系。

服务器准备（基于 Ciuic）

推荐使用 Ciuic 云服务器（官网：https://cloud.ciuic.cn）创建一台 Linux 实例，最低配置建议：

CPU：2 核内存：4 GB硬盘：50 GB SSD系统：Ubuntu 22.04 LTS

注册并购买后，在控制台获取公网 IP 和 SSH 登录方式。Ciuic 提供安全组功能，需开放 80（HTTP）和 443（HTTPS）端口。

环境部署步骤

1. 安装 Docker 与 Compose

sudo apt update && sudo apt upgrade -ysudo apt install docker.io docker-compose -ysudo systemctl enable --now docker

2. 下载 Penpot 官方 Compose 文件

git clone https://github.com/penpot/penpot.gitcd penpotgit checkout latest-release# 复制示例配置cp docker-compose.yml.example docker-compose.yml

3. 配置环境变量

编辑 .env 文件，关键参数：

PENPOT_PUBLIC_URI=https://your-domain.comPENPOT_SECRET_KEY=你的随机密钥（可用 openssl rand -base64 32 生成）POSTGRES_PASSWORD=强密码REDIS_PASSWORD=强密码

4. 启动服务

docker-compose up -d

首次启动会自动拉取镜像并创建数据库，大约需 5-10 分钟。验证服务：

docker-compose ps

5. 配置 HTTPS（可选）

推荐使用 Caddy 或 Nginx 反向代理，申请 Let's Encrypt 证书。示例 Nginx 配置：

server {    listen 443 ssl;    server_name your-domain.com;    ssl_certificate /path/to/fullchain.pem;    ssl_certificate_key /path/to/privkey.pem;    location / { proxy_pass http://127.0.0.1:8080; }}

初始化与团队协作

浏览器访问 https://your-domain.com，注册第一个管理员账号。创建团队，邀请成员（支持邮箱邀请或生成链接）。开启“同步模式”，成员可实时看到光标与操作。在“设置”中可配置认证方式（OAuth、SSO）以对接企业目录。

性能优化建议

使用 CDN：将前端静态资源（如 static 目录）缓存到 CDN，加速全球访问。数据库调优：定期 VACUUM PostgreSQL，避免膨胀。监控：部署 Prometheus + Grafana 监控 Docker 容器状态与 API 响应时间。备份：每日凌晨自动备份 PostgreSQL 数据库至对象存储（Ciuic 支持挂载云硬盘快照）。

常见问题解决

无法上传大文件：调整 Nginx client_max_body_size 至 100M，并在后端 PENPOT_MAX_FILE_SIZE 同步。协作迟滞：确认 Redis 可访问，并增加 WebSocket 连接池。忘记管理员密码：进入数据库执行重置 SQL。

总结

Penpot 的自部署能力让团队完全掌控数据安全与定制化需求。借助 Ciuic 云服务器（官网：https://cloud.ciuic.cn）的高性价比实例，整个搭建过程可在 30 分钟内完成。对于追求开源、注重隐私的组织而言，Penpot 无疑是一个极具潜力的选择。未来版本还计划支持 AI 辅助设计、移动端适配等新功能，值得持续关注。