N8N + Cherry Studio 本地大模型对接｜全踩坑保姆级指南（Docker 版）

标签#N8N #CherryStudio #本地大模型 #AI自动化 #避坑指南摘要本文完整记录 Docker 部署的 N8N 对接 Cherry Studio 本地中转服务从网络连通、接口鉴权、节点选型、模型命名等多维度整理所有报错原因与可直接复制的解决方案新手可直接照着配置。环境前置说明N8NDocker Desktop 容器化部署Windows 环境Cherry StudioWindows 本地运行提供 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‑xxxxxBearer 后面必须带 1 个空格-允许的 HTTP 请求域All本机验证命令确认鉴权正常curlhttp://localhost:23333/v1/models-HAuthorization: Bearer cs‑sk‑xxxxx返回模型列表 鉴权完全正常。三、坑 3404 无法 POST /v1/responses报错现象404 !DOCTYPE htmlhtml langenheadmeta charsetutf-8title错误/title/headbodypre无法 POST /v1/responses/pre/body/html根因误用了 AnthropicClaude专用节点。Cherry Studio 仅兼容标准 OpenAI 接口/v1/chat/completions不支持 Claude 专属的/v1/responses接口。解决方案删除当前报错的Anthropic/Responses节点新建节点OpenAI → 聊天消息Chat Message后续所有调用只使用OpenAI 聊天节点。四、坑 4MODEL_NOT_FOUND模型不被允许报错现象提示模型nvidia/openai/gpt‑oss‑120b不被允许LangChain 报错MODEL_NOT_FOUND根因N8N 填写的模型名和 Cherry Studio 内加载的模型名不一致。五、全局避坑总结必看Docker 访问 Windows 本地服务禁止使用127.0.0.1必须用host.docker.internalCherry Studio 仅兼容 OpenAI 标准接口只能用 OpenAI 聊天节点鉴权优先使用「自定义页眉」规避 N8N 自动拼接 Bearer 的格式问题模型名称严格匹配配置异常时重启 Cherry Studio 本地服务器 重启 N8N 容器清除缓存。