如何在最新的 Mac mini M4 机器上,让 Ollama 支持局域网访问

如果你在 Mac mini 4 上使用 Ollama,并希望让同一局域网上的其他设备通过 IP 访问 Ollama API,那么必须解决一个关键问题:

用传统的 shell 环境变量方式是无效的!

macOS 上的 GUI 程序(包括点图标启动的 Ollama)并不会从 .zshrc.bashrc 等配置文件中继承你手动 export 的环境变量,这也导致不论如何配置 OLLAMA_HOST 都无效,Ollama 总是只聚听 127.0.0.1,无法局域网访问。

解决方案:使用 LaunchAgent 配置 Ollama

你需要在 ~/Library/LaunchAgents/ 目录下创建一个 .plist 文件,进行以下操作:

1. 创建 com.ollama.server.plist 文件

在终端执行:

bash 复制代码
touch ~/Library/LaunchAgents/com.ollama.server.plist
open -e ~/Library/LaunchAgents/com.ollama.server.plist

把以下纯准版 XML 内容复制到文件中:

xml 复制代码
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>com.ollama.server</string>

  <key>ProgramArguments</key>
  <array>
    <string>/usr/local/bin/ollama</string>
    <string>serve</string>
  </array>

  <key>EnvironmentVariables</key>
  <dict>
    <key>OLLAMA_HOST</key>
    <string>http://0.0.0.0:11434</string>
  </dict>

  <key>RunAtLoad</key>
  <true/>
</dict>
</plist>

注意: /usr/local/bin/ollama 路径需根据你实际安装的结果,可以用 which ollama 查看。


2. 验证 plist 格式是否合法

bash 复制代码
plutil ~/Library/LaunchAgents/com.ollama.server.plist
  • 如果返回不报错,则表明文件格式正确

3. 加载 LaunchAgent

直接使用以下命令即可:

bash 复制代码
launchctl load -w ~/Library/LaunchAgents/com.ollama.server.plist

然后重启电脑

重启后,Ollama 就会以你指定的 OLLAMA_HOST 运行,支持局域网访问。


4. 配置 Chrome 插件 Page Assist

如果你使用了这个 Chrome 插件 Page Assist,需要进入插件设置,手动指定 Ollama 服务器地址,并启用 CORS 自动修复功能:

  • 通常为 http://192.168.x.x:11434
  • 否则即使服务本身运行正常,插件也会报错无法连接

5. 验证 Ollama 是否已成功聚听 0.0.0.0

1) 检查是否有运行进程
bash 复制代码
ps aux | grep ollama
2) 检查端口是否已聚听
bash 复制代码
netstat -an | grep 11434

bash 复制代码
lsof -n -iTCP:11434 -sTCP:LISTEN

如果看到如下结果:

复制代码
tcp4       0      0  *.11434                *.*                    LISTEN

则表明 Ollama 已成功聚听在全网络网卡,局域网可访问。


为什么需要这么做?

因为 Ollama 如果通过图标启动(或系统登录时自启),它的启动时机可能在你手动或 plist 设置环境变量之前。因此:

  • 这么启动的 Ollama 看不到 OLLAMA_HOST,也就无法聚听 0.0.0.0
  • 即使后续手动设置环境变量,Ollama 还是需要重启,并不合理

解决办法就是一次性在 LaunchAgent 中定义环境变量和启动命令,一开机就自动运行。


小结

  • 不要尝试把 export OLLAMA_HOST=... 写入 ~/.zshrc 并无效
  • 也不要用 launchctl setenv 这种随系统重启会失效的方法
  • 唯一精准、稳定、无效期的方法:在 LaunchAgent 中配置 plist 文件,定义环境变量 + 自动启动命令

做完这些步骤,你就可以让 Mac mini 上的 Ollama 在局域网下正常装载、可被其他设备通过 IP 访问了!

相关推荐
岁忧10 小时前
macOS配置 GO语言环境
开发语言·macos·golang
岁忧17 小时前
macOS 安装 Homebrew
macos·homebrew
棒棒AIT18 小时前
mac 苹果电脑 Intel 芯片(Mac X86) 安卓虚拟机 Android模拟器 的救命稻草(下载安装指南)
android·游戏·macos·安卓·mac
*愿风载尘*1 天前
SecureCRT连接密钥交换失败
linux·macos
mCell1 天前
从删库到跑路?这50个Linux命令能保你职业生涯
linux·windows·macos
fhf2 天前
2025年了你会卸载Macbook上的应用吗?
macos·shell
归辞...2 天前
「iOS」——内存五大分区
macos·ios·cocoa
穆雄雄2 天前
备份一下我的 mac mini 的环境变量配置情况
macos
秃然想通2 天前
mac电脑搭载c、c++环境(基于vs code)
macos
归辞...2 天前
「iOS」——GCD其他方法详解
macos·ios·cocoa