n8n 中文文档

SSRF保护环境变量

提示

File-based configuration 基于文件的配置

您可以将 _FILE 添加到各个变量,以在单独的文件中提供其配置。有关更多详细信息,请参阅将敏感数据保存在单独的文件中。

服务器端请求伪造 (SSRF) 是一种攻击,它会诱骗服务器向攻击者选择的地址发出 HTTP 请求,例如 localhost 等内部目标、专用网络范围或云提供商的元数据端点 (169.254.169.254)。由于工作流可以根据用户控制的输入构建请求 URL,因此 n8n 可以保护目的地来自该输入的出站请求。

SSRF 保护默认关闭。此页面列出了打开和调整它的变量。

保护范围

变量 类型 默认 描述
N8N_SSRF_PROTECTION_ENABLED 布尔 false 为用户可控目标的请求打开 SSRF 保护。
N8N_SSRF_BLOCKED_IP_RANGES 字符串 default 要阻止的以逗号分隔的 CIDR 范围。关键字 default(不区分大小写)扩展为 n8n 的内置集。附加您自己的范围:default,100.64.0.0/10。
N8N_SSRF_ALLOWED_IP_RANGES 字符串 - 允许的以逗号分隔的 CIDR 范围。优先于阻止列表,因此使用它来访问已知的内部主机。
N8N_SSRF_ALLOWED_HOSTNAMES 字符串 - 允许的以逗号分隔的主机名。支持前导 *. 通配符:*.internal.example.com 匹配任何子域,包括嵌套子域,但不匹配裸域。匹配不区分大小写。
N8N_SSRF_BLOCKED_HOSTNAMES 字符串 - 以逗号分隔的主机名按名称拒绝,在 DNS 解析之前检查。使用与 N8N_SSRF_ALLOWED_HOSTNAMES 相同的前导 *. 通配符和不区分大小写的匹配。允许的主机名始终会覆盖被阻止的主机名。
N8N_SSRF_DNS_CACHE_MAX_SIZE 数量 1048576 内部 DNS 解析缓存的最大大小,以字节为单位(默认为 1 MB)。当缓存已满时,n8n 会逐出最近最少使用的条目。

n8n 记录警告并跳过您在 N8N_SSRF_BLOCKED_IP_RANGES 或 N8N_SSRF_ALLOWED_IP_RANGES 中设置的任何无效 CIDR 范围,因此拼写错误不会阻止实例启动。

默认情况下被阻止

当 N8N_SSRF_BLOCKED_IP_RANGES 包含 default 时,n8n 会阻止这些范围:

  • 专用网络(RFC 1918):10.0.0.0/8、172.16.0.0/12、192.168.0.0/16
  • 环回:127.0.0.0/8、::1/128
  • 链接本地,包括云元数据:169.254.0.0/16、fe80::/10
  • IPv6 唯一本地:fc00::/7、fd00::/8
  • 保留或特殊用途:0.0.0.0/8、192.0.0.0/24、192.0.2.0/24、198.18.0.0/15、198.51.100.0/24、203.0.113.0/24

n8n 如何评估请求

n8n 按此顺序检查每个目的地并在第一个匹配处停止:

  1. Allowed hostname 允许的主机名:如果请求主机名与 N8N_SSRF_ALLOWED_HOSTNAMES 匹配,则 n8n 允许该请求。
  2. Blocked hostname 被阻止的主机名:如果请求主机名与 N8N_SSRF_BLOCKED_HOSTNAMES 匹配,则 n8n 阻止该请求。此检查在 DNS 解析之前运行,因此 n8n 会拒绝该名称而不进行查找,即使它会解析为公共 IP。
  3. Allowed IP range 允许的IP范围:如果解析的IP与N8N_SSRF_ALLOWED_IP_RANGES匹配,则n8n允许该请求。
  4. Blocked IP range 被封锁的IP范围:如果解析的IP与N8N_SSRF_BLOCKED_IP_RANGES匹配,则n8n阻止该请求。
  5. Otherwise 否则:n8n 允许该请求。

由于 n8n 首先检查允许列表,因此允许条目始终会覆盖阻止列表。

常见场景

有意达到内部服务。如果工作流必须调用内部主机,请仅允许该目标而不是关闭保护:

N8N_SSRF_PROTECTION_ENABLED=true
N8N_SSRF_ALLOWED_IP_RANGES=10.20.0.5/32

允许内部主机名:

N8N_SSRF_ALLOWED_HOSTNAMES=*.svc.cluster.local

收紧超出默认值。添加特定于您的环境的范围:

N8N_SSRF_BLOCKED_IP_RANGES=default,100.64.0.0/10

按名称拒绝主机名。阻止主机及其所有子域,无论其解析为什么 IP:

N8N_SSRF_BLOCKED_HOSTNAMES=example.com,*.example.com

提示

Hostname blocking is egress governance, not SSRF hardening 主机名阻止是出口治理,而不是 SSRF 强化

N8N_SSRF_BLOCKED_HOSTNAMES 按名称拒绝,因此调用者仍然可以通过 IP 文字、备用主机名或 DNS 重新绑定到达相同的目的地。使用它来阻止已知不需要的目的地,但依靠基于 IP 的阻止列表进行 SSRF 保护。

当 n8n 阻止请求时

被 IP 阻止的请求失败,并显示错误“请求被阻止,因为它解析为受限制的 IP 地址”。被主机名阻止的请求失败,并显示“请求被阻止,因为目标主机名受到限制”。两个描述都命名了目标,并告诉用户要求其 n8n 管理员允许主机名或 IP 范围。如果请求真实,请将预期目标添加到 N8N_SSRF_ALLOWED_IP_RANGES 或 N8N_SSRF_ALLOWED_HOSTNAMES。

警告

Review allow lists before enabling in production 在生产中启用之前查看允许列表

保护默认处于关闭状态,因此不会破坏调用内部服务的现有自托管设置。在打开之前,请列出您的工作流程所需的内部主机并将其添加到允许列表中。优先选择狭窄的允许条目(例如单个主机或主机名)而不是关闭保护。

相关资源

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