qazzxxx/cloudimgs

cloudimgs 镜像文档

镜像概述

cloudimgs 是一个简单、方便的开源图床项目，专为NAS环境设计，提供图片存储与管理功能。通过Docker容器化部署，简化了安装和配置流程，适合个人或家庭用户在NAS设备上搭建私有图床服务。

核心功能与特性

• 轻量部署：基于Docker容器化，部署简单，无需复杂依赖
• NAS适配：支持NAS环境部署，可通过卷挂载管理图片存储目录
• 权限控制：支持通过PUID/PGID设置文件访问权限，确保数据安全
• 灵活配置：可自定义端口、存储路径，支持可选密码保护功能
• 持久化存储：通过卷挂载实现图片数据持久化，容器重启数据不丢失

使用场景

• 个人或家庭NAS设备上搭建私有图床
• 存储和管理日常照片、截图等图片资源
• 需要简单易用的图片托管服务的场景
• 对数据隐私有要求，希望本地存储图片的用户

使用方法

1. Docker Run 部署

bash
docker run -d \
  --name cloudimgs-app \
  -p 3001:3001 \
  -v ./uploads:/app/uploads:rw \
  -e PUID=1000 \
  -e PGID=1000 \
  -e UMASK=002 \
  -e NODE_ENV=production \
  -e PORT=3001 \
  -e STORAGE_PATH=/app/uploads \
  --restart unless-stopped \
  docker.xuanyuan.run/qazzxxx/cloudimgs:latest

2. Docker Compose 部署

创建 docker-compose.yml 文件：

yaml
version: "3.8"

services:
  cloudimgs:
    image: docker.xuanyuan.run/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

启动服务：

bash
docker-compose up -d

配置参数说明

环境变量

卷挂载

• ./uploads:/app/uploads:rw：本地图片存储目录，需确保本地目录存在且有读写权限

注意事项

1. 首次部署前需创建本地上传目录：mkdir -p ./uploads
2. 获取NAS用户ID和用户组ID：通过终端执行 id -u 获取PUID，id -g 获取PGID
3. 若启用密码保护，建议使用强密码并定期更换
4. 升级镜像时，建议先备份本地uploads目录数据