安全环境变量
提示
File-based configuration 基于文件的配置
您可以将 _FILE 添加到各个变量,以在单独的文件中提供其配置。有关更多详细信息,请参阅将敏感数据保存在单独的文件中。
| 变量 | 类型 | 默认值 | 描述 |
|---|---|---|---|
N8N_BLOCK_ENV_ACCESS_IN_NODE |
布尔 | false |
是否允许用户访问表达式和代码节点中的环境变量(false)或不允许(true)。 |
N8N_BLOCK_FILE_ACCESS_TO_N8N_FILES |
布尔 | true |
设置为 true 可阻止访问 .n8n 目录中的所有文件和用户定义的配置文件。 |
N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS |
布尔 | false |
设置为 true 以尝试为设置文件设置 0600 权限,仅授予所有者读写访问权限。 |
N8N_RESTRICT_FILE_ACCESS_TO |
字符串 | 限制对这些目录中文件的访问。以分号分隔的列表形式提供多个文件(“;”)。 |
|
N8N_SECURITY_AUDIT_DAYS_ABANDONED_WORKFLOW |
数量 | 90 | 90如果工作流未执行,则考虑放弃该工作流的天数。 |
N8N_CONTENT_SECURITY_POLICY |
字符串 | script-src <nonce> 'strict-dynamic' 'unsafe-eval'; object-src 'none'; base-uri 'none' |
n8n 在自身页面上提供的 Content-Security-Policy。接受策略字符串(例如 frame-ancestors http://localhost:3000)或 helmet.js 指令对象。使用 <nonce> 标记 n8n 插入每次请求的 nonce 的位置。设为 default 使用 n8n 的策略,设为 {} 则不发送此标头。 |
N8N_CONTENT_SECURITY_POLICY_REPORT_ONLY |
字符串 | n8n 以 Content-Security-Policy-Report-Only 提供的策略,格式与 N8N_CONTENT_SECURITY_POLICY 相同。浏览器会报告违规但不会阻止,可在强制执行之前用它试用策略。 |
|
N8N_SECURE_COOKIE |
布尔 | true |
确保 cookie 仅通过 HTTPS 发送,从而增强安全性。 |
N8N_SAMESITE_COOKIE |
枚举字符串:strict、lax、none |
lax |
控制跨站 cookie 行为(了解更多):
|
N8N_INSECURE_DISABLE_FORM_HTML_SANDBOX |
布尔 | false |
是否从表单页面的内容安全策略(CSP)中移除 sandbox 指令。仅适用于与编辑器使用不同主机名的表单。从 n8n 2.15.0 起可用。完整详情和安全条件请参阅使用反向代理配置 webhook URL。 |
N8N_GIT_NODE_DISABLE_BARE_REPOS |
布尔 | false |
设置为 true 可防止 Git 节点 使用裸存储库,从而增强安全性。 |
N8N_GIT_NODE_ENABLE_HOOKS |
布尔 | false |
设置为 true 以允许 Git 节点 执行 Git 挂钩。 |
N8N_POSTMESSAGE_ALLOWED_ORIGINS |
字符串 | 当 editor 嵌入到其他页面时,允许与 editor 交换 postMessage commands 的 origins。仅在可能嵌入 editor 的情况下相关,例如使用 N8N_PREVIEW_MODE=true 运行时。多个 origins 使用逗号分隔,例如 https://n8n.io,https://app.example.com。为空(默认)时,editor 接受来自任意 origin 的 messages。 |
使用环境变量 的安全策略
将 N8N_SECURITY_POLICY_MANAGED_BY_ENV 设置为 true 以从环境变量管理安全策略。请参阅使用环境变量管理实例设置 了解激活模式的工作原理。
| 变量 | 类型 | 默认 | 描述 |
|---|---|---|---|
N8N_SECURITY_POLICY_MANAGED_BY_ENV |
Boolean | false |
设为 true 后,可通过环境变量管理安全策略。启用后,n8n 会在每次启动时应用安全策略相关变量,并锁定对应的 UI 控件。 |
N8N_MFA_ENFORCED_ENABLED |
Boolean | false |
是否对所有用户强制启用双因素认证:true 为强制,false 为不强制。 |
N8N_PERSONAL_SPACE_PUBLISHING_ENABLED |
Boolean | true |
用户是否可以从其个人空间发布工作流:true 为允许,false 为不允许。 |
N8N_PERSONAL_SPACE_SHARING_ENABLED |
Boolean | true |
用户是否可以从其个人空间共享资源:true 为允许,false 为不允许。 |
相关资源
不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。