0Pricing
API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) · Leçon

Configurer un proxy inverse simple

Configurez Nginx pour transmettre les requêtes à une seule application ou à un seul serveur principal.

Configurer un proxy inverse simple est une leçon API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway), et ta progression se synchronise sur le web et l'application CoddyKit. Le cours API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) comprend 4 leçons au total.

Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.

What's a Reverse Proxy?

In simple terms, a reverse proxy acts as an intermediary between clients (like your web browser) and your backend servers. When you send a request, it goes to the reverse proxy first.

The reverse proxy then forwards your request to the appropriate backend server, collects the response, and sends it back to you. It's like a helpful receptionist for your web services!

Nginx: Your Traffic Cop

Nginx (pronounced "engine-x") is a popular, high-performance web server that can also function as a very efficient reverse proxy.

It sits at the "edge" of your network, receiving all incoming client requests. Based on its configuration, Nginx decides which backend application or server should handle the request.

Think of it as a traffic cop, directing incoming requests to the correct destination.

Nginx Server Block Basics

Nginx configurations are organized into blocks. The primary block for handling incoming connections is the server block.

Each server block defines a virtual host, specifying:

  • The port Nginx listens on (listen directive).
  • The domain names it responds to (server_name directive).

It's where Nginx decides which specific application configuration to use for a given request.

server {
    listen 80;
    server_name example.com www.example.com;

    # Other configurations will go here
}

Routing with Location Blocks

Inside a server block, you use location blocks to define how Nginx should handle requests for specific URLs or URL patterns.

For example, a location / {} block matches all requests, while a location /api {} block matches requests starting with /api.

This allows you to route different parts of your application to different backend services.

server {
    listen 80;
    server_name myapp.com;

    location / {
        # How to handle requests to myapp.com/
    }

    location /api {
        # How to handle requests to myapp.com/api
    }
}

Forwarding Requests: proxy_pass

The magic directive for reverse proxying is proxy_pass. This directive tells Nginx where to forward the incoming request.

You place proxy_pass inside a location block. Its value is the URL of your backend server or application.

  • http://localhost:8080: A local web server.
  • http://my-backend-service.com: A remote service.

Nginx will take the client's request and send it directly to this specified URL.

Basic Reverse Proxy Setup

Let's create a simple Nginx configuration to proxy requests. We'll set Nginx to listen on port 80 and forward all requests to a backend application running on localhost:8080.

This hides the backend's port and allows Nginx to handle public traffic.

server {
    listen 80;
    server_name myapp.com;

    location / {
        proxy_pass http://localhost:8080;
    }
}

Preserving Request Info

When Nginx proxies a request, it acts on behalf of the client. By default, some original client information (like their IP address) might be lost or replaced by Nginx's own details.

To preserve this information, we use proxy_set_header directives. Key headers to set include:

  • Host: Original requested host.
  • X-Real-IP: The client's actual IP address.
  • X-Forwarded-For: A list of proxy IPs, including the client's.
  • X-Forwarded-Proto: The original protocol (HTTP/HTTPS).

These headers are crucial for backend applications to correctly identify the client and handle requests.

Proxying with Proper Headers

It's good practice to include essential headers in your reverse proxy configuration. This helps your backend application receive the correct client information.

Here's our previous example, updated with common proxy_set_header directives.

server {
    listen 80;
    server_name myapp.com;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Why Use a Simple Proxy?

Even a basic reverse proxy setup offers significant advantages:

  • Security: Hides the backend server's direct IP and port from the public.
  • Load Distribution: (Even for one server, it prepares for more).
  • SSL Termination: Nginx can handle HTTPS encryption, offloading the backend.
  • URL Rewriting: Present a cleaner URL to clients while internally routing to complex paths.

This single point of entry simplifies management and enhances control over traffic.

Quick Check: Nginx Proxy

Consider the following Nginx configuration snippet. Which directive is used to forward client requests to a backend server?

server {
listen 80;
server_name example.com;
location / {
# THIS IS WHERE THE DIRECTIVE GOES
http://my-backend-app:9000;
}
}

Summary: Simple Proxying

Great job! You've learned the fundamentals of configuring Nginx as a simple reverse proxy.

We covered:

  • The role of server and location blocks.
  • Using proxy_pass to forward requests.
  • The importance of proxy_set_header for preserving client information.

This foundational knowledge is key to building more complex and robust Nginx setups. Next, we'll explore how to manage multiple backend servers!

Questions Fréquemment Posées

La leçon « Configurer un proxy inverse simple » est-elle gratuite ?

Oui — le texte complet de « Configurer un proxy inverse simple » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway), passe à CoddyKit PRO. Le cours API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Configurer un proxy inverse simple » ?

Configurez Nginx pour transmettre les requêtes à une seule application ou à un seul serveur principal. Tu pratiques API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) ?

Aucune expérience préalable n'est requise. API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.

Combien de temps prend la leçon « Configurer un proxy inverse simple » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) ?

Oui. Chaque leçon API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

  1. Configurer un proxy inverse simple
  2. Serveurs en amont et équilibrage de charge
  3. Mise en mémoire tampon et mise en cache du proxy
  4. Transmission des en-têtes et adresse IP du client
← Retour à API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)