部署环境变量#
基于文件的配置
您可以在单个变量后添加 _FILE 以在单独的文件中提供其配置。有关更多详细信息，请参阅在单独文件中保存敏感数据。
此页面列出自托管 n8n 实例的部署配置选项，包括设置访问 URL、启用模板、自定义加密以及配置服务器详情。
Proxy variable priorities 代理变量优先级
n8n 用于处理代理环境变量（以 _PROXY 结尾）的 proxy-from-env 包有一定的变量优先级规则。尤其是当同时存在时，小写版本（如 http_proxy）的优先级高于大写版本（如 HTTP_PROXY）。
要了解更多代理环境变量信息，请查看该包详情中的 environment variables 部分。
| 变量 | 类型 | 默认值 | 说明 |
|---|---|---|---|
HTTP_PROXY |
String | - | 用于代理未加密 HTTP 请求的 URL。设置后，n8n 会通过该代理 URL 转发所有来自节点的未加密 HTTP 流量。 |
HTTPS_PROXY |
String | - | 用于代理 TLS/SSL 加密 HTTP 请求的 URL。设置后，n8n 会通过该代理 URL 转发所有来自节点的 TLS/SSL 加密 HTTP 流量。 |
ALL_PROXY |
String | - | 用于代理未加密与加密 HTTP 请求的 URL。当更具体的变量（HTTP_PROXY 或 HTTPS_PROXY）不存在时，n8n 会使用此值。 |
NO_PROXY |
String | - | 应绕过代理的主机名或 URL 列表，使用逗号分隔。当使用 HTTP_PROXY、HTTPS_PROXY 或 ALL_PROXY 时，n8n 会直接连接此处定义的 URL 或主机名，而不是通过代理。 |
N8N_EDITOR_BASE_URL |
String | - | 用户访问编辑器的公共 URL。也用于 n8n 发送的邮件，以及 SAML 身份验证的重定向 URL。 |
N8N_DISABLE_UI |
Boolean | false |
设为 true 可禁用 UI。 |
N8N_PREVIEW_MODE |
Boolean | false |
设为 true 可运行在预览模式。 |
N8N_TEMPLATES_ENABLED |
Boolean | false |
启用 workflow templates 工作流模板（true）或禁用（false）。 |
N8N_TEMPLATES_HOST |
String | https://api.n8n.io |
如果你要创建自己的工作流模板库，请更改此项。注意，要使用你自己的工作流模板库，你的 API 必须提供与 n8n 相同的端点和响应结构。更多信息请参阅 Workflow templates 工作流模板。 |
N8N_ENCRYPTION_KEY |
String | n8n 生成的随机密钥 | 提供用于加密 n8n 数据库中凭据的自定义密钥。默认情况下，n8n 会在首次启动时生成随机密钥。 |
N8N_USER_FOLDER |
String | user-folder |
提供 n8n 创建 .n8n 文件夹的路径。此目录存储用户特定数据，例如数据库文件和加密密钥。 |
N8N_PATH |
String | / |
n8n 部署到的路径。将 N8N_PATH 与反向代理组合可能导致目录导航问题。建议使用子域名（例如 n8n.example.com），或在不使用反向代理时使用 N8N_PATH。 |
N8N_HOST |
String | localhost |
n8n 运行的主机名。 |
N8N_PORT |
Number | 5678 |
n8n 运行的 HTTP 端口。 |
N8N_LISTEN_ADDRESS |
String | :: |
n8n 应监听的 IP 地址。 |
N8N_PROTOCOL |
Enum string: http, https |
http |
访问 n8n 使用的协议。 |
N8N_SSL_KEY |
String | - | HTTPS 协议使用的 SSL key。 |
N8N_SSL_CERT |
String | - | HTTPS 协议使用的 SSL 证书。 |
N8N_PERSONALIZATION_ENABLED |
Boolean | true |
是否询问用户个性化问题并据此定制 n8n。 |
N8N_VERSION_NOTIFICATIONS_ENABLED |
Boolean | true |
启用后，n8n 会发送新版本和安全更新的通知。 |
N8N_VERSION_NOTIFICATIONS_ENDPOINT |
String | https://api.n8n.io/versions/ |
用于获取版本信息的端点。 |
N8N_VERSION_NOTIFICATIONS_INFO_URL |
String | https://docs.n8n.io/getting-started/installation/updating.html |
New Versions 面板中显示的更多信息 URL。 |
N8N_DIAGNOSTICS_ENABLED |
Boolean | true |
是否与 n8n 共享选定的匿名 telemetry 遥测。注意：如果将其设置为 false，你将无法在 Code 节点中启用 Ask AI。 |
N8N_DIAGNOSTICS_CONFIG_FRONTEND |
String | 1zPn9bgWPzlQc0p8Gj1uiK6DOTn;https://telemetry.n8n.io |
前端遥测配置。 |
N8N_DIAGNOSTICS_CONFIG_BACKEND |
String | 1zPn7YoGC3ZXE9zLeTKLuQCB4F6;https://telemetry.n8n.io/v1/batch |
后端遥测配置。 |
N8N_PUSH_BACKEND |
String | websocket |
选择 n8n 后端是通过 server-sent events（sse）还是 WebSockets（websocket）向 UI 发送变更。 |
VUE_APP_URL_BASE_API |
String | http://localhost:5678/ |
手动构建 n8n-editor-ui 包时使用，用于设置前端访问后端 API 的方式。请参考 配置 Base URL。 |
N8N_HIRING_BANNER_ENABLED |
Boolean | true |
是否在控制台显示 n8n 招聘横幅（true）或不显示（false）。 |
N8N_PUBLIC_API_SWAGGERUI_DISABLED |
Boolean | false |
是否禁用 Swagger UI（API playground）（true）或不禁用（false）。 |
N8N_PUBLIC_API_DISABLED |
Boolean | false |
是否禁用公共 API（true）或不禁用（false）。 |
N8N_PUBLIC_API_ENDPOINT |
String | api |
公共 API 端点路径。 |
N8N_GRACEFUL_SHUTDOWN_TIMEOUT |
Number | 30 |
n8n 进程在退出前等待组件关闭的最长时间（秒）。 |
N8N_DEV_RELOAD |
Boolean | false |
在开发 n8n 源码时，设为 true 可在源代码文件发生变更时自动重载或重启应用。 |
N8N_REINSTALL_MISSING_PACKAGES |
Boolean | false |
设为 true 时，n8n 会自动尝试重新安装缺失的包。 |
N8N_TUNNEL_SUBDOMAIN |
String | - | 指定 n8n tunnel 的子域名。如果未设置，n8n 会生成一个随机子域名。 |
N8N_PROXY_HOPS |
Number | 0 | n8n 运行在其后的反向代理数量。 |