Repolode
dvershinin

dvershinin/gixy

A static analyzer that scans NGINX configuration files for security misconfigurations and common performance pitfalls.

Stars
1,187
Forks
29
Open issues
0
Last commit
yesterday

What is it?

Gixy parses NGINX configuration files and reports security misconfigurations without running the server. It is aimed at catching problems such as SSRF-prone proxy setups, HTTP response splitting from unsafe variables, host header spoofing, weak TLS settings, alias path traversal, and exposed server version information.

Beyond security checks, Gixy flags performance and maintainability issues like risky regular expressions that may cause ReDoS, `if` directives used inside locations, and missing resolvers for OCSP stapling. A NGINX CVE check can be enabled by passing the server version, and an auto-fix mode can apply certain corrections with backup files.

Gixy runs as a Python command-line tool installable via pip, Homebrew, RPM, Alpine, Arch AUR, or conda-forge, and is also available as a Docker image and as IDE plugins for VS Code and JetBrains products.

Key features

  • 01Detects SSRF, HTTP splitting, and host spoofing risks in NGINX configs.
  • 02Checks TLS settings, HSTS headers, and server version disclosure.
  • 03Flags risky regular expressions that may cause ReDoS.
  • 04Can check known NGINX CVEs when given a version number.
  • 05Offers an auto-fix mode with optional .bak backups.

Use cases

  • Auditing production NGINX configs before a deployment or security review.
  • Adding NGINX config linting to a CI pipeline.
  • Checking ingress controller configuration inside a Kubernetes cluster.
  • Getting real-time NGINX security hints inside a JetBrains or VS Code editor.

Topics

FAQ

What is gixy?
A static analyzer that scans NGINX configuration files for security misconfigurations and common performance pitfalls. Gixy parses NGINX configuration files and reports security misconfigurations without running the server. It is aimed at catching problems such as SSRF-prone proxy setups, HTTP response splitting from unsafe variables, host header spoofing, weak TLS settings, alias path traversal, and exposed server version information.
Is gixy free to use? What license does it have?
gixy is open source under the Other license. Check the license terms before using it in commercial products.
Is gixy still maintained?
Actively maintained. The last commit to gixy was on Oct 20, 2026.
What can I use gixy for?
Auditing production NGINX configs before a deployment or security review. Adding NGINX config linting to a CI pipeline. Checking ingress controller configuration inside a Kubernetes cluster. Getting real-time NGINX security hints inside a JetBrains or VS Code editor.
Where can I get gixy?
The source code and installation instructions are on GitHub: https://github.com/dvershinin/gixy

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects