快速开始

使用 Docker 快速部署

使用 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   # 替换为您 NAS 用户组的实际 ID (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：

environment:
  - PASSWORD=your_secure_password_here

注意事项：

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