dclong/python

dclong/docker-python 镜像文档

镜像概述

dclong/docker-python 是一个预配置的Python环境Docker镜像，旨在为用户提供便捷、一致的Python运行环境。该镜像无需用户在本地系统安装Python，即可快速启动Python解释器或运行Python应用程序，适用于开发、测试及生产环境。

核心功能与特性

• 预装Python环境：包含指定版本的Python解释器，开箱即可使用
• 依赖管理工具：集成pip包管理工具，支持快速安装Python第三方库
• 轻量级基础：基于轻量级Linux发行版构建，镜像体积小，资源占用低
• 环境一致性：确保不同环境（开发、测试、生产）中Python版本及依赖一致，避免"在我机器上能运行"问题

使用场景与适用范围

• Python应用程序开发与测试
• 快速运行Python脚本（如数据处理、自动化任务）
• CI/CD流程集成，作为Python项目构建或测试环境
• 教学环境搭建，提供统一的Python学习环境

使用方法与配置说明

基本使用

1. 拉取镜像

bash
docker pull dclong/docker-python

2. 运行Python交互式解释器

bash
docker run -it --rm dclong/docker-python python

3. 运行本地Python脚本

将本地脚本目录挂载到容器中执行：

bash
# 假设本地脚本路径为 ./my_script.py
docker run -it --rm -v $(pwd):/app -w /app dclong/docker-python python my_script.py

环境变量配置

支持通过环境变量自定义运行环境：

• PYTHONPATH：设置Python模块搜索路径，默认为空
• PIP_NO_CACHE_DIR：设置为"1"可禁用pip缓存，减少磁盘占用

示例：禁用pip缓存安装依赖

bash
docker run -it --rm -e PIP_NO_CACHE_DIR=1 dclong/docker-python python -m pip install requests

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  python-app:
    image: dclong/docker-python
    volumes:
      - ./app:/app  # 挂载本地项目目录
    working_dir: /app  # 设置工作目录
    command: python main.py  # 运行应用入口脚本

启动服务：

bash
docker-compose up

注意事项

• 完整配置说明及最新版本信息请参考 https://github.com/dclong/docker-python
• 生产环境中建议指定具体镜像标签（如:3.11-slim）以确保版本稳定性
• 如需持久化存储依赖包，可将/usr/local/lib/pythonX.X/site-packages目录挂载为卷