|
|
|
@ -0,0 +1,121 @@
|
|
|
|
|
[![GitHub stars](https://img.shields.io/github/stars/digitalocean/nginxconfig.io.svg)](https://github.com/digitalocean/nginxconfig.io/stargazers) |
|
|
|
|
[![GitHub contributors](https://img.shields.io/github/contributors/digitalocean/nginxconfig.io.svg?color=blue)](https://github.com/digitalocean/nginxconfig.io/graphs/contributors) |
|
|
|
|
[![License](https://img.shields.io/github/license/digitalocean/nginxconfig.io.svg?color=blue)](https://github.com/digitalocean/nginxconfig.io/blob/master/LICENSE.md) |
|
|
|
|
<br /> |
|
|
|
|
[![Closed issues](https://img.shields.io/github/issues-closed-raw/digitalocean/nginxconfig.io.svg?color=brightgreen)](https://github.com/digitalocean/nginxconfig.io/issues?q=is%3Aissue+is%3Aclosed) |
|
|
|
|
[![Closed PR](https://img.shields.io/github/issues-pr-closed-raw/digitalocean/nginxconfig.io.svg?color=brightgreen)](https://github.com/digitalocean/nginxconfig.io/pulls?q=is%3Apr+is%3Aclosed) |
|
|
|
|
[![Open issues](https://img.shields.io/github/issues-raw/digitalocean/nginxconfig.io.svg)](https://github.com/digitalocean/nginxconfig.io/issues) |
|
|
|
|
[![Open PR](https://img.shields.io/github/issues-pr-raw/digitalocean/nginxconfig.io.svg)](https://github.com/digitalocean/nginxconfig.io/pulls) |
|
|
|
|
|
|
|
|
|
[![nginxconfig.io](src/static/github.png)](https://nginxconfig.io) |
|
|
|
|
|
|
|
|
|
<h3 align="center">⚙️ NGINX configuration generator on steroids 💉</h3> |
|
|
|
|
<p align="center"> |
|
|
|
|
The only tool you'll ever need to configure your NGINX server. |
|
|
|
|
<br /> |
|
|
|
|
<a href="https://nginxconfig.io"><strong>nginxconfig.io »</strong></a> |
|
|
|
|
<br /> |
|
|
|
|
<br /> |
|
|
|
|
<a href="https://github.com/digitalocean/nginxconfig.io/issues">Report Bug</a> |
|
|
|
|
· |
|
|
|
|
<a href="https://github.com/digitalocean/nginxconfig.io/issues">Request Feature</a> |
|
|
|
|
</p> |
|
|
|
|
|
|
|
|
|
<br /> |
|
|
|
|
|
|
|
|
|
# ✨ [nginxconfig.io](https://nginxconfig.io) |
|
|
|
|
|
|
|
|
|
NGINX is so much more than just a webserver. You already knew that, probably. |
|
|
|
|
|
|
|
|
|
We love NGINX, because: |
|
|
|
|
* low memory usage |
|
|
|
|
* high concurrency |
|
|
|
|
* asynchronous event-driven architecture |
|
|
|
|
* load balancing |
|
|
|
|
* reverse proxying |
|
|
|
|
* FastCGI support with caching (PHP) |
|
|
|
|
* amazing fast handling of static files |
|
|
|
|
* TLS/SSL with SNI |
|
|
|
|
|
|
|
|
|
A lot of features with corresponding configuration directives. |
|
|
|
|
You can deep dive into the [NGINX documentation](http://nginx.org/en/docs/) right now OR you can use this tool to check |
|
|
|
|
how NGINX works, observe how your inputs are affecting the output, **generate the best config for your specific |
|
|
|
|
use-case** (and in parallel you can still use the docs). |
|
|
|
|
|
|
|
|
|
## 🚀 Usage |
|
|
|
|
|
|
|
|
|
`GOTO` **[`nginxconfig.io`](https://nginxconfig.io)** |
|
|
|
|
|
|
|
|
|
**Features:** |
|
|
|
|
HTTPS, HTTP/2, IPv6, certbot, HSTS, security headers, SSL profiles, OCSP resolvers, caching, gzip, brotli, fallback |
|
|
|
|
routing, reverse proxy, www/non-www redirect, CDN, PHP (TCP/socket, WordPress, Drupal, Magento), Node.js support, Python |
|
|
|
|
(Django) server, etc. |
|
|
|
|
|
|
|
|
|
## 👨💻 Author |
|
|
|
|
|
|
|
|
|
### Rewrite & maintenance |
|
|
|
|
|
|
|
|
|
**Matt (IPv4) Cowley <me@mattcowley.co.uk> (https://mattcowley.co.uk)** |
|
|
|
|
* GitHub: [@MattIPv4](https://github.com/MattIPv4) |
|
|
|
|
|
|
|
|
|
### Original version |
|
|
|
|
|
|
|
|
|
**Bálint Szekeres <balint@szekeres.me> (https://balint.szekeres.me)** |
|
|
|
|
* GitHub: [@0xB4LINT](https://github.com/0xB4LINT) |
|
|
|
|
* LinkedIn: [@0xB4LINT](https://www.linkedin.com/in/0xB4LINT/) |
|
|
|
|
|
|
|
|
|
## ▶️ Install locally |
|
|
|
|
|
|
|
|
|
1. Clone the repository |
|
|
|
|
```sh |
|
|
|
|
git clone https://github.com/digitalocean/nginxconfig.io.git |
|
|
|
|
``` |
|
|
|
|
2. Install NPM packages |
|
|
|
|
```sh |
|
|
|
|
npm ci |
|
|
|
|
``` |
|
|
|
|
3. Run the development server *(with file watchers)* |
|
|
|
|
```sh |
|
|
|
|
npm run dev |
|
|
|
|
``` |
|
|
|
|
4. Open the development site **[localhost:8080](http://localhost:8080)** |
|
|
|
|
|
|
|
|
|
## 🤝 Contributing |
|
|
|
|
|
|
|
|
|
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. |
|
|
|
|
Any contributions you make are **greatly appreciated**. |
|
|
|
|
|
|
|
|
|
1. Fork the Project |
|
|
|
|
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`) |
|
|
|
|
3. Commit your Changes (`git commit -m 'Add some AmazingFeature`) |
|
|
|
|
4. Push to the Branch (`git push origin feature/AmazingFeature`) |
|
|
|
|
5. Open a Pull Request |
|
|
|
|
|
|
|
|
|
## ⚒️ Built With |
|
|
|
|
|
|
|
|
|
* [Vue.js](https://vuejs.org/) - Template handling & app generation |
|
|
|
|
* [Bulma](https://bulma.io/) - Base styling, customised by [do-bulma](https://github.com/do-community/do-bulma) |
|
|
|
|
* [Prism](https://prismjs.com/) - Bash & NGINX syntax highlighting |
|
|
|
|
|
|
|
|
|
## 📚 Resources |
|
|
|
|
|
|
|
|
|
* [Mozilla SSL Configuration Generator v5](https://ssl-config.mozilla.org) |
|
|
|
|
* [Mozilla SSL Configuration Generator](https://mozilla.github.io/server-side-tls/ssl-config-generator/) |
|
|
|
|
* [OWASP TLS Cipher String Cheat Sheet](https://github.com/OWASP/CheatSheetSeries/blob/master/cheatsheets/TLS_Cipher_String_Cheat_Sheet.md) |
|
|
|
|
* [Nginx Optimization: understanding sendfile, tcp_nodelay and tcp_nopush](https://thoughts.t37.net/nginx-optimization-understanding-sendfile-tcp-nodelay-and-tcp-nopush-c55cdd276765) |
|
|
|
|
* [NGINX Tuning For Best Performance](https://gist.github.com/denji/8359866) |
|
|
|
|
* [Hardening Your HTTP Security Headers](https://www.keycdn.com/blog/http-security-headers/) |
|
|
|
|
* [h5bp/server-configs-nginx](https://github.com/h5bp/server-configs-nginx) |
|
|
|
|
* [Diffie-Hellman DSA-like parameters](https://security.stackexchange.com/questions/95178/diffie-hellman-parameters-still-calculating-after-24-hours/95184#95184) |
|
|
|
|
* [hstspreload.org](https://hstspreload.org) |
|
|
|
|
* [Optimal value for nginx worker_connections](https://serverfault.com/questions/787919/optimal-value-for-nginx-worker-connections) |
|
|
|
|
|
|
|
|
|
## ⭐️ Show your support |
|
|
|
|
|
|
|
|
|
Give a ⭐️ if this project helped you! |
|
|
|
|
|
|
|
|
|
## 📝 License |
|
|
|
|
|
|
|
|
|
Copyright © 2020 [DigitalOcean, Inc <contact@digitalocean.com> (https://www.digitalocean.com)](https://www.digitalocean.com). |
|
|
|
|
<br /> |
|
|
|
|
This project is licensed under the [Apache 2.0](https://github.com/digitalocean/nginxconfig.io/blob/master/LICENSE) license. |