rkuprieiev/oss-emulator

阿里云OSS模拟器

镜像概述

oss-emulator是一款轻量级的阿里云OSS服务模拟器，提供与官方OSS服务相同的API接口，旨在帮助开发者在本地或无网络环境下调试基于OSS的应用，以及进行性能测试，从而降低测试成本。

核心功能

支持多种OSS数据操作和部分Bucket操作接口，具体如下：

• Bucket相关接口：支持ListBuckets、PutBucket、GetBucket、DeleteBucket、GetBucketLocation、GetBucketInfo、PutBucketACL、GetBucketACL；不支持日志、网站配置等相关接口。
• Object相关接口：支持PutObject、CopyObject、AppendObject、GetObject、DeleteObject、DeleteMultipleObjects、HeadObject、GetObjectMeta、PutObjectACL、GetObjectACL；不支持PostObject、回调等接口。
• Multipart相关接口：支持InitiateMultipartUpload、UploadPart、CompleteMultipartUpload；不支持UploadPartCopy等接口。

使用场景

1. 基于OSS应用的调试：可在无网络环境下调试OSS相关应用，无需连接真实OSS服务。
2. 性能测试：替代真实OSS服务进行性能测试，大幅节省测试费用。

配置说明

环境要求

需安装Ruby 2.2.8及以上版本。

安装步骤

Linux系统

1. 安装依赖：

bash
sudo gem install thor builder

2. 下载oss-emulator源码：https://github.com/aliyun/oss-emulator
3. 运行模拟器：进入源码目录，执行命令：

bash
ruby bin/emulator -r store -p 8080

Windows系统

1. 安装依赖：

bash
gem install thor builder

2. 下载oss-emulator源码：https://github.com/aliyun/oss-emulator
3. 运行模拟器：进入源码目录，执行命令：

bash
ruby bin/emulator -r store -p 8080

使用示例

使用ossutil工具

• 方法一：直接携带参数执行命令（替换IP为模拟器实际地址）：

bash
ossutil -e http://192.168.0.1:8080 -i AccessKeyId -k AccessKeySecret ls oss://bucket

• 方法二：通过config命令配置参数：

bash
ossutil config

提示：ossutil详细文档请参考阿里云官网：[***]

使用Python SDK

连接模拟器的示例代码（替换IP和Bucket名称）：

python
import oss2

auth = oss2.Auth('AccessKeyId', 'AccessKeySecret')
bucket = oss2.Bucket(auth, 'http://192.168.0.1:8080', 'MyBucketName')
bucket.create_bucket()

提示：Python SDK详细文档请参考阿里云官网：[***]