### 概述 VersityGW 是一个高性能 S3 网关，将 AWS S3 API 请求转换为 POSIX 文件系统存储操作。它支持在本地文件系统之上使用 S3 兼容 API。网关无状态、可扩展，兼顾简洁性与可扩展性。每个用户拥有独立的实例，S3 数据存储在用户文稿目录下。 ### 功能特性 - 🪣 完整的 S3 API 兼容性（存储桶/对象操作） - 📁 POSIX 文件系统后端（本地存储） - 🖥️ WebUI 管理界面，可浏览存储桶和管理用户 - 👥 多用户 IAM，支持平面文件或 Vault 存储 - 📜 对象版本控制支持 - 🔐 Root 和 IAM 用户认证 - 📊 Admin API 用于编程式管理 - 🐳 轻量级 Docker 部署 - 👤 多实例模式：每个用户拥有独立的 S3 网关 ### 配置说明 安装时可配置以下参数： | 参数 | 类型 | 必填 | 默认值 | 说明 | |------|------|------|--------|------| | ROOT_ACCESS_KEY | 密钥 | 是 | random(20) | Root S3 访问密钥 | | ROOT_SECRET_KEY | 密钥 | 是 | random(40) | Root S3 密钥 | | S3_DATA_DIR | 字符串 | 是 | s3-data | 用户文稿目录下用于存储 S3 数据的子目录名称 | ### 访问入口 | 服务 | URL 格式 | 说明 | |------|----------|------| | WebUI | `https://versitygw.<微服设备名>.heiyu.space` | 浏览器管理界面 | | S3 API | `https://s3-versitygw.<微服设备名>.heiyu.space` | S3 兼容 API 端点 | ### 使用说明 - 本应用运行在懒猫微服平台上，采用多实例模式 - S3 对象数据存储在用户文稿目录下（`/lzcapp/document/<S3_DATA_DIR>`） - 版本控制和 IAM 数据持久化存储在 `/lzcapp/var/` 目录下 - 通过主子域名访问 WebUI，可浏览存储桶和管理用户 - 使用 S3 API 端点配合 AWS CLI 或任何 S3 兼容客户端 #### WebGUI 登录 1. 从懒猫微服启动器打开 WebUI 2. 在登录页面输入安装时设置的 **Root 访问密钥** 和 **Root 密钥** 4. 登录后，管理员可访问仪表盘、用户管理、存储桶管理和文件浏览器 5. 普通用户只能访问自己存储桶的文件浏览器 #### 使用 AWS CLI - 通过主子域名访问 WebUI，可浏览存储桶和管理用户 - 使用 S3 API 端点配合 AWS CLI 或任何 S3 兼容客户端 #### 使用 AWS CLI 安装完成后，配置 AWS CLI 使用 S3 API 端点： ```bash # 安装 AWS CLI（如尚未安装） pip install awscli # 配置凭证（使用安装时设置的 ROOT_ACCESS_KEY 和 ROOT_SECRET_KEY） aws configure set aws_access_key_id <你的访问密钥> aws configure set aws_secret_access_key <你的密钥> # 创建存储桶 aws --endpoint-url https://s3-versitygw.<boxname>.heiyu.space s3 mb s3://mybucket # 上传文件 aws --endpoint-url https://s3-versitygw.<boxname>.heiyu.space s3 cp myfile.txt s3://mybucket/ # 列出对象 aws --endpoint-url https://s3-versitygw.<boxname>.heiyu.space s3 ls s3://mybucket ``` #### 多用户设置 1. 从懒猫微服启动器打开 WebUI 2. 使用 root 凭证登录 3. 导航到 IAM 部分创建额外用户 4. 每个用户将获得独立的访问密钥和密钥