mdhamim/yolks

Python基础镜像文档

镜像概述

该镜像基于python:3.11-slim-bookworm构建，旨在提供一个包含常用依赖和工具的Python运行环境。适用于需要系统工具、HTML转PDF功能或网页自动化能力的Python应用部署。

• 基础镜像：python:3.11-slim-bookworm（多平台支持）
• 维护者：MD HAMIM (me@mdhamim.com)
• 源代码：https://github.com/seracoder/yolks
• 许可证：MIT

核心功能与特性

系统依赖

预安装以下常用系统工具和库：

• 构建工具：cmake、make、g++、gcc
• 网络工具：curl、wget、iproute2
• 媒体处理：ffmpeg
• 版本控制：git
• 安全与数据：ca-certificates、openssl、sqlite3
• 系统工具：tar、tzdata（时区支持）

专用工具

• wkhtmltopdf：版本0.12.6.1-3，用于将HTML内容转换为PDF或图片格式
• Playwright：版本1.44.0，包含浏览器支持，用于网页自动化测试、截图、爬虫等场景

优化处理

• 清理APT缓存和临时文件（/var/lib/apt/lists/*、/tmp/*等）
• 移除/root/.cache目录，减小镜像体积
• 执行apt autoremove和apt clean进一步优化

入口脚本

• 包含/entrypoint.sh脚本，已设置执行权限
• 作为容器默认启动命令（CMD ["/bin/bash", "/entrypoint.sh"]）

使用场景

• 需要HTML转PDF/图片功能的Python应用（如报告生成、文档导出）
• 基于Playwright的网页自动化测试或数据采集应用
• 需要编译C/C++扩展的Python项目（依赖cmake、gcc等工具）
• 需处理音视频文件的Python应用（依赖ffmpeg）

使用方法

基本运行

直接启动容器进入交互式终端：

bash
docker run -it --rm [镜像名称或ID]

运行自定义Python脚本

将本地代码挂载到容器并执行：

bash
docker run -it --rm -v /本地代码路径:/app -w /app [镜像名称或ID] python your_script.py

Docker Compose配置示例

yaml
version: '3.8'
services:
  python-app:
    image: [镜像名称或ID]
    volumes:
      - ./your-app:/app  # 挂载本地应用代码
    working_dir: /app    # 设置工作目录
    command: python main.py  # 覆盖默认命令执行应用
    environment:
      - TZ=Asia/Shanghai  # 设置时区（可选）

入口脚本说明

入口脚本/entrypoint.sh的具体逻辑可参考原项目链接：
https://gist.github.com/seracoder/dc1ca564f***b54cc52686ee89df25
通常用于环境初始化、权限设置或启动前准备工作。