{"id":16813065,"url":"https://github.com/ivanvc/s3rp","last_synced_at":"2026-05-20T03:31:13.462Z","repository":{"id":66900194,"uuid":"228310016","full_name":"ivanvc/s3rp","owner":"ivanvc","description":"Simplest S3 reverse proxy","archived":false,"fork":false,"pushed_at":"2023-06-16T22:39:17.000Z","size":15,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-23T20:52:26.031Z","etag":null,"topics":["aws","aws-s3","reverse-proxy","s3"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ivanvc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2019-12-16T05:32:22.000Z","updated_at":"2023-06-16T22:36:51.000Z","dependencies_parsed_at":"2024-01-20T04:08:58.968Z","dependency_job_id":"974c4355-7486-44a4-9ea3-a12b76d3f7e6","html_url":"https://github.com/ivanvc/s3rp","commit_stats":null,"previous_names":["ivanvc/s3rp","ivanvc/s3-reverse-proxy"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivanvc%2Fs3rp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivanvc%2Fs3rp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivanvc%2Fs3rp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivanvc%2Fs3rp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ivanvc","download_url":"https://codeload.github.com/ivanvc/s3rp/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244022636,"owners_count":20385133,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","aws-s3","reverse-proxy","s3"],"created_at":"2024-10-13T10:24:31.645Z","updated_at":"2026-05-20T03:31:13.343Z","avatar_url":"https://github.com/ivanvc.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# S3 Reverse Proxy\n\nSimplest AWS S3 proxy. It proxies the contents for an specific bucket. If the\nrequest path ends with a slash (/), it will try to get `index.html`, or the\nspecified index page.\n\nIt doesn't have a cache, nor anything fancy on top of it. Internally it just\nsigns the request using the provided AWS credentials, and Go's reverse\nproxy does the rest. It was initially intended for internal use and not\nexposed to the Internet. If you want to expose a full bucket, using the built-in\nS3 website would work better. Be aware that the contents of the buckets will be\naccessible through this server.\n\n## Usage\n\nIt can be used by using the Docker image [`ivan/s3-reverse-proxy`][docker], or\ncan be installed using Go, by doing:\n\n```bash\ngo install github.com/ivanvc/s3rp\n```\n\n[docker]: https://hub.docker.com/r/ivan/s3-reverse-proxy\n\n### Configuration\n\nIt can be configured either with environment variables or passing arguments.\n\n* `HOST`, or `-host \u003chost\u003e`: The host to where listen to (default: `\":8080\"`)\n* `INDEX_PAGE` or `-index \u003cindex\u003e`: The name of the index pages\n  (default: `\"index.html\"`)\n* `BUCKET`, or `-bucket \u003cbucket\u003e`: The bucket to proxy, mandatory\n\nAuthentication with AWS is done by the AWS SDK. It can read environment\nvariables, or your aws-cli credentials, instance role, etc.\n\n### Running\n\nIf using docker, you can run it with (adjust values as required):\n\n```bash\ndocker run -e BUCKET=my-bucket -e AWS_REGION=us-west-2 AWS_ACCESS_KEY_ID=xx \\\nAWS_SECRET_ACCESS_KEY=xx ivan/s3-reverse-proxy\n```\n\nOr directly with Go, by doing:\n\n```bash\ns3rp -bucket=my-bucket\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivanvc%2Fs3rp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fivanvc%2Fs3rp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivanvc%2Fs3rp/lists"}