README.md

August 21, 2026 ยท View on GitHub

Mentioned in Awesome Go Go Doc Github Actions Go Report Card

Coverage Status Docker Pulls GHCR GitHub license GitHub release (latest by date)

Features

  • Multi S3 bucket proxy
  • Index document (display index document instead of listing when found)
  • Custom templates
  • Custom S3 endpoints supported
  • Basic Authentication support
  • Multiple Basic Authentication support
  • OpenID Connect Authentication support
  • Multiple OpenID Connect Provider support
  • Redirect to original host and path with OpenID Connect authentication
  • Bucket mount point configuration with hostname and multiple path support
  • Authentication by path and http method on each bucket
  • Prometheus metrics
  • Allow to publish files on S3 bucket
  • Allow to delete files on S3 bucket
  • Per-user folder isolation with transparent username injection

And many others.

Documentation

There is an online documentation generated for this project.

You can find it here: https://oxyno-zeta.github.io/s3-proxy/

Advanced interfaces

Looking for more advanced interfaces. Take a look on this project: s3-proxy-interfaces.

Want to contribute ?

Inspired by

Thanks

  • My wife BH to support me doing this

Author

  • Oxyno-zeta (Havrileck Alexandre)

License

Apache 2.0 (See in LICENSE)