Проверено на NetBox 4.6 · netbox-docker

Установка NetBox в Docker за 30 минут

Обновлено 08.08.2026 · АЙ-ТИ Фреш · уровень: базовый

Самый быстрый и поддерживаемый способ поднять NetBox — официальный проект netbox-docker: PostgreSQL, Redis-совместимый кеш и сам NetBox поднимаются одной командой. Ниже — путь от чистого сервера Ubuntu до рабочей системы, который мы используем в реальных внедрениях.

Понадобится: сервер Ubuntu 22.04/24.04, 2+ vCPU, 4+ ГБ RAM, 20 ГБ диска, root-доступ.

Шаг 1. Docker

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER && newgrp docker

Шаг 2. Клонируем netbox-docker

Важно: работайте от релизного тега, а не от main — обновления будут предсказуемыми.

git clone -b release https://github.com/netbox-community/netbox-docker.git
cd netbox-docker

Шаг 3. docker-compose.override.yml

По умолчанию порт наружу не публикуется — это делается override-файлом:

cat > docker-compose.override.yml <<'EOF'
services:
  netbox:
    ports:
      - "127.0.0.1:8001:8080"
EOF

Мы публикуем порт только на 127.0.0.1 — наружу NetBox должен смотреть через реверс-прокси с HTTPS (Caddy или nginx; отдельная инструкция — скоро).

Шаг 4. Запуск и суперпользователь

docker compose pull
docker compose up -d
# дождитесь, пока netbox станет healthy (2–3 минуты):
docker compose ps
# создаём администратора:
docker compose exec netbox /opt/netbox/netbox/manage.py createsuperuser

Откройте http://127.0.0.1:8001 (через SSH-туннель: ssh -L 8001:127.0.0.1:8001 user@server) и войдите.

Шаг 5. Русский язык и базовые настройки

В configuration/extra.py добавьте:

DEFAULT_LANGUAGE = "ru"
PAGINATE_COUNT = 50
BANNER_LOGIN = "Система техучёта сети"

И перезапустите: docker compose restart netbox netbox-worker. Интерфейс станет русским для всех новых пользователей.

Частые грабли

Обновились с main и всё сломалось. Используйте релизные теги netbox-docker и читайте release notes: мажорные версии NetBox требуют миграций.
Забыли про бэкапы. Минимум: pg_dump -Fc базы + архив media/ по крону с ротацией. Наш скрипт — в отдельной статье (скоро).
Открыли 8080 в мир. Только 127.0.0.1 + реверс-прокси с HTTPS и, при необходимости, ограничением по IP.

Что дальше

Система пустая — сила NetBox раскрывается с данными. Начните с модели данных, а если хотите сразу правильно — мы спроектируем модель и перенесём ваши данные из Excel или старых систем скриптами через API.