🖥️ 在线演示 | Demo
- 演示地址：https://yt.qazz.site
- 文档地址：https://ytdoc.qazz.site/
此演示为 纯静态 Mock 模式 部署，图片数据随机加载，不涉及真实后端调用。
访问密码：123456说明：上传、删除等操作仅演示UI交互，数据不会保存，部分功能不可用。真实环境下通过 thumbhash 生成缩略图，体验会更流畅。
🚀 功能特点 | Features
🛠️ 核心功能
- 多格式支持：支持上传各种格式图片及其他文件，支持全局上传。
- 图片管理：在线管理图片，瀑布流展示，批量圈选删除。
- 相册分享：支持相册分享功能。
- 安全保护：支持设置密钥，保护图片安全。
- 目录管理：支持多级子目录管理。
- 移动适配：完美适配移动端。
⚡️ 高级特性
- 魔法搜索：基于CLIP本地小模型，支持自然语言搜索（如搜“蓝天白云”）。
- 流量看板：直观展示流量使用情况。
- 照片轨迹：在地图上展示照片拍摄轨迹。
- 性能优化：集成 thumbhash 无感生成缩略图，大幅优化加载体验。
🔌 开放接口 (API)
- 上传/管理：支持Base64上传、SVG转PNG、拖拽上传、图片删除/列表等。
- 图片处理：支持实时 URL 参数处理（尺寸、质量、格式转换）。
示例：image.jpg?w=500&h=300&q=80&fmt=webp - 随机图/指定图：支持获取随机图片或指定参数的图片。
- 生态集成：支持 PicGo 插件 直接安装使用。
🎨 图片工具
- 在线编辑：内置图片编辑功能。
- 格式转换：支持 SVG 转 PNG。
- 压缩工具：自定义压缩质量和尺寸。
- 一键分享：支持一键复制图片链接。
🛠️ 快速部署 | Quick Start
推荐使用 Docker Compose 进行快速部署。
services:
cloudimgs:
image: qazzxxx/cloudimgs:latest
container_name: cloudimgs-app
restart: unless-stopped
ports:
- "你的端口:3001"
volumes:
- 你的目录:/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小模型，占用内存较高）
🔐 环境变量说明
| 变量名 | 说明 | 示例 / 默认值 |
|---|---|---|
| PASSWORD | 设置访问密码，留空则无需密码 | 123456 |
| ENABLE_MAGIC_SEARCH | 是否开启 AI 魔法搜索 | true / false |
| MAX_FILE_SIZE | 最大上传文件限制 (Byte) | 104857600 (100MB) |
| THUMBNAIL_WIDTH | 列表缩略图宽度 (px) | 0 (原图) / 500 |
注意：
设置 PASSWORD 后，系统会自动启用登录保护。
登录状态会保存在浏览器本地存储中。
Comments NOTHING