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 按此顺序检查每个目的地并在第一个匹配处停止:
- Allowed hostname 允许的主机名:如果请求主机名与
N8N_SSRF_ALLOWED_HOSTNAMES匹配,则 n8n 允许该请求。 - Blocked hostname 被阻止的主机名:如果请求主机名与
N8N_SSRF_BLOCKED_HOSTNAMES匹配,则 n8n 阻止该请求。此检查在 DNS 解析之前运行,因此 n8n 会拒绝该名称而不进行查找,即使它会解析为公共 IP。 - Allowed IP range 允许的IP范围:如果解析的IP与
N8N_SSRF_ALLOWED_IP_RANGES匹配,则n8n允许该请求。 - Blocked IP range 被封锁的IP范围:如果解析的IP与
N8N_SSRF_BLOCKED_IP_RANGES匹配,则n8n阻止该请求。 - 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 在生产中启用之前查看允许列表
保护默认处于关闭状态,因此不会破坏调用内部服务的现有自托管设置。在打开之前,请列出您的工作流程所需的内部主机并将其添加到允许列表中。优先选择狭窄的允许条目(例如单个主机或主机名)而不是关闭保护。