一，项目配置
我在 ip 为 192.168.31.177 的机器上使用 vue3 开发前端项目，项目中使用 axios 调用后端接口。
这是 axios 的配置：
import axios from 'axios';const request = axios.create({baseURL: 'http://192.168.31.177:8001',// 设置请求头headers: {},// 设置超时时间timeout: 2000,
});// 请求拦截器
request.interceptors.request.use(config => {// 在发送请求之前做些什么return config;},error => {// 对请求错误做些什么return Promise.reject(error);}
);// 响应拦截器
request.interceptors.response.use(response => {if (response) {// 响应数据为二进制流处理(数据导出)if (response.data.data instanceof Blob) {return response}const {code, msg} = response.dataif (code === 200) {return Promise.resolve(response.data)} else {return Promise.resolve(response)}} else {return Promise.reject(new Error('系统出错'))}},function (error) {// 对响应错误做点什么// 比如：根据响应状态码，做不同的响应处理console.log(error)return Promise.reject(error)}
)export default request这是页面中的请求：
axios.get('/api/getNumbers').then(res => {ElMessage({message: res.msg,type: 'success'})}).catch(err => {ElMessage({message: err,type: 'error'})})
这是 package.json 中的配置：
"scripts": {"dev": "vite --host 192.168.31.177","build": "vite build","preview": "vite preview"}
然后在 ip 为 192.168.31.45 的机器上启动 expressjs 开发的后端项目 192.168.31.45:3000：
app.get('/api/getNumbers', (req, res) => {// 生成两个随机数const number1 = Math.floor(Math.random() * 100);const number2 = Math.floor(Math.random() * 100);res.json({code: 200,msg: '成功！',data: {"a": number1,"b": number2,}});
});
现在想使用 nginx 将前端的请求代理到后端，下面将介绍 nginx 需要怎样配置以及具体原理。
二，配置 nginx
前端项目运行在 192.168.31.177（开发机器），后端运行在 192.168.31.45:3000，Nginx 需要配置为反向代理，将前端请求转发到后端。
在开发机器（192.168.31.177）上 Nginx 的配置文件（nginx.conf）：
http {server {listen 8001; # Nginx 监听的端口，前端 axios 中配置的 端口server_name 192.168.31.177; # 前端 axios 中配置的 IPlocation / {try_files $uri $uri/ /index.html; # 支持Vue路由的history模式}# 代理后端API请求location /api {proxy_pass http://192.168.31.45:3000; # 后端项目运行的地址# 可选：如果后端接口路径不包含/api，移除前缀# rewrite ^/api/(.*) /$1 break;# 添加必要的代理头信息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;}}
}
配置完成后执行：
G:\nginx-1.24.0>nginx -t # 检查配置语法
nginx: the configuration file G:\nginx-1.24.0/conf/nginx.conf syntax is ok
nginx: configuration file G:\nginx-1.24.0/conf/nginx.conf test is successfulG:\nginx-1.24.0>start nginx # 启动nginxG:\nginx-1.24.0>nginx -s reload # 不停止，重新加载
- 打开【任务管理器——进程，搜索 nginx，可以看到两个进程，说明 nginx 正确启动。
启动前端项目，访问 http://192.168.31.177:5173/。打开页面后调用接口，获取到接口数据。
三，Nginx 代理原理
反向代理的作用：
-
请求转发：Nginx 监听前端请求（如 http://192.168.31.177:8080/api/getNumbers），并将匹配 /api 的请求转发到后端服务器 http://192.163.109.134:3000。
-
隐藏后端细节：前端无需知道后端地址，只需与 Nginx 通信。
-
解决跨域：浏览器认为请求是同源的（都是 http://192.168.31.177:8080），实际由 Nginx 转发到不同域的后端。
-
关键配置解释
location /api：匹配所有以 /api 开头的请求路径。proxy_pass：将匹配的请求转发到后端服务器。proxy_set_header：设置请求头，确保后端能获取客户端的真实 IP 和协议信息。add_header：添加 CORS 响应头，显式允许跨域（可选，如果代理已解决跨域，可能不需要）。
为什么这样配置？
-
解决跨域问题：浏览器默认禁止跨域请求，但通过 Nginx 代理：前端请求发送到 http://192.168.31.177:8080/api（同源）。Nginx 将请求转发到 http://192.163.109.134:3000/api，后端响应通过 Nginx 返回前端。浏览器认为请求是“同源”的，不会触发跨域限制。
-
灵活的路由控制：可以按路径（如 /api）或域名分发请求。
-
支持负载均衡、缓存等高级功能（开发阶段可能不需要）。
-
统一入口：前端和后端通过同一个端口（如 8080）通信，简化开发配置。
验证配置是否生效：
- 在浏览器中访问后端 API http://192.163.109.134:3000/api/getNumbers，确保后端正常返回数据。
- 通过 Nginx 访问 API http://192.168.31.177:8080/api/getNumbers，检查是否返回相同数据。
- 检查看 Nginx 的访问日志和错误日志，确认请求是否被正确转发。
- Nginx 未启动或配置错误问题排查
status nginx 检查服务状态。 nginx -t 检查配置语法。
四，源码
nginx代理前端请求——教程源码
