Better external apps support for the Ollama AI enginer

快速结论：当外部应用（如 Thunderbird 插件、Excel 插件、浏览器扩展）无法连接在 Unix-like 系统（macOS、Linux）上自启动的 Ollama GUI 应用时，通常是因为 Ollama 没有加载所需环境变量（如 OLLAMA_HOST、OLLAMA_ORIGINS）。优先排查是否在系统服务或 shell 配置文件中正确设置了环境变量，并重启 Ollama 进程。

问题场景

用户在 macOS（Apple MacMini Pro M2）和 NVIDIA DGX Spark（Ubuntu Linux）上通过标准安装的方式运行 Ollama GUI 应用（开机自启动）。当使用以下外部应用调用 Ollama 作为 AI 引擎时，出现连接失败：

Thunderbird 邮件客户端 + ThunderAI 扩展
Microsoft Excel + ollama-excel 插件
Microsoft Edge 浏览器 + Ollama UI 扩展

报错原文

external application cannot talk to Ollama GUI APP when runs in its normal form, where Ollama automatically starts at boot

# On macOS:
# User has to stop the Ollama GUI app, then run: ollama serve

# On Linux (DGX Spark):
# User modified /etc/profile with OLLAMA_* variables, but Ollama still not picking them up

原因分析

Ollama GUI 应用在系统自启动时，不会自动加载用户 shell 配置文件（如 .zprofile、/etc/profile）中设置的环境变量。因此，外部应用（尤其是浏览器扩展、Thunderbird 插件）会因缺少 OLLAMA_ORIGINS、OLLAMA_HOST 等关键变量而无法与 Ollama 服务通信。
在 Linux（如 DGX Spark 使用 systemd）上，环境变量应通过 systemd override.conf 注入，而非 /etc/profile。在 macOS 上，需要手动通过 launchctl setenv 或编写启动脚本来注入环境变量。

环境排查

确认操作系统版本：macOS（如 Sonoma/Ventura）、Linux（如 Ubuntu 22.04+）
确认 Ollama 版本（可通过 ollama --version 查看）
确认外部应用（Thunderbird 插件、浏览器扩展、Excel 插件）版本
检查 Ollama 当前启动方式：
- macOS: 是否为 GUI 应用自启动，或命令行 ollama serve
- Linux: 是否使用 systemd 服务（systemctl status ollama）
检查环境变量是否生效：
- macOS: launchctl getenv OLLAMA_HOST
- Linux: systemctl show ollama --property=Environment

解决步骤

macOS 上的优先解决方案（可优先尝试）：
编写一个启动脚本来替代直接使用 GUI 启动，该脚本负责设置环境变量并重新启动 Ollama。

创建一个脚本文件（如 ~/ollama-start.sh）：

#!/bin/bash

[ "$1" == "restart" ] && {
	ENV=~/.ollama/env

	[ -f $ENV ] && {
	  while read i ; do
	    k="${i%%=*}"
	    v="${i#*=}"
	    launchctl setenv "$k" "$v"
	  done < $ENV
	}

	env | grep "^OLLAMA" | while read i ; do
	    k="${i%%=*}"
	    v="${i#*=}"
	    launchctl setenv "$k" "$v"
	done
	pkill Ollama ollama
	nohup /Applications/Ollama.app/Contents/MacOS/Ollama hidden 2>&1 > ~/.ollama/logs/app.log &
	exit 0
}

exec /usr/local/bin/ollama "${@}"

授予执行权限：chmod +x ~/ollama-start.sh
然后运行 ./ollama-start.sh restart 重启 Ollama，可使环境变量对 GUI 应用生效。

macOS 备选方案：修改 .zprofile
在用户 shell 配置文件（如 .zprofile）中添加环境变量后，务必执行 launchctl setenv 命令使其对 GUI 应用生效。举例：
```
launchctl setenv OLLAMA_HOST "0.0.0.0:11434"
launchctl setenv OLLAMA_ORIGINS "chrome-extension://*,moz-extension://*,safari-web-extension://*,*"
launchctl setenv OLLAMA_FLASH_ATTENTION "1"
```
然后重启 Ollama（GUI 或命令行）。注意：OLLAMA_ORIGINS 中的 * 通配符需谨慎使用，可能带来安全风险。

Linux（DGX Spark / systemd）上的解决方案：

创建或编辑 systemd override 配置文件：

sudo mkdir -p /etc/systemd/system/ollama.service.d
sudo nano /etc/systemd/system/ollama.service.d/override.conf

填入以下内容：

[Service]
Environment="OLLAMA_HOST=0.0.0.0:11434"
Environment="OLLAMA_ORIGINS=chrome-extension://*,moz-extension://*,safari-web-extension://*,*"
Environment="OLLAMA_FLASH_ATTENTION=1"
Environment="OLLAMA_LOAD_TIMEOUT=20"
Environment="OLLAMA_KEEP_ALIVE=5m"
Environment="OLLAMA_MAX_LOADED_MODELS=3"
Environment="OLLAMA_NUM_PARALLEL=6"
Environment="OLLAMA_CONTEXT_LENGTH=131072"
# 注意：OLLAMA_LOAD_TIMEOUT 默认5分钟，设为20秒可能过短

然后重载 systemd 并重启 Ollama 服务：

sudo systemctl daemon-reload
sudo systemctl restart ollama

不要将 OLLAMA_* 变量放在 /etc/profile 中，systemd 服务不会读取该文件。

通用排查：验证环境变量是否正确
- macOS: launchctl getenv OLLAMA_HOST 应返回 0.0.0.0:11434
- Linux: systemctl show ollama --property=Environment 应列出所有设置的环境变量
- 确认 OLLAMA_LOAD_TIMEOUT=20（设为20秒）是否合理，默认值为5分钟。过短的超时可能导致大模型加载失败。
- OLLAMA_SCHED_SPREAD 在 Mac 或 DGX Spark 上非必需。

验证方法

完成上述配置后，通过以下方式确认 Ollama 服务可被外部应用访问：

浏览器扩展（如 Ollama UI）能成功发送请求并返回结果
Thunderbird 的 ThunderAI 扩展能正常调用 Ollama
Excel 插件能连接并执行 AI 功能
命令行测试：curl http://localhost:11434/api/tags（或 0.0.0.0:11434）应返回模型列表
检查 Ollama 日志（macOS: ~/.ollama/logs/app.log，Linux: journalctl -u ollama）确认无 CORS 或连接拒绝错误