如何在Docker+Miniconda环境部署Flask API并实现本地访问？

背景信息 #

用户创建了基于Miniconda的Flask API Docker镜像，Dockerfile内容如下：

FROM continuumio/miniconda3

# Install base utilities
RUN apt-get update \
&& apt-get install -y wget \
&& rm -rf /var/lib/apt/lists/*

COPY api /root/api
RUN echo "Running $(conda --version)" 
RUN conda update conda 
RUN conda create -n api python=3.9 
RUN echo "conda activate api" >> ~/.bashrc
SHELL ["/bin/bash", "--login", "-c"]
RUN conda activate api
RUN conda install flask requests 
ENTRYPOINT ["conda", "run", "-n", "api", "python", "/root/api/main.py"]

遇到的问题：已添加EXPOSE 5000但本地无法访问API，尝试http://172.17.0.2/api和http://localhost/api均无响应；进入容器终端运行main.py时提示“Port 5000 is in use by another program”。

1. Linux上正确运行Flask API的方式及当前操作问题 #

正确运行步骤： #

• 绑定0.0.0.0：Flask默认仅监听127.0.0.1（容器内部回环地址），必须在代码中设置app.run(host='0.0.0.0', port=5000)，才能让外部访问。
• 端口冲突处理：执行lsof -i :5000或netstat -tulpn | grep 5000找到占用5000端口的进程，用kill -9 <进程PID>终止后再运行API。
• 环境激活：激活conda环境后直接运行python main.py，确保依赖包都在当前环境中。

当前操作的问题： #

• 未配置Flask监听0.0.0.0，导致外部无法访问。
• 容器启动时ENTRYPOINT已在运行API，再进入容器重复运行会触发端口占用。

2. Docker中正确运行Flask API的方式及当前Dockerfile问题 #

修正后的Dockerfile示例： #

FROM continuumio/miniconda3

# Install base utilities（增加net-tools方便排查端口）
RUN apt-get update \
    && apt-get install -y wget net-tools \
    && rm -rf /var/lib/apt/lists/*

COPY api /root/api

# 简化conda环境创建，用--yes自动确认安装
RUN conda create -n api python=3.9 --yes \
    && conda install -n api flask requests --yes

# 声明端口（仅为文档作用，实际需靠端口映射生效）
EXPOSE 5000

# 启动命令，确保Flask代码已绑定0.0.0.0
ENTRYPOINT ["conda", "run", "-n", "api", "python", "/root/api/main.py"]

关键注意事项： #

• Flask代码配置：必须在main.py中设置app.run(host='0.0.0.0', port=5000)，这是外部能访问的核心前提。
• 端口映射：启动容器时必须添加-p参数，将宿主机端口映射到容器端口，例如：docker run -d -p 5000:5000 <镜像名称>。
• 端口冲突排查：若启动容器时提示端口被占，先排查宿主机端口：netstat -tulpn | grep 5000，终止占用进程；若为容器内部冲突，用docker ps查看运行中的容器，执行docker stop <容器ID>后重新启动。

当前Dockerfile的问题： #

• 未确保Flask监听0.0.0.0，这是访问失败的核心原因。
• EXPOSE仅为声明端口，未配合端口映射操作，导致宿主机无法转发请求到容器。
• 存在冗余的conda环境激活配置（如修改.bashrc），conda run已可直接激活指定环境，无需额外配置。

3. 访问本地Docker容器中Flask API的方法 #

• 必备操作：启动容器时必须做端口映射，例如：docker run -d -p 5000:5000 my-flask-api（将宿主机5000端口映射到容器5000端口）。
• 访问地址：
  • 本地宿主机直接访问：http://localhost:5000/api（假设API路由为/api）。
  • 同一局域网内其他机器访问：使用宿主机的IP地址，例如http://192.168.1.100:5000/api（替换为实际宿主机IP）。
• 容器IP查看（可选）：执行docker inspect <容器ID> | grep "IPAddress"可查看容器内部IP，但无需直接用此IP访问，端口映射是更便捷的方式。

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