n8n 中文文档

安全环境变量

提示

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 行为(了解更多):
  • strict:仅为第一方请求发送。
  • lax(默认):随顶层导航请求发送。
  • none:在所有上下文中发送(需要 HTTPS)。
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 工作流库 找现成的中文工作流。