这是一份针对在飞牛 NAS（Docker Compose）环境下，使用 n8n 2.x 通过 OpenRouter 调用 Gemini 大模型的详细实战教程：

第一阶段：获取 OpenRouter 凭证

1. 注册与密钥生成：访问 OpenRouter 官网，生成一个 API Key。
2. 查找免费模型：在 OpenRouter 模型库中搜索带有 :free 标签的 Gemini 模型（例如 google/gemini-pro-1.5-exp:free），这可以让你在不充值的情况下进行测试。

第二阶段：在 n8n 2.x 配置凭证 (Credentials)

1. 进入 n8n 控制面板，点击左侧 Credentials > Add Credential。
2. 搜索并选择 OpenRouter API。
3. 填入你的 API Key 并保存。

第三阶段：构建 AI 工作流

n8n 2.x 采用了积木式的 AI 架构，模型作为子节点（Sub-node）连接。

1. 添加触发器：在画布添加 Manual Trigger（手动触发）。
2. 添加主节点：搜索并添加 AI Agent 或 Basic LLM Chain 节点。
3. 连接模型插件：
   • 点击主节点的 "Model" 连接点。
   • 搜索并添加 OpenRouter Chat Model 节点。
   • 在插件节点中选择你刚才创建的 OpenRouter 凭证。
   • 在 Model 字段中输入 Gemini 的模型 ID。

第四阶段：国内网络环境适配（关键）

由于你在国内飞牛 NAS 环境下，n8n 容器可能无法直接连接 OpenRouter 的 API 端点 (https://openrouter.ai/api/v1)。

• 配置 Docker 代理：修改你的 docker-compose.yml 文件，在 n8n 服务的 environment 下添加代理：

  environment:
    - HTTP_PROXY=http://你的代理IP:端口
    - HTTPS_PROXY=http://你的代理IP:端口
  

• 重启服务：运行 docker compose up -d 使配置生效。

第五阶段：测试与故障排除

• 执行测试：点击 Test Step，如果成功，你将收到 Gemini 的回复。
• 常见报错：
  • Bad Decrypt：如果迁移后出现凭证解密错误，需检查环境变量中的加密密钥（Encryption Key）配置。
  • Schema 错误：在 n8n 2.0.x 版本中使用 Gemini + Tools 时，可能会遇到输入模式不匹配的随机错误。

下一步建议： 你想尝试为你的 Gemini 节点添加一些工具（Tools）（如搜索或计算器），让它能处理更复杂的任务吗？或者我们需要先确认一下你的代理配置是否已生效？