私有基础设施 / 无需身份证明阅读隐私原则
KoalaVPS 现场笔记

能经受下一次重启的工作流。

自托管的自动化编辑器可以连接高权限账户。请将其数据库和加密密钥视为关键基础设施。

保护编辑器

将编辑器置于 HTTPS 和支持的认证之后。限制管理访问,并在不必要时避免公开注册。Webhook 路由需要各自决定暴露方式和认证方式。

保留凭据密钥

以适当保护备份已配置的加密密钥。在没有正确密钥的情况下恢复数据库可能导致已保存的凭据无法使用。将密钥排除在截图、代码仓库和未过滤日志之外。

审慎扩展执行路径

对于繁忙的设置,审查受支持的数据库、队列和工作进程模型。Redis 和独立工作进程会增加各自的访问和持久化要求。限制并发作业,以免激增耗尽 VPS 或外部 API 预算。

仅保留有用的执行数据

工作流可以处理令牌、个人记录和文档。设置执行历史清理、遮蔽敏感值并谨慎定义重试。重复的 webhook 不得导致意外的第二次付款或消息。

将加密密钥视为数据库的一部分

已保存的凭据依赖 n8n 的加密密钥。请保留包含自动生成密钥的状态目录,或从私有密钥存储中设置 N8N_ENCRYPTION_KEY。所有队列 worker 都需要与主进程相同的密钥。用一次性凭据测试恢复;仅恢复数据库可能看似健康,但其凭据仍无法读取。

  • 将密钥保存在公共目录和代码仓库之外
  • 持续备份数据库
  • 为预期的生产部署使用受支持的 PostgreSQL

为 webhook 提供其公开地址

Caddy 等反向代理可以终止 HTTPS,而 n8n 在内部监听。当前文档使用 N8N_WEBHOOK_URL 表示外部 webhook 源,并替换了版本 2.35.0 中较旧的 WEBHOOK_URL 名称。将受信任的代理跳数设置为真实路径;单个代理使用 N8N_PROXY_HOPS=1。保留转发的 host、协议和客户端信息。从服务器外部测试 webhook,并验证其生产 URL。

  • 审慎设置工作流时区
  • 清理包含敏感输入的执行历史
  • 仅在具备所需私有访问控制时使用队列工作进程和 Redis
# Example: one HTTPS reverse proxy
N8N_WEBHOOK_URL=https://automations.example.com/
N8N_PROXY_HOPS=1

定义工作负载和允许的集成

列出触发器、外部账户、预期执行量以及每个工作流可产生的最大支出或副作用。检查 n8n 许可证以确认实际用途,尤其是将其作为服务提供给他人时。小型计划工作流和公共 webhook 处理器有不同的资源需求。从受支持的版本、私有持久状态、TLS 名称和适合部署的数据库开始;避免通过编辑器暴露数据库端口。

  • 为每个集成使用单独的受限凭据。
  • 设置预期的工作流时区和执行历史保留期限。
  • 保持导出的工作流不包含嵌入的真实密钥。

为已安装版本设置公共 webhook 源

Caddy 等反向代理在内部访问 n8n,而外部服务调用其 HTTPS webhook 源。使用已安装版本文档中记录的 webhook URL 变量;当前文档命名为 N8N_WEBHOOK_URL,而较旧版本使用 WEBHOOK_URL。设置真实的代理跳数,而不是信任任意转发头。将编辑器访问策略与 webhook 身份验证分开,并验证生产回调不包含内部主机或端口。

# Example values for a supported current release, behind one proxy:
N8N_WEBHOOK_URL=https://automations.example.com/
N8N_PROXY_HOPS=1

在授予写入权限前测试无害工作流

从只读请求或一次性测试记录开始。在 VPS 之外测试生产 webhook、认证拒绝和一次有意重试。重复请求不得意外产生第二个有后果的操作。检查执行日志是否泄露输入,然后应用保留策略。如果 webhook 仅在编辑器的测试模式下有效,请检查工作流是否已发布/激活,以及生产和测试路由是否到达正确的进程。

  • 使用一次性集成凭据测试恢复。
  • 保留 N8N_ENCRYPTION_KEY 或生成的密钥状态的独立加密副本。
  • 不要将示例密码或 API 令牌发送到保留的调试输出中。

仅在观察到执行瓶颈后再扩展

队列模式会增加 Redis、工作进程和共享数据库;主进程接收触发器,而工作进程执行任务。每个工作进程必须使用相同的凭据加密密钥。在将包含文件的工作流迁移到队列模式之前,遵循当前的二进制数据存储要求。限制并发和上游 API 预算,并监控队列年龄和失败情况。将数据库、状态和密钥一起备份;重启容器不是针对无法读取的已保存凭据的恢复方案。

配置您的基础设施

掌控一切。
按你的条件部署。

无需身份文件。完整管理员权限。原生加密货币计费。