{"id":13908123,"url":"https://github.com/fsouza/s3-upload-proxy","last_synced_at":"2025-03-16T19:32:08.475Z","repository":{"id":20869266,"uuid":"91149890","full_name":"fsouza/s3-upload-proxy","owner":"fsouza","description":"Tool for proxying HTTP uploads to S3 and Elemental MediaStore, designed for video live streaming.","archived":false,"fork":false,"pushed_at":"2024-04-22T12:45:15.000Z","size":2968,"stargazers_count":28,"open_issues_count":2,"forks_count":8,"subscribers_count":5,"default_branch":"main","last_synced_at":"2024-04-22T13:28:09.299Z","etag":null,"topics":["aws-s3","go","golang","hacktoberfest","livestream","mediastore","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":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fsouza.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,"dei":null}},"created_at":"2017-05-13T04:45:25.000Z","updated_at":"2024-04-22T13:28:16.896Z","dependencies_parsed_at":"2023-10-02T19:05:29.679Z","dependency_job_id":"901a605c-1564-41d8-9fec-056265d08266","html_url":"https://github.com/fsouza/s3-upload-proxy","commit_stats":null,"previous_names":[],"tags_count":59,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fsouza%2Fs3-upload-proxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fsouza%2Fs3-upload-proxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fsouza%2Fs3-upload-proxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fsouza%2Fs3-upload-proxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fsouza","download_url":"https://codeload.github.com/fsouza/s3-upload-proxy/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221667380,"owners_count":16860610,"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-s3","go","golang","hacktoberfest","livestream","mediastore","proxy","s3"],"created_at":"2024-08-06T23:02:28.955Z","updated_at":"2024-10-27T11:10:25.996Z","avatar_url":"https://github.com/fsouza.png","language":"Go","funding_links":[],"categories":["HarmonyOS"],"sub_categories":["Windows Manager"],"readme":"# s3-upload-proxy\n\n[![Build Status](https://github.com/fsouza/s3-upload-proxy/workflows/Build/badge.svg)](https://github.com/fsouza/s3-upload-proxy/actions?query=branch:main+workflow:Build)\n\nTool for proxying HTTP uploads to S3 buckets and Elemental MediaStore\nContainers (added later, bad naming :D). Useful for private network protected environments.\n\n## Running locally\n\nMake sure you have [latest Go](https://golang.org/doc/install), then make sure\nyou have AWS credentials properly configured (s3-upload-proxy uses the [default\ncredential provider\nchain](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/credentials.html#credentials-default),\nso you can use environment variables or file-based configuration).\n\nHaving Go and AWS credentials, just set the environment variable\n`BUCKET_NAME`, build and start the process:\n\n```\n% export BUCKET_NAME=some-bucket\n% go build -o s3-upload-proxy\n% ./s3-upload-proxy\n```\n\nIf you want to use MediaStore, the environment variable `UPLOAD_DRIVER`\nshould be set to \"mediastore\" and `BUCKET_NAME` must be set to the container\nname on mediastore:\n\n```\n% export UPLOAD_DRIVER=mediastore BUCKET_NAME=mediastoretest\n% go build -o s3-upload-proxy\n% ./s3-upload-proxy\n```\n\n## Environment variables\n\ns3-upload-proxy configuration's is defined using the following environment\nvariables:\n\n| Variable                    | Default value | Required | Description                                                                      |\n| --------------------------- | ------------- | -------- | -------------------------------------------------------------------------------- |\n| UPLOAD_DRIVER               | s3            | No       | Upload driver to use (options are \"mediastore\" or \"s3\")                          |\n| BUCKET_NAME                 |               | Yes      | Name of the S3 bucket or the mediastore container (depends on the upload driver) |\n| HEALTHCHECK_PATH            | /healthcheck  | No       | Path for healthcheck                                                             |\n| HTTP_PORT                   | 80            | No       | Port to bind (unsigned int)                                                      |\n| LOG_LEVEL                   | debug         | No       | Logging level                                                                    |\n| CACHE_CONTROL_RULES         |               | No       | JSON array with cache control rules (see below)                                  |\n| MEDIASTORE_CHUNKED_TRANSFER | false         | No       | Whether to enable chunked transfer with MediaStore for lower latency             |\n\n## Defining cache-control rules\n\nThe tool also allow configuration for cache-control rules. The value of the\nenvironment variable `CACHE_CONTROL_RULES` is a JSON array with the rules. An\nexample:\n\n```\n% export CACHE_CONTROL_RULES='[{\"regexp\":\".mp4$\",\"value\":\"public, max-age=3600\"},{\"regexp\":\".ts$\",\"value\":\"public, max-age=2, s-maxage=999999\"},{\"regexp\":\".m3u8$\",\"value\":\"private\"}]'\n```\n\nNotice that the extension must include the dot.\n\nAlso available on Docker Hub: https://hub.docker.com/r/fsouza/s3-upload-proxy/.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffsouza%2Fs3-upload-proxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffsouza%2Fs3-upload-proxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffsouza%2Fs3-upload-proxy/lists"}