n8n 中文文档

执行数据

根据您的执行设置和数量,您的 n8n 数据库可能会增长并耗尽存储空间。

为了避免这种情况,n8n 建议您不要保存不必要的数据,并启用旧执行数据的清理。

为此,请配置相应的环境变量。

减少保存数据

提示

Configuration at workflow level 工作流程级别的配置

您还可以使用工作流程设置 在单个工作流程的基础上配置这些设置。

您可以选择 n8n 保存哪些执行数据。例如,您可以仅保存生成 Error 的执行。

# npm <a href="#npm" id="npm"></a>
# Save executions ending in errors <a href="#save-executions-ending-in-errors" id="save-executions-ending-in-errors"></a>
export EXECUTIONS_DATA_SAVE_ON_ERROR=all

# Don't save successful executions <a href="#dont-save-successful-executions" id="dont-save-successful-executions"></a>
export EXECUTIONS_DATA_SAVE_ON_SUCCESS=none

# Don't save node progress for each execution <a href="#dont-save-node-progress-for-each-execution" id="dont-save-node-progress-for-each-execution"></a>
export EXECUTIONS_DATA_SAVE_ON_PROGRESS=false

# Don't save manually launched executions <a href="#dont-save-manually-launched-executions" id="dont-save-manually-launched-executions"></a>
export EXECUTIONS_DATA_SAVE_MANUAL_EXECUTIONS=false

# Docker <a href="#docker" id="docker"></a>
docker run -it --rm \
 --name n8n \
 -p 5678:5678 \
 -e EXECUTIONS_DATA_SAVE_ON_ERROR=all \
 -e EXECUTIONS_DATA_SAVE_ON_SUCCESS=none \
 -e EXECUTIONS_DATA_SAVE_ON_PROGRESS=true \
 -e EXECUTIONS_DATA_SAVE_MANUAL_EXECUTIONS=false \
 n8nio/n8n
# Docker Compose <a href="#docker-compose" id="docker-compose"></a>
n8n:
    environment:
      - EXECUTIONS_DATA_SAVE_ON_ERROR=all
      - EXECUTIONS_DATA_SAVE_ON_SUCCESS=none
      - EXECUTIONS_DATA_SAVE_ON_PROGRESS=true
      - EXECUTIONS_DATA_SAVE_MANUAL_EXECUTIONS=false

启用执行剪枝

执行清理会按定期计划删除已完成的执行及其执行数据和二进制数据。n8n 默认启用清理。出于性能原因,清理首先标记要删除的目标,然后稍后永久删除它们。

当发生以下任一条件时,n8n 会清理执行:

  • 年龄: 执行在 EXECUTIONS_DATA_MAX_AGE 小时之前完成(默认值: 336 小时 -> 14 天)。
  • 数量: 执行总数超过 EXECUTIONS_DATA_PRUNE_MAX_COUNT(默认值: 10,000)。发生这种情况时,n8n 从最旧到最新删除执行。

请记住:

  • 状态为 new、running 或 waiting 的执行不符合清理条件。
  • 带注释的执行(例如,带有标签或评分的执行)永远不会被清理。
  • 清理遵守 EXECUTIONS_DATA_HARD_DELETE_BUFFER 小时的安全缓冲期(默认值: 1 小时),以确保在用户构建或调试工作流时最近的数据仍然可用。
# Enable executions pruning <a href="#enable-executions-pruning" id="enable-executions-pruning"></a>
export EXECUTIONS_DATA_PRUNE=true

# How old (hours) a finished execution must be to qualify for soft-deletion <a href="#how-old-hours-a-finished-execution-must-be-to-qualify-for-soft-deletion" id="how-old-hours-a-finished-execution-must-be-to-qualify-for-soft-deletion"></a>
export EXECUTIONS_DATA_MAX_AGE=168

# Max number of finished executions to keep. May not strictly prune back down to the exact max count. Set to `0` for unlimited. <a href="#max-number-of-finished-executions-to-keep-may-not-strictly-prune-back-down-to-the-exact-max-count-set-to-0-for-unlimited" id="max-number-of-finished-executions-to-keep-may-not-strictly-prune-back-down-to-the-exact-max-count-set-to-0-for-unlimited"></a>
export EXECUTIONS_DATA_PRUNE_MAX_COUNT=50000
# Docker <a href="#docker" id="docker"></a>
docker run -it --rm \
 --name n8n \
 -p 5678:5678 \
 -e EXECUTIONS_DATA_PRUNE=true \
 -e EXECUTIONS_DATA_MAX_AGE=168 \
 n8nio/n8n
# Docker Compose <a href="#docker-compose" id="docker-compose"></a>
n8n:
    environment:
      - EXECUTIONS_DATA_PRUNE=true
      - EXECUTIONS_DATA_MAX_AGE=168
      - EXECUTIONS_DATA_PRUNE_MAX_COUNT=50000

提示

SQLite

如果使用默认的 SQLite 数据库运行 n8n,已清理数据占用的磁盘空间不会自动释放,而是留给将来的执行数据重复使用。要释放这部分空间,请配置 DB_SQLITE_VACUUM_ON_STARTUP 环境变量,或手动运行 VACUUM 操作。

提示

Binary data pruning 二进制数据修剪

二进制数据修剪在活动二进制数据模式下进行。例如,如果您的实例将数据存储在 S3 中,并且您后来切换到文件系统模式,则 n8n 仅修剪文件系统中的二进制数据。这将来可能会改变。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。