极空间部署Photopea:Docker运行、网页修图与多设备使用
前言
Photopea 的特点在于,它把类似桌面图像编辑器的操作界面搬到了浏览器中。对于已经长期运行极空间 NAS、又有 Docker 环境的用户来说,可以把这类 Web 图像编辑工具部署到自己的设备上,再通过浏览器访问。
本文按照现有实操流程展开:先通过 SSH 连接极空间并确认 Docker 环境,再创建 /docker/Photopea 目录,拉取对应镜像,通过 Docker 将容器内部 2887 端口映射到宿主机 2000 端口,最后在浏览器访问 http://极空间IP:2000。
本地页面打开以后,还会继续验证实际修图界面和基础操作,而不是只看容器有没有启动。这样可以确认从 NAS、Docker、端口映射到 Web 页面这一整条链路都已经正常。
最后再补充异地访问和固定地址的配置,让 Photopea 不只停留在家庭局域网里。整篇重点放在"部署---访问---实际操作---多设备使用"这条完整链路,而不是单纯把它当成一个 NAS 应用来介绍。
对于第一次在 NAS 上部署这类 Web 工具的人来说,先把本地服务跑通,再处理外部访问,会比一开始同时排查容器和网络问题更清楚。
对于这种 Web 图像编辑工具,我更看重的是页面能不能稳定打开、操作链路是不是简单,而不是单纯追求功能数量。
1. 为什么我会想把修图工具放到 NAS 上
临时修图这件事,真正麻烦的往往不是功能不够,而是工具不在手边。
桌面 Photoshop 功能够强,但需要安装;手机 App 随手能用,但复杂操作不一定顺手。如果 NAS 本身一直在线,那把一个浏览器里的图像编辑工具放进去,反而多了一种更轻的使用方式。

这里用到的是 Photopea。它的界面和常见图像编辑软件比较接近,支持图层、选区、文字等常见操作,浏览器打开以后就可以直接使用。
原稿还先介绍了 Photoshop 的一些典型能力,比如:
- 图层、蒙版、通道、路径;
- 选区、画笔、修复、调色、文字等工具;
- PSD、JPEG、PNG、TIFF、GIF 等格式;
- 摄影后期、平面设计、UI、插画和图像修复等场景。
对我来说,这里没必要把 Photopea 当成桌面 Photoshop 的完全替代,更实际的定位是:需要临时修图、又不想每台设备都安装软件时,多一个随手能打开的入口。
2. 部署前先确认 SSH 和 Docker
2.1 SSH 连接极空间
先在极空间里开启 SSH 服务,然后从电脑终端连接:
shell
ssh root@IP
原稿还给出了对应参考文章:
《极空间别再吃灰了!开启SSH,秒变全能服务器!》

SSH 能正常连接以后,再继续确认 Docker。
2.2 检查 Docker
执行:
shell
docker -v
systemctl status -v
如果设备还没有 Docker,原稿也提供了极空间 Docker 环境的参考文章。

我会先把这两步确认好,因为后面 Photopea 本身就是通过 Docker 运行的。基础环境有问题,继续往下拉镜像只会让排错更乱。
3. 在极空间部署 Photopea
3.1 创建目录
先创建 Photopea 目录并进入:
shell
mkdir /docker/Photopea -p && cd /docker/Photopea

3.2 拉取镜像
执行:
shell
docker pull registry.cn-guangzhou.aliyuncs.com/os_cmty/os_cmty:Photopea

等镜像下载完成以后,再继续启动容器。
3.3 启动 Photopea 容器
执行:
shell
docker run -d --name Photopea -p 2000:2887 registry.cn-guangzhou.aliyuncs.com/os_cmty/os_cmty:Photopea

这里最关键的是端口映射:
2000:2887
也就是浏览器最终访问极空间的 2000 端口。
3.4 打开网页
部署完成以后,在浏览器输入:
http://极空间IP:2000

能看到 Photopea 页面以后,说明 NAS、Docker、镜像和端口映射这一整条本地链路已经跑通。
接下来就可以直接在页面里操作:

对我来说,这一步比"docker ps 显示容器正在运行"更有意义。因为真正要验证的是修图页面能不能打开、能不能实际使用。
4. 为什么我更在意"随手能打开"
原稿后半段提出了几个比较典型的场景:
- 外出时临时需要改一张图;
- 手机 App 功能不够;
- 不想把照片上传到陌生在线工具;
- 想在平板、手机或笔记本上直接通过浏览器操作。
这也是我觉得把 Photopea 放到 NAS 上比较有意思的地方。
如果只是坐在自己的电脑前,我完全可以继续用熟悉的桌面软件;但当设备变了、地点变了,浏览器入口的优势才会出来。
5. 本地修图页面跑通后,再处理外部访问
前面的 Photopea 目前主要还是局域网使用。
如果还想从公司、平板或者其他外部网络访问,就需要给 2000 这个 Web 服务增加外部入口。
这里 cpolar 负责的是网络访问这一层,Photopea 本身仍然负责图像编辑。
6. 安装 cpolar
6.1 cpolar 的作用
cpolar 可以把局域网中的 Web、SSH 等服务映射到公网,不需要先配置公网 IP 或路由器端口转发。
6.2 安装
执行:
shell
sudo curl https://get.cpolar.sh | sh

安装完成以后查看服务状态:
shell
sudo systemctl status cpolar

浏览器通过主机 IP 加 9200 进入 cpolar Web UI:

7. 给 Photopea 创建远程访问地址
登录 cpolar Web UI 后创建隧道。
参数按原配置:
- 隧道名称:
photo - 协议:
http - 本地地址:
2000 - 域名类型:随机域名
- 地区:
China Top

创建以后,在在线隧道列表查看生成的地址:

再从其他设备测试:

能够打开 Photopea 页面以后,说明远程 Web 入口已经生效。
8. 配置固定二级子域名
如果准备长期从外面使用,再继续配置固定地址。

进入预留页面,地区选择 china Top,名称示例使用 photoo:

然后回到隧道列表,找到对应隧道并编辑:

把域名类型改成二级子域名,并填写已经保留成功的名称:

更新以后,再到在线隧道列表查看:

最后使用固定地址重新访问:

这样,Photopea 的固定远程入口就配置完成了。
9. 这套方案真正适合什么人
我觉得它最适合的,不是想在 NAS 上复制一整套专业设计工作站的人。
更合适的场景是:家里本来就有极空间,平时偶尔需要修图、改 PSD、处理临时图片,又希望电脑、平板之间不用反复装软件。
这种时候,一个一直运行在 NAS 上、浏览器就能打开的图像编辑入口,会比"每台设备都重新配环境"轻很多。
总结
整套流程可以拆成三层:极空间提供 NAS 与 Docker 运行环境,Photopea 容器提供浏览器图像编辑页面,远程访问部分负责把已经运行好的 2000 Web 服务带到局域网之外。
本地部署时,核心步骤是 SSH、Docker 检查、目录创建、镜像拉取、容器启动和端口映射。浏览器真正能打开 Photopea 页面以后,才说明本地链路已经完整。
需要多设备或异地访问时,再继续创建 2000 隧道,并根据长期使用需求配置固定二级子域名。这样从本地部署到浏览器使用,再到外部访问,整个流程才真正闭环。
对于长期使用,我会更关注 NAS 运行状态、容器更新和访问入口安全。Photopea 的价值不只是"像 Photoshop",而是把图像编辑变成了一个随时可以从浏览器打开的工具。