Ollama 安装与连接指南

第 1 步：安装 Ollama

Ollama 是一款免费应用，可以在你自己的电脑上运行 AI 模型。请从官网下载适合你系统的安装包。

• macOS： 打开下载的文件，把 Ollama 拖进“应用程序”文件夹并启动。运行时菜单栏会出现一个羊驼图标。
• Windows： 运行 OllamaSetup.exe 并按提示操作。Ollama 会在后台启动，并在托盘显示图标。
• Linux： 运行下面这行安装脚本，它会同时配置后台服务。

curl -fsSL https://ollama.com/install.sh | sh

想确认安装成功，可以在浏览器中打开 http://localhost:11434，看到 “Ollama is running” 即可。

第 2 步：允许 mysnipbox 连接（OLLAMA_ORIGINS）

macOS

1. 1从菜单栏图标退出 Ollama。
2. 2打开“终端”，运行下面的命令。它会为之后启动的应用设置该变量。
3. 3重新打开 Ollama。

launchctl setenv OLLAMA_ORIGINS "*"

更习惯用终端？先退出 Ollama 应用，再用下面的命令自己启动服务，并保持该窗口打开：

OLLAMA_ORIGINS="*" ollama serve

launchctl setenv 只在重启 Mac 之前有效，重启后请再运行一次（或把它加入登录脚本）。

Windows

1. 1从系统托盘退出 Ollama（右键图标 → Quit）。
2. 2打开开始菜单，搜索并打开 编辑账户的环境变量。
3. 3在“用户变量”下点击 新建…，变量名填 OLLAMA_ORIGINS，变量值填 *，然后点击确定。
4. 4从开始菜单重新启动 Ollama。

Linux（systemd）

运行 sudo systemctl edit ollama.service，添加下面两行并保存，然后运行 sudo systemctl daemon-reload && sudo systemctl restart ollama。

[Service]
Environment="OLLAMA_ORIGINS=*"

第 3 步：下载推荐模型

mysnipbox 会用到两类模型。你可以在应用内一键下载，也可以用终端下载。ollama run 首次运行时会下载模型，然后打开对话（输入 /bye 退出）。只想下载的话，使用 ollama pull <模型名>。

标签提取（视觉）

• Llama 3.2 Vision（11B）： 高质量的深度分析模型。下载较大（约 8GB），需要充足的内存。
• Qwen2.5-VL 7B： 体积较小（约 6GB）但表现均衡的全能型模型。

ollama run llama3.2-vision
ollama run qwen2.5vl:7b

标签翻译（文本）

• Qwen2.5（3B）： 轻量快速，能很好地保留中日韩词汇。

ollama run qwen2.5:3b

第 4 步：在 mysnipbox 中确认

1. 1打开 mysnipbox，进入 Settings。
2. 2在视觉提供商中选择 Ollama，状态应显示为 Running。
3. 3你下载的本地模型会出现在模型列表中。分别选择一个用于标签提取（视觉），一个用于标签翻译（文本）。
4. 4分析一张测试图片。模型载入内存期间，第一次请求会比较慢。

仍然检测不到？

• 确认 Ollama 正在运行：在浏览器中打开 http://localhost:11434，应显示 “Ollama is running”。
• 重新检查第 2 步，然后彻底退出并重新打开 Ollama。环境变量只在 Ollama 启动时读取。
• 列表中没有模型： 先下载，并确认名称完全一致。ollama list 可以查看已安装的模型。
• 更多关于硬件、远程服务器和故障排查，请参阅本地模型（Ollama）。