核心用法
ollama-updater 是专为网络不稳定环境设计的 Ollama 安装/更新工具，通过包装官方安装脚本，核心解决大模型文件下载易中断的痛点。用户只需运行 ollama-updater 即可自动完成下载、断点续传、重试及安装全流程。支持通过 OLLAMA_VERSION 环境变量指定特定版本，满足开发测试需求。
显著优点
1. 断点续传能力：基于 curl -C - 实现，下载中断后可从断点继续，避免数 GB 文件重复下载，对国内弱网环境极为关键
2. 自动容错机制：内置 3 次自动重试，每次失败后延迟 5 秒再试，大幅降低人工干预
3. 零功能损失：完整保留官方脚本的 GPU 自动检测、systemd 配置、进度显示等全部能力
4. 多平台支持：覆盖 Linux x86_64/aarch64 及 macOS 双架构
5. 智能维护：自动清理旧版本，减少磁盘占用
潜在缺点与局限性
1. 依赖外部工具：必须预装 curl 和 zstd（新版必需），部分精简系统可能缺失
2. 权限要求：系统级安装需 sudo，无法做到完全用户态安装
3. 非官方维护：由第三方社区维护，版本更新可能滞后于官方
4. Python 包装层：主程序为 Python 脚本 wrapper，存在轻微的额外依赖和性能开销
5. 无镜像源内置：需用户手动配置国内镜像，未提供开箱即用的镜像切换
适合人群
- 国内开发者：网络条件不稳定，官方脚本频繁下载失败
- CI/CD 场景：需要可靠、可自动恢复的安装流程
- 边缘设备部署：网络质量差的 IoT/工控环境
- 大模型运维：频繁重装/更新 Ollama 的 MLOps 工程师
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 供应链风险 | 第三方包装官方脚本，存在篡改可能 | 审查 `ollama-install.sh` 内容后再执行 |
| 权限提升风险 | 需 sudo 执行系统级安装 | 仅在可信环境使用 sudo，可考虑容器化部署 |
| 网络中间人 | curl 下载过程可能被劫持 | 校验官方签名或 HTTPS 证书 pinning |
| 版本兼容 | 未来 Ollama 官方脚本变更可能导致不兼容 | 关注版本更新日志，锁定已知工作版本 |
整体而言，ollama-updater 是对官方安装体验的有效补强，特别适合网络基础设施薄弱的场景，但建议生产环境使用前审查脚本源码并建立私有镜像。