☁️ 云端一隅，拾光深藏
一个简单、开放且强大的自托管图像托管解决方案。

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

• 演示地址：https://yt.qazz.site
• 文档地址：https://ytdoc.qazz.site/

• 多格式支持：支持上传各种格式图片及其他文件，支持全局上传。
• 图片管理：在线管理图片，瀑布流展示，批量圈选删除。
• 相册分享：支持相册分享功能。
• 安全保护：支持设置密钥，保护图片安全。
• 目录管理：支持多级子目录管理。
• 移动适配：完美适配移动端。

• 魔法搜索：基于CLIP本地小模型，支持自然语言搜索（如搜“蓝天白云”）。
• 流量看板：直观展示流量使用情况。
• 照片轨迹：在地图上展示照片拍摄轨迹。
• 性能优化：集成 thumbhash 无感生成缩略图，大幅优化加载体验。

• 上传/管理：支持Base64上传、SVG转PNG、拖拽上传、图片删除/列表等。
• 图片处理：支持实时 URL 参数处理（尺寸、质量、格式转换）。
  • 示例：image.jpg?w=500&h=300&q=80&fmt=webp
• 随机图/指定图：支持获取随机图片或指定参数的图片。
• 生态集成：支持 PicGo 插件 直接安装使用。

• 在线编辑：内置图片编辑功能。
• 格式转换：支持 SVG 转 PNG。
• 压缩工具：自定义压缩质量和尺寸。
• 一键分享：支持一键复制图片链接。

✨ 点击收起/展开截图

魔法搜索 & 主要界面

魔法搜索 (Magic Search)	登录页面 (Login)

图片管理 (Management)	批量操作 (Batch Actions)

功能展示

相册分享 (Share)	整页上传 (Upload)

轨迹地图 (Map)	图片编辑 (Editor)

开放接口 (API)	移动端 (Mobile)

推荐使用 Docker Compose 进行快速部署。

services:
  cloudimgs:
    image: qazzxxx/cloudimgs:latest
    container_name: cloudimgs-app
    restart: unless-stopped
    ports:
      - "3001:3001"
    volumes:
      - ./uploads:/app/uploads:rw # 上传目录配置，明确读写权限
    environment:
      # 权限配置 (建议填写 NAS 用户真实 ID)
      - PUID=1000  # id -u
      - PGID=1000   # id -g
      - UMASK=002
      
      # 基础配置
      - NODE_ENV=production
      - PORT=3001
      - STORAGE_PATH=/app/uploads
      
      # 可选配置
      # - MAX_FILE_SIZE=104857600 # 最大文件大小，默认 100MB
      # - THUMBNAIL_WIDTH=0 # 瀑布流缩略图宽度（像素），默认 0 表示使用原图
      # - PASSWORD=your_secure_password_here # 🔐 密码保护配置
      # - ENABLE_MAGIC_SEARCH=true # ✨ 开启魔法搜索（使用本地CLIP小模型，占用内存较高）

注意：

1. 设置 PASSWORD 后，系统会自动启用登录保护。
2. 登录状态会保存在浏览器本地存储中。