Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bassetts/warp-cors
warp-cors is a proxy server which enables CORS for the proxied request
https://github.com/bassetts/warp-cors
cli command-line command-line-tool cors proxy rust server
Last synced: 10 days ago
JSON representation
warp-cors is a proxy server which enables CORS for the proxied request
- Host: GitHub
- URL: https://github.com/bassetts/warp-cors
- Owner: Bassetts
- License: mit
- Created: 2020-04-20T14:28:30.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2023-03-06T18:00:41.000Z (over 1 year ago)
- Last Synced: 2024-10-27T10:12:16.556Z (10 days ago)
- Topics: cli, command-line, command-line-tool, cors, proxy, rust, server
- Language: Rust
- Homepage:
- Size: 115 KB
- Stars: 38
- Watchers: 2
- Forks: 7
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# warp-cors
[](https://github.com/Bassetts/warp-cors/actions?query=workflow%3Aci)
[](./LICENSE)
[](https://crates.io/crates/warp-cors)
warp-cors is a proxy server which enables CORS for the proxied request.
The path of the request is validated and then used as the url to proxy. Only
http and https protocols are allowed and must be specified.
Preflight requests will allow any methods and headers. All proxied requests will
have any origin allowed and allow all headers in the request to be exposed in the
reponse.
## Installation
### Binaries
[Archives of precompiled binaries](https://github.com/Bassetts/warp-cors/releases)
are available for Linux, macOS, and Windows.
The Windows binaries require [Microsoft Visual C++ 2015 Redistributable](https://www.microsoft.com/en-us/download/details.aspx?id=53587)
to be installed.
### Cargo
The minimum supported Rust version is **1.59.0**, warp-cors will not work with
versions lower than this.
```shell
$ cargo install warp-cors
```
### Docker
Docker images are published in the
[bassetts/warp-cors](https://hub.docker.com/repository/docker/bassetts/warp-cors)
repository.
```shell
$ docker run -dp 3030:3030 bassetts/warp-cors
```
## Usage
By default warp-cors will listen on port `3030` and use the package name
(`warp-cors`) as the pseudonym in the `Via` header sent with the proxied
request. These can be overwritten by using the `--port ` and
`--hostname ` flags respectively.
If you are running warp-cors on a pubicly accessible hostname it is
recommended to set the `--hostname` flag to match.
#### Example
```shell
$ warp-cors --port 3000 --hostname cors.example.org
```
## Example requests
```shell
http://localhost:3030/ # 404 Not Found
http://localhost:3030/http://example.org # Proxied HTTP response with CORS headers
http://localhost:3030/https://example.org # Proxied HTTPS response with CORS headers
http://localhost:3030/example.org # 404 Not Found (no scheme provided)
http://localhost:3030/ftp://example.org # 404 Not Found (invalid scheme provided)
```
## Logging
warp-cors uses [`pretty_env_logger`], so you can control log levels by setting
the `RUST_LOG` environment variable. This is useful for both developing and
for running warp-cors.
```shell
# Output all info level logs, including those from libraries used by warp-cors
$ RUST_LOG=info warp-cors
# Output info level logs for only warp-cors
$ RUST_LOG=warp_cors=info warp-cors
# Filter logging by module, useful for development or debugging
$ RUST_LOG=warp_cors::filters::request=trace warp-cors
```
[`pretty_env_logger`]: https://docs.rs/pretty_env_logger/*/pretty_env_logger/