云图

「云图」是一个轻量级、功能开放的自托管图床项目，专为有 NAS、注重控制权、希望避免商业图床限制的用户设计。

它的诞生源于实际需求：在使用 n8n 自动化流程时，频繁涉及图片上传、转换与分发，但现有开源图床要么年久失修，要么核心功能被锁在 PRO 版本中。于是，作者基于自身 NAS 环境，开发了这个完全免费、无功能阉割、API 友好的替代方案。

核心特点

• 极简设计：界面干净，无广告、无追踪
• NAS 友好：Docker 部署，支持 UID/GID 权限控制
• PicGo 原生支持：可直接通过插件安装，无缝集成
• 开放 API：提供完整的 RESTful 接口，便于自动化调用
• 实时图片处理：通过 URL 参数动态调整尺寸、格式、质量
• 本地存储：所有文件保存在你指定的目录，数据完全自主

功能详解

图片管理

• 多图拖拽上传，支持批量操作
• 瀑布流展示，支持圈选批量删除
• 多级子目录管理，组织更清晰
• 移动端适配，手机访问体验良好
• 多主题切换（亮色/暗色等）

API 支持（全部开放）

• 图片上传：支持 Base64 编码
• 获取图片：支持动态参数处理（见下文）
• 随机图片：/api/random 返回一张随机图
• 图片列表：分页获取所有图片元数据
• 图片删除：通过 ID 或路径删除
• SVG 转 PNG：自动将 SVG 渲染为 PNG 图像
• 全局文件上传：不仅限于图片，支持任意格式（如 PDF、ZIP 等）

实时图片处理（URL 参数）

无需预处理，直接在 URL 中指定参数，服务端自动返回处理后的图像：

https://your-domain.com/image.jpg?w=500&h=300&q=80&fmt=webp

参数说明：

• w：宽度（px）
• h：高度（px）
• q：质量（1–100，仅适用于 JPEG/WebP）
• fmt：输出格式（jpg、png、webp、avif 等）

原图不变，处理结果按需生成，兼顾灵活性与存储效率。

安全与分享

• 可选密码保护：设置 PASSWORD 环境变量后启用
• 登录状态保存在浏览器 LocalStorage，无需频繁输入
• 相册分享：可生成带密码或公开的分享链接
• 一键复制链接：上传后自动复制直链，方便粘贴
• 缩略图优化：集成 ThumbHash，实现“无感加载”——在图片加载前显示低质量占位图，提升体验

开发者友好

• 所有接口文档清晰，易于集成到自动化流程（如 n8n、Node-RED、自定义脚本）
• 支持自定义压缩策略（质量 + 尺寸）
• 上传目录可挂载到 NAS 共享文件夹，实现多设备访问

快速部署（Docker Compose）

创建 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 用户 ID（运行 `id -u` 获取）
      - PGID=1000    # 替换为你的用户组 ID（运行 `d -g` 获取）
      - UMASK=002
      - NODE_ENV=production
      - PORT=3001
      - STORAGE_PATH=/app/uploads
      # - PASSWORD=your_secure_password_here  # 取消注释以启用密码

启动服务：

docker compose up -d

访问 http://你的IP:3001 即可使用。

💡 权限提示：正确设置 PUID/PGID 可避免 NAS 上文件权限混乱，确保其他应用也能正常读写上传目录。

PicGo 插件安装

1. 打开 PicGo
2. 进入「插件设置」→「搜索插件」
3. 搜索 cloudimgs 并安装
4. 配置服务器地址（如 http://192.168.1.100:3001）
5. 如启用了密码，填入即可

此后，截图、拖图均可一键上传至你的私有图床。

适用场景

• 家庭 NAS 用户搭建私有图床
• 技术博主/开发者管理文章配图
• 自动化流程（如 n8n）中作为图片中转站
• 需要 WebP/AVIF 转换、SVG 渲染等高级处理的项目
• 对数据隐私敏感，拒绝第三方图床上传