ollama使用方法

模型与算力

给第一次装 Ollama 的开发者讲清从下载安装、拉模型到跑通第一条命令的完整顺序,以及卡住时的排查方向。

你可能刚听说本地跑大模型不用显卡集群,于是搜到 Ollama,装完却不知道下一步敲什么;或者敲了命令半天没反应,分不清是没拉模型、服务没起还是网络在转圈。这篇按一条能走完的路径来:先确认你要的是哪种用法,再按顺序装、起、拉、跑,最后给出几种常见卡点的排查顺序。不承诺某台机器一定跑得动,只告诉你每一步该看到什么、看不到该去哪儿核对。

你可能是听说本地跑大模型不用显卡集群,于是搜到 Ollama,装完之后却对着空终端不知道敲什么;也可能命令发出去了半天没反应,分不清是模型没拉、服务没起,还是网络在转圈。这几个状态看起来都像「卡住」,但排查方向完全不一样,先搞清楚自己在哪一步,比反复重装有用得多。这篇按一条能走完的顺序来:先确认你要哪种用法,再按顺序装、起、拉、跑,最后给常见的卡点排查顺序。

这里不承诺某台机器一定跑得动,也不给死数字。每一步该看到什么、看不到该去哪儿核对,才是能带走的东西。凡是要看当下的价格、规格、榜单或硬件对应关系,一律去站内对应页面看当时的值。

装之前先分清:你要的是命令行还是图形界面

纯终端对话
只想要一个能在命令行里问答的本地模型,装 Ollama 本体就够,不用再配别的。
当后端接口
想让自己的脚本或程序调用本地模型,Ollama 自带的本地接口能顶一阵,注意端口和路径。
图形聊天窗口
想点鼠标聊天,通常要在 Ollama 之上再套一层界面工具,本体只负责加载和推理。
  • 按操作系统选安装方式:桌面系统走图形安装包更省事;服务器和容器环境走命令行安装脚本更顺手,别在服务器上硬套桌面流程。
  • 先规划模型放哪:默认路径往往落在系统盘,模型文件体积大,装之前就把存储目录想好,装完再挪很麻烦。
  • 判断硬件下限:显存和内存决定能跑多大参数、哪个量化档位,具体对应关系到 /models/deploy 按你的卡和参数量算一遍。
  • 先定一个近期目标:是验证链路能通,还是要长期日常用,两者的模型选择和存储规划不同。

安装与服务启动:确认它真的在跑

  1. 确认安装成功新开一个终端窗口敲版本查询命令,能看到输出说明可执行文件已经在 PATH 里;提示找不到命令,多半是安装方式选的路径没进环境变量。
  2. 确认服务在跑查版本之后紧接着做一次健康检查,比如用本地请求打一下默认端口。有响应才叫服务起来了,没响应先别去拉模型。
  3. 记下监听地址和端口默认通常只监听本机。要让同网段别的机器访问得改环境变量,改法和暴露风险看 /ai-dict/category/infra。
  4. 设成常驻或开机自启不然每次重启都要手动起一遍。Linux 下找不到服务名是高频坑,先确认你是脚本安装还是包管理器安装,再找对应的服务单元。
现象优先怀疑下一步动作
命令找不到PATH 或安装方式不对确认安装路径,重开终端再试
服务打不通服务没起或端口被占查进程、查端口占用,看日志
改了配置不生效没重启服务重启后重新做一次健康检查
只有本机能访问默认只监听本地确认是否真的需要对外暴露,再改绑定地址

拉模型与第一条命令:从下载到出字

下载和运行是两件事。下载只把文件取到本地磁盘,运行才会把权重加载进内存或显存。很多人卡在「下载完了没反应」,其实是从没执行过运行那一步,或者运行了但模型根本装不下,被不停地换进换出。

所以先选一个体量小的模型把流程走通,别一上来就拉最大的那个,下载时间和服务负载都不划算。加载起来之后观察三种信号:加载耗时、第一个字出现的时间、之后每秒吐多少字。三个都正常,说明链路通了。

  • 一直不出字:先看显存是不是被别的进程占满,再确认模型大小是否超出可用显存。
  • 时快时慢:可能在做内存和显存之间的搬运,参数量或量化档位选大了。
  • 报显存不足:换更小的模型或更激进的量化档位,别硬撑。
  • 参数看不懂:到 /ai-dict/category/tips 对照参数含义,别凭猜改配置。
  • 跑通之后把完整命令记下来:模型名加参数一起存,后面接工具、写脚本直接复制。

跑通之后接什么:接口、界面和下一步

命令行能用之后,才有必要考虑接图形界面、知识库或代码编辑器。常见的新手自阻塞是一次性装一堆东西,结果任何一环出问题都定位不了。一次加一个,每次加完都验证一遍原先那条命令还能不能跑。

想做的事走哪条路先确认什么
给程序调用走本地接口默认端口和路径是否对得上
接图形界面装界面工具再连本地服务服务是否允许被该工具访问
更高并发吞吐未必继续用 Ollama到 /inference 看同类开源模型的实测口径
替代线上服务先别急到 /models 看模型的上下文与规格说明

一份可以照着打勾的检查清单

  • 服务在跑:健康检查有响应。
  • 命令能通:版本查询能返回。
  • 模型拉下来了:本地能找到对应文件。
  • 能出字:第一条命令有正常输出。
  • 速度可接受:加载和输出不让人等到怀疑人生。

五步依次确认,跳过任何一步,后面都会加倍还回来。失败时先把范围缩小:是环境问题、网络问题还是模型本身的问题,这三条排查路径完全不同。另外,凡是改过环境变量的,记得重启服务再验证,很多「改了没生效」都栽在这一步。

最后一条经验:不要相信截图和口口相传的旧值。要看当下的价格、规格、榜单数字,一律去站内对应页面核对,页面上的才是当时的值。

下一步先确认你的硬件能跑多大参数,再到工具目录挑一个顺手的界面,最后用速度测试给自己的机器留个底数。

常见问题

装完 Ollama 之后敲什么命令才能开始用?

顺序是:先确认服务在运行,再把模型下载到本地,最后运行模型进入对话。下载和运行是两个独立动作,只做前面那步是不会有反应的。具体命令写法以你当前版本的官方输出为准,模型名和可用列表到 /models 里按需挑一个先跑通。

为什么我拉模型特别慢,或者干脆卡住不动?

先分清是网络问题还是模型体积问题:体积大的模型下载本身就是几十分钟起步,看着像卡住其实在传。如果是网络侧的问题,换镜像源、换时段、或在有缓存的内网机器上先下好再迁移,都能绕开。判断方法到 /tools/speed-test 先量一条基线再下结论。

本地跑起来之后,能直接给别的程序当接口用吗?

可以,Ollama 起来后本身会提供一个本地接口,按默认端口调用即可。要注意的是默认只对本机开放,想让同网段其他机器或容器访问,得显式改绑定地址,同时想清楚暴露出去的安全后果。接口地址和常见连接失败的排查顺序参考 /ai-dict/category/infra。

本文依据各平台公开文档与官方公告整理,只做中文归纳;具体做法、参数与限制以官方文档为准。