{"id":21462163,"url":"https://github.com/wolfpup-software/reverse_proxy","last_synced_at":"2025-03-17T04:51:19.560Z","repository":{"id":143851353,"uuid":"492309392","full_name":"wolfpup-software/reverse_proxy","owner":"wolfpup-software","description":"a reverse proxy server","archived":false,"fork":false,"pushed_at":"2025-01-20T01:40:27.000Z","size":57,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-01-20T02:31:05.176Z","etag":null,"topics":["gateway","reverse-proxy","rust","tls"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wolfpup-software.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,"publiccode":null,"codemeta":null}},"created_at":"2022-05-14T19:38:37.000Z","updated_at":"2025-01-20T01:38:25.000Z","dependencies_parsed_at":"2023-12-27T09:23:34.371Z","dependency_job_id":"1e25dabe-a0eb-4d71-9a15-92a4c5c988fe","html_url":"https://github.com/wolfpup-software/reverse_proxy","commit_stats":null,"previous_names":["taylor-vann/gateway","wolfpup-software/gateway","wolfpup-software/reverse_proxy"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wolfpup-software%2Freverse_proxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wolfpup-software%2Freverse_proxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wolfpup-software%2Freverse_proxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wolfpup-software%2Freverse_proxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wolfpup-software","download_url":"https://codeload.github.com/wolfpup-software/reverse_proxy/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243976503,"owners_count":20377691,"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":["gateway","reverse-proxy","rust","tls"],"created_at":"2024-11-23T07:12:53.919Z","updated_at":"2025-03-17T04:51:19.554Z","avatar_url":"https://github.com/wolfpup-software.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# reverse_proxy\n\nRoute requests to local or upstream servers.\n\n## About\n\nA reverse proxy written in rust using [tokio](https://tokio.rs/) and\n[hyper](https://hyper.rs/).\n\n`reverse_proxy` forwards incoming encrypted http1 and http2 requests to upstream servers.\n\n## How to use\n\n### Install reverse_proxy\n\nExecute the following to install `reverse_proxy`.\n\n```sh\ngit clone https://github.com/wolfpup_software/reverse_proxy\ncargo install --path reverse_proxy/reverse_proxy\n```\n\n### Create a JSON config\n\nA JSON configuration file is required to run `reverse_proxy`.\n\n#### JSON Schema\n\nAll filepaths can be absolute or relative to the config filepath.\n\n```JSON\n{\n  \"host_and_port\": \"\u003cstring\u003e\",\n  \"key_filepath\": \"\u003cstring\u003e\",\n  \"cert_filepath\": \"\u003cstring\u003e\",\n  \"addresses\": [\n    [\"\u003corigin_address\u003e\", \"\u003ctarget_address\u003e\"]\n  ],\n  \"dangerous_self_signed_addresses\": [\n    [\"\u003corigin_address\u003e\", \"\u003ctarget_address\u003e\"]\n  ]\n}\n```\n\nA valid configuration example can be found at [`./reverse_proxy.example.json`](./reverse_proxy.example.json`)\n\n#### Properties\n\n| name | definition |\n|----------|------------|\n| `host_and_port` | the address of the server (ie: 0.0.0.0:3000) |\n| `key_filepath` | the filepath of a key from a TLS certificate |\n| `cert_filepath` |  the filepath of a cert from a TLS certificate | \n| `addresses` | A key value map of URIs used to route incoming requests to upstream servers. Only the `host` and `port` of a URI will be used for routing requests. |\n| `dangerous_self_signed_addresses` (optional)  | allows `reverse_proxy` to make requests to servers with self-signed TLS certificates |\n\n#### Allow self-signed certificates\n\nONLY USE the `dangerous_self_signed_addresses` property WITH EXTREME CAUTION.\n\nIdeally never.\n\nThis optional property is intended to forward requests to servers using self-signed TLS certificates on local networks.\n\n### Run reverse_proxy\n\n```sh\nreverse_proxy ./path/to/config.json\n```\n\nOpen a browser and visit `https://localhost:XXXX`.\n\n## Licence\n\n`reverse_proxy` is released under the BSD 3-Clause License\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwolfpup-software%2Freverse_proxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwolfpup-software%2Freverse_proxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwolfpup-software%2Freverse_proxy/lists"}