ollama-updater

带断点续传功能的 Ollama 安装/更新工具，解决网络不稳定导致的下载中断问题。

功能

• ✅ 断点续传: 使用 curl -C - 实现下载中断后继续下载
• ✅ 自动重试: 下载失败自动重试 3 次
• ✅ 进度显示: 实时显示下载进度
• ✅ 智能清理: 自动清理旧版本
• ✅ GPU 支持: 自动检测并安装 NVIDIA/AMD GPU 驱动

安装

# 使用 OpenClaw
openclaw skills install ollama-updater

# 或使用 ClawHub
clawhub install ollama-updater

使用方法

基本用法

ollama-updater

指定版本

OLLAMA_VERSION=0.5.7 ollama-updater

手动运行

# 直接运行脚本
bash /path/to/ollama-updater/main.py

# 或使用 sudo
sudo bash /path/to/ollama-updater/main.py

断点续传原理

使用 curl 的 -C - 参数实现断点续传：

# 普通下载（中断后需要从头开始）
curl -O https://example.com/file.tar.gz

# 断点续传（中断后可以继续）
curl -C - -O https://example.com/file.tar.gz

如果下载中断，只需重新运行命令，curl 会自动从断点处继续下载。

故障排查

下载总是中断

原因: 网络不稳定或服务器限速

解决:

1. 多次运行脚本，会自动从断点续传
2. 使用国内镜像（如有）
3. 检查网络连接

提示 zstd 错误

原因: 需要 zstd 解压工具

解决:

# Debian/Ubuntu
sudo apt-get install zstd

# RHEL/CentOS/Fedora
sudo dnf install zstd

# Arch
sudo pacman -S zstd

权限错误

原因: 需要 sudo 权限

解决:

sudo ollama-updater

与官方脚本的区别

| 功能 | 官方脚本 | ollama-updater |

|------|---------|----------------|

| 断点续传 | ❌ | ✅ |

| 自动重试 | ❌ | ✅ (3 次) |

| 进度显示 | ✅ | ✅ |

| GPU 检测 | ✅ | ✅ |

| systemd 配置 | ✅ | ✅ |

技术细节

断点续传实现

download_file() {
    local url="$1"
    local output="$2"
    local max_retries=3
    local retry_count=0
    
    while [ $retry_count -lt $max_retries ]; do
        retry_count=$((retry_count + 1))
        
        # 使用 -C - 实现断点续传
        if curl --fail --show-error --location --progress-bar -C - -o "$output" "$url"; then
            return 0
        fi
        
        if [ $retry_count -lt $max_retries ]; then
            sleep 5
        fi
    done
    
    error "Download failed after $max_retries attempts"
}

下载流程

1. 检查是否需要断点续传（已有部分文件）
2. 使用 curl -C - 继续下载
3. 下载失败自动重试（最多 3 次）
4. 下载成功后验证并解压

系统要求

• Linux (x86_64, aarch64)
• macOS (x86_64, aarch64)
• curl (必需)
• zstd (新版 Ollama 需要)
• sudo (系统级安装需要)

文件结构

ollama-updater/
├── main.py              # 主程序（包装官方脚本）
├── ollama-install.sh    # 改进的安装脚本
├── SKILL.md             # 技能说明
├── README.md            # 使用指南
└── package.json         # 包信息

版本历史

v1.0.0 (2026-02-20)

• 初始版本
• 添加断点续传功能
• 添加自动重试机制
• 保留官方脚本所有功能

许可证

MIT License

支持

如有问题，请提交到：https://github.com/openclaw/skills/issues