Обновление версии Ollama и миграция

Как безопасно обновить Ollama, перенести библиотеку моделей на новый диск или новый компьютер, а также создать резервную копию и восстановить пользовательские модели.

Сделайте эти три вещи правильно — и ваши локальные ресурсы моделей действительно будут принадлежать вам, не завися от любых изменений оборудования или версий.


Безопасное обновление: стратегия перед действием

Само обновление простое; сложная часть — «не напортачить». Рекомендуемая трёхэтапная стратегия обновления:

Шаг 1: проверьте примечания к выпуску. В примечаниях к выпуску будут описаны новые функции, исправления и известные проблемы, особенно поддержка моделей и изменения интерфейса.

Шаг 2, создайте резервную копию критически важных ресурсов: экспортируйте используемые рецепты пользовательских моделей (см. метод ниже) и подтвердите расположение каталога моделей.

Шаг 3, протестируйте перед развёртыванием: для продакшен-серверов сначала проверьте обновление на тестовой машине, затем разверните в более широком масштабе.

ПлатформаСпособ обновления
macOS / WindowsАвтоматически загружать обновления, нажмите "Перезапустить для обновления" в строке меню или системном трее
Linux (установка скриптом)Повторно запустите официальный установочный скрипт
Linux (ручная установка)Сначала удалите старый каталог библиотеки, затем распакуйте новый пакет
DockerПосле получения нового образа пересоберите контейнер; том данных сохраняет все модели

Если вы столкнётесь с проблемами совместимости и вам нужно откатиться или вы хотите попробовать предрелизную версию, используйте переменную номера версии для точного контроля, установите указанную версию (см. номера версий в GitHub Releases):

curl -fsSL https://ollama.com/install.sh | OLLAMA_VERSION=0.5.7 sh

Предрелизные версии также устанавливаются через номера версий.

Перед ручным обновлением в Linux сначала удалите старый каталог библиотеки (sudo rm -rf /usr/lib/ollama); смешивание старых и новых библиотек инференса — причина номер один "странного поведения после обновления".


Миграция библиотеки моделей: смена дисков и машин

Модели часто занимают десятки ГБ; суть миграции — всего одно предложение: переместите каталог моделей в другое место, затем укажите Ollama, где находится новое расположение.

迁移三步:导出备份、迁移数据、验证

Сценарий 1: замена диска на той же машине

Пример

# 1. После остановки службы переместите весь каталог моделей на новый диск
sudo mv /usr/share/ollama/.ollama/models /data/ollama-models

# 2. Укажите новое расположение в переменной окружения (см. главу по конфигурации для трёх способов настройки на платформах)
OLLAMA_MODELS=/data/ollama-models ollama serve

# 3. Стандартная установка Linux требует передачи прав владения пользователю ollama
sudo chown -R ollama:ollama /data/ollama-models

Сценарий 2: Миграция на новую машину

Пример

# Старая машина: упакуйте весь каталог моделей (включая blobs и manifests)
tar czf models-backup.tar.gz -C ~/.ollama models

# Новая машина: установите ту же версию Ollama, затем распакуйте в соответствующее расположение
mkdir -p ~/.ollama
tar xzf models-backup.tar.gz -C ~/.ollama

# Убедитесь, что список моделей полный
ollama list

Две детали определяют успех или провал миграции: версия Ollama на новой машине должна по возможности совпадать со старой машиной; структуру blobs и manifests в каталоге models нужно сохранять как есть, не копируйте только отдельные файлы моделей.


Резервное копирование и восстановление пользовательских моделей

У пользовательских моделей (продуктов, собранных из Modelfile) есть два способа резервного копирования; рекомендуется сделать оба.

Способ 1: Экспорт рецепта в Git

Пример

# Экспорт полного рецепта модели
ollama show --modelfile example-coder > example-coder.modelfile

Обратите внимание на одну деталь: строка FROM в экспортированном рецепте указывает на путь к локальному blob-файлу, поэтому её нельзя использовать напрямую после смены машины. При восстановлении измените FROM обратно на имя базовой модели (например, FROM qwen3.5:9b) и пересоберите.

Пример

# После изменения FROM пересоберите, и рецепт восстановлен
ollama create example-coder -f example-coder.modelfile

Способ 2: Отправка в библиотеку моделей для облачного резервного копирования

Пример

# Скопируйте в имя с пространством имён, затем отправьте (для приватной публикации см. главу о командном развёртывании)
ollama cp example-coder myteam/example-coder:v1
ollama push myteam/example-coder:v1

Рекомендуемая организация: поместите все Modelfiles в один репозиторий Git для управления в сочетании со скриптом для пересборки окружения с нуля — оборудование будет заменено, системы будут переустановлены, но с имеющимися рецептами все пользовательские модели можно восстановить за десять минут.

Другие расширения