Docker 部署宝塔面板 Nginx 反向代理 502 踩坑实战指南
更新时间：2026年03月27日 10:46:20 作者：xuefeiniao
该文主要讨论了使用Docker部署宝塔面板时遇到的Nginx反向代理问题,错误在于将127.0.0.1作为宿主机端口,导致容器找不到服务；正确的做法是使用host.docker.internal,它可以访问到宿主机,喜欢的朋友跟随小编一起看看吧
一、问题描述
最近在使用 Docker 部署宝塔面板，配置 Nginx 反向代理宿主机端口服务时，遇到以下问题：
- 访问
127.0.0.1:20000/api报 502 Bad Gateway - 宿主机直接访问
6688 / 6689端口正常 - 日志/页面提示：
invalid link、link dead
宿主机端口正常，但容器内 Nginx 代理不通，这是非常典型的 Docker 网络误区。
二、核心原因：99% 的人都错在这里
❌ 错误写法（添加反向代理宝塔默认生成）
proxy_pass http://127.0.0.1:6688;
为什么错？
在 Docker 容器内部：
127.0.0.1 = 容器自己
不是宿主机！
容器访问自己的端口，当然找不到服务 → 直接 502。
三、正确方案：host.docker.internal
✅ 正确写法
proxy_pass http://host.docker.internal:6688;
作用解释
host.docker.internal 是 Docker 官方内置的固定域名作用：让容器内部访问到宿主机
重启nginx即可
到此这篇关于Docker 部署宝塔面板 Nginx 反向代理 502 踩坑实战指南的文章就介绍到这了,更多相关docker nginx 反向代理 502内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
本文介绍了如何将前端项目构建为Docker镜像,并在容器中配置Nginx进行部署,通过编写Dockerfile,将前端构建和Nginx配置结合在一起,实现了一键部署2025-10-10
在docker desktop中一键启动k8s环境很简单,下面介绍如何启动dashboard,dashboard仪表盘是新手学习k8s至关重要的一个工具,本文给大家介绍的非常详细,感兴趣的朋友一起看看吧2023-11-11
这篇文章主要为大家介绍了cgroup blkio子系统对容器的读写限速详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪2023-08-08
这篇文章主要介绍了使用Docker搭建本地开发环境的详细指南,涵盖了从基础Docker准备到多容器管理、安全强化等各个方面,通过使用Docker,可以确保开发环境的一致性、可移植性和可版本控制,文中通过代码介绍的非常详细,需要的朋友可以参考下2025-04-04
文章概述了部署多服务的流程：创建文件夹、上传并解压文件,删除旧容器,修正文件名,添加执行权限后运行脚本,最终启动多个服务2025-08-08
这篇文章主要介绍了阿里云安装docker全过程，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2023-04-04
这篇文章主要介绍了Dockerfile常用命令的使用简介，帮助大家更好的理解和学习使用Docker，感兴趣的朋友可以了解下2021-04-04
这篇文章主要介绍了Docker创建nacos容器的方法,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧2024-03-03
这篇文章主要介绍了尝试Docker+Nginx部署单页应用方法，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧2019-02-02
docker打造Ubuntu20.04 ssh远程连接镜像的实现
本文主要介绍了docker打造Ubuntu20.04 ssh远程连接镜像的实现,再也不用电脑上装了一堆的软件(mysql、redis、elk等),文中通过示例代码介绍的非常详细,需要的朋友们下面随着小编来一起学习学习吧2025-07-07
最新评论