On Premise#
On Premise позволяет твоему корпоративному рабочему пространству использовать наборы данных и вычислительные ресурсы на компьютере с Linux, macOS или Windows. Исходные изображения и видео остаются на твоем компьютере. Обучение работает так же, как и в любом другом месте для удаленного обучения: метрики передаются в Platform, а веса обученной модели загружаются для скачивания, предсказания, экспорта и развертывания.
Настройка занимает одну команду. Платформа определяет твою операционную систему, заполняет подходящие пути к папкам, устанавливает Docker, если это необходимо, и показывает прогресс подключения в реальном времени.
Как это работает#
flowchart LR
A[Your browser] <-->|Interface, labels, and progress| B[Ultralytics Platform]
A <-->|Dataset previews| C[Your On Premise computer]
B <-->|Jobs, metrics, and model weights| C
C --- D[(Dataset folder)]
C --- E[(Models folder)]Границы данных#
| Данные | Твой компьютер On Premise | Platform и облачные сервисы |
|---|---|---|
| Пиксели исходного и производного набора данных | Оставайся локально для загрузки, просмотра и обучения | Никогда не хранятся, не регистрируются и не обрабатываются |
| Классы, метки и аннотации | Исходные метки считываются во время загрузки | Сохраняются как канонические метаданные набора данных, чтобы ты мог аннотировать их в Platform |
| Обучение моделей | Запуск, лучшая контрольная точка (checkpoint) и другие артефакты обучения записываются в твою папку моделей | Лучшая контрольная точка загружается для скачивания, предсказания, экспорта и развертывания; остальные артефакты остаются на твоем компьютере |
Веса моделей, метки, аннотации и метрики могут содержать информацию, полученную из твоих изображений. Только пиксели набора данных имеют строгую локальную границу. Облачное предсказание обрабатывает только изображения, которые ты отдельно отправляешь в этот облачный рабочий процесс; воркер никогда не пересылает изображение из твоего подключенного набора данных.
Перед началом#
Выбери компьютер на базе Linux, Mac с процессором Apple silicon или 64-битную систему Windows, которая может получать доступ к твоим датасетам и оставаться во включенном состоянии во время их использования Platform. Выдели достаточно свободного места на диске для датасетов, запусков моделей и образов Docker, а также убедись, что компьютер может устанавливать исходящие соединения HTTPS.
GPU не обязателен. Любой компьютер может обрабатывать наборы данных и обучать модели на своем CPU. Совместимый NVIDIA GPU может ускорить выполнение более крупных задач обучения.
Если в твоей компании ограничен исходящий трафик, перед настройкой разреши HTTPS-доступ к Ultralytics Platform, реестрам Docker и загрузкам пакетов Python.
Подключи свой компьютер#
- Открой Ultralytics Platform на компьютере, имеющем доступ к твоим наборам данных.
- Перейди в раздел
Settings > Integrationsи выбери On Premise из списка интеграций. - Проверь предварительно заполненные пути Dataset folder on this machine и Models folder on this machine.
- Нажми Создать команду установки.
- Открой терминал, указанный в диалоговом окне, скопируй команду, вставь ее и нажми Enter.
- Не закрывай страницу интеграций, пока индикатор выполнения не покажет статус Connected.

