Storage UI 

Storage UI 是一款开源、轻量且功能丰富的 Web 界面工具，专为管理 S3、R2、阿里云 OSS、Backblaze B2 及其他兼容 S3 协议的对象存储后端而设计。它填补了云服务商原生控制台在用户体验上的空白，提供了一个类似本地文件资源管理器的直观界面，让用户能够轻松浏览、预览、搜索和管理云端文件。

无论是个人开发者还是小型团队，Storage UI 都能通过简单的 Docker 部署，将复杂的对象存储操作转化为优雅的可视化体验。

核心功能亮点

🖼️ 多样化的视图与预览

• 四种视图模式：支持图标、列表、分栏和画廊视图，满足不同场景下的浏览习惯。
• 丰富的文件预览：无需下载即可直接在浏览器中预览 PDF、DOCX、XLSX、图片、音频、文本及代码文件，极大提升了工作效率。
• 文件夹懒加载：针对大型目录结构优化，实现快速响应和平滑滚动。

🔍 强大的搜索与管理

• 智能搜索：支持关键词搜索、筛选、排序及日期范围查询，帮助用户在海量文件中快速定位目标。
• 完整文件操作：支持上传、下载、重命名、移动、删除及创建文件夹，所有操作均通过直观的拖放交互完成。
• 多连接管理：在一个界面中同时管理多个存储后端（如 AWS S3、Cloudflare R2、阿里云 OSS 等），数据配置本地持久化，切换无缝。

🛡️ 安全与访问控制

• 只读模式：支持按桶（Bucket）配置只读权限，适合共享链接给他人查看而不暴露修改能力。
• 密码保护：内置基于用户名和密码的身份认证机制，防止未经授权的访问。
• 环境变量配置：通过 .env 文件灵活配置连接信息，敏感数据不硬编码，确保部署安全。

📱 响应式设计与深色模式

• 全平台适配：采用响应式布局，完美适配桌面、平板和移动设备，随时随地管理文件。
• 深色模式：提供舒适的深色主题，减少长时间使用的视觉疲劳。

快速开始：Docker 一键部署

Storage UI 提供了预构建的 Docker 镜像，只需几分钟即可完成部署。

1. 准备环境变量

创建一个 .env 文件，参考项目中的 .env.example 填写你的存储连接信息。例如：

# 示例：配置第一个存储连接 (S3/R2)
STORAGE_1_NAME=MyCloud
STORAGE_1_PROVIDER=s3 # 或 r2, oss, b2 等
STORAGE_1_ENDPOINT=https://your-endpoint.com
STORAGE_1_ACCESS_KEY=your-access-key
STORAGE_1_SECRET_KEY=your-secret-key
STORAGE_1_BUCKET=your-bucket-name
STORAGE_1_REGION=auto # 可选

# 认证信息
AUTH_USERNAME=admin
AUTH_PASSWORD=your-secure-password

2. 运行容器

使用以下命令拉取镜像并启动服务：

docker pull hahahumble/storageui

docker run -d \
  --name storage-ui \
  --restart unless-stopped \
  -p 3000:3000 \
  --env-file .env \
  hahahumble/storageui

3. 访问界面

打开浏览器访问 http://localhost:3000，使用你在 .env 中设置的账号密码登录即可开始管理文件。

适用场景

• 个人云盘替代：结合 Cloudflare R2 或 Backblaze B2 的低成本存储，搭建私人的媒体库或文档中心。
• 团队协作空间：为小团队提供一个统一的文件入口，支持多桶管理和权限隔离。
• 开发者工具箱：方便调试和查看上传到对象存储的资源，支持代码和图片的快速预览。
• 静态网站管理：直接通过界面管理托管在 S3 上的静态网站文件，比命令行更直观。