nginx-reverse-proxy

Community

Nginx proxy patterns for self-hosted services.

AuthorMassimilianoPili
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill provides a comprehensive set of Nginx configuration patterns to efficiently manage and route multiple self-hosted services behind a single domain, handling complex scenarios like WebSocket proxying, lazy DNS resolution, and OAuth2 authentication.

Core Features & Use Cases

  • Path-based Routing: Directs traffic to different services based on URL paths.
  • Lazy DNS Resolution: Prevents Nginx startup failures when backend services are temporarily unavailable.
  • WebSocket/SSE Proxying: Enables real-time communication for modern applications.
  • OAuth2 Integration: Secures services using auth_request with OAuth2 Proxy.
  • Subpath Handling: Correctly routes traffic whether the backend service expects a subpath or not.
  • Use Case: You need to expose your self-hosted Gitea, Portainer, and a custom API to the internet. This Skill's patterns will help you configure Nginx to route /git/, /portainer/, and /api/ to their respective services, all under yourdomain.com, while ensuring secure access and proper handling of real-time connections.

Quick Start

Use the nginx-reverse-proxy skill to add a new service called 'my-app' that requires WebSocket support and OAuth2 authentication.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: nginx-reverse-proxy
Download link: https://github.com/MassimilianoPili/claude-code-config/archive/main.zip#nginx-reverse-proxy

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.