Ubuntu 20.04 手动安装 Ollama 指南
Ubuntu 20.04 手动安装 Ollama 指南
系统要求
- 操作系统：Ubuntu 20.04 LTS 或更高版本
- 架构：x86_64 (AMD64) - 通过
uname -m确认输出为x86_64 - 权限：需要 sudo 权限
1. 下载安装包
确认系统架构
uname -m # 应输出: x86_64# 如果输出 aarch64/arm64，需下载ARM版本下载地址
从 Ollama GitHub Releases 下载最新版本：
- 选择
ollama-linux-amd64.tar.gz或ollama-linux-x86_64.tar.gz
注意：不要下载 ollama-linux-arm64.tar.gz（ARM架构专用）
2. 安装步骤
2.1 创建安装目录并解压
# 创建安装目录sudomkdir -p /opt/ollama # 进入目录并解压（假设安装包在 ~/Downloads）cd /opt/ollama sudotar -xzvf ~/Downloads/ollama-linux-amd64.tar.gz --strip-components=1# 参数说明：`--strip-components=1` 会去掉压缩包内可能存在的顶层文件夹，直接提取文件。2.2 创建系统用户
# 为Ollama创建专用系统用户（安全考虑）sudouseradd -r -s /bin/false -m -d /usr/share/ollama ollama # 设置目录权限sudochown -R ollama:ollama /opt/ollama # 1. 确保Ollama用户的HOME目录存在且有正确权限sudomkdir -p /usr/share/ollama sudochown -R ollama:ollama /usr/share/ollama sudochmod755 /usr/share/ollama # 2. 提前创建模型目录（避免后续权限问题）sudomkdir -p /usr/share/ollama/.ollama/models sudochown -R ollama:ollama /usr/share/ollama/.ollama sudochmod755 /usr/share/ollama/.ollama # 3. 确保Ollama主程序有执行权限sudochmod +x /opt/ollama/ollama 2.3 配置系统服务
创建 /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 2.4 启动服务
# 重载systemd配置sudo systemctl daemon-reload # 启用开机自启sudo systemctl enable ollama # 启动服务sudo systemctl start ollama # 检查状态sudo systemctl status ollama 2.5 创建命令快捷方式
# 创建软链接，使ollama命令全局可用sudoln -sf /opt/ollama/ollama /usr/local/bin/ollama # 验证安装 ollama --version 3. 使用指南
3.1 基本命令
# 查看版本 ollama --version # 列出已安装模型 ollama list # 运行模型（首次运行会自动下载） ollama run llama2 # 拉取模型但不运行 ollama pull llama2 # 删除模型 ollama rm llama2 3.2 常用模型
# 较小模型，适合测试 ollama run phi # Llama 2（7B参数） ollama run llama2 # Code Llama（编程专用） ollama run codellama # Mistral（平衡性能与速度） ollama run mistral 4. 故障排除
4.1 服务启动失败
常见错误：status=226/NAMESPACE
# 检查服务状态sudo systemctl status ollama --no-pager -l # 查看详细日志sudo journalctl -u ollama -n 30 --no-pager # 临时解决方案：简化服务配置sudotee /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 EOF4.2 权限问题
# 检查目录权限sudols -la /opt/ollama/ sudols -la /usr/share/ollama/ # 重新设置权限sudochown -R ollama:ollama /opt/ollama sudochown -R ollama:ollama /usr/share/ollama sudochmod +x /opt/ollama/ollama 4.3 端口冲突
# 检查11434端口是否被占用sudo ss -tlnp |grep :11434 # 如果被占用，修改服务配置中的启动参数：# ExecStart=/opt/ollama/ollama serve --host 0.0.0.0:114354.4 模型下载问题
# 检查模型目录ls -la /usr/share/ollama/.ollama/models/ # 设置代理（如果需要）exporthttps_proxy=http://your-proxy:port ollama pull llama2 5. 文件路径说明
| 路径 | 用途 | 默认权限 |
|---|---|---|
/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 |
6. 卸载指南
# 停止并禁用服务sudo systemctl stop ollama sudo systemctl disable ollama # 删除服务文件sudorm /etc/systemd/system/ollama.service sudo systemctl daemon-reload # 删除安装目录sudorm -rf /opt/ollama sudorm -rf /usr/share/ollama/.ollama # 删除系统用户sudouserdel ollama 2>/dev/null # 删除命令软链接sudorm -f /usr/local/bin/ollama 7. 注意事项
- 首次运行模型会下载模型文件（数GB大小），请确保磁盘空间充足
- 默认端口：11434，可通过
--host参数修改 - 模型存储：默认存储在
/usr/share/ollama/.ollama/models/ - 内存要求：7B模型约需14GB RAM，3B模型约需6GB RAM
- GPU支持：如需GPU加速，确保已安装NVIDIA驱动和CUDA
8. 快速验证脚本
#!/bin/bash# ollama_quick_test.shecho"1. 检查服务状态..."sudo systemctl status ollama --no-pager |grep -E "(Active|Loaded|Main PID)"echo -e "\n2. 检查端口监听..."sudo ss -tlnp |grep11434||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 最后更新：根据实际安装经验整理，已解决 status=226/NAMESPACE 权限错误问题。
