Proksi is a simple, lightweight, and easy-to-use proxy server that automatically handles SSL, HTTP, and DNS traffic. It is designed to be used as a standalone proxy server or as a component in a larger system. Proksi is written in Rust and uses Pingora as its core networking library.
Of the many features Proksi offers is the ability to load balance to your infrastructure or any IP that supports your host configurations. Other features of Proksi also include:
- Automatic Docker and Docker Swarm service discovery through labels
- Built-in most common middlewares such as OAuth, Rate Limiting, CDN Caching and others
- The ability of running it as a single binary in your system
- Automatic SSL through Let's Encrypt and redirection from HTTP to HTTPS
- Configuration through HCL with support for functions (get environment variables, etc)
- Powerful plugin system for adding new middlewares and other features using WebAssembly (WASM)
- Many others.
- Download the latest release from https://github.com/luizfonseca/proksi/releases
- Create a configuration file named
proksi.hcl - Add the following content to the file:
lets_encrypt {
enabled = true
email = "[email protected]"
}
paths {
# Where to save certificates?
lets_encrypt = "./"
}
# A list of routes Proksi should handle
routes = [
{
# You might need to edit your /etc/hosts file here.
host = "mysite.localhost",
# Will create a certificate for mysite.localhost
ssl_certificate = {
self_signed_on_failure = true
}
# Where to point mysite.localhost to
upstreams = [{
ip = "docs.proksi.info"
port = 443
headers = {
add = [{ name = "Host", value = "docs.proksi.info" }]
}
}]
}
]- Run
proksi -c /path-where-proksi.hcl-is-located
For more information or guides, please refer to the documentation.
Documentation for Proksi can be found at https://docs.proksi.info which is also available in the gitbook folder of this repository.
We welcome contributions to Proksi. If you have any suggestions or ideas, please feel free to open an issue or a pull request on the GitHub repository.
Proksi is licensed under the MIT License, the Apache License 2.0 and is free to use and modify.