lvthillo/python-flask-docker

Flask容器信息展示应用

镜像概述和主要用途

概述

本镜像是一个Docker化的轻量级Flask应用程序，核心功能是在访问时返回当前容器的名称和IP地址。应用基于Python Flask框架构建，通过Docker容器化封装，实现快速部署和使用。

主要用途

用于便捷地获取容器的基本标识信息（名称和IP），可作为容器网络调试工具、Docker基础教学示例或简单的容器信息展示服务。

核心功能和特性

核心功能

• 自动获取并展示当前容器的名称
• 自动获取并展示当前容器的IP地址

特性

• 轻量级：基于Python和Flask框架，镜像体积小，资源占用低
• 即开即用：无需复杂配置，启动容器即可提供服务
• 跨平台兼容：支持所有Docker运行环境（Linux、Windows、macOS）
• 网络透明：自动适配Docker默认网络模式，准确获取容器网络信息

使用场景和适用范围

使用场景

• 容器网络调试：快速验证容器网络连接状态和IP分配情况
• 教学演示：展示Docker容器基础信息获取方法，适合Docker入门学习
• 容器标识服务：为小型应用提供简单的容器身份标识展示功能
• 自动化测试：作为基础镜像验证容器部署是否成功

适用范围

• 开发人员：调试容器网络配置或学习Docker基础操作
• 运维人员：快速检查容器运行状态和网络信息
• 教育场景：演示容器与主机、容器间的网络关系

使用方法和配置说明

前提条件

• 已安装Docker Engine（推荐版本20.10及以上）
• 网络环境允许容器端口映射（默认使用5000端口）

获取镜像

从Docker Registry拉取（假设存在）

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/flask-container-info:latest

本地构建（如需自定义）

1. 创建项目目录并编写基础文件（示例）：

   bash
   mkdir flask-container-info && cd flask-container-info
   # 创建Dockerfile和app.py
   

2. 构建镜像：

   bash
   docker build -t flask-container-info .
   

运行容器

基本运行命令

bash
docker run -d -p 5000:5000 --name container-info-demo docker.xuanyuan.run/flask-container-info

参数说明

• -d：后台运行容器
• -p 5000:5000：端口映射（主机端口:容器端口，Flask默认使用5000端口）
• --name container-info-demo：自定义容器名称（可选，不指定则自动生成）

访问应用

容器启动后，通过以下方式访问服务：

• 浏览器访问：http://localhost:5000
• 命令行访问：curl http://localhost:5000

预期输出示例

Container Information:
Name: container-info-demo
IP Address: 172.17.0.2

自定义配置

端口映射修改

若主机5000端口已被占用，可修改端口映射：

bash
docker run -d -p 8080:5000 --name container-info-demo docker.xuanyuan.run/flask-container-info
# 访问地址变为 http://localhost:8080

网络模式调整

使用自定义网络时，IP地址将显示对应网络中的分配结果：

bash
# 创建自定义网络
docker network create my-network
# 在自定义网络中运行容器
docker run -d -p 5000:5000 --name container-info-demo --network my-network docker.xuanyuan.run/flask-container-info

注意事项

• 容器名称默认通过环境变量HOSTNAME获取，与docker run --name参数一致
• IP地址获取依赖容器网络接口（通常为eth0），不同网络模式（bridge/host/overlay）下显示结果不同
• 如需持久化日志，可添加日志挂载：-v $(pwd)/logs:/app/logs（需应用支持日志输出）