API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) · Урок

Настройка простого обратного прокси

Настройте Nginx для перенаправления запросов к одному серверному приложению или серверу.

Урок 1 из 411 шагов

«Настройка простого обратного прокси» — бесплатный урок API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) на CoddyKit. Это урок 1 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway), и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) содержит 4 уроков всего.

Части этого урока еще не переведены и отображаются на английском.

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!

Можно начать бесплатно

Изучай API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) с ИИ-репетитором — бесплатно

Пиши и запускай код прямо в браузере, получай мгновенную помощь от ИИ-репетитора 24/7 и продолжи учиться на сайте или в приложении.

Курсы
12
Уроки
48

Часто задаваемые вопросы

Урок «Настройка простого обратного прокси» бесплатный?

Да — полный текст урока «Настройка простого обратного прокси» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway), подпишись на CoddyKit PRO. Курс API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) содержит 4 уроков всего.

Чему я научусь в уроке «Настройка простого обратного прокси»?

Настройте Nginx для перенаправления запросов к одному серверному приложению или серверу. Ты практикуешь API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)?

Предыдущий опыт не требуется. API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 1 из 4.

Сколько времени занимает урок «Настройка простого обратного прокси»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)?

Да. Каждый урок API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

  1. Настройка простого обратного прокси
  2. Серверы upstream и балансировка нагрузки
  3. Буферизация и кэширование прокси
  4. Пересылка заголовков и IP-адрес клиента
← Назад к API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)