配置简单反向代理
设置 Nginx,将请求转发到单个后端应用或服务器。
配置简单反向代理 是 CoddyKit 上的免费 API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) 课时。 这是第 1 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 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 (
listendirective). - The domain names it responds to (
server_namedirective).
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
serverandlocationblocks. - Using
proxy_passto forward requests. - The importance of
proxy_set_headerfor 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!
常见问题解答
「配置简单反向代理」课时是免费的吗?
是的 — 「配置简单反向代理」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 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),全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) 需要有经验吗?
无需任何先前经验。CoddyKit 上的 API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 1 节课,共 4 节。
「配置简单反向代理」课时需要多长时间?
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。
我能在这节 API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) 课中编写并运行代码吗?
能。每节 API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- 配置简单反向代理
- 上游服务器与负载均衡
- 代理缓冲与缓存
- 转发标头与客户端 IP