layui怎么在内网穿透或反向代理环境下正确配置请求路径

陌晨吖_4876

陌晨吖_4876

2026-11-16

787人浏览

原创

layui的ajax请求在反向代理下404,是因为其不感知代理层,请求直接发往浏览器当前域名;需通过layui.config统一配置base路径(如'/api/'),并确保Nginx的location与proxy_pass路径精准对齐(尾部斜杠必须一致),同时补全header及proxy_redirect规则。

layui怎么在内网穿透或反向代理环境下正确配置请求路径

layui 的 ajax 请求路径在反向代理下为什么会 404

因为 layui 自身不感知代理层,$.ajax() 或 layer.open({type: 2}) 发出的请求是直接走浏览器当前域名的,如果后端 API 实际部署在内网(如 http://192.168.1.100:3000),而你通过 Nginx 反代暴露为 https://app.example.com/api/,但前端代码里还写 /api/user 或 http://192.168.1.100:3000/api/user,就会触发跨域或路径错位。

  • 写绝对 URL(如 http://192.168.1.100:3000/api/login)→ 浏览器直连失败(内网地址不可达)
  • 写相对路径(如 /api/login)→ 路径对齐依赖 Nginx 的 location 和 proxy_pass 配置是否精准,稍有偏差就 404
  • 没统一配置 base URL → 各处 url: 字段硬编码,改环境就得全局搜替换

用 layui.config 全局设置 base URL 最省事

不要在每个 $.ajax() 里拼地址,而是启动时用 layui.config 注入一个可变的 base,后续所有模块自动继承:

layui.config({
  base: '/api/' // 注意结尾斜杠,和 Nginx location 保持一致
}).use(['jquery', 'layer'], function(){
  var $ = layui.jquery;
  $.ajax({
    url: 'user/list', // 实际发到 /api/user/list
    success: function(res){ ... }
  });
});
  • base 必须以 / 开头且以 / 结尾,否则拼接逻辑会出错
  • 值不能写协议+域名(如 https://app.example.com/api/),否则跨域;只写路径前缀即可
  • 若 Nginx 配置了子路径代理(如 location /admin/ { proxy_pass http://backend/; }),这里就填 /admin/api/

Nginx 必须配合做路径对齐,否则 layui 请求仍 404

layui 发 /api/user,Nginx 得准确把这段路径转发给后端。常见错误是 proxy_pass 尾部斜杠缺失或多余:

  • ✅ 正确(带尾部 /):location /api/ { proxy_pass http://192.168.1.100:3000/; } → /api/user → 后端收到 /user
  • ❌ 错误(无尾部 /):location /api/ { proxy_pass http://192.168.1.100:3000; } → /api/user → 后端收到 /api/user(多了一级)
  • ⚠️ 若后端本身监听 /api 前缀,才考虑不加尾部 /,但极易混淆,不推荐

同时必须补全关键 header,否则后端可能解析不到真实路径或 IP:

深蓝色网站后台管理系统layui框架模板-AdminPro
深蓝色网站后台管理系统layui框架模板-AdminPro

一款深蓝色网站后台管理系统layui框架模板

下载
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;
}

遇到重定向(302)时 layui 会跳错域名,得靠 proxy_redirect 拦截

后端返回 Location: http://192.168.1.100:3000/login,浏览器会直接跳去这个内网地址——必须用 proxy_redirect 改写。变量要用正则匹配,不能写死:

location /api/ {
  proxy_pass http://192.168.1.100:3000/;
  proxy_redirect ~^http://[^/]+(?::\d+)?/(.*)$ $scheme://$host/api/$1;
}
  • 这个规则把任意内网绝对重定向(如 http://localhost:3000/login)→ 改成 https://app.example.com/api/login
  • 注意 $scheme://$host/api/$1 中的 /api/ 必须和 layui 的 base、Nginx 的 location 完全一致
  • 别用 proxy_redirect http://192.168.1.100:3000/ /api/; —— IP 或端口一变就失效

最易被忽略的是:layui 的 iframe 弹窗(layer.open({type: 2, content: '/page/user.html'}))也走同样路径逻辑,必须确保 /page/ 这类静态资源路径也在 Nginx 中做了对应代理,否则打开空白页。

相关文章

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

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

下载

相关标签:

layui layui菜鸟教程

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

相关专题

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

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

2023.08.11

3043

5

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

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

2023.10.09

6663

6

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

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

2024.03.19

7490

13

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

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

2024.03.22

7438

10

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

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

2024.05.22

1063

5

http500解决方法
http500解决方法

http500解决方法有检查服务器日志、检查代码错误、检查服务器配置、检查文件和目录权限、检查资源不足、更新软件版本、重启服务器或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.09

4123

4

http请求415错误怎么解决
http请求415错误怎么解决

解决方法:1、检查请求头中的Content-Type;2、检查请求体中的数据格式;3、使用适当的编码格式;4、使用适当的请求方法;5、检查服务器端的支持情况。更多http请求415错误怎么解决的相关内容,可以阅读下面的文章。

2023.11.14

994

3

HTTP 503错误解决方法
HTTP 503错误解决方法

HTTP 503错误表示服务器暂时无法处理请求。想了解更多http错误代码的相关内容,可以阅读本专题下面的文章。

2024.03.12

6926

8

http与https有哪些区别
http与https有哪些区别

http与https的区别:1、协议安全性;2、连接方式;3、证书管理;4、连接状态;5、端口号;6、资源消耗;7、兼容性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.08.16

5630

6

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
ThinkPHP配置开发与CMS后台实战
ThinkPHP配置开发与CMS后台实战

共87课时 | 13.2万人学习

第二十三期_综合实战
第二十三期_综合实战

共89课时 | 11.5万人学习

Layui 快速入门精讲
Layui 快速入门精讲

共5课时 | 1.6万人学习