Ubuntu 20.04 手动安装 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 命令全局可用
sudo ln -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
# 临时解决方案：简化服务配置
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

4.2 权限问题

# 检查目录权限
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

4.3 端口冲突

# 检查 11434 端口是否被占用
sudo ss -tlnp | grep :11434
# 如果被占用，修改服务配置中的启动参数：
# ExecStart=/opt/ollama/ollama serve --host 0.0.0.0:11435

4.4 模型下载问题

# 检查模型目录
ls -la /usr/share/ollama/.ollama/models/
# 设置代理（如果需要）
export https_proxy=http://your-proxy:port
ollama pull llama2

5. 文件路径说明

6. 卸载指南

# 停止并禁用服务
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

7. 注意事项

1. 首次运行模型会下载模型文件（数 GB 大小），请确保磁盘空间充足
2. 默认端口：11434，可通过 --host 参数修改
3. 模型存储：默认存储在 /usr/share/ollama/.ollama/models/
4. 内存要求：7B 模型约需 14GB RAM，3B 模型约需 6GB RAM
5. GPU 支持：如需 GPU 加速，确保已安装 NVIDIA 驱动和 CUDA

8. 快速验证脚本

#!/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