{"id":16064399,"url":"https://github.com/bassetts/warp-cors","last_synced_at":"2025-03-16T08:32:07.964Z","repository":{"id":37758977,"uuid":"257306552","full_name":"Bassetts/warp-cors","owner":"Bassetts","description":"warp-cors is a proxy server which enables CORS for the proxied request","archived":false,"fork":false,"pushed_at":"2023-03-06T18:00:41.000Z","size":118,"stargazers_count":41,"open_issues_count":5,"forks_count":9,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-16T00:11:16.771Z","etag":null,"topics":["cli","command-line","command-line-tool","cors","proxy","rust","server"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/Bassetts.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":"bassetts","ko_fi":"bassetts"}},"created_at":"2020-04-20T14:28:30.000Z","updated_at":"2025-03-08T17:03:36.000Z","dependencies_parsed_at":"2023-02-04T00:46:28.531Z","dependency_job_id":null,"html_url":"https://github.com/Bassetts/warp-cors","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bassetts%2Fwarp-cors","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bassetts%2Fwarp-cors/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bassetts%2Fwarp-cors/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bassetts%2Fwarp-cors/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Bassetts","download_url":"https://codeload.github.com/Bassetts/warp-cors/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243846976,"owners_count":20357294,"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":["cli","command-line","command-line-tool","cors","proxy","rust","server"],"created_at":"2024-10-09T05:07:00.361Z","updated_at":"2025-03-16T08:32:07.452Z","avatar_url":"https://github.com/Bassetts.png","language":"Rust","funding_links":["https://github.com/sponsors/bassetts","https://ko-fi.com/bassetts"],"categories":[],"sub_categories":[],"readme":"# warp-cors\n\n[![ci](https://github.com/Bassetts/warp-cors/workflows/ci/badge.svg)](https://github.com/Bassetts/warp-cors/actions?query=workflow%3Aci)\n[![GitHub](https://img.shields.io/github/license/bassetts/warp-cors?color=blue)](./LICENSE)\n[![Crates.io](https://img.shields.io/crates/v/warp-cors)](https://crates.io/crates/warp-cors)\n\nwarp-cors is a proxy server which enables CORS for the proxied request.\n\nThe path of the request is validated and then used as the url to proxy. Only\nhttp and https protocols are allowed and must be specified.\n\nPreflight requests will allow any methods and headers. All proxied requests will\nhave any origin allowed and allow all headers in the request to be exposed in the\nreponse.\n\n## Installation\n\n### Binaries\n\n[Archives of precompiled binaries](https://github.com/Bassetts/warp-cors/releases) \nare available for Linux, macOS, and Windows.\n\nThe Windows binaries require [Microsoft Visual C++ 2015 Redistributable](https://www.microsoft.com/en-us/download/details.aspx?id=53587)\nto be installed.\n\n### Cargo\n\nThe minimum supported Rust version is **1.59.0**, warp-cors will not work with\nversions lower than this.\n\n```shell\n$ cargo install warp-cors\n```\n\n### Docker\n\nDocker images are published in the \n[bassetts/warp-cors](https://hub.docker.com/repository/docker/bassetts/warp-cors) \nrepository.\n\n```shell\n$ docker run -dp 3030:3030 bassetts/warp-cors\n```\n\n## Usage\n\nBy default warp-cors will listen on port `3030` and use the package name\n(`warp-cors`) as the pseudonym in the `Via` header sent with the proxied\nrequest. These can be overwritten by using the `--port \u003cPORT\u003e` and\n`--hostname \u003cHOST\u003e` flags respectively.\n\nIf you are running warp-cors on a pubicly accessible hostname it is\nrecommended to set the `--hostname` flag to match.\n\n#### Example\n```shell\n$ warp-cors --port 3000 --hostname cors.example.org\n```\n\n## Example requests\n\n```shell\nhttp://localhost:3030/ # 404 Not Found\nhttp://localhost:3030/http://example.org # Proxied HTTP response with CORS headers\nhttp://localhost:3030/https://example.org # Proxied HTTPS response with CORS headers\nhttp://localhost:3030/example.org # 404 Not Found (no scheme provided)\nhttp://localhost:3030/ftp://example.org # 404 Not Found (invalid scheme provided)\n```\n\n## Logging\n\nwarp-cors uses [`pretty_env_logger`], so you can control log levels by setting\nthe `RUST_LOG` environment variable. This is useful for both developing and\nfor running warp-cors.\n\n```shell\n# Output all info level logs, including those from libraries used by warp-cors\n$ RUST_LOG=info warp-cors\n\n# Output info level logs for only warp-cors\n$ RUST_LOG=warp_cors=info warp-cors\n\n# Filter logging by module, useful for development or debugging\n$ RUST_LOG=warp_cors::filters::request=trace warp-cors\n```\n\n[`pretty_env_logger`]: https://docs.rs/pretty_env_logger/*/pretty_env_logger/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbassetts%2Fwarp-cors","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbassetts%2Fwarp-cors","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbassetts%2Fwarp-cors/lists"}