Платформа заполняет папки и одноразовый токен подключения перед тем, как ты скопируешь команду. Сгенерированная команда следует приведенному ниже формату:
Открой Терминал и вставь:
curl -fsSL 'https://platform.ultralytics.com/api/workers/install?os=linux' \
| sudo sh -s -- \
"/datasets" \
"/models" \
"YOUR_CONNECTION_TOKEN"Платформа автоматически включает токен подключения. Он подтверждает, что этот компьютер имеет право подключаться к твоему рабочему пространству, истекает через 10 минут и работает один раз. Тебе не нужно вводить его отдельно. Не делись сгенерированной командой, пока она действительна.
Стандартные настройки работают без изменений:
| Linux | macOS и Windows | |
|---|---|---|
| Папка с наборами данных | /datasets | ~/Ultralytics/datasets |
| Папка с моделями | /models | ~/Ultralytics/models |
Команда настройки создает эти папки, устанавливает и запускает Docker при необходимости, а также настраивает подключение для автоматического перезапуска вместе с компьютером. Твоя операционная система может попросить тебя подтвердить установку или выполнить перезагрузку перед завершением настройки.
Базовые образы Docker#
Установщик запускает один контейнер и выбирает официальный базовый образ Ultralytics для хоста:
| Хост | Шаблон базового образа |
|---|---|
| Apple silicon или ARM64 Linux | ultralytics/ultralytics:<version>-arm64 |
| x86-64 CPU | ultralytics/ultralytics:<version>-cpu |
| x86-64 с поддержкой GPU NVIDIA | ultralytics/ultralytics:<version> |
Инсталлер выбирает для хоста официальный образ с зафиксированной версией. Воркер добавляет зависимости подключения без переустановки Ultralytics. Он определяет CUDA во время настройки, поэтому хост NVIDIA по-прежнему запускает один контейнер, а не раздельные воркеры для CPU и GPU. Облачные сервисы Platform обрабатывают предсказание и экспорт моделей после загрузки лучшего чекпоинта.
Настройка CPU не требует ничего, кроме выполнения пошаговой установки. В Linux для ускорения на GPU NVIDIA требуется Docker >= 28.2 и NVIDIA Container Toolkit >= 1.18. Установщик использует CDI --device резервирование, а не устаревший --gpus all, поэтому доступ к GPU сохраняется после перезагрузки хост-демона. Docker Desktop на Windows использует поддерживаемое резервирование устройств NVIDIA, так как CDI-устройства NVIDIA там недоступны. Platform автоматически определяет поддерживаемый путь к GPU; подробности настройки см. в Руководстве по быстрому запуску Docker.
Добавь набор данных#
- Помести свой набор данных в настроенную папку для наборов данных.
- На Платформе выбери New Dataset > On Premise.
- Выбери подключенный компьютер.
- Перейди в папку набора данных, выбери задачу и нажми Создать.
Платформа индексирует набор данных локально и открывает его в той же галерее, что используется для загруженных и облачных наборов данных. Ты можешь просматривать изображения, проверять разметку, фильтровать набор данных и аннотировать без загрузки самих пикселей на сервер.
Поддерживаемые данные#
On Premise поддерживает те же форматы загрузки и задачи компьютерного зрения, что и при работе с облачными данными:
- Изображения и видео
- Архивы ZIP, TAR, TAR.GZ и TGZ
- Ultralytics NDJSON и COCO JSON
- Наборы данных YOLO и папки классификации
- Задачи детектирования, сегментации, распознавания ключевых точек, ориентированных BBox (OBB) и классификации
Платформа автоматически распознает типичные структуры наборов данных, классы, метки и разделение на обучающую/валидационную/тестовую выборки. Платформа воспринимает исходные файлы как доступные только для чтения и никогда не меняет их размер, не перекодирует, не редактирует и не удаляет их.
Предпросмотр и аннотирование#
Когда ты открываешь изображение, твой браузер загружает его напрямую с подключенного компьютера. Сертификаты, имена хостов, VPN или настройки предварительного просмотра не требуются.
Аннотации и организация наборов данных сохраняются в твоем рабочем пространстве Платформы, но правки внутри Платформы никогда не изменяют твои исходные файлы изображений или меток.
Обучить модель#
Начни обучение через стандартный диалог обучения Платформы:
- Открой проект и выбери New Model.
- Выбери набор данных On Premise.
- Выбери модель и настройки обучения.
- Начни обучение.
Платформа запускает задачу на подключенном компьютере. Она автоматически использует доступный NVIDIA GPU или переключается на CPU, поэтому Mac может обучить небольшую модель, например YOLO26n, на COCO8 без специального GPU-оборудования.
Файлы обучения записываются в настроенную папку моделей во время активного выполнения. Пакет Ultralytics использует те же обратные вызовы удаленного обучения, что и любая управляемая клиентом машина: прогресс и метрики передаются в Platform, лучшая контрольная точка загружается в хранилище Platform, а завершенная модель работает с существующими путями для скачивания, предсказания, экспорта и развертывания. Другие артефакты обучения остаются в твоей папке моделей. Обучение On Premise не использует вычислительные кредиты Platform, и Platform никогда не отправляет задание обучения в облачные вычисления.
Управление подключением#
Открой Settings > Integrations, чтобы увидеть, доступны ли компьютер и его CPU или GPU. Ты можешь переподключиться для обновления доступа или отключить его, когда он больше не нужен.
Отключение предотвращает запуск новых заданий и просмотров, но не удаляет наборы данных или исходные файлы с компьютера. Загруженные модели остаются доступными в Platform.
Если настройка не завершается#
- Docker запрашивает разрешение: подтверди запрос и подожди, пока Docker запустится. Настройка продолжится автоматически.
- Windows требует перезагрузки: перезагрузи компьютер, вернись в
Settings > Integrationsи создай новую команду установки. - Команда установки устарела: создай новую команду установки. Каждая команда временная и работает один раз.
- Соединение остается офлайн: открой Docker Desktop, запусти заново новую сгенерированную команду и держи терминал открытым, пока он не сообщит, что On Premise запущен.
- Просмотры не загружаются: Открой Platform в браузере на подключенном компьютере. Предварительные просмотры наборов данных приходят напрямую с этого компьютера.
Также смотри Datasets, Annotation и Training.