N8N + Cherry Studio 本地大模型对接｜全踩坑保姆级指南（Docker 版）
标签：#N8N #CherryStudio #本地大模型 #AI自动化 #避坑指南
摘要：本文完整记录 Docker 部署的 N8N 对接 Cherry Studio 本地中转服务，从网络连通、接口鉴权、节点选型、模型命名等多维度，整理所有报错原因与可直接复制的解决方案，新手可直接照着配置。
环境前置说明
- N8N：Docker Desktop 容器化部署（Windows 环境）
- Cherry Studio：Windows 本地运行，提供 OpenAI 兼容接口，端口固定 23333
核心踩坑点：Docker 网络隔离、鉴权格式错误、接口协议不兼容、模型命名格式、节点类型误用
一、坑 1：无法连接到这些设置｜127.0.0.1 访问失败
报错现象
N8N 界面提示：无法连接到这些设置
本机 CMD 测试接口正常，N8N 容器内完全无法连通 Cherry Studio。
根因
Docker 容器内的 127.0.0.1 指向容器自身，不是你的 Windows 宿主机，天然无法访问本地软件服务。
解决方案
基础 URL 必须使用 Docker 专用地址
❌ 错误：http://127.0.0.1:23333/v1
✅ 正确：http://host.docker.internal:23333/v1
二、坑 2：鉴权失败｜Unauthorized: missing credentials
报错现象
CMD 执行接口返回：{"error":"Unauthorized: missing credentials"}
N8N 认证一直失败，密钥格式踩坑。
根因
Cherry Studio 本地服务开启密钥鉴权，必须携带 Authorization 请求头；N8N 自带密钥输入框，会自动拼接 Bearer，手动填写会造成格式冲突。
最佳解决方案（自定义页眉，100% 兼容）
开启「添加自定义页眉」：
- 标题名称：Authorization
- 标题值：Bearer cs‑sk‑xxxxx（Bearer 后面必须带 1 个空格）
- 允许的 HTTP 请求域：All
本机验证命令（确认鉴权正常）
curl http://localhost:23333/v1/models -H "Authorization: Bearer cs‑sk‑xxxxx"
返回模型列表 = 鉴权完全正常。
三、坑 3：404 无法 POST /v1/responses
报错现象
404 <!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><title>错误</title></head><body><pre>无法 POST /v1/responses</pre></body></html>
根因
误用了 Anthropic（Claude）专用节点。Cherry Studio 仅兼容标准 OpenAI 接口 /v1/chat/completions，不支持 Claude 专属的 /v1/responses 接口。
解决方案
- 删除当前报错的 Anthropic/Responses 节点；
- 新建节点：OpenAI → 聊天消息（Chat Message）；
- 后续所有调用，只使用 OpenAI 聊天节点。
四、坑 4：MODEL_NOT_FOUND｜模型不被允许
报错现象
提示：模型 xxxxx 不被允许
LangChain 报错：MODEL_NOT_FOUND
根因
N8N 填写的模型名，和 Cherry Studio 内加载的模型名不一致。
五、全局避坑总结（必看）
- Docker 访问 Windows 本地服务，禁止使用
127.0.0.1，必须用host.docker.internal； - Cherry Studio 仅兼容 OpenAI 标准接口，只能用 OpenAI 聊天节点；
- 鉴权优先使用「自定义页眉」，规避 N8N 自动拼接 Bearer 的格式问题；
- 模型名称严格匹配
- 配置异常时，重启 Cherry Studio 本地服务器 + 重启 N8N 容器，清除缓存。
汇聚全球AI编程工具，助力开发者即刻编程。
更多推荐
5
0- 0
已为社区贡献1条内容
所有评论(0)