CloudImgs私有图床：NAS一键部署与功能全解析

CloudImgs 是一款设计简洁的开源图床应用，专为NAS环境优化，支持一键快速部署，提供图片上传、管理、预览和分享等多样化服务。

核心功能详解

🚀 主要功能

• • 图片上传：支持拖放操作上传，兼容多种常见图片格式
• • 图片管理：提供浏览、预览、下载和删除图片的完整操作
• • 图片分享：一键快速复制图片链接，方便分享使用
• • 统计信息：实时监控存储使用情况，展示详细数据

🔐 安全防护

• • 访问控制：可设置访问密码，有效保护图片隐私安全
• • 登录界面：设计美观的登录页面，支持密码验证机制
• • 会话管理：自动保存登录状态，支持手动退出登录操作
• • API 保护：所有管理接口均需密码验证，增强安全性
• • 可选启用：通过环境变量灵活控制是否启用密码保护功能

📁 目录管理

• • 智能目录选择：支持选择现有目录或创建新目录路径
• • 目录信息展示：在图片管理页面清晰显示当前目录详情
• • 目录统计：按目录统计图片数量和存储空间占用情况

🔧 SVG 处理工具

• • SVG 转 PNG：输入 SVG 代码，实时转换为 PNG 格式图片
• • 在线预览：转换完成后立即预览 PNG 效果图
• • 一键上传：转换后直接上传到图床存储空间
• • 批量下载：支持下载转换后的 PNG 图片文件
• • 示例代码：提供常用 SVG 示例代码，方便参考使用
• • 自定义文件名：允许自定义上传和下载的文件名
• • 自动生成文件名：基于时间戳自动生成唯一文件名

🗜️ 图像压缩功能

• • Canvas 压缩：利用 Canvas API 实现高质量图片压缩处理
• • 尺寸调整：支持设置压缩后的图片宽度和高度参数
• • 宽高比锁定：自动保持原始图片的宽高比例不变
• • 质量调节：1-100% 范围内可调节压缩质量等级
• • 实时预览：压缩后立即查看效果预览图
• • 压缩信息：显示原始大小、压缩后大小和压缩率数据
• • 一键上传：压缩完成后直接上传到图床系统
• • 本地下载：支持下载压缩后的图片文件到本地
• • 智能默认：根据原始图片自动计算合适的压缩尺寸

🌓 主题切换选项

• • 多主题支持：提供浅色主题和暗色主题两种模式
• • 自动模式：根据系统时间自动切换主题（6:00-18:00 浅色，18:00-6:00 暗色）
• • 手动切换：支持手动选择浅色、暗色或自动模式
• • 主题持久化：主题设置自动保存到本地存储空间
• • 实时切换：主题切换立即生效，无需刷新页面
• • 全面适配：所有页面和组件都完美适配两种主题样式
• • 优雅动画：主题切换时带有平滑的过渡动画效果

📱 移动端优化

• • 响应式布局：基于 Ant Design Grid 系统实现完美响应式设计
• • 移动端导航：移动端使用抽屉式菜单，优化触摸操作体验
• • 自适应布局：根据屏幕尺寸自动调整布局和组件大小
• • 触摸优化：按钮和交互元素针对移动端触摸操作进行专门优化
• • 图片管理：移动端图片网格自动调整为单列布局显示
• • API 文档：移动端代码示例和文档自动适配小屏幕浏览
• • 主题适配：移动端完美支持浅色和暗色主题切换功能

部署步骤

Docker Compose 配置示例

services:  
  cloudimgs:  
    image: qazzxxx/cloudimgs:latest  
    container_name: cloudimgs  
    ports:  
      - 3001:3001  
    environment:  
      - NODE_ENV=production  
      - PORT=3001  
      - STORAGE_PATH=/app/uploads  
    volumes:  
      - ./uploads:/app/uploads  
    restart: unless-stopped

参数说明（更多详细参数建议参考官方文档）

:::
PORT（环境变量）：设置应用访问端口号

PASSWORD（环境变量，可选）：设置访问密码保护

/app/uploads（路径）：配置上传文件存储目录

:::

提示：原模板默认使用 root 用户运行，此处通过赋予 777 权限解决可能出现的权限问题

sudo chmod -R 777 /vol1/1000/docker/cloudimgs

使用指南

在浏览器中输入 http://NAS的IP:3001 即可访问应用界面

界面右上角提供主题切换功能，可选择暗色主题（为展示截图效果，此处使用深色主题示例）

点击上传图片按钮进行操作，如遇问题请检查目录权限设置

进入对应上传目录，可查看之前上传的图片文件

图片管理功能支持对图片进行浏览、下载和删除等操作

统计信息页面直观显示当前图床系统的详细状态数据

除基本图床功能外，还集成 SVG 工具、图片压缩和图片裁剪等实用功能

开放接口提供详细说明文档，支持二次开发调用图床功能服务

总结与推荐

CloudImgs 这款开源图床工具在实际使用中体现出轻量级、操作简单和便捷高效的特点。无需额外部署数据库系统，使用过程简单直观，支持图片上传、管理、分享及统计等核心功能。对于有个人图床需求的用户，这款工具值得尝试体验。

综合推荐：⭐⭐⭐（适合有图床需求的个人用户）

使用体验：⭐⭐⭐（轻量级设计，操作简单便捷）

部署难度：⭐⭐（部署过程简单直接）