lostintime/aws-s3-webdav

AWS S3 WebDAV

用Rust实现的基础AWS S3 WebDAV接口，允许通过WebDAV协议与AWS S3存储桶进行交互。

支持的方法

GET

返回对象内容：

curl -X GET http://localhost:8080/hello.txt

HEAD

检查对象是否存在（不获取内容）：

curl -X HEAD http://localhost:8080/hello.txt

PUT

创建或更新对象：

curl -X PUT http://localhost:8080/hello.txt \
  -d 'Hello there!'

或从文件上传：

curl -X PUT http://localhost:8080/hello.txt \
  --upload-file ./hello.txt

DELETE

删除对象：

curl -X DELETE http://localhost:8080/hello.txt 

COPY

在同一存储桶内复制对象：

curl -X COPY http://localhost:8080/hello.txt \
  -H 'Destination: /hello2.txt'

MOVE

在同一存储桶内移动对象：

curl -X MOVE http://localhost:8080/hello.txt \
  -H 'Destination: /hello2.txt'

配置

运行应用程序需要以下配置选项。

AWS 区域（必填）

AWS服务区域ID可通过--aws-region参数或AWS_REGION环境变量提供。

完整区域列表请查看[***]

存储桶名称（必填）

AWS S3存储桶名称可通过--aws-bucket参数或AWS_BUCKET环境变量提供。

键前缀（可选）

用于键的前缀，会自动添加到请求的服务路径前。可通过--aws-key-prefix参数或AWS_KEY_PREFIX环境变量提供。

例如，当--aws-key-prefix=folder1/时，路径http://<aws-webdav-host:port>/path/to/my/file.txt将被转换为S3对象键folder1/path/to/my/file.txt。

AWS 凭据（可选）

如果S3存储桶需要授权，可通过以下方式提供凭据：

环境变量

• AWS_ACCESS_KEY_ID：访问密钥
• AWS_SECRET_ACCESS_KEY：密钥

凭据文件

可使用默认位置（~/.aws/credentials）的AWS凭据文件，或通过AWS_SHARED_CREDENTIALS_FILE环境变量配置自定义位置。

可通过AWS_PROFILE环境变量选择配置文件，默认使用default配置文件。

IAM实例配置文件

仅在运行于具有实例配置文件/角色的EC2实例上时可用。

（可能不适用于Docker镜像，如有使用成功请反馈。）

使用Docker运行

该仓库已配置自动Docker构建：https://hub.docker.com/r/lostintime/aws-s3-webdav/%E3%80%82

运行服务容器

docker run --read-only \
    -p 127.0.0.1:8080:8080 \
    -v ~/.aws/credentials:/.aws/credentials \
    -e "AWS_SHARED_CREDENTIALS_FILE=/.aws/credentials" \
    -e "AWS_PROFILE=my_custom_profile" \
    -e "AWS_REGION=eu-central-1" \
    -e "AWS_BUCKET=my-bucket" \
    -e "AWS_KEY_PREFIX=tmp/" \
    lostintime/aws-s3-webdav:0.1.0

限制

HTTPS

应用程序目前使用http协议与AWS端点通信，使用https时SSL会话似乎存在内存泄漏问题，尚未修复。

分块上传

上传文件时应用程序使用AWS分块上传，如果上传过程中失败，部分上传的块将保留在S3中，可能产生存储费用。建议配置存储桶生命周期策略来清理未完成的分块上传。

许可证

采用Apache License 2.0许可。