Как безопасно изменить каталог моделей Ollama

Укажите новый каталог в переменной среды OLLAMA_MODELS, скопируйте туда текущее хранилище моделей, перезапустите Ollama и подтвердите работу известной модели. Сохраняйте старый каталог, пока новое расположение не пройдёт эту проверку и новый перезапуск.

До перемещения найдите активное хранилище

Стандартное расположение моделей Ollama зависит от операционной системы: ~/.ollama/models в macOS, /usr/share/ollama/.ollama/models для стандартной службы Linux и C:\Users\%username%\.ollama\models в Windows. Существующее значение OLLAMA_MODELS переопределяет эти пути.

Проверьте среду процесса, прежде чем считать стандартный путь активным. Также убедитесь, что в месте назначения достаточно свободного места для временной второй копии. Если перемещение начинается с удаления исходника, чистого отката не будет, когда обнаружится ошибка в разрешениях, конфигурации службы или пути.

Скопируйте каталог, не меняя внутреннюю структуру

Остановите активные загрузки и запуски моделей, затем скопируйте содержимое текущего каталога моделей в место назначения. Сохраните структуру каталогов и имена файлов. Хранилище Ollama — не папка с понятными именами моделей, которую следует реорганизовать вручную; манифесты ссылаются на блобы содержимого внутри этой структуры.

# Примеры мест назначения — выберите реальный путь на своём компьютере
/Volumes/AI-Library/Ollama/models       # macOS
/mnt/ai-library/ollama/models           # Linux
D:\AI-Library\Ollama\models             # Windows

Используйте обычный инструмент копирования платформы, а затем сравните число файлов или хеши. Не указывайте службе наполовину скопированное место назначения, пока копия продолжает меняться.

Установите OLLAMA_MODELS там, где процесс Ollama сможет её прочитать

Переменная должна находиться в среде приложения или службы Ollama, а не только в окне терминала, которое вы затем закроете.

• Приложение macOS: завершите Ollama, выполните launchctl setenv OLLAMA_MODELS "/Volumes/AI-Library/Ollama/models" и снова откройте приложение. В официальном FAQ указано, что приложение наследует переменные среды через launchctl.
• Служба systemd в Linux: выполните systemctl edit ollama.service, добавьте Environment="OLLAMA_MODELS=/mnt/ai-library/ollama/models" в [Service], затем перезагрузите systemd и перезапустите Ollama.
• Приложение Windows: завершите Ollama на панели задач, добавьте пользовательскую переменную среды с именем OLLAMA_MODELS в параметрах Windows и снова запустите приложение.

В Linux стандартный установщик запускает службу от пользователя ollama. Поэтому официальные рекомендации требуют предоставить этому пользователю чтение и запись в месте назначения; пример — sudo chown -R ollama:ollama <directory>. Выберите разрешения, подходящие системе, вместо предоставления библиотеке записи для всех.

Проверьте место назначения, а не доверяйте настройке

1. Полностью перезапустите Ollama.
2. Запустите ollama list и подтвердите наличие известной модели.
3. Запустите эту модель с небольшим промптом, затем завершите её обычным способом.
4. Загрузите небольшую модель или проверьте активность изменений, чтобы подтвердить поступление новых данных в место назначения.
5. Перезапустите ещё раз и повторите проверку известной модели.

Если список неожиданно пуст, остановитесь. Снова проверьте переменную в среде службы, владельца каталога и не скопировано ли содержимое в лишнюю вложенную папку models. Восстановление прежнего значения среды должно немедленно вернуть старый путь в работу.

Перемещение хранилища — не то же самое, что его сохранение

Новый каталог может решить проблему ёмкости или расположения, но всё равно остаётся активным хранилищем среды. Случайное удаление, сбой файловой системы или чрезмерная очистка могут затронуть единственную копию. Поддерживайте отдельную стратегию восстановления моделей, которые нельзя позволить себе загрузить, создать или обучить заново.

Tensor Archive полезен после того, как вы можете назвать связанные файлы, которые намерены сохранить. Заархивируйте завершённое локальное семейство, проверьте его и восстановите в отдельное место, прежде чем считать рабочую копию расходной. Приложение не заменяет OLLAMA_MODELS, не изменяет службу и не выдаёт изменение пути за резервную копию.

Что читать дальше

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