跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像AI 生图工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashAI算法

本地部署大模型 Ollama 安装与使用教程

Ollama 是一款支持本地运行大语言模型的开源工具。在 Windows 和 Linux 系统下安装 Ollama 的方法,包括下载官方安装包或执行安装脚本。内容涵盖模型下载命令、命令行交互模式、多行文本输入技巧以及常见环境依赖问题的解决。此外,补充了通过 API 调用模型的基本示例,帮助用户快速实现本地大模型的私有化部署与应用开发。

moshang发布于 2025/2/6更新于 2026/7/2147 浏览
本地部署大模型 Ollama 安装与使用教程

Ollama 本地部署大模型指南

Ollama 是一个开源工具,允许用户在本地计算机上轻松运行大型语言模型(LLM)。它支持 Windows、macOS 和 Linux 系统,无需复杂的配置即可启动对话。本文将详细介绍在不同操作系统下的安装步骤、模型管理、命令行交互以及 API 调用方法。

Windows 安装步骤

  1. 下载客户端 访问 Ollama 官方网站 (https://ollama.com),在 Windows 平台页面点击 Download 按钮下载安装程序。

  2. 执行安装 运行下载的安装包,按照向导提示完成安装。默认安装路径为 C 盘,请确保磁盘空间充足(建议预留至少 10GB 以上空间用于模型存储)。

  3. 验证安装 安装完成后,打开 Windows PowerShell 或 CMD,输入以下命令:

    ollama --version
    

    若显示版本号信息,则说明环境变量配置成功且安装无误。

  4. 环境依赖 纯净版 Windows 系统可能缺少 VC++ 运行库。如果遇到报错,请前往微软官网下载并安装 Visual C++ Redistributable 组件。

Linux 安装步骤

对于 Debian/Ubuntu 等 Linux 发行版,推荐使用官方提供的安装脚本。

  1. 执行安装脚本 在终端中复制并运行以下命令:

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

    该脚本会自动检测系统架构并下载对应的二进制文件。

  2. 验证服务 安装结束后,检查 Ollama 服务状态:

    systemctl status ollama
    

    确认服务正在运行后,可通过 ollama 命令测试。

  3. Docker 部署(可选) 如需容器化部署,可使用 Docker 镜像:

    docker run -d -v ollama:/root/.ollama -p 11434:11434 --name ollama ollama/ollama
    

模型下载与运行

Ollama 采用拉取模式,首次使用时会自动下载模型权重。

  1. 运行模型 在命令行中输入以下格式指令:

    ollama run <模型名称>
    

    例如,运行 Gemma 2B 模型:

    ollama run gemma:2b
    

    系统将自动从仓库拉取模型文件,下载完成后进入对话界面。

  2. 常用模型推荐

    • llama3: Meta 最新开源模型,性能均衡。
    • mistral: 高效的小型模型,适合低资源环境。
    • wizardlm: 擅长复杂推理任务。

命令行交互方式

单行对话

直接输入问题并按回车键,模型将返回回答。

多行文本输入

若需发送包含换行的长文本或代码块,请使用双引号包裹内容:

"""
在此处输入多行文本
第一行
第二行
"""

或者在 PowerShell 中使用反引号进行续行。

退出与帮助

  • 输入 /bye 或按 Ctrl + D 退出当前会话。
  • 输入 /help 查看可用命令列表。

常见问题排查

  1. 端口冲突 Ollama 默认监听 11434 端口。如果端口被占用,可修改配置文件或使用其他端口。

  2. 显存不足 运行大模型时若显存溢出,可尝试加载量化版本(如 :7b-q4_0),减少内存占用。

  3. 网络延迟 国内用户下载模型较慢,建议配置代理或等待后台下载完成。

API 调用示例

Ollama 提供 REST API 接口,便于集成到应用程序中。

  1. 启动服务 确保 Ollama 已在后台运行(通常安装后自动启动)。

  2. 发送请求 使用 curl 命令调用 API:

    curl http://localhost:11434/api/generate -d '{
      "model": "llama3",
      "prompt": "你好,请介绍一下你自己。"
    }'
    
  3. Python 调用 使用 Python 的 requests 库:

    import requests
    
    response = requests.post(
        'http://localhost:11434/api/generate',
        json={
            'model': 'llama3',
            'prompt': 'Hello, how are you?',
            'stream': False
        }
    )
    print(response.json()['response'])
    

通过上述步骤,您可以快速搭建本地大模型环境,实现数据隐私保护下的 AI 应用开发。

目录

  1. Ollama 本地部署大模型指南
  2. Windows 安装步骤
  3. Linux 安装步骤
  4. 模型下载与运行
  5. 命令行交互方式
  6. 单行对话
  7. 多行文本输入
  8. 退出与帮助
  9. 常见问题排查
  10. API 调用示例
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 默认安全治理实践:水平越权检测与前端安全防控
  • Rust 异步代码测试与调试实战指南
  • LeetCode 390 消除游戏 Swift 算法解析
  • 具身智能与视觉:机器人如何“看懂”世界?
  • 具身机器人的软件系统架构
  • Ubuntu 24.04 下使用 Docker Compose 本地部署 Whisper 服务
  • 基于 Dify 工作流的自动化内容生成与分发引擎架构
  • 基于 Leaflet 和天地图的长沙免费运动场所 WebGIS 可视化
  • 企业大模型集成私有数据构建知识库实战指南
  • Claude Code 本地环境配置与使用指南
  • Qwen-Image-Edit-2511 模型本地部署与功能特性分析
  • 常用国内 Python 镜像站地址及 pip 配置指南
  • Python + Linux 构建高可用数据采集服务
  • DeepSeek-R1-Distill-Llama-8B 在 Ollama Web UI 中的提示模板配置指南
  • 谷歌 Bard 更新:支持内网搜索及日程安排
  • Linux 初识线程
  • OmniSteward:基于大语言模型的智能家居与电脑控制工具
  • SpringBoot 整合 LangChain4j AIService 深度使用详解
  • 数据结构:二叉树遍历与实现
  • 金仓 SQL 防火墙落地指南:学习、警告、阻断三步配置

相关免费在线工具

  • 加密/解密文本

    使用加密算法(如AES、TripleDES、Rabbit或RC4)加密和解密文本明文。 在线工具,加密/解密文本在线工具,online

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Gemini 图片去水印

    基于开源反向 Alpha 混合算法去除 Gemini/Nano Banana 图片水印,支持批量处理与下载。 在线工具,Gemini 图片去水印在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online