apify/actor-python

Apify Python Actor 运行镜像

镜像概述

本Docker镜像是一个轻量级运行环境，专为在Apify平台的actors中执行Python脚本设计。它基于最小化基础镜像构建，旨在减少资源占用的同时，确保与Apify生态系统的完整兼容性，简化Python编写的Apify actors的开发与部署流程。

核心功能与特性

轻量级设计

• 基于精简基础镜像（如Alpine Linux）构建，镜像体积小，启动速度快，适合资源受限环境
• 仅包含运行Python脚本的必要依赖，避免冗余组件

Apify生态兼容性

• 原生支持Apify Actor生命周期管理（初始化、启动、清理）
• 兼容Apify SDK for Python（apify-sdk），支持输入/输出处理、密钥管理、事件循环等核心功能
• 适配Apify平台的日志系统、错误处理机制和资源监控

Python环境支持

• 内置Python 3.9+运行时环境，包含pip包管理工具
• 支持标准Python脚本执行，兼容常见Python库（需手动安装依赖）

简化部署流程

• 与Apify CLI无缝集成，支持apify push一键部署
• 提供标准化的文件结构，降低actor配置复杂度

使用场景与适用范围

• 在Apify平台开发和运行Python编写的网络爬虫、数据提取工具
• 构建基于Python的自动化任务（如API调用、数据转换、定时任务）
• 开发需要与Apify生态（如任务队列、存储系统、代理池）交互的actor
• 对镜像大小和资源消耗有严格要求的生产环境

使用方法与配置说明

基本使用流程

1. 准备Python脚本：编写符合Apify Actor规范的Python脚本（推荐使用apify-sdk）
2. 配置依赖：创建requirements.txt声明所需Python依赖（如需额外库）
3. 构建/引用镜像：直接使用官方镜像或基于此镜像构建自定义镜像
4. 部署到Apify：通过Apify CLI或平台界面部署actor

Docker Run示例

本地测试Apify Python actor：

bash
# 运行简单Python脚本（无额外依赖）
docker run --rm \
  -v $(pwd)/src:/actor \  # 挂载本地脚本目录到容器内/actor
  -e APIFY_TOKEN=your_apify_token \  # Apify平台访问令牌
  -e INPUT='{"url": "https://example.com"}' \  # Actor输入数据（JSON格式）
  apify/python-actor \
  python /actor/main.py

自定义依赖安装

如需添加Python依赖，创建Dockerfile扩展基础镜像：

dockerfile
FROM apify/python-actor

# 安装额外依赖
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 复制actor代码
COPY src /actor

# 设置工作目录
WORKDIR /actor

# 启动命令（默认已设置为python main.py，可覆盖）
CMD ["python", "main.py"]

环境变量配置

Apify SDK集成示例

使用apify-sdk编写基础actor（src/main.py）：

python
from apify import Actor

async def main():
    async with Actor:
        # 获取输入数据
        input_data = await Actor.get_input() or {}
        url = input_data.get('url', 'https://example.com')
        
        # 执行任务（示例：打印URL）
        Actor.log.info(f"Processing URL: {url}")
        
        # 保存输出结果
        await Actor.set_output({'status': 'completed', 'processed_url': url})

if __name__ == "__main__":
    Actor.main(main)

注意事项

• 如需使用非纯Python库（如依赖系统库的包），需在自定义Dockerfile中安装系统依赖（如apk add for Alpine）
• 镜像默认不包含Chrome等浏览器环境，如需网页渲染需额外配置
• 通过apify push部署时，确保项目根目录包含actor.json配置文件

版本信息

• Python版本：3.9+
• 基础镜像：Alpine Linux（或类似轻量级发行版）
• Apify SDK兼容性：apify-sdk>=1.0.0