3分钟上手Ollama：全平台安装与配置教程
项目地址: https://gitcode.com/datawhalechina/handy-ollama 🔥 还在为GPU资源发愁？本地部署大模型原来这么简单！
你是否曾因没有高端GPU而放弃体验大模型？是否想在本地安全运行AI而不依赖云端？现在，这些问题都能通过Ollama解决！作为一款轻量级大模型管理工具，Ollama让普通电脑也能流畅运行Llama 3、Qwen等主流模型，支持Windows/macOS/Linux全平台，甚至可用Docker一键部署。本文将带你3分钟完成安装，5分钟启动第一个本地大模型，彻底打破硬件限制！
读完本文你将获得：
- 4大操作系统的极速安装指南
- 环境变量优化配置方案
- 安全加固的5个关键步骤
- 常见问题的10分钟排查技巧
- 从零到一的模型运行实例
📋 全平台安装概览
| 系统类型 | 安装难度 | 耗时 | 核心命令 | 适用场景 |
|---|---|---|---|---|
| Windows 10/11 | ⭐⭐ | 3分钟 | OllamaSetup.exe | 个人PC用户 |
| macOS 12+ | ⭐ | 2分钟 | ollama run qwen2:0.5b | 苹果生态开发者 |
| Linux (Ubuntu) | ⭐⭐⭐ | 5分钟 | curl -fsSL https://ollama.com/install.sh \| sh | 服务器部署 |
| Docker | ⭐⭐ | 4分钟 | docker run -d -p 11434:11434 ollama/ollama | 多环境隔离 |
💻 Windows系统安装指南
1. 快速安装
# 1. 访问官网下载安装包
# 2. 双击OllamaSetup.exe，点击Install
# 3. 等待自动完成安装
2. 关键环境变量配置
按Win+R输入sysdm.cpl打开系统属性，添加以下环境变量：
| 变量名 | 推荐值 | 作用说明 |
|---|---|---|
| OLLAMA_MODELS | E:\ollama\models | 更改模型存储路径（避免C盘占用） |
| OLLAMA_HOST | 127.0.0.1:11434 | 限制本地访问提高安全性 |
| OLLAMA_KEEP_ALIVE | 24h | 模型驻留内存24小时提升响应速度 |
3. 验证与启动
# 验证安装
ollama -v
# 启动轻量级模型（首次运行会自动下载）
ollama run qwen2:0.5b
# 交互示例
>>> 你好
>>> 你好！我是由阿里巴巴开发的AI助手Qwen，很高兴为你服务。有什么我可以帮助你的吗？
🍎 macOS系统安装指南
1. 安装步骤
# 1. 下载安装包
curl -O https://ollama.com/download/Ollama-darwin.zip
# 2. 解压并移动到应用程序
unzip Ollama-darwin.zip
mv Ollama.app /Applications/
# 3. 启动应用
open /Applications/Ollama.app
2. 命令行快速启动
# 安装完成后在终端直接运行
ollama run llama3:8b
# 如需后台运行服务
nohup ollama serve > ollama.log 2>&1 &
3. 可视化界面推荐
推荐安装开源客户端Enchanted（App Store搜索即可），自动连接本地Ollama服务，支持对话历史和模型切换。
🐧 Linux系统安装指南
1. 一键安装脚本（推荐）
# 适用于Ubuntu/Debian系统
curl -fsSL https://ollama.com/install.sh | sh
# 适用于CentOS/RHEL系统
yum install -y curl
curl -fsSL https://ollama.com/install.sh | sh
2. 手动安装（高级用户）
# AMD64架构
curl -L https://ollama.com/download/ollama-linux-amd64.tgz -o ollama-linux-amd64.tgz
sudo tar -C /usr -xzf ollama-linux-amd64.tgz
# 创建系统服务
sudo useradd -r -s /bin/false -U -m -d /usr/share/ollama ollama
sudo usermod -a -G ollama $USER
# 配置服务文件
sudo tee /etc/systemd/system/ollama.service <<EOF
[Unit]
Description=Ollama Service
After=network-online.target
[Service]
ExecStart=/usr/bin/ollama serve
User=ollama
Group=ollama
Restart=always
RestartSec=3
[Install]
WantedBy=default.target
EOF
# 启动服务
sudo systemctl daemon-reload
sudo systemctl enable --now ollama
3. 验证安装
# 查看服务状态
systemctl status ollama
# 运行模型测试
ollama run phi3
🐳 Docker容器化部署
1. 快速启动
# CPU版本
docker run -d -v ollama:/root/.ollama -p 11434:11434 --name ollama ollama/ollama
# 进入容器交互
docker exec -it ollama /bin/bash
ollama run llama3
2. 持久化配置
# 创建本地数据卷
mkdir -p /data/ollama/models
# 带数据持久化启动
docker run -d \
-v /data/ollama/models:/root/.ollama/models \
-p 11434:11434 \
--name ollama \
--restart always \
ollama/ollama
🔒 安全加固必须做的5件事
- 限制网络访问
# Windows防火墙设置只允许本地访问11434端口
# Linux配置防火墙
sudo ufw allow 11434/tcp
sudo ufw allow from 192.168.1.0/24 to any port 11434
- 修改默认环境变量
# 设置仅本地访问
export OLLAMA_HOST=127.0.0.1:11434
# 限制请求来源
export OLLAMA_ORIGINS=http://localhost:3000,http://127.0.0.1:5500
- 定期更新版本
# Linux更新命令
curl -fsSL https://ollama.com/install.sh | sh
# Docker更新
docker pull ollama/ollama
docker stop ollama && docker rm ollama
docker run -d -p 11434:11434 ollama/ollama
- 监控服务状态
# Linux查看日志
journalctl -u ollama -f
# Windows查看日志
Get-Content -Path "C:\Users\%username%\.ollama\logs\ollama.log" -Tail 100 -Wait
- 设置资源限制
# Docker启动时限制资源
docker run -d \
--memory=8g \
--cpus=4 \
-p 11434:11434 \
ollama/ollama
🚀 下一步：开启你的本地AI之旅
安装完成后，推荐尝试这些实用场景：
- 代码助手：
ollama run codellama - 文档理解：结合LangChain搭建本地RAG
- 多轮对话：使用Enchanted等客户端保存对话历史
收藏本文，关注项目更新：https://gitcode.com/datawhalechina/handy-ollama
下一篇：《10分钟搭建本地知识库：Ollama+LangChain实战》
如果安装过程遇到问题，欢迎在评论区留言，我们将优先解答点赞最高的问题！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
