容器化Python Web服务器无法连接问题求助

问题场景 #

我用Python的http.server模块搭建了Web服务，本地直接运行sudo python -m http.server 80或者sudo python main.py都能正常访问127.0.0.1:80，但通过以下Docker流程部署后，外部访问出现无限加载或“无法连接”错误，且容器已确认正常运行：

• 构建镜像：sudo docker build -t container_name .
• 运行容器：sudo docker run -p 127.0.0.1:80:80 container_name

我的Dockerfile内容如下：

FROM python:3-alpine

RUN apk update && apk upgrade

WORKDIR /ClientConnector

COPY . /ClientConnector

EXPOSE 80

RUN pip install -r requirements.txt

CMD ["python", "main.py"]

核心原因 #

http.server默认只绑定127.0.0.1（容器内部的回环地址），这意味着服务仅能被容器自身访问，外部主机通过端口映射也无法触达服务。

解决方案 #

修改main.py中的服务启动代码，将绑定地址改为0.0.0.0（监听容器的所有网卡接口），具体分两种情况：

情况1：自定义请求处理器 #

如果你的代码是继承BaseHTTPRequestHandler实现的服务：

from http.server import HTTPServer, BaseHTTPRequestHandler

class CustomHandler(BaseHTTPRequestHandler):
    def do_GET(self):
        self.send_response(200)
        self.end_headers()
        self.wfile.write(b"Service is running")

if __name__ == "__main__":
    # 关键修改：把127.0.0.1替换为0.0.0.0
    server = HTTPServer(('0.0.0.0', 80), CustomHandler)
    server.serve_forever()

情况2：使用SimpleHTTPRequestHandler #

如果是直接用静态文件服务的方式：

from http.server import SimpleHTTPRequestHandler
import socketserver

# 绑定0.0.0.0:80
with socketserver.TCPServer(("0.0.0.0", 80), SimpleHTTPRequestHandler) as httpd:
    httpd.serve_forever()

验证与额外检查 #

• 容器内验证：执行docker exec -it container_name curl 127.0.0.1:80，如果能正常返回内容，说明服务本身没问题，问题确实出在绑定地址上。
• 端口映射检查：确认运行容器的命令中端口映射规则正确，-p 127.0.0.1:80:80表示将主机的80端口映射到容器的80端口。
• 防火墙检查：检查主机防火墙是否允许80端口的入站流量，避免被防火墙拦截。
• 日志排查：执行docker logs container_name查看服务启动日志，确认日志中是否有“Listening on 0.0.0.0:80”类似的输出。

内容的提问来源于stack exchange，提问作者bruh