Docker 30分钟自托管 Penpot

Docker 30分钟自托管 Penpot【免费下载链接】penpotPenpot: The open-source design platform for Product teams that need scalable collaboration.项目地址: https://gitcode.com/GitHub_Trending/pe/penpot团队的设计文件不想放在别人的 SaaS 上所以我在自己的 VPS 上自托管了一套 Penpot用 Docker Compose 拉起的整个过程 30 分钟中途踩了 2 个坑。它和 Figma 最大的区别文件是标准的 .penpot 格式数据全在自己手里开发者还能直接在图层面板拿到 CSS/SVG。下面按我实际操作的顺序讲。先跑起来最短路径整条路径就两条命令链clone 仓库把官方生产 compose 文件拿出来直接用。git clone https://gitcode.com/GitHub_Trending/pe/penpot cd penpot cp docker/images/docker-compose.yaml ./docker-compose.yaml # 固定版本号别裸用 latest升级时才可控 PENPOT_VERSION2.16 docker compose -p penpot up -dcompose 文件里已经把 frontend、backend、PostgreSQL、Valkey 缓存、临时邮件服务都编排好了第一次跑要拉镜像等几分钟。跑通后验证curl -I http://localhost:9001浏览器打开http://localhost:9001能看到登录页就算活了按需配置只动你要用的官方 compose 文件顶部有全量 flag 清单改之前先翻一眼再对着 docs/technical-guide/configuration.md 查细节。下面四个场景是我真用过的改哪段动哪段。当你需要让团队用 GitHub 账号登录的时候environment: # 追加 login-with-github 到 PENPOT_FLAGS PENPOT_GOOGLE_...: # 换成对应提供商 PENPOT_GITHUB_CLIENT_ID: your_client_id_here PENPOT_GITHUB_CLIENT_SECRET: your_client_secret_here # ... 其余保持不变注意OAuth 应用的回调地址要填https://你的域名/api/rpc/command/oauth-callback填错就登录死循环。当设计资产太多想存到 S3/对象存储的时候environment: PENPOT_OBJECTS_STORAGE_BACKEND: s3 # 默认是 fs数据在 penpot_assets 卷里 PENPOT_OBJECTS_STORAGE_S3_ENDPOINT: https://your_endpoint_here PENPOT_OBJECTS_STORAGE_S3_BUCKET: your_bucket_here AWS_ACCESS_KEY_ID: your_access_key_here AWS_SECRET_ACCESS_KEY: your_secret_key_here # ... 其余保持不变注意桶的 CORS 和公共读权限没配好图片资源会全部加载失败而且只发生在用户上传图片之后启动时看不出来。当你想关掉自助注册、只允许管理员建号的时候environment: # 从 PENPOT_FLAGS 里删掉 registration PENPOT_FLAGS: enable-smtp enable-prepl-server # ... 其余按需保留关掉后唯一建号途径是进 backend 容器执行python3 manage.py create-profile漏掉enable-prepl-server这个 flag 脚本就跑不了。当你要接 CI/CD 自动导出设计稿的时候团队设置里建个访问令牌让流水线直接调导出接口注意令牌等同于账号权限发出去就存进 secrets 里别贴到代码库。上生产前必须做的三件事1. 换掉默认的 PENPOT_SECRET_KEY。它是会话、邀请令牌等所有加密密钥的根默认值change-this-insecure-key是公开的等于谁都能伪造你的登录态。python3 -c import secrets; print(secrets.token_urlsafe(64))把输出填进 compose 的x-secret-key段。不改的后果拿到这份 compose 文件的人可以任意伪造用户会话。2. 配一条真实的 SMTP 通道。compose 内置的 mailcatch 只是临时收件箱验证邮件永远发不到用户手上。environment: PENPOT_SMTP_HOST: smtp.your_provider_here PENPOT_SMTP_PORT: 587 PENPOT_SMTP_USERNAME: your_smtp_user_here PENPOT_SMTP_PASSWORD: your_smtp_pass_here PENPOT_SMTP_TLS: true # ... 其余保持不变不配的后果用户注册验证邮件永远收不到只能靠手动放行团队一多就乱。3. 上 HTTPS反代只给关键行。生产环境别裸奔 9001 端口用 Nginx 或 Traefik 反代到 backend。location /ws/ { proxy_pass http://127.0.0.1:9001; proxy_set_header Upgrade $http_upgrade; # WebSocket 必须多人协作靠它 proxy_set_header Connection upgrade; } client_max_body_size 350M; # 别用 Nginx 默认的 1MB上传必挂/ws/的 Upgrade 头漏掉多人实时协作消息会卡住不刷新body 限制不同步上传大文件 500。我踩过的坑现象frontend 容器反复重启docker compose ps里一直 RESTARTING。原因不是配置错了是启动顺序——backend 等 Postgres 和 Valkey 健康检查通过才起frontend 又依赖 backend首跑要几分钟。解决别急着查日志docker compose ps盯到全绿真卡住了docker compose logs penpot-backend看是否数据库还在初始化。现象第一次部署就栽在这——登录后刷新页面就掉回登录页。原因PENPOT_PUBLIC_URI还停留在http://localhost:9001和你实际的访问地址对不上会话 cookie 写不进去。解决把它改成你的真实域名改完 backend 和 frontend 都要重启。现象上了反代之后大文件上传报 413。原因Nginx 默认client_max_body_size是 1MB看着吓人其实一行配置的事。解决代理层加client_max_body_size 350M;和 Penpot 的PENPOT_HTTP_SERVER_MAX_BODY_SIZE保持一致。日常维护5条命令够用了备份数据库docker exec penpot-penpot-postgres-1 pg_dump -U penpot penpot db_$(date %F).sql备份资产卷docker run --rm -v penpot_penpot_assets:/data alpine tar czf assets_$(date %F).tar.gz -C /data .健康检查docker compose -p penpot ps所有服务都应该是 healthy/Up看日志docker compose -p penpot logs -f penpot-backend升级docker compose -p penpot pull docker compose -p penpot up -d跨大版本别跳小步升官方全量配置项和 flag 清单都在 docs/technical-guide/configuration.md下次升级前翻一遍。现在就去把 compose 里的PENPOT_SECRET_KEY和数据库密码换成自己的值这是上生产前最不值钱也最不能省的一步。【免费下载链接】penpotPenpot: The open-source design platform for Product teams that need scalable collaboration.项目地址: https://gitcode.com/GitHub_Trending/pe/penpot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考