Page Assist项目Ollama连接问题排查指南

Page Assist项目Ollama连接问题排查指南

page-assist Use your locally running AI models to assist you in your web browsing 项目地址: https://gitcode.com/gh_mirrors/pa/page-assist

问题现象分析

在使用Page Assist浏览器扩展与Ollama进行交互时，用户可能会遇到两种典型的连接错误：

1. 直接连接错误：表现为无法建立与Ollama服务的基本连接
2. 403禁止访问错误：在发送消息时出现HTTP 403状态码

这些问题的根源在于浏览器的同源策略(Same-Origin Policy)和CORS(跨域资源共享)机制。由于Page Assist作为浏览器扩展运行在一个与本地Ollama服务不同的源(origin)上，浏览器会默认阻止这种跨域请求。

解决方案详解

方案一：通过Page Assist配置解决

这是推荐的首选解决方案，通过修改Page Assist的配置来绕过CORS限制：

1. 进入设置界面：

   • 点击Page Assist扩展图标
   • 选择"Settings"（设置）选项

2. 配置Ollama设置：

   • 切换到"Ollama Settings"标签页
   • 展开"Advanced Ollama URL Configuration"（高级URL配置）选项

3. 启用自定义源URL：

   • 开启"Enable or Disable Custom Origin URL"开关
   • 在"Custom Origin URL"字段中保持默认值（除非Ollama运行在非标准端口）

4. 保存设置：

   • 点击"Save"按钮应用更改

技术原理：此方案通过修改请求头信息，使浏览器认为请求来自与Ollama服务相同的源，从而绕过CORS限制。Page Assist已针对127.0.0.1和localhost做了特殊处理。

方案二：修改Ollama服务配置

如果方案一未能解决问题，可以尝试在Ollama服务端放宽CORS限制：

Windows系统配置步骤

1. 打开系统环境变量设置
2. 添加新的系统变量：
   • 变量名：OLLAMA_ORIGIN
   • 变量值：*
3. 重启Ollama服务

macOS系统配置步骤

1. 打开终端
2. 执行命令：

   launchctl setenv OLLAMA_ORIGIN "*"
   

3. 重启Ollama服务

Linux系统配置步骤

1. 打开终端
2. 执行命令：

   export OLLAMA_ORIGIN="*"
   

3. 重启Ollama服务

安全提示：将OLLAMA_ORIGIN设为*会允许任何来源的请求，仅建议在可信网络环境中使用此配置。生产环境中应考虑指定具体的允许来源。

常见问题排查

如果按照上述步骤操作后问题仍然存在，建议检查以下方面：

1. Ollama服务状态：确认Ollama服务正在运行且监听正确端口
2. 防火墙设置：确保没有防火墙规则阻止浏览器扩展与本地服务的通信
3. 浏览器缓存：尝试清除浏览器缓存或使用隐身模式测试
4. 端口冲突：确认没有其他服务占用Ollama的默认端口(通常11434)

技术背景知识

理解这些连接问题需要了解几个关键概念：

1. 同源策略：浏览器安全机制，限制不同源(协议+域名+端口)之间的交互
2. CORS：跨域资源共享标准，允许服务器声明哪些外部源可以访问资源
3. 浏览器扩展架构：扩展运行在特殊的安全上下文中，与普通网页有不同的权限限制

Page Assist通过智能修改请求头和使用特定的代理机制，在保证安全性的同时实现了与本地AI服务的无缝集成。

page-assist Use your locally running AI models to assist you in your web browsing 项目地址: https://gitcode.com/gh_mirrors/pa/page-assist