本文属于「自托管 Docker 部署实战」系列（共 35 篇），第 26 篇。 示例中的 IP（192.0.2.10）、域名（example.com）、密码均为占位符，请按实际环境替换。

它是什么

Photopea 是一个浏览器里的「免费版 Photoshop」，支持 PSD、XCF、Sketch、AI 等格式的打开与编辑。ramuses/photopea 是把它打包成自托管容器，方便在离线/内网环境使用。

前置条件

  • 一台 Linux 服务器（1C512M 起）；
  • 已安装 Docker 与 Compose v2；
  • 浏览器建议 Chrome/Edge，运行时会占用较多内存。
curl -fsSL https://get.docker.com | sh
mkdir -p /srv/docker/active/photopea && cd /srv/docker/active/photopea

镜像地址

ramuses/photopea:latest

目录结构

/srv/docker/active/photopea/
└── docker-compose.yml

部署步骤

# docker-compose.yml
services:
  photopea:
    image: ramuses/photopea:latest
    container_name: photopea
    restart: unless-stopped
    ports:
      - "8887:8887"

docker compose up -d

打开 http://<SERVER_IP>:8887，即可新建/打开图片开始编辑。

关键配置

项 说明
8887 Web 端口，容器内同为 8887
数据卷 无，纯前端应用
浏览器要求 需要较新的浏览器与足够内存

注意事项

  • 这是第三方打包镜像，不是 Photopea 官方发布，生产使用前确认镜像来源；
  • 图片处理在浏览器本地完成，文件不会上传到服务器，隐私上比在线版更可控；
  • 没有账号与云存储，关掉页面未保存的内容会丢，重要文件及时导出；
  • 大 PSD 在低配电脑上会卡，服务器本身压力不大；
  • 无状态，升级直接换 tag。

备份与升级

# 无数据需要备份
docker compose pull
docker compose up -d
  • 升级后打不开，先在浏览器控制台看静态资源 404，再检查镜像是否完整。