安装 Ollama
Ollama 是一个把开源大模型跑在你自己电脑上的轻量级框架。动手调用模型之前,先要在本机装好 Ollama 并确认它的后台服务能正常启动。本节按 macOS / Windows / Linux 三平台给出安装方式与验证命令,全部以官方文档(docs.ollama.com,版本基线 v0.40.12)为准。
一、各平台安装方式
macOS
## 方式一:到 https://ollama.com/download 下载 Ollama.dmg,拖入「应用程序」
## 方式二(已装 Homebrew):用 brew 安装
brew install --cask ollama
安装完成后在「启动台」打开 Ollama,菜单栏会出现 Ollama 图标,后台服务随应用启动。
Windows
## 到 https://ollama.com/download 下载 OllamaSetup.exe,双击按向导安装
## 安装后 Ollama 会注册为后台服务并自动启动;也可从开始菜单打开 Ollama 应用
PowerShell 中验证(需新开一个终端窗口使 PATH 生效):
powershell
ollama --version
Linux
## 官方一键安装脚本(会配置 systemd 服务并设为开机自启)
curl -fsSL https://ollama.com/install.sh | sh
国内网络访问
ollama.com下载可能偏慢,可配置代理后重试;脚本只需联网这一次。
二、验证安装与服务
装好后在终端运行版本命令,能输出版本号即说明命令行已就位:
## 查看 Ollama 版本(基线 v0.40.12,你的版本号可能更高)
ollama --version
确认后台服务是否运行:
## 查看当前正在运行的模型;若服务未起会报错,可手动启动
ollama ps
- macOS / Windows:直接打开 Ollama 应用即可启动后台服务。
- Linux:安装脚本已配置 systemd,可用下面命令管理:
## 启动 / 停止 / 查看状态(Linux systemd)
sudo systemctl start ollama
sudo systemctl stop ollama
systemctl status ollama
若需要在不打开桌面应用的情况下手动拉起服务(例如服务器场景),可运行:
## 手动启动 Ollama 服务(默认监听 http://localhost:11434)
ollama serve
三、国内下载与代理提示
- 模型权重从
ollama.com下载。国内网络偶尔较慢属正常,耐心等待即可,终端会显示下载进度。 - 如长期下载不畅,可为终端配置代理后再运行
ollama run/ollama pull。 - 不要从非官方镜像下载安装包;版本以 GitHub release(当前 v0.40.12)为交叉核对基准。
四、失败处理
ollama: command not found:命令行未找到 Ollama。macOS/Windows 重开终端或重新安装;Linux 确认安装脚本执行成功且已加入 PATH。- 服务起不来(Linux):检查
systemctl status ollama日志,常见原因是端口被占用或权限不足;用ollama serve看前台报错。 - 版本过旧:运行
ollama --version后到官方下载页升级;本教程示例以 v0.40.12 为基线,新版本命令可能略有差异。
五、动手试
- 在你的系统上完成安装,运行
ollama --version确认有版本输出。 - 打开 Ollama 应用(或 Linux 上
systemctl start ollama),运行ollama ps确认服务已起。 - 下一节(1.2 Ollama 运行你的第一个模型)将带你跑起第一个模型并对话。