介绍在 Ubuntu 20.04 LTS 系统上手动安装 Ollama 本地大模型服务的完整流程。涵盖系统架构确认、二进制包解压、systemd 服务配置、用户权限设置及命令快捷方式创建。包含常用模型运行指令、端口冲突排查、权限错误修复及卸载方法。适用于需要本地部署 AI 模型的开发者。
uname -m 确认输出为 x86_64 -m
从 Ollama GitHub Releases 下载最新版本：
ollama-linux-amd64.tar.gz 或 ollama-linux-x86_64.tar.gz注意：不要下载 ollama-linux-arm64.tar.gz（ARM 架构专用）
# 创建安装目录
sudo mkdir -p /opt/ollama
# 进入目录并解压（假设安装包在 ~/Downloads）
cd /opt/ollama
sudo tar -xzvf ~/Downloads/ollama-linux-amd64.tar.gz --strip-components=1
# 参数说明：`--strip-components=1` 会去掉压缩包内可能存在的顶层文件夹，直接提取文件。
# 为 Ollama 创建专用系统用户（安全考虑）
sudo useradd -r -s /bin/false -m -d /usr/share/ollama ollama
# 设置目录权限
sudo chown -R ollama:ollama /opt/ollama
# 1. 确保 Ollama 用户的 HOME 目录存在且有正确权限
sudo mkdir -p /usr/share/ollama
sudo chown -R ollama:ollama /usr/share/ollama
sudo chmod 755 /usr/share/ollama
# 2. 提前创建模型目录（避免后续权限问题）
sudo mkdir -p /usr/share/ollama/.ollama/models
sudo chown -R ollama:ollama /usr/share/ollama/.ollama
sudo chmod 755 /usr/share/ollama/.ollama
# 3. 确保 Ollama 主程序有执行权限
sudo chmod +x /opt/ollama/ollama
创建 /etc/systemd/system/ollama.service：
[Unit]
Description=Ollama Service
After=network-online.target
Wants=network-online.target
[Service]
Type=exec
User=ollama
Group=ollama
WorkingDirectory=/opt/ollama
ExecStart=/opt/ollama/ollama serve
Restart=always
RestartSec=3
Environment="HOME=/usr/share/ollama"
Environment="OLLAMA_MODELS=/usr/share/ollama/.ollama/models"
# 允许 Ollama 写入模型目录
ReadWritePaths=/usr/share/ollama/.ollama
[Install]
WantedBy=default.target
# 重载 systemd 配置
sudo systemctl daemon-reload
# 启用开机自启
sudo systemctl enable ollama
# 启动服务
sudo systemctl start ollama
# 检查状态
sudo systemctl status ollama
# 创建软链接，使 ollama 命令全局可用
sudo ln -sf /opt/ollama/ollama /usr/local/bin/ollama
# 验证安装
ollama --version
# 查看版本
ollama --version
# 列出已安装模型
ollama list
# 运行模型（首次运行会自动下载）
ollama run llama2
# 拉取模型但不运行
ollama pull llama2
# 删除模型
ollama rm llama2
# 较小模型，适合测试
ollama run phi
# Llama 2（7B 参数）
ollama run llama2
# Code Llama（编程专用）
ollama run codellama
# Mistral（平衡性能与速度）
ollama run mistral
常见错误：status=226/NAMESPACE
# 检查服务状态
sudo systemctl status ollama --no-pager -l
# 查看详细日志
sudo journalctl -u ollama -n 30 --no-pager
# 临时解决方案：简化服务配置
sudo tee /etc/systemd/system/ollama.service <<'EOF'
[Unit]
Description=Ollama Service
After=network.target
[Service]
Type=simple
User=ollama
Group=ollama
ExecStart=/opt/ollama/ollama serve
Restart=always
RestartSec=3
[Install]
WantedBy=multi-user.target
EOF
# 检查目录权限
sudo ls -la /opt/ollama/
sudo ls -la /usr/share/ollama/
# 重新设置权限
sudo chown -R ollama:ollama /opt/ollama
sudo chown -R ollama:ollama /usr/share/ollama
sudo chmod +x /opt/ollama/ollama
# 检查 11434 端口是否被占用
sudo ss -tlnp | grep :11434
# 如果被占用，修改服务配置中的启动参数：
# ExecStart=/opt/ollama/ollama serve --host 0.0.0.0:11435
# 检查模型目录
ls -la /usr/share/ollama/.ollama/models/
# 设置代理（如果需要）
export https_proxy=http://your-proxy:port
ollama pull llama2
| 路径 | 用途 | 默认权限 |
|---|---|---|
/opt/ollama/ | Ollama 主程序 | ollama:ollama |
/usr/share/ollama/.ollama/models/ | 模型存储位置 | ollama:ollama |
/etc/systemd/system/ollama.service | 服务配置文件 | root:root |
/usr/local/bin/ollama | 命令软链接 | root:root |
# 停止并禁用服务
sudo systemctl stop ollama
sudo systemctl disable ollama
# 删除服务文件
sudo rm /etc/systemd/system/ollama.service
sudo systemctl daemon-reload
# 删除安装目录
sudo rm -rf /opt/ollama
sudo rm -rf /usr/share/ollama/.ollama
# 删除系统用户
sudo userdel ollama 2>/dev/null
# 删除命令软链接
sudo rm -f /usr/local/bin/ollama
--host 参数修改/usr/share/ollama/.ollama/models/#!/bin/bash
# ollama_quick_test.sh
echo "1. 检查服务状态..."
sudo systemctl status ollama --no-pager | grep -E "(Active|Loaded|Main PID)"
echo -e "\n2. 检查端口监听..."
sudo ss -tlnp | grep 11434 || echo "端口未监听"
echo -e "\n3. 测试 API 连接..."
curl -s http://localhost:11434/api/tags || echo "API 连接失败"
echo -e "\n4. 测试命令行..."
ollama --version && echo "Ollama 命令正常" || echo "命令异常"
保存为脚本并执行：
chmod +x ollama_quick_test.sh
./ollama_quick_test.sh
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online