AIRI 接入 Ollama 本地模型：聊天配置、Base URL 与 CORS 排障实战

人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手【免费下载链接】airi 自托管、归你拥有的 Grok 风格 AI 伴侣与 waifu / 赛博生命灵魂容器目标是接近 Neuro-sama 的高度支持实时语音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。项目地址https://gitcode.com/moeru-ai/airi点击查看免费下载Ollama 是开源的本地大模型运行时它把语言模型直接跑在你自己的设备上通过本地 API 提供推理服务默认不需要 API Key。本文以 AIRI 的「意识Consciousness聊天模块」为核心场景完整讲解如何安装 Ollama、下载并运行模型、在 AIRI 设置中接入本地服务、用自动校验与 Ping API 确认连通以及如何处理跨设备访问与 CORS 报错。读完本文你将掌握一条完全不依赖云端 API 的 AIRI 聊天链路并理解其背后从设置界面到 provider 校验的完整实现原理。为什么选择 Ollama对 AIRI 用户来说Ollama 的价值集中在三点本机运行模型模型权重、推理过程全部发生在本机对话数据不需要上传到任何云端服务减少云端 API 依赖无需申请、管理 API Key也不用担心配额和计费重视本地数据处理如果你的场景对对话隐私或本地化处理有明确要求Ollama 是合适的聊天提供者。从仓库实现看Ollama 在 AIRI 中被定义为一个完整的聊天 providertasks: [chat]与 OpenRouter、DeepSeek、OpenAI Compatible 等并列出现在「设置 → 服务商 → 聊天」列表中具体见 provider 注册实现 与 Ollama provider 定义。第一步安装 Ollama访问 Ollama 官方网站下载并安装适合自己操作系统的版本Windows、macOS、Linux 均有对应安装包在终端Terminal或 PowerShell 中执行以下命令确认安装成功ollama --version看到版本号输出即说明运行环境就绪。若该命令无法识别请检查安装路径是否已加入系统 PATH。第二步下载并运行模型执行以下命令Ollama 会自动下载并启动一个模型ollama run qwen2如需使用其他模型把qwen2替换为对应的模型 ID 即可首次下载时间取决于模型大小和网络环境模型越大、网络越慢等待越久下载完成后模型会常驻本地后续启动无需重新下载。下载成功后Ollama 默认会在11434端口提供两种 API原生 APIhttp://localhost:11434/和 OpenAI 兼容 APIhttp://localhost:11434/v1/。AIRI 使用的是后者。第三步在 AIRI 中配置 Ollama打开设置 → 服务商 → 聊天 → Ollama保留默认 Base URLhttp://localhost:11434/v1/。如果 Ollama 运行在其他设备上请填写从 AIRI 所在设备可以访问到的地址例如局域网 IP 形式http://192.168.x.x:11434/v1/在设置 → 模块 → 意识中选择 Ollama 与刚才下载的模型。配置项详解结合源码Ollama 在 AIRI 中实际可配置的字段由 provider 配置 schema 定义共三项配置项类型默认值说明baseUrlstringhttp://localhost:11434/v1/Ollama OpenAI 兼容 API 的地址必须是绝对 URLthinkingModeenumauto思考模式可选auto/disable/enable/low/medium/highheadersrecord无附加请求头键值对形式按需配置其中thinkingMode和headers属于高级设置。思考模式会被映射为 OpenAI 兼容协议下的reasoningEffortdisable映射为none、enable映射为medium、low/medium/high原样透传、auto则不附加该参数见 resolveOllamaReasoningEffort 实现。如果请求级别明确指定了 reasoning 开关则enabled → medium、disabled → none见 createProvider 实现。对应设置页面 ollama.vue 提供了 Base URL 输入框、思考模式下拉框和请求头键值对编辑器所有字段一旦修改会立即持久化并自动触发一次重新校验watch([baseUrl, thinkingMode, headers], refetch)页面挂载时会用已保存的配置或默认值初始化表单。第四步验证配置AIRI 会在编辑配置的过程中自动校验无需手动保存后再检查字段级校验validateConfig检查 Base URL 是否为空、是否为合法且带 host 的绝对 URL见 ollama provider 校验器连通性校验Connectivity对{baseUrl}/models发起 GET 请求10 秒超时模型列表校验ModelList拉取 Ollama 返回的模型列表确认服务可用聊天补全校验ChatCompletions向模型发送一条ping探测消息max_tokens: 16验证真实推理链路。以上校验通过 OpenAI 兼容校验器统一调度默认每 15 秒按间隔模式复查一次见 openai-compatible 校验器。Ping API如果校验页面出现Ping API按钮说明该 provider 提供真实请求测试能力点击即可发起一次实际推理请求来确认端到端连通选择模型 →校验通过后点击此按钮会直接跳转到设置 → 模块 → 意识对应代码中的路由/settings/modules/consciousness选择你已下载的模型并完成激活。注意保存 provider 凭据并不会自动激活该 provider必须回到「意识」模块同时选定 provider 和模型AIRI 才会真正使用它生成回复。这是聊天模型配置的通用规则详见 聊天模型设置指南。配置完成后回到聊天界面发送一条类似 Hello 的短消息。如果收到回复说明 Ollama 已作为 AIRI 的大脑正常工作。问题排查AIRI 无法连接本地 Ollama按以下顺序检查Ollama 是否在运行在终端执行ollama list确认服务进程存在端口是否匹配确认 Base URL 使用了正确的端口默认11434且带/v1/路径与 默认配置 保持一致跨设备访问如果 AIRI 与 Ollama 不在同一台设备请使用从 AIRI 设备可访问的局域网地址并只在可信网络中开放该服务不要直接把服务暴露到公网。遇到 CORS 报错如果 Ollama 明明在运行AIRI 却报告 CORS跨域资源共享错误这是浏览器/桌面环境向本地服务发起跨域请求被拒绝的典型表现。AIRI 的 provider 实现会在连通性检查失败时给出明确提示需要为 Ollama 设置OLLAMA_ORIGINS环境变量把 AIRI 的精确 origin 加进去然后重启 Ollama见 ollama provider 的失败原因文案。推荐写法示例按你的启动方式选择其一# macOS / Linux OLLAMA_ORIGINShttp://localhost:5173 ollama serve # Windows PowerShell按官方文档设置环境变量后重启 Ollama 服务 $env:OLLAMA_ORIGINShttp://localhost:5173注意不要为了省事使用通配符如*来绕过 CORS 限制也不要将 Ollama 暴露到公共互联网——这些都是排障捷径但会带来严重的安全风险。只用 AIRI 需要的精确 origin。校验通过但意识模块里没有模型如果 provider 校验通过、但「意识」模块的模型列表为空通常是 Ollama 尚未下载任何模型ollama run model未执行过或模型列表接口返回异常。回到终端先完成模型下载再刷新设置页必要时可在「意识」模块手动输入与 Ollama 官方一致的模型 ID。从源码看 AIRI 的 Ollama 集成架构AIRI 对 Ollama 的支持落在proj-airi/provider-inference包的本地 provider 分组中核心结构清晰providerOllama 定义负责配置 schema、思考模式映射、请求构造与校验器装配provider 注册表providerOllama与其他 40 个云/本地 provider 一起被注册为可移植定义运行时再按需加载Ollama 设置页面落地 Base URL、思考模式、请求头与校验状态展示的 UIOpenAI 兼容校验器为 Ollama 复用了连通性、模型列表、聊天补全三类检查这也是它无需 API Key 即可完成全链路验证的原因。这套架构意味着只要 Ollama 服务可达、模型已下载AIRI 的聊天模块就能以完全本地化的方式工作适合注重数据本地处理或希望脱离云端依赖的用户作为首选聊天提供者。赞分享人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手【免费下载链接】airi 自托管、归你拥有的 Grok 风格 AI 伴侣与 waifu / 赛博生命灵魂容器目标是接近 Neuro-sama 的高度支持实时语音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。项目地址https://gitcode.com/moeru-ai/airi点击查看免费下载相关推荐AIRI 接入 Ollama 本地模型从安装、配置到排障的完整实战指南AIRI 接入 Ollama 本地模型从安装、配置到排障的完整实战指南 导读 本文讲解如何在自托管 AI 伴侣项目 AIRI 中接入 Ollama 本地模型服人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手后端AIRI 接入本地 Ollama从零配置自托管聊天模型完整指南AIRI 接入本地 Ollama从零配置自托管聊天模型完整指南 Ollama 是运行在本地设备上的开源大模型运行时它让 AIRI 可以在完全离线、无需 AP人工智能AI 应用大模型AI Agent交互助手语音数字人后端前端桌面应用移动开发GUI 自动化MCP 服务AIRI 接入 Groq在“意识”中启用高速聊天模型API Key、Base URL、Ping API 与排障AIRI 接入 Groq在“意识”中启用高速聊天模型API Key、Base URL、Ping API 与排障 Groq 是 AIRI 内置的一类 Ope人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手后端上一篇ChanlunX缠论插件5分钟快速上手的通达信自动画线工具终极指南 下一篇BFS Best Face Swap跨基座模型的人脸、头部与全身替换 LoRA 实战指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考