讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

SoundView
SoundView

字幕擦除翻译、配音口型同步

Laper
Laper

剧本策划到成片协作

uni-app怎么配置Nginx代理

轻强姑娘_7203

轻强姑娘_7203

发布时间:2026-11-21 06:23:22

|

771人浏览过

|

来源于php中文网

原创

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 在服务器本机测,别只看浏览器控制台报错。

热门AI工具

更多
花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

相关专题

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

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

3143

2023.08.11

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

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

6883

2023.10.09

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

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

7690

2024.03.19

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

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

7678

2024.03.22

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

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

1083

2024.05.22

nginx 重启
nginx 重启

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

423

2023.07.27

nginx 配置详解
nginx 配置详解

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

4407

2023.08.04

nginx配置详解
nginx配置详解

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

7385

2023.08.04

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

0

2026.11.20

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn