### [云图 – 极简风格的云图库，无数据库图床项目，支持NAS部署，支持设置密钥，支持各种灵活的API开放接口，NAS图床，PicGo插件直接安装使用](https://www.appmiao.com/article/2595)

**Published:** 2025-12-30T02:17:12

**Author:** 阿喵

**Excerpt:** 项目的开始是用 N8N处理相关流程 时有很多图片处理的需求，找了很多开源项目有的比较老无人维护，有的需要购买PRO版本才能有更多的功能。以上种种原因吧，再加上自己也有NAS，所以写了一个比较自由开放的图床项目。 🚀 功能特点 软件预览 登录

> 项目的开始是用 **N8N处理相关流程** 时有很多图片处理的需求，找了很多开源项目有的比较老无人维护，有的需要购买PRO版本才能有更多的功能。以上种种原因吧，再加上自己也有NAS，所以写了一个比较自由开放的图床项目。

## 🚀 功能特点[](https://github.com/qazzxxx/cloudimgs#-%E5%8A%9F%E8%83%BD%E7%89%B9%E7%82%B9)

-   支持各种灵活开放API
    -    图片上传接口-支持base64
    -    随机图片接口
    -    获取指定图片（支持尺寸/质量/格式处理）
    -    SVG 转 PNG接口
    -    图片列表接口
    -    图片删除接口
-    图片上传，多图拖拽一键上传
-    支持压缩图片大小
-    支持URL参数实时处理图片 （如：image.jpg?w=500&h=300&q=80&fmt=webp 自动将原图转换为WebP 、宽500px，高300px，图片质量压缩到80% 返回）
-    支持PicGo插件直接安装使用[PicGo插件](https://github.com/qazzxxx/picgo-plugin-cloudimgs-uploader)
-    支持上传其他文件格式，全局上传
-    在线管理图片，瀑布流展示，批量圈选删除
-    相册分享
-    集成thumbhash无感生成缩略图加载图片列表优化
-    支持设置密钥，保护图片安全
-    支持多级子目录管理
-    支持 SVG 图片转换为 PNG 格式
-    支持图片压缩工具，可自定义压缩质量和尺寸
-    支持图片分享，一键复制图片链接
-    支持多主题样式切换
-    移动端适配
-    更多功能，等你来发现

## 软件预览[](https://github.com/qazzxxx/cloudimgs#%E8%BD%AF%E4%BB%B6%E9%A2%84%E8%A7%88)

登录页面 

![](https://pic.amiao.app/2025/12/26062730/31001.webp)

[](https://github.com/qazzxxx/cloudimgs/blob/main/client/public/login.jpg)

图片管理页面 

![](https://pic.amiao.app/2025/12/26062732/82149.webp)

[](https://github.com/qazzxxx/cloudimgs/blob/main/client/public/cloudimgs.jpg)

批量圈选操作 

![](https://pic.amiao.app/2025/12/26062733/45395.webp)

[](https://github.com/qazzxxx/cloudimgs/blob/main/client/public/batch.jpg)

相册分享 

![](https://pic.amiao.app/2025/12/26063438/4214.webp)

[](https://github.com/qazzxxx/cloudimgs/blob/main/client/public/share.jpg)

整页上传 

![](https://pic.amiao.app/2025/12/26063440/18649.webp)

[](https://github.com/qazzxxx/cloudimgs/blob/main/client/public/upload.jpg)

开放接口页面 

![](https://pic.amiao.app/2025/12/26063443/66746.webp)

[](https://github.com/qazzxxx/cloudimgs/blob/main/client/public/api.jpg)

## 快速开始

[](https://github.com/qazzxxx/cloudimgs#%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B)

### 快速部署 – docker-compose.yml

[](https://github.com/qazzxxx/cloudimgs#%E5%BF%AB%E9%80%9F%E9%83%A8%E7%BD%B2---docker-composeyml)

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   # 替换为您 NAS 用户组的实际 ID (id -g)
      - UMASK=002
      - NODE\_ENV=production
      - PORT=3001
      - STORAGE\_PATH=/app/uploads
      # 密码保护配置（可选）
      # - PASSWORD=your\_secure\_password\_here

### 密码保护配置

[](https://github.com/qazzxxx/cloudimgs#%E5%AF%86%E7%A0%81%E4%BF%9D%E6%8A%A4%E9%85%8D%E7%BD%AE)

如需启用密码保护，请在环境变量中设置 `PASSWORD`：

environment:
  - PASSWORD=your\_secure\_password\_here

**注意事项：**

-   设置 `PASSWORD` 环境变量后，系统将自动启用密码保护
-   未设置 `PASSWORD` 时，系统无需密码即可访问
-   密码验证成功后，登录状态会保存在浏览器本地存储中

## 项目地址

[https://github.com/qazzxxx/cloudimgs](https://github.com/qazzxxx/cloudimgs)

### 🖥️ 在线演示[](https://github.com/qazzxxx/cloudimgs#%EF%B8%8F-%E5%9C%A8%E7%BA%BF%E6%BC%94%E7%A4%BA)

**演示地址**：[https://yt.qazz.site](https://yt.qazz.site/)

> 此演示为**纯静态 Mock 模式**部署，图片数据随机加载，不涉及真实后端调用。
> 
> -   **访问密码**：`123456`
> -   **说明**：上传、删除等操作仅演示UI交互，数据不会保存，部分功能不可用。演示的加载图片列表体验比真实环境下体验差很多，真实环境下通过thumbhash生成缩略图优化加载。

**Categories:** 开源项目

---