Ollama 怎么安装：脚本、客户端、Docker 三条路与验证命令对照

木木夕 技术创作者 2026-11-01 392 阅读

Ollama 可通过系统安装脚本、JavaScript 库或 Docker 部署使用。

截至 2026-11-01 抓取时，Ollama 官方 JavaScript 仓库已经同时列出本地调用、云模型和云 API 三类用法，并提供 npm i ollama、ollama signin、模型拉取及 REST API 调用示例。现在值得重新梳理安装方式，是因为“安装 Ollama 桌面程序”“安装 JavaScript 客户端”“在服务器里运行 Ollama”并非同一件事；选错路径，后面即使照着命令执行，也可能只得到客户端而没有本地模型服务。

下文凡涉及模型、命令和接口的内容，均以已核到的官方仓库或明确标注的社区指南为准；根据不同入口组合出的适用边界属于本文分析，不是官方结论。

先确定要装哪一种

Ollama 的官方 JavaScript 仓库地址是：

https://github.com/ollama/ollama-js

这个仓库提供的是 JavaScript library（用于调用 Ollama 服务的 JavaScript 客户端库），不是 Windows、macOS、Linux 本地运行时的完整安装包。因此，“我要在电脑里运行模型”和“我要在 Node.js 项目里调用 Ollama”，入口不同。

安装或接入路径 适合谁 主要产物 是否需要本地 Ollama 服务
系统安装脚本 想在 macOS、Linux 本机直接运行模型的人 本地 Ollama 命令与后台服务 需要
JavaScript 库 已有 Node.js 项目，要写应用的人 ollama npm 包 本地调用需要；云端调用可不用
Docker 要把服务部署到服务器或隔离环境的人 容器中的 Ollama 服务 需要由容器提供

系统安装脚本来自社区安装指南所引用的 Ollama 官方安装入口；JavaScript 命令来自官方仓库 README；Docker 部分结合 Docker 官方仓库配置与社区项目实践。三条路径不能互相替代。

前置条件：动手前只检查 3 项

  1. 确认系统能执行下载命令。 在 macOS 或 Linux 终端查看是否存在 curl；Windows 用户先准备 WSL（Windows Subsystem for Linux，Windows 的 Linux 子系统），再执行后续命令。
  2. 确认 Node.js 项目目录。 在准备运行应用的目录执行 npm -v；能看到版本号后再安装 JavaScript 包。没有 Node.js 的读者不必执行第二条路径。
  3. 确认服务器容器环境。 使用 Docker 前，在服务器执行 docker --version 和 docker compose version；两条命令都可用，再继续安装 Docker。

本地模型还需要足够的内存和磁盘空间，具体需求取决于模型大小。已核到的社区指南给出的环境示例是 Windows 10+、macOS 10.15+ 或 Ubuntu 18.04+，并建议预留 20GB 以上 SSD 空间；其中 NVIDIA GPU 8GB+ 显存是可选加速项，不是运行 Ollama 的绝对前提。

路径一：用系统脚本安装本地 Ollama

这条路径适合希望在终端中直接执行 ollama pull、ollama run 的用户。Ollama 的社区安装指南在 Quick Start 中给出了 macOS/Linux 安装入口，完整命令为：

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

执行完成后重新打开终端，使安装脚本写入的 PATH（系统查找可执行程序的环境变量路径）生效。然后先确认 Ollama 命令已经进入当前环境，再下载模型：

ollama pull llama3.2:3b

这里的 llama3.2:3b 是社区 Ollama 配置指南列出的轻量模型示例：3B 指约 30 亿参数，适合资源较紧的本地环境。模型越大，占用的内存、显存和磁盘通常越多；不要在尚未确定机器配置时直接下载 70B 级模型。

如果系统安装后仍找不到 ollama，先关闭当前终端并新开一个终端，再执行 ollama --version。仍无法识别时，不要反复重跑安装脚本；这通常意味着安装目录没有进入当前用户的 PATH，需要检查脚本安装时输出的目录是否已加入 shell 配置。

系统脚本路径的优点是命令最直接，适合先验证“本机能否跑模型”。代价是它会直接改动当前系统环境。如果电脑需要保留干净，或者服务要部署给多台机器调用，路径三更容易控制。

路径二：在 Node.js 项目中安装客户端

如果目标是让网页、脚本或后端服务调用 Ollama，不需要重新抄写 REST 请求。官方 JavaScript 仓库给出的安装命令是：

npm i ollama

然后在项目入口文件中导入：

import ollama from 'ollama'

const response = await ollama.chat({
  model: 'llama3.1',
  messages: [{ role: 'user', content: 'Why is the sky blue?' }],
})
console.log(response.message.content)

这段示例来自官方仓库的 Getting Started。成功标志不是仅仅看到 npm 安装结束，而是应用能够返回 response.message.content。如果应用提示找不到模块，检查命令是否在包含 package.json 的项目目录执行，以及入口文件是否写成了 import ollama from 'ollama'。

官方 README 还展示了流式输出：

import ollama from 'ollama'

const message = { role: 'user', content: 'Why is the sky blue?' }
const response = ollama.chat({
  model: 'llama3.1',
  messages: [ message ],
  stream: true,
})
for await (const part of response) {
  process.stdout.write(part.message.content)
}

需要留意：npm i ollama 安装的是调用客户端，不等于本地模型已经准备好。本地模式下仍需运行 Ollama 服务并下载对应模型；如果 JavaScript 程序只访问云端 API，则用下文”另一种选择”里的云端方案。

路径三：Docker 部署（服务器 / CI 场景）

Docker 更适合 Linux 服务器、CI（持续集成）环境以及需要隔离依赖的场景。分两步：先把 Docker 装好，再用官方镜像起 Ollama。

3.1 先装 Docker（Debian/Ubuntu，按官方仓库方式）：不要依赖发行版自带的旧包，先清理再加官方源：

# 清理旧组件（没有就跳过）
sudo apt remove docker docker-engine docker.io containerd runc

# 依赖与密钥（包名是 gnupg，别写错）
sudo apt update
sudo apt install -y ca-certificates curl gnupg lsb-release
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 装 Docker 引擎与常用插件
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

# 把当前用户加进 docker 组，之后不用每次 sudo（重新登录后生效）
sudo usermod -aG docker $USER

Docker 引擎的官方安装文档在 docs.docker.com 的安装页；download.docker.com 这个域名在国内服务器上偶尔超时，卡在这一步时可改用其国内镜像地址（社区指南的做法，属替代方案，不是官方承诺）。

3.2 用官方镜像起 Ollama 并验证（命令出自 ollama/ollama 官方仓库）：

# 无 GPU 的基础版
docker run -d -v ollama:/root/.ollama -p 11434:11434 --name ollama ollama/ollama

# 有 NVIDIA GPU 时加 --gpus=all
docker run -d --gpus=all -v ollama:/root/.ollama -p 11434:11434 --name ollama ollama/ollama

# 进容器拉一个模型（示例用 qwen3-coder:30b，可换成任意你要的模型）
docker exec -it ollama ollama pull qwen3-coder:30b

# 验证：列出已拉取的模型
docker exec -it ollama ollama list

成功标志是 ollama list 能打印出模型名，且本机 curl http://127.0.0.1:11434 有响应。数据卷 ollama:/root/.ollama 保存模型文件，删容器不会丢模型。

另一种选择：不装本地服务，直接用云端 API

若不想在服务器上装任何东西，Ollama 官方 JavaScript 仓库提供了云端方案。先登录：

ollama signin

再拉取云模型：

ollama pull gpt-oss:120b-cloud

官方 README 说明，该模型会从 Ollama 云端卸载运行，应用侧仍可沿用熟悉的调用方式。直接访问云 API 时，需要创建 API key，并设置环境变量：

export OLLAMA_API_KEY=your_api_key

然后把客户端地址指向：

https://ollama.com

对应示例是：

import { Ollama } from 'ollama'

const ollama = new Ollama({
  host: 'https://ollama.com',
  headers: { Authorization: 'Bearer ' + process.env.OLLAMA_API_KEY },
})
const response = await ollama.chat({
  model: 'gpt-oss:120b',
  messages: [{ role: 'user', content: 'Explain quantum computing' }],
  stream: true,
})

常见卡点：先分清客户端、服务和模型

安装环节最容易混淆的是三种状态：npm 包已安装，只代表客户端存在；ollama pull 完成，只代表模型文件已经下载；JavaScript 示例返回内容，才代表客户端、服务地址和模型名称已经串通。若示例报“找不到模型”，先核对 model 字段；若报连接失败，则检查本地 Ollama 服务是否启动，或云端客户端是否确实使用了 https://ollama.com。

三条路的验证命令对照

同一句“装好了”，在三条路上的验证命令不同，放在一起对照（均可直接复制）：

路径 验证命令 成功时你会看到
一、系统脚本 ollama --version 然后 ollama run llama3.2 版本号 + 交互式问答
二、Node 客户端 node -e "console.log(require('ollama/package.json').version)"，再跑项目里的 chat 示例 包版本号 + 控制台 response.message.content
三、Docker docker exec -it ollama ollama list 容器内已拉取的模型列表
云 API（另一种选择） echo $OLLAMA_API_KEY 后执行 signin 后的拉取命令 密钥非空 + 云模型流式返回

三者都不通时，先回到上一节的“三种状态”判断卡在哪一层，不要跨层改配置。

装好后的判断与延伸入口

本地路径的成功标志是 ollama 命令可用、模型已经出现在本地列表中，并能完成一次问答。JavaScript 路径的成功标志是控制台输出 response.message.content，而不是只看到 npm i ollama 返回成功。云端路径的成功标志是 ollama signin 已登录、OLLAMA_API_KEY 已设置，并且云模型能够返回流式内容。

继续核对时可使用以下入口：

按最省事的顺序选择：个人电脑先用系统脚本，Node.js 应用用官方 npm 客户端，服务器或不想安装本地运行时就选 Docker 或云 API。

参考来源

# AI# 知识

评论区

0 条评论

登录后可评论。

木木夕 392 阅读