uni-app怎么配置Nginx代理

轻强姑娘_7203

轻强姑娘_7203

2026-11-21

771人浏览

原创

Nginx代理是部署时在服务端配置的反向代理,用于生产环境解决跨域和路径统一问题;开发阶段必须用vue.config.js的devServer.proxy,因打包后H5请求直连网络,无代理则触发CORS或404。

uni-app怎么配置nginx代理

直接说结论:Nginx 代理不是 uni-app 自身的配置,而是部署时在 Nginx 侧做的反向代理,用来解决生产环境跨域和接口路径统一问题。开发阶段用 vue.config.js 的 devServer.proxy,上线后必须切到 Nginx 的 location + proxy_pass,否则请求会 404 或跨域失败。

为什么不能只靠开发代理?

因为 devServer.proxy 只在 npm run serve 本地启动时生效,打包成 H5 后所有请求都走真实网络——此时浏览器直连后端,若域名、协议、端口不一致,就会触发 CORS。而 Nginx 作为服务端反向代理,能隐藏真实后端地址,让前端所有请求看起来都“同源”。

常见错误现象:

  • 页面能打开,但接口全部 404(Nginx 没配 location /api/)
  • 接口返回 502(proxy_pass 地址写错,或后端没起来)
  • 登录态丢失(漏配 proxy_set_header Cookie $http_cookie,尤其带 session 的接口)

nginx.conf 里怎么写 location 和 proxy_pass

核心是两段:静态资源路由 + API 代理。不要把它们写进同一个 location / 块里。

正确写法示例(关键参数已加粗):

server {
    listen 80;
    server_name example.com;
<pre class="brush:php;toolbar:false;"># 静态资源(uni-app 打包后的 dist/build/h5)
location / {
    root /var/www/html/uniapp;
    index index.html;
    try_files $uri $uri/ /index.html;  # 必须!支持 hash 路由回退
}

# API 代理(假设后端接口地址是 http://192.168.1.100:3000)
location /api/ {
    proxy_pass http://192.168.1.100:3000/;  # 注意末尾斜杠:有则去掉前缀,无则保留
    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;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}

}

重点说明:

Nginx Reverse Proxy
Nginx Reverse Proxy

配置 Nginx 反向代理,实现域名绑定。用户说“绑定域名”“配置 Nginx”“反向代理”时触发,将域名绑定到指定 IP:端口。

下载
  • proxy_pass 末尾带 /:请求 /api/user 会被转发为 http://.../user(自动剥离 /api)
  • proxy_pass 末尾不带 /:请求 /api/user 会被转发为 http://.../api/user
  • try_files $uri $uri/ /index.html 是 uni-app 的刚需,否则刷新页面 404(hash 模式也依赖它)
  • 如果后端是 HTTPS,proxy_pass 必须写 https://,且确保 Nginx 编译时含 OpenSSL 支持

uni-app 代码里请求路径怎么写?

前端代码中所有接口调用,路径必须跟 Nginx 的 location 前缀严格对齐。比如你配了 location /api/,那 JS 里就得写:

uni.request({
    url: '/api/login',  // ✅ 正确:以 /api/ 开头
    method: 'POST',
    success: res => console.log(res)
});

不能写:

  • url: 'http://192.168.1.100:3000/login'(硬编码后端地址,上线必挂)
  • url: '/login'(没加 /api/ 前缀,Nginx 不会代理,直接跨域)
  • url: 'api/login'(缺开头斜杠,变成相对路径,可能拼成 http://example.com/current-path/api/login)

更稳妥的做法是抽成常量:

const API_BASE = '/api';
uni.request({ url: API_BASE + '/login' });

HTTPS 环境下要注意什么?

如果用 HTTPS 域名访问前端,但 proxy_pass 指向 HTTP 后端,Nginx 默认允许(称作“mixed content”代理),但部分浏览器会拦截非安全响应。解决方案只有两个:

  • 后端也上 HTTPS(推荐),proxy_pass https://backend.example.com/
  • 若后端暂不支持 HTTPS,需在 Nginx 的 location 块中显式关闭 SSL 验证(仅限内网可信环境):
    proxy_ssl_verify off;
    proxy_ssl_trusted_certificate /path/to/ca.crt;

另外,SSL 配置本身要放在 server { listen 443 ssl; ... } 块里,别和 listen 80 混在一起;证书路径必须用绝对路径,且 Nginx 进程要有读取权限。

最容易被忽略的一点:Nginx reload 后,一定要检查 proxy_pass 目标服务是否真的可达——用 curl -v http://192.168.1.100:3000/health 在服务器本机测,别只看浏览器控制台报错。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

3143

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

6883

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

7690

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

7678

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

1083

5

nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.27

423

5

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

4407

6

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

2023.08.04

7385

6

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

601

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习