naskio/n8n-python

n8n Docker镜像（含Python 3.10及PythonFunction自定义节点）

!https://raw.githubusercontent.com/n8n-io/n8n/master/assets/n8n-logo.png

镜像概述和主要用途

本镜像基于n8n工作流自动化平台构建，默认集成Python 3.10环境及PythonFunction自定义节点。主要用途是在n8n工作流中直接运行Python代码片段或脚本，扩展n8n的数据处理能力，支持依赖Python生态的自动化任务。

核心功能和特性

• 内置Python 3.10环境：无需额外配置即可运行Python代码及脚本
• 预安装PythonFunction自定义节点：可直接在工作流中使用，功能类似n8n原生Function节点，但支持Python语法
• 支持多方式运行Python代码：通过PythonFunction节点执行代码片段或通过Execute Command节点运行挂载的脚本文件
• 外部依赖管理：支持通过Execute Command节点安装Python包或从requirements.txt文件导入依赖

使用场景和适用范围

• 工作流中的Python数据处理：在自动化流程中嵌入Python代码进行数据转换、分析或计算
• 依赖外部Python库的任务：需调用Python第三方库（如pandas、requests）的自动化场景
• 现有Python脚本集成：将本地Python脚本挂载到容器，通过n8n触发执行
• Python生态工具联动：结合n8n的触发器和动作节点，实现Python脚本的定时/事件驱动执行

详细使用方法和配置说明

Docker部署方案

1. 使用docker run命令部署

bash
docker run -d \
  --name n8n-python \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  -v ./python-scripts:/python-scripts \  # 挂载本地Python脚本目录
  naskio/n8n-python:latest

2. 使用docker-compose部署

创建docker-compose.yml文件：

yaml
version: '3'

services:
  n8n-python:
    image: naskio/n8n-python:latest
    container_name: n8n-python
    ports:
      - "5678:5678"
    volumes:
      - ~/.n8n:/home/node/.n8n  # n8n数据持久化
      - ./python-scripts:/python-scripts  # 挂载Python脚本目录
      - ./requirements.txt:/requirements.txt  # 可选：挂载依赖文件
    restart: unless-stopped
    environment:
      - N8N_HOST=localhost
      - N8N_PORT=5678
      - N8N_PROTOCOL=http
      # 可选：启用基本认证
      # - N8N_BASIC_AUTH_USER=admin
      # - N8N_BASIC_AUTH_PASSWORD=your_password

启动容器：

bash
docker-compose up -d

使用Python Function节点运行代码

基本用法

1. 在n8n工作流编辑器中添加Python Function节点（位于"自定义节点"分类下）
2. 在节点配置中编写Python代码，通过items变量访问输入数据（与原生Function节点用法类似）
3. 代码返回结果将作为节点输出，传递至下一个节点

示例代码

python
# 处理输入items，将每个item的"value"字段乘以2
result = []
for item in items:
    new_value = item["json"].get("value", 0) * 2
    result.append({"json": {"value": new_value}})
return result

使用Execute Command节点运行挂载脚本

前提条件

将本地Python脚本文件（如script.py）挂载到容器内目录（如/python-scripts，对应宿主机./python-scripts）

操作步骤

1. 添加Execute Command节点
2. 配置命令为：python /python-scripts/script.py
3. （可选）在"输入"选项卡中配置脚本所需的环境变量或参数
4. 运行节点，脚本输出将作为节点结果返回

安装外部Python包

单包安装

通过Execute Command节点直接运行pip命令：

bash
pip install pandas  # 安装pandas库

从requirements.txt安装

1. 将本地requirements.txt挂载到容器（如/requirements.txt）
2. 通过Execute Command节点运行：

bash
pip install -r /requirements.txt

自动安装依赖（容器启动后）

结合n8nTrigger节点实现容器启动后自动安装依赖：

1. 添加n8nTrigger节点，触发条件设为"工作流启动"
2. 连接至Execute Command节点，配置命令为依赖安装命令（如pip install -r /requirements.txt）
3. 保存工作流并启用，容器重启后将自动执行依赖安装

环境变量说明

参考链接

• https://hub.docker.com/r/naskio/n8n-python
• https://github.com/naskio/docker-n8n-python
• https://github.com/naskio/n8n-nodes-python
• n8n官方文档
• https://github.com/n8n-io/n8n/tree/master/docker/images/n8n/README.md