我为 NAS 党手撸了一个极简且强大的开源云图库CloudImgs（云图）

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

爱意满满的作品展示区。

今天想和大家分享一个我最近开发的开源项目**云图 (CloudImgs)**。

这是一个极简风格的自建图床/云图库，支持 Docker 一键部署，完美适配 NAS 环境，并且拥有超灵活的 API 接口。

为什么要造这个轮子？

说实话，起初我并没有打算写个图床。

事情的起因是我在使用 N8N 处理自动化工作流时，遇到了大量的图片处理需求。我尝试寻找现有的开源解决方案，但结果并不理想：

太老旧：很多曾经优秀的开源项目已经几年没更新了，UI 停留在十年前，代码维护也停滞了。
要付费：好用一点的现代图床，往往需要购买 PRO 版本才能解锁高级功能（如图片压缩、格式转换等）。
功能过剩或不足：有的太复杂，有的又太简陋，不支持 API 自动化调用。

既然我自己有 NAS，又懂一点代码，为什么不自己写一个呢？于是，云图 (CloudImgs) 诞生了。它主打自由、开放、极简，专为解决实际问题而来。

在线体验

先别急着看技术细节，大家可以直接上手体验一下 UI 和交互。

演示地址：https://yt.qazz.site
访问密码：123456

注：演示站为纯静态 Mock 模式，上传/删除仅演示 UI 交互，数据不保存。真实部署后，体验会更好（特别是缩略图加载）。

核心亮点：不仅仅是存图片

1. 颜值即正义：极简瀑布流 & 丝滑交互

我们抛弃了繁杂的后台界面，采用现代化的瀑布流布局。集成 ThumbHash 技术，在图片未完全加载时通过算法生成极小的占位哈希图，实现无感加载，告别“白屏”等待，视觉体验极佳。

2. 生产力工具：PicGo 插件无缝集成

对于写博客、Markdown 文档的朋友，图床的便捷性至关重要。云图原生支持 PicGo，我已经写好了对应的插件，安装即用。截图 -> 自动上传 -> 粘贴链接，一气呵成。

PicGo 插件地址

3. 开发者福音：强大的实时处理 API

这是我最自豪的功能之一。云图不仅仅是存储，还是一个即时的图片处理引擎。你可以通过 URL 参数实时处理图片：

格式转换：image.jpg?fmt=webp (自动转 WebP ，节省带宽)
尺寸调整：image.jpg?w=500&h=300 (强制缩放)
质量压缩：image.jpg?q=80 (80% 质量压缩)

这就意味着，你上传一张 4K 原图，在不同设备上可以通过参数调用不同尺寸的缩略图，极大减轻前端压力。

4. 全能管理与安全

多级目录：支持文件夹管理，井井有条。
隐私保护：支持设置访问密钥，保护你的私有图片。
全格式支持：不仅仅是 JPG/PNG ，SVG 甚至其他文件格式也能传。
SVG 转 PNG：专为设计师和前端优化的功能。
批量操作：支持圈选批量删除，效率拉满。

极速部署 (NAS/Docker)

作为 NAS 党，我深知部署难度的痛点。云图完全 Docker 化，只需要一个 docker-compose.yml 即可跑起来。

1. 创建 docker-compose.yml

services: cloudimgs: image: qazzxxx/cloudimgs:latest ports: - "3001:3001" volumes: - ./uploads:/app/uploads:rw # 图片数据存储位置 restart: unless-stopped container_name: cloudimgs-app environment: - PUID=1000 # 替换为你 NAS 用户的 UID (终端输入 id -u 查看) - PGID=1000 # 替换为你 NAS 用户组的 GID (终端输入 id -g 查看) - UMASK=002 - NODE_ENV=production - PORT=3001 - STORAGE_PATH=/app/uploads # 如果需要密码访问，请取消下面这行的注释并修改密码 # - PASSWORD=your_secure_password_here