Ollama 官网入口在哪：下载、文档与模型库地址

模型笔记内容创作者 2026-11-01 10 阅读

Ollama 是本地大模型运行工具，官网可下载客户端并接入模型库与开发文档。

截至 2026 年 10 月 26 日抓取时，Ollama 文档站已经更新了首页、集成、Windows 安装等页面。现在值得重新确认入口，是因为官网、下载页、文档站和模型库分散在不同域名，搜索结果里还混有 JavaScript 客户端仓库，容易把“运行 Ollama 的官网”和“调用 Ollama 的开发库”当成同一个页面。

下文凡标注“判断”或“推算”的内容，都是根据官方页面关系得出的结论；命令、功能和链接均来自官方文档或官方仓库。

三个入口分别做什么

直接访问 Ollama 官网。这是产品主入口，适合下载桌面客户端、查找模型以及进入其他官方服务。

想做的事	应打开的地址	页面用途
下载桌面客户端	https://ollama.com/download	macOS、Windows、Linux 下载入口
阅读安装与使用文档	https://docs.ollama.com/index	快速开始、模型管理、API 与集成说明
浏览模型库	https://ollama.com/search	按名称查找可拉取的模型
查看 JavaScript 客户端	https://github.com/ollama/ollama-js	npm 安装方式、JavaScript API 与示例

官方集成文档的 macOS 路径直接指向 https://ollama.com/download，所以需要安装客户端时，不要在搜索结果里寻找其他安装包地址。官方文档索引还把 https://ollama.com/search 标为 model library，这就是模型库的准确入口。

判断：官网负责“找到并获取 Ollama”，文档站负责“学会使用 Ollama”，GitHub 仓库负责“开发时集成 Ollama”。三者用途不同，不应只保存其中一个地址。

下载客户端：按系统进入对应安装页

打开 Ollama 下载页，根据正在使用的系统选择对应安装包。官方 Windows 文档说明，Ollama 以原生 Windows 应用运行，并支持 NVIDIA 和 AMD Radeon GPU。

Windows 用户还可以从 Windows 安装文档进入下载入口。文档给出的本地服务地址是：

http://localhost:11434

这个地址用于确认本机 Ollama 服务是否已经启动。安装后，若应用已经运行，本机接口应能在该地址提供服务；如果浏览器访问时没有任何响应，应先重新启动 Ollama 应用，再打开同一地址复查。

macOS 和 Linux 的具体安装选项也以下载页为准。不要从非官方镜像下载同名安装包：官方页面已经把系统区分、客户端获取和文档导航集中在同一路径中，没必要再去找第三方下载页。

下载是否成功，可以通过三个可观察结果确认：

系统应用列表或启动项中出现 Ollama。
启动后，本机服务可从 http://localhost:11434 访问。
再次打开下载页时，页面提供的是当前系统对应的安装选项。

找模型：进入模型库后确认名称

打开模型库，搜索需要的模型，并把模型名称完整抄到后续操作中。模型库是查找入口；真正把模型放进本地 Ollama 环境，还要使用文档中的模型管理命令。

官方 JavaScript 仓库提供的安装命令如下：

npm i ollama

该命令安装的是 ollama JavaScript 包，不是桌面客户端。若目标是让本机运行模型，应先完成上一节的客户端安装；若目标是在 JavaScript 项目中调用 Ollama，再执行这条 npm 命令。

官方仓库的云模型示例直接使用以下命令拉取模型：

ollama pull gpt-oss:120b-cloud

这里的 gpt-oss:120b-cloud 是示例模型名称，不要把它误解为所有账号都默认拥有该模型。实际使用时，应先在模型库确认目标模型及其准确名称，再替换命令中的模型名。

写代码：从官方仓库进入 JavaScript 接入

需要在 Node.js 项目中接入 Ollama 时，打开 ollama-js 官方仓库，先安装客户端，再复制 README 中的最小示例：

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)

这段示例成功时，终端会输出模型对“为什么天空是蓝色的？”的回答；如果输出模型名称缺失、模块无法解析或服务无法连接，应回到两个位置排查：先确认 Ollama 客户端已经启动，再确认项目依赖中已经安装 ollama 包。

仓库还给出了浏览器模块、流式输出和云端 API 的用法。浏览器模式使用：

import ollama from 'ollama/browser'

如果应用要在浏览器中运行，这条导入路径不能替换成普通 Node.js 的 import ollama from 'ollama'。这是两个运行环境的入口差异，而不是两套模型服务。

云端 API：官网与本地服务不是一回事

需要把请求直接发往 Ollama 云端时，使用官方仓库给出的云 API 地址 https://ollama.com，并先创建 API key。官方示例通过环境变量传入密钥：

export OLLAMA_API_KEY=your_api_key

然后让客户端使用云端主机：

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,
})
for await (const part of response) {
  process.stdout.write(part.message.content)
}

本地调用默认面向本机服务，云端调用则必须同时设置 host 和 OLLAMA_API_KEY。边界推导：如果把 https://ollama.com 填进本地客户端的默认地址，却仍沿用无鉴权的本地请求方式，请求链路就与官方云 API 示例不一致；遇到这种情况，应按仓库中的云端配置完整设置主机、密钥和模型名。

云模型还有一个容易混淆的入口。官方仓库提供一次性登录命令：

ollama signin

登录后再拉取带 -cloud 后缀的云模型，才会走官方示例描述的云端工作流。只想运行本地模型时，不需要额外执行登录。

最容易卡住的三个入口问题

把 JavaScript 仓库当成 Ollama 主仓库。ollama-js 的用途是“让 JavaScript 项目调用 Ollama”，页面也明确将它标为 Ollama JavaScript library。需要客户端安装时，应回到官网下载页；需要写代码时，才使用这个仓库的 npm i ollama 示例。

下载后仍访问 localhost:11434，但服务尚未启动。官方 Windows 文档说明本地服务地址为 http://localhost:11434。若该地址没有响应，关闭后重新启动 Ollama 应用，再复查；不要通过修改地址绕过服务启动问题。

模型名称照抄示例，实际却拉取不到。官方示例中的 llama3.1 和 gpt-oss:120b-cloud 都只是具体模型名。先到模型库确认名称是否可用，再执行 ollama pull；模型名是精确标识，不是“同类模型”的模糊类别。

最短使用路径与成功标志

只想在本机使用 Ollama 的读者，按这条路径操作即可：

打开 https://ollama.com/download，安装对应系统的客户端。
启动 Ollama，确认 http://localhost:11434 可访问。
打开 https://ollama.com/search，查找并确认模型名称。
遇到不会填写的命令项时，打开官方文档搜索模型管理章节。

开发者的最短路径则是：先安装客户端，再进入 ollama-js 仓库执行 npm i ollama，最后复制对应运行环境的示例。

整条链路成功时，应同时看到三个结果：客户端已安装并启动；本机地址 http://localhost:11434 有响应；调用代码能返回所选模型的内容。只看到官网能打开，只能证明网络访问正常，不能证明本地服务或模型调用已经成功。

官方文档与仓库入口

Ollama 官网：产品主入口。
Ollama 文档：安装、快速开始、模型管理和集成说明。
Ollama 下载页：桌面客户端下载。
Ollama 模型库：查找模型名称。
Ollama Windows 文档：Windows 安装、GPU 支持与本地服务说明。
Ollama 集成文档：桌面应用及第三方工具接入路径。
ollama-js 官方仓库：JavaScript、浏览器、流式输出和云 API 示例。

# AI # 知识

评论区

0 条评论

登录后可评论。