云服务器实战：用 Nginx 搭建高性能 API 网关与反向代理服务（附完整配置流程）

news2025/4/9 16:32:39

在如今的 Web 系统架构中，“接口统一出口”已成为必备设计模式——无论是前后端分离、微服务架构，还是多端接入（Web、小程序、App），一个稳定、高性能、可扩展的 API 网关至关重要。

而 Nginx，作为轻量级高并发 Web 服务器，在反向代理与负载均衡场景中表现出色，配合宝塔面板使用，可以快速部署一套可控、安全、高可用的 API 统一出口方案。

本文将以实际项目为例，介绍如何在云服务器上使用 Nginx 搭建 API 网关服务，实现前端调用统一地址转发至后端服务，涵盖请求路由、跨域设置、安全限制、日志分析等核心功能。

一、使用场景举例

Web 前端访问统一接口 /api/*，自动转发到 Node/Python/Golang 后端
网关对接多个子系统（如用户服务、订单服务、支付服务）
保护后端真实地址，防止直接攻击
配置 HTTPS、限速、防刷机制
统一日志收集与监控

二、服务器与部署环境准备

推荐配置：

系统：Ubuntu 20.04 / CentOS 7+
内存：1GB+（推荐 2GB+）
软件：Nginx、宝塔面板（简化配置）

三、安装宝塔面板（建议方式）

宝塔面板可快速管理网站、SSL、反代、日志等，非常适合构建接口服务。

安装命令（按系统选择）

Ubuntu 系统：

wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh 02f332488

CentOS 系统：

yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh 02f332488

安装完成后，访问 http://服务器IP:8888 登录宝塔后台。

四、添加站点并启用反向代理

在宝塔中添加网站，域名或 IP 均可
设置根目录为空或任意目录
启用反向代理，将接口请求转发至后端服务端口

例如：

前端请求：https://api.example.com/user/list
实际服务：转发至 http://127.0.0.1:3001/user/list

设置规则：

location /api/user/ {
    proxy_pass http://127.0.0.1:3001/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

每个服务模块可绑定一个路径前缀，实现“多服务统一入口”。

五、处理跨域问题（CORS）

Nginx 支持配置响应头解决跨域：

add_header Access-Control-Allow-Origin *;
add_header Access-Control-Allow-Methods GET,POST,OPTIONS;
add_header Access-Control-Allow-Headers Content-Type,Authorization;

对 OPTIONS 预检请求设置响应：

if ($request_method = 'OPTIONS') {
    return 204;
}

六、配置 HTTPS 与访问控制

使用 Let’s Encrypt 免费申请证书（宝塔面板支持）
设置请求速率限制：

limit_req_zone $binary_remote_addr zone=api_limit:10m rate=10r/s;
location /api/ {
    limit_req zone=api_limit burst=20 nodelay;
}

限制某些国家或 IP 段访问（通过 geo + deny 实现）

七、日志管理与接口监控

开启独立访问日志，便于接口问题排查
使用宝塔日志分析插件查看每日调用量、访问来源、状态码
结合 ELK / Grafana 等实现更强的监控体系（可后续扩展）

八、示例：微服务多模块接口路由配置

location /api/user/ {
    proxy_pass http://127.0.0.1:3001/;
}
location /api/order/ {
    proxy_pass http://127.0.0.1:3002/;
}
location /api/pay/ {
    proxy_pass http://127.0.0.1:3003/;
}

这样即可实现不同微服务按模块划分接口入口，统一由 Nginx 网关管理转发。