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/api502 Bad Gateway
  • 宿主机直接访问 6688 / 6689 端口正常
  • 日志/页面提示:invalid linklink 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镜像拉取失败的几种原因及解决方法

    Docker镜像拉取失败的几种原因及解决方法

    本文主要介绍了Docker镜像拉取失败的几种原因及解决方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-07-07
  • docker拉取镜像错误missing signature key的解决方法

    docker拉取镜像错误missing signature key的解决方法

    这篇文章主要介绍了docker拉取镜像错误missing signature key的解决方法,当我使用docker拉取一个特定的镜像时,提示错误,文中给出了相关的解决方法,需要的朋友可以参考下
    2024-03-03
  • docker执行java的jar包两种方法示例

    docker执行java的jar包两种方法示例

    这篇文章主要介绍了docker执行java的jar包两种方法,一是使用jar包,二是使用DockerFile,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2025-04-04
  • 使用Jenkins+docker打包部署后端服务的实现

    使用Jenkins+docker打包部署后端服务的实现

    本文主要介绍了使用Jenkins+docker打包部署后端服务的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-08-08
  • docker 详解设置容器防火墙

    docker 详解设置容器防火墙

    这篇文章主要介绍了docker 详解设置容器防火墙的相关资料,需要的朋友可以参考下
    2017-01-01
  • Docker部署Django的详细指南

    Docker部署Django的详细指南

    部署Django应用到Docker中的详细步骤是一个较为复杂的过程,涉及到许多技术和工具的结合使用,本文将详细介绍如何从零开始使用Docker部署Django应用,感兴趣的小伙伴跟着小编一起来看看吧
    2024-12-12
  • docker镜像无法上传的解决方法

    docker镜像无法上传的解决方法

    大家都知道创建镜像有很多方法,用户可以从 Docker Hub 获取已有镜像并更新,也可以利用本地文件系统创建一个。但是工作中却发现docker镜像怎么都无法上传,通过在网上查找资料终于解决了,下面将方法分享给大家,有需要的朋友们可以参考借鉴,下面来一起看看吧。
    2016-11-11
  • 使用docker exec在容器中运行命令的方法

    使用docker exec在容器中运行命令的方法

    Docker 是一个流行的容器化平台,它允许您在容器中打包、部署和运行应用程序,docker exec 命令允许您在容器中运行命令,这对于调试、测试和管理容器非常有用,在本文中,我们将介绍如何使用 docker exec 命令在容器中运行命令,需要的朋友可以参考下
    2026-03-03
  • Docker部署服务端口无法访问的排查与解决方法

    Docker部署服务端口无法访问的排查与解决方法

    在使用 Docker 部署 Grafana 的过程中,我遇到了一个比较常见的问题:容器已经启动成功,宿主机本地能访问 Grafana 的 3000 端口,但在局域网中却无法访问,本文就为大家详细介绍了排查与解决方法,需要的朋友可以参考下
    2025-11-11
  • liunx内存满了,docker中overlay2爆表解决方案

    liunx内存满了,docker中overlay2爆表解决方案

    这篇文章主要介绍了liunx内存满了,docker中overlay2爆表解决方案,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-08-08

最新评论