使用 Docker 自托管
在自有服务器上用官方 Docker Compose 方式运行完整的希爱设计(Penpot)实例,包含前端、后端、数据库与周边服务。
整体架构
希爱设计基于 Penpot 的开源架构,自托管实例由前端(Nginx + Web)、后端 API、管理服务、实时协作(Realtime/Exporter)以及 PostgreSQL、Redis 等基础服务组成。官方提供 Docker Compose 编排文件,一条命令即可拉起完整环境。
环境要求(建议)
- 一台运行 Linux 的服务器(x86_64 或 ARM64)
- 至少 2 vCPU / 4 GB 内存,生产环境建议 4 vCPU / 8 GB 以上
- 20 GB 以上可用磁盘,团队越大建议容量越高
- 已安装 Docker 与 Docker Compose 插件
- 一个可解析到服务器的域名,用于配置 HTTPS 访问
快速部署
- 获取官方 penpot 仓库中的 docker-compose 配置文件与环境变量模板
- 复制 .env 模板,重点修改公网访问地址、密钥与邮件配置
- 执行 docker compose -p penpot up -d 拉取镜像并启动全部服务
- 等待容器健康检查通过,用浏览器访问服务器地址完成初始化
- 注册第一个账号,该账号默认拥有实例的管理权限
- 配置反向代理与 HTTPS 证书,然后开放给团队成员使用
上线前检查清单
- 公网访问地址(PUBLIC_URI/DOMAIN)与实际域名一致
- 默认密钥、数据库口令已替换为强随机值
- SMTP 邮件发送可用(邀请与通知依赖邮件)
- 已为数据库与资源目录配置定期备份
- 反向代理开启 WebSocket 支持,保证实时协作正常
- 防火墙仅暴露必要端口,管理端口不对公网开放
不想自己运维?
不想自己运维?
希爱设计提供私有化部署服务:软件本身免费,可按需要购买部署、培训与运维支持,由团队协助完成上线与后续升级。
实用提示
- 先用一台测试服务器跑通完整流程,再迁移到生产环境。
- 升级前先备份数据库与 .env 配置,并阅读对应版本的升级说明。