При развертывании удаленного сервера NVIDIA Nucleus и интеграции контейнеров Harmonizer пользователи сталкиваются со сбоями микросервиса nucleus-search-1. Публикуем руководство по правильной настройке сетевых переменных и устранению ошибок доступа.
Сервер базы данных и синхронизации файлов NVIDIA Nucleus обеспечивает совместную работу над 3D-сценами в платформе Omniverse. При развертывании контейнерного стека Docker Compose часто возникают таймауты и сбои инициализации микросервиса nucleus-search-1 из-за неверной конфигурации внешнего IP-адреса и портов маршрутизации.
Причины сбоев развертывания Nucleus
Лог работы nucleus-search-1 при ошибке указывает на невозможность возврата ответов на внутренние запросы. Это происходит при совпадении двух факторов: использования loopback-адреса 127.0.0.1 в переменной SERVER_IP_OR_HOST и блокировке сетевых портов 3009 и 3100 межсетевым экраном хоста.
Шаг 1. Корректировка переменных окружения .env
Перед запуском стека контейнеров откройте файл конфигурации nucleus-stack.env и укажите действительный статический IP-адрес сервера или FQDN вместо дефолтных значений:
SERVER_IP_OR_HOST=192.168.1.100
WEB_PORT=8080
DATA_PATH=/var/lib/omniverse/nucleus/data
Важно: не используйте localhost или 127.0.0.1, если к серверу будут подключаться клиенты Omniverse Create или Machinima из внешней сети.
Шаг 2. Перезапуск службы поиска и очистка индекса
Если служба nucleus-search-1 завершается с ошибкой Returning status code 500, выполните сброс индекса поиска без удаления основных 3D-ресурсов:
- Остановите стек контейнеров:
docker compose down. - Удалите кэш индексатора:
rm -rf /var/lib/omniverse/nucleus/data/search_index/*. - Проверьте права доступа к директориям:
chown -R 1000:1000 /var/lib/omniverse/nucleus. - Запустите стек заново:
docker compose up -d.
Шаг 3. Интеграция контейнера Harmonizer в NuRec 26.04
Для правильного вызова Harmonizer во время обучения в среде NuRec 26.04 убедитесь, что в конфигурационном файле omniverse.toml включен флаг harmonizer.enabled = true и прописан корректный порт связи со службой Nucleus.
Источники
- NVIDIA Developer Forums, 2026-07-29
- NVIDIA Support Community, 2026-07-29