N8N中文教程
集成节点/Community_nodes

故障排除与错误#

错误:缺少软件包#

n8n 会将社区节点直接安装到硬盘上。这些文件必须在启动时可用,n8n 才能加载它们。如果启动时软件包不可用,您将收到缺少软件包的错误警告。

如果使用 Docker 运行 n8n:根据您的 Docker 设置,在重新创建容器或升级 n8n 版本时可能会丢失软件包。您必须选择以下任一方案:

  • 持久化 ~/.n8n/nodes 目录的内容。这是最佳方案。如果您按照 Docker 安装指南操作,设置步骤中已包含对该目录的持久化配置。
  • N8N_REINSTALL_MISSING_PACKAGES 环境变量设置为 true

第二种方案可能会增加启动时间,并可能导致健康检查失败。

在 n8n 云上阻止加载社区节点#

如果您的 n8n 云实例崩溃且无法启动,可以在实例启动时阻止加载已安装的社区节点。请访问 云管理面板 > 管理,将 禁用所有社区节点 切换为 true。此开关仅在您允许安装社区节点时可见。