Penpot Docker 部署入门5 步跑起一个自托管设计协作平台【免费下载链接】penpotPenpot: The open-source design platform for Product teams that need scalable collaboration.项目地址: https://gitcode.com/GitHub_Trending/pe/penpotPenpot 是一个开源设计协作平台帮产品团队把设计文件、组件和评审放进同一套自托管系统不依赖外部云服务。它解决的核心问题是数据要留在自己服务器上同时多人能一起改同一个文件。你不需要设计背景也能用起来也没有订阅费用。下面带你用 Docker 跑起一个可用实例再走通创建文件、邀请队友两条常用路径。上手之前它适合你吗数据必须留在内网吗。如果是自托管适合你。如果无所谓云版更省事不必自己跑。团队多大。2 到 20 人协作单台机器就够。超过几十人同时在线先评估服务器内存和磁盘。有人愿意长期维护吗。你要会 Docker 和基本的服务器操作。不会的话建议先用现成托管。有人负责备份吗。数据库和素材都存在 Docker 卷里需要定期备份。没人管的话先别上生产。用最短时间跑起来下面这条路径最短装好 Docker 和 Docker Compose 后依次执行。克隆仓库并进入目录git clone https://gitcode.com/GitHub_Trending/pe/penpot cd penpot验证ls能看到docker和docs两个目录。复制 compose 文件并固定版本启动cp docker/images/docker-compose.yaml docker-compose.yaml PENPOT_VERSION2.16 docker compose -p penpot up -d验证docker compose -p penpot ps显示 backend、frontend、postgres 都是 Up 状态。确认服务已对外监听curl -I http://localhost:9001验证返回 HTTP 200浏览器打开 http://localhost:9001 能看到注册或登录表单。跑起来之后两个典型用法创建第一个设计文件登录后进仪表板点新建文件。给文件命名选一个项目或默认项目。进入工作区左侧工具栏选画板工具在画布拖出一个画板。选中画板右侧属性栏改尺寸和名字。看右上角保存状态确认显示已保存。邀请队友进团队顶部团队选择器拉到最底点 创建新团队。输入团队名回车创建。打开Invite to team窗口填入队友邮箱用逗号分隔。给每个邮箱选角色查看者、编辑者或管理员。点Send invitation在Invitations里看到状态为 pending。对外提供服务前三件必做的事安全密钥。何时做一旦给外人访问就要换。怎么做把 backend 里PENPOT_SECRET_KEY从默认值change-this-insecure-key改成随机串。检查重新 up 后旧登录失效、要求重新登录说明已生效。文件存储。何时做素材变多或想换 S3 时。怎么做本地用PENPOT_OBJECTS_STORAGE_BACKEND: fs配PENPOT_OBJECTS_STORAGE_FS_DIRECTORY指到某目录上生产可换s3并配PENPOT_OBJECTS_STORAGE_S3_BUCKET等参数。检查传一张图后确认文件落到了指定目录或桶里。通知邮件。何时做要发注册和邀请邮件时必须配真实 SMTP。怎么做配PENPOT_SMTP_HOST、PENPOT_SMTP_PORT、PENPOT_SMTP_USERNAME、PENPOT_SMTP_PASSWORD并把PENPOT_SMTP_TLS设为true。检查发一封邀请确认收件箱能收到收不到就查后端日志里的 smtp 关键字。出问题时先看这三处症状容器起不来或反复重启。先查什么docker compose -p penpot ps和 postgres 日志。最可能原因数据库健康检查没过或端口 9001 被占用。docker compose -p penpot logs penpot-backend验证能看到后端最近报错重点找 storage 和 smtp 两类关键字。症状页面能开但图片和上传失败。先查什么backend 日志里的存储报错。最可能原因素材目录没有写权限或 S3 参数没配对。症状能登录但邀请和注册邮件收不到。先查什么PENPOT_SMTP_*是否指向真实 SMTP。最可能原因还在用临时 mailcatch或 TLS 没开。下一步建议把 docs/technical-guide/configuration.md 里与你环境相关的变量过一遍再配上 HTTPS 代理。备份和升级的具体命令在 docs/technical-guide/getting-started/docker.md 里都有。【免费下载链接】penpotPenpot: The open-source design platform for Product teams that need scalable collaboration.项目地址: https://gitcode.com/GitHub_Trending/pe/penpot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考