Ubuntu 20.04 手动安装与配置 Ollama 本地服务

3. 配置系统服务

创建 /etc/systemd/system/ollama.service 配置文件。这里要注意环境变量 HOME 和 OLLAMA_MODELS 的路径匹配，否则服务启动后可能找不到模型。

[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"
ReadWritePaths=/usr/share/ollama/.ollama

[Install]
WantedBy=default.target

4. 启动服务

# 重载 systemd 配置
sudo systemctl daemon-reload

# 启用开机自启
sudo systemctl enable ollama

# 启动服务
sudo systemctl start ollama

# 检查状态
sudo systemctl status ollama

5. 创建命令快捷方式

为了让 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

常用模型

• Phi: 较小模型，适合测试
• Llama 2: 7B 参数，通用性强
• Code Llama: 编程专用
• Mistral: 平衡性能与速度

故障排除

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

修改后记得重新加载并重启服务：

sudo systemctl daemon-reload
sudo systemctl restart ollama

2. 权限问题

如果无法写入模型目录，检查目录权限：

ls -la /opt/ollama/
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

3. 端口冲突

默认监听 11434 端口。如果被占用，可以修改服务配置中的启动参数：

# 检查端口是否被占用
sudo ss -tlnp | grep ':11434'

# 如果被占用，修改 ExecStart 为：
# ExecStart=/opt/ollama/ollama serve --host 0.0.0.0:11435

4. 模型下载问题

国内网络环境下可能需要代理：

export https_proxy=http://your-proxy:port
ollama pull llama2

文件路径说明

卸载指南

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

注意事项

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

快速验证脚本

保存以下脚本为 ollama_quick_test.sh 并执行，可以快速检查安装状态：

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