{"id":17787552,"url":"https://github.com/dmarby/yokuso","last_synced_at":"2025-07-06T10:07:22.222Z","repository":{"id":149341984,"uuid":"124122759","full_name":"DMarby/yokuso","owner":"DMarby","description":"DigitalOcean Spaces proxy for Dropshare, using OpenResty","archived":false,"fork":false,"pushed_at":"2018-04-01T23:24:17.000Z","size":17,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-02T00:21:06.279Z","etag":null,"topics":["digitalocean","digitalocean-spaces","dropshare","openresty"],"latest_commit_sha":null,"homepage":"","language":"Lua","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/DMarby.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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,"publiccode":null,"codemeta":null}},"created_at":"2018-03-06T18:41:57.000Z","updated_at":"2023-07-25T14:15:32.000Z","dependencies_parsed_at":"2023-09-03T14:46:00.208Z","dependency_job_id":null,"html_url":"https://github.com/DMarby/yokuso","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/DMarby/yokuso","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DMarby%2Fyokuso","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DMarby%2Fyokuso/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DMarby%2Fyokuso/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DMarby%2Fyokuso/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DMarby","download_url":"https://codeload.github.com/DMarby/yokuso/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DMarby%2Fyokuso/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263882286,"owners_count":23524461,"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":["digitalocean","digitalocean-spaces","dropshare","openresty"],"created_at":"2024-10-27T10:10:58.883Z","updated_at":"2025-07-06T10:07:22.200Z","avatar_url":"https://github.com/DMarby.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Yokusō\n[DigitalOcean Spaces](https://www.digitalocean.com/products/spaces/) proxy for [Dropshare](https://getdropsha.re/), using [OpenResty](https://openresty.org).  \nYokusō makes it possible to use a private DigitalOcean Space with Dropshare, without needing to store the API keys on your device.  \nIt also caches the requests, to serve the files you upload faster.\n\n## Usage\n\n### Running the service\nTo run Yokusō, it's recommended to use Docker.\nTo start off, build the container:  \n```\ndocker build -t yokuso:latest .\n```\nYou can now run it with the following command:\n```\ndocker run \\\n  -p 80:80 \\\n  -v /var/cache/nginx:/var/cache/nginx \\\n  -e SPACES_REGION=\"\u003cSPACES_REGION\u003e\" \\\n  -e ACCESS_KEY_ID=\"\u003cSPACES_ACCESS_KEY\u003e\" \\\n  -e SECRET_ACCESS_KEY=\"\u003cSPACES_SECRET_KEY\u003e\" \\\n  -e SPACES_ENDPOINT=\"\u003cSPACES_URL\u003e\" \\\n  -e ROOT_REDIRECT=\"http://google.com\" \\\n  -e CLIENT_ACCESS_KEY_ID=\"\u003cDROPSHARE_ACCESS_KEY\u003e\" \\\n  -e CLIENT_SECRET_ACCESS_KEY=\"\u003cDROPSHARE_ACCESS_KEY\u003e\" \\\n  yokuso:latest\n```  \n\n### Configuring Dropshare\nYou can configure Dropshare by adding a [Custom S3 API Compliant Connection](https://dropshare.zendesk.com/hc/en-us/articles/201139232-How-to-set-up-Amazon-S3-or-S3-API-compatible-connections).  \n\nIf you are not using path-style URLs, Yokusō will need to run on a subdomain.\nSet the `server` in drop share to the main domain, and `bucket name` to the subdomain (e.g. if Yokusō is running on `dump.dmarby.se`, the `server` would be `dmarby.se`, and the `bucket name` would be `dump`.  \n\nIf you are using path-style URLs, set the `server` to the domain where Yokusō is running, and the `bucket name` to anything.  \n\nFor access key and secret key, enter the values you specified in `CLIENT_ACCESS_KEY_ID` and `CLIENT_SECRET_ACCESS_KEY` above.\n\n## Thanks to\n* [Kamal Nasser](https://kamal.io) for making the error page.\n* [Moriyoshi Koizumi](https://github.com/moriyoshi) for [their work](https://github.com/DMarby/api-gateway-aws/commit/35fd7af0d9783247a3085bacac3421038f382432) extending api-gateway-aws.\n* [Hector Castro](https://github.com/hectcastro) for creating [docker-s3-proxy-cache](https://github.com/azavea/docker-s3-proxy-cache) which inspired this project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdmarby%2Fyokuso","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdmarby%2Fyokuso","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdmarby%2Fyokuso/lists"}