群晖/威联通/极空间 Docker 部署「云图」：打造你的终极私有图床

今天给大家安利一个刚刚出炉、颜值非常能打，且功能硬核的开源图床项目——云图 (CloudImgs)。

如果你是 NAS 玩家，或者平时有写博客、做笔记、整理素材的需求，你一定遇到过这些痛点：

公共图床不稳定：不仅要付费，还担心哪天跑路，图片全挂。
NAS 自带相册太重：只想存点博客配图或设计素材，系统自带的相册往往功能过剩，且不支持直链。
缺乏 API 支持：想用 N8N 做自动化流程，或者想在 Markdown 里直接调整图片大小，找不到好用的工具。

「云图」就是为了解决这些问题诞生的。它轻量、好看、支持 API，而且 Docker 一键部署！

01. 为什么选择「云图」？

🎨 始于颜值：极简瀑布流

咱们折腾 NAS，软件的颜值也是生产力的一部分。云图采用了现代化的瀑布流布局。最让我惊喜的是它集成了 Thumbhash 技术，图片列表加载时会有非常优雅的模糊占位符，浏览成百上千张图片也丝滑无感，体验极佳。

⚡ 强于内核：不仅仅是存储

云图不仅仅是个存图片的地方，它更像是一个图片处理引擎。这也是我最推荐它的理由——强大的 API 支持。

实时处理：你可以通过 URL 参数直接改变图片。比如 image.jpg?w=500&fmt=webp，它就会自动把图片缩放到 500px 宽并转换为 WebP 格式返回。这对于博客优化加载速度简直是神器！
格式转换：支持 SVG 一键转 PNG。
自动化友好：完美适配 N8N 等自动化工具。

🛠️ 生产力闭环：PicGo 插件

对于经常写文的朋友，云图开发了专属的 PicGo 插件。配置好之后，截图 -> 快捷键上传 -> 粘贴 Markdown 链接，一气呵成。你的数据在自己手里，体验却和付费图床一样爽。

🔒 安全与便捷并存

批量管理：支持鼠标像在 Windows/Mac 上一样批量圈选、删除。
私有相册：支持设置访问密码，保护你的隐私。
一键分享：生成的相册链接可以直接发给朋友。

02. Docker 部署保姆级教程

无论你是群晖 (Synology)、威联通 (QNAP)、极空间 还是绿联，只要支持 Docker (现在的 NAS 基本都支持)，都可以轻松部署。

第一步：准备工作

在 NAS 的 Docker 文件夹下创建一个文件夹，命名为 cloudimgs。
在里面再创建一个子文件夹 uploads，用于存放图片。
确保你知道你的 PUID 和 PGID（一般默认 1000 即可，群晖用户可以在 SSH 输入 id 查看，或者直接用 root 权限运行）。

第二步：配置 docker-compose.yml

云图支持 Docker Compose 部署，这是最推荐的方式，日后升级维护都方便。

打开你的 Docker 管理器（群晖是 Container Manager，威联通是 Container Station），创建一个新的项目/应用，粘贴以下代码：

YAML

version: '3' services: cloudimgs: image: qazzxxx/cloudimgs:latest container_name: cloudimgs-app ports: - "3001:3001" # 左边的端口可以根据自己NAS的情况修改 volumes: - ./uploads:/app/uploads:rw # 冒号左边请修改为你NAS的实际路径 restart: unless-stopped environment: - PUID=1000 # 替换为你实际的用户ID - PGID=1000 # 替换为你实际的组ID - UMASK=002 - NODE_ENV=production - PORT=3001 - STORAGE_PATH=/app/uploads # ↓↓↓ 强烈建议设置密码，开启私人模式 ↓↓↓ - PASSWORD=你的强密码123456