ollama安装步骤使用教程

简介

Ollama 是一个开源的本地大模型运行框架，核心目标是让在本地电脑上运行 AI 模型变得像安装一个普通软件一样。它把模型下载、量化、环境配置和推理过程全部封装成命令行操作，用户不必手动处理依赖、路径和量化参数。Ollama 支持 macOS、Windows、Linux 三种平台，也可通过 Docker 容器运行，适合想在个人电脑上跑 Llama、Qwen、DeepSeek 等开源模型的开发者、学生和研究人员。它的优势在于部署路径短、跨平台命令统一、社区生态集成方便，一条命令即可进入模型对话。

核心功能

• 把模型下载、量化、环境配置和推理封装成命令行操作，省去手动准备依赖与路径的步骤。
• 一条命令即可运行模型，例如在终端执行 ollama run qwen 就能进入对话。
• 覆盖 macOS、Windows、Linux 三个平台，也支持通过 Docker 容器运行。
• 官方提供 Linux 一键脚本 curl -fsSL https://ollama.com/install.sh | sh，复制到终端回车即可执行。
• Windows 走图形化流程：下载 OllamaSetup.exe 后双击，在弹窗中点击 Install 等待完成。
• 程序跑完后 Ollama 已经默认在运行，打开终端即可直接调用 ollama 命令，无需再手动启动服务。
• 遇到 ollama 命令无法使用的问题时，可通过配置环境变量解决，不必重复部署。
• 官方文档提供快速入门与常见问题页面：https://ollama.readthedocs.io/quickstart/ 与 https://ollama.readthedocs.io/faq/

使用场景

• 在个人电脑本地运行开源大模型，不依赖云端账号与在线服务，模型下载后即可离线推理。
• 开发者把本地模型接入自己的应用做原型验证，用统一的命令行接口完成调用与切换。
• 学生和研究人员对比不同模型的输出差异，用 ollama run 加模型名快速换模型测试。
• 网络受限的办公或实验环境，先在有网时取回模型文件，之后在本地持续使用。
• 已在 Windows 上启用 WSL 的用户，在 vEthernet (WSL) 适配器相关配置下排查网络问题。
• 需要在多系统之间保持一致操作习惯的团队，三个平台的命令写法基本相同。

安装与获取步骤

1. Windows：打开浏览器访问 https://ollama.com/download，下载适用于 Windows 的安装程序 OllamaSetup.exe。
2. Windows：等待浏览器下载完成后双击 OllamaSetup.exe，出现弹窗时点击 Install，等待下载完成。
3. Windows：流程结束后可以看到 Ollama 已经默认运行，此时打开终端即可直接输入命令。
4. macOS：访问 https://ollama.com/download 下载页，选择 macOS 对应的下载入口，按提示完成；该页同时提供 Windows 与 Linux 入口。
5. Linux：在系统终端执行 curl -fsSL https://ollama.com/install.sh | sh；文档另附手动安装说明，有特殊目录需求时可按其步骤操作。
6. Docker：Ollama 也支持通过 Docker 容器运行，具体镜像与启动参数以官方页面为准。
7. 验证：在终端执行 ollama run qwen，能进入模型交互即说明命令可用；首次运行会拉取模型文件，请耐心等待。
8. 若提示 ollama 命令无法使用，进入系统环境变量配置，把 Ollama 所在目录加入 PATH，重开终端后再验证一次。

平台选择与命令速查

• 平台支持：macOS、Windows、Linux，以及通过 Docker 容器运行，可按现有系统选择对应入口。
• Windows 流程关键词：OllamaSetup.exe → 双击 → Install → 等待完成 → 默认已运行。
• Linux 流程关键词：系统终端 → curl -fsSL https://ollama.com/install.sh | sh；Ubuntu 22.04 等发行版的命令行方式类似。
• 首次运行示例：ollama run qwen，把 qwen 换成你要跑的模型名即可切换。
• 文档入口：https://ollama.readthedocs.io/quickstart/ ；官网入口：https://ollama.com 。
• 升级：官方推荐的升级方法在系统终端执行，具体命令与适用范围以官方页面为准。

注意事项

• 首次运行模型需要联网拉取模型文件，文件体积较大，请预留磁盘空间并耐心等待，具体大小以官方页面为准。
• 终端提示 ollama 命令无法使用时，优先检查环境变量是否配置正确，Windows 下确认 PATH 中包含 Ollama 所在目录，改完需重开终端。
• 模型加载失败时，确保模型文件完整且路径正确；若使用自定义模型，检查模型的格式是否正确。
• Windows + WSL 场景出现网络异常：打开 控制面板 > 网络和Internet > 查看网络状态和任务，点击左侧的更改适配器设置，找到 vEthernet (WSL) 适配器，右键点击属性检查其配置。
• 与其他软件包发生冲突时，先卸载冲突的软件包、清理残留文件，再重新部署；相关运行时建议使用官方推荐的 LTS 版本。
• 不同系统与版本的命令可能存在差异，支持范围、参数与模型清单一律以官方页面为准。