Skip to content

Запуск без прав root ​

По умолчанию контейнеры Эсборд запускаются от пользователя root. Если политика безопасности вашей инфраструктуры этого не допускает (например, Kubernetes с Pod Security Standards уровня restricted или аналогичными политиками Kyverno/Gatekeeper), Эсборд можно запустить под непривилегированным пользователем.

Версия

Запуск без прав root поддерживается начиная с коробочной версии 2026.4.1.

Как это работает ​

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

  • Контейнер запущен от root (поведение по умолчанию) — Эсборд работает так же, как в предыдущих версиях. Существующие установки обновляются без изменений.
  • Контейнер запущен под другим пользователем (user: в Docker Compose, runAsUser в Kubernetes) — Эсборд сам перестраивает всё, что раньше требовало прав root. Все файлы, которые создаются во время работы (сгенерированная конфигурация nginx, временные файлы, служебные файлы процессов), записываются в каталог /tmp.

Рекомендуемый пользователь — 1000 (группа 1000): он уже есть в образе sboard. Поддерживается и произвольный идентификатор пользователя, в том числе при корневой файловой системе в режиме только для чтения.

Для отдельного образа nginx (используется в вариантах установки minimal) рекомендуемый пользователь — 101 (группа 101).

Что нужно учесть ​

Порты ​

Непривилегированный процесс может слушать порты ниже 1024 не во всех окружениях:

  • Docker (начиная с версии 20.10) по умолчанию разрешает это внутри контейнера, поэтому порты 80/443 продолжают работать без изменений.
  • Kubernetes по умолчанию такого разрешения не даёт. Задайте порты выше 1024 через переменные окружения NGINX_HTTP_PORT и NGINX_HTTPS_PORT (например, 8085 и 8443) и направьте на них targetPort сервиса Kubernetes.

Внутри контейнера sboard порты 8080–8084 заняты сервисами Эсборд — не используйте их для NGINX_HTTP_PORT.

Если порт недоступен, контейнер сообщит об этом при запуске:

FATAL: nginx runs as uid 1000 and cannot listen on port 80 (ports below 1024 need root).

TLS-сертификат ​

Если TLS завершается в контейнере Эсборд (переменная REVERSE_PROXY не задана), закрытый ключ /certs/private.key должен быть доступен на чтение пользователю, под которым запущен контейнер. Ключ, доступный только root (права 600, владелец root), прочитать не получится — контейнер сообщит об этом при запуске:

FATAL: /certs/private.key is not readable by uid 1000. ...

Выдайте права на чтение (например, chown 1000 private.key или chmod 640 с группой 1000) либо завершайте TLS на внешнем reverse proxy или Ingress и задайте REVERSE_PROXY (см. Настройка за reverse proxy).

Сторонние корневые сертификаты ​

Установка сторонних корневых сертификатов работает так же, как при запуске от root: смонтируйте сертификаты в /usr/local/share/ca-certificates.

Docker Compose ​

Укажите пользователя для сервиса sboard:

yml
services:
  sboard:
    # ... остальная конфигурация без изменений
    user: '1000:1000'

В вариантах установки minimal укажите пользователя и для сервиса nginx:

yml
services:
  sboard:
    user: '1000:1000'
  nginx:
    user: '101:101'

Дополнительно можно ограничить права контейнера — с ними Эсборд также работает:

yml
cap_drop:
  - ALL
security_opt:
  - no-new-privileges:true

Kubernetes ​

Пример для развёртывания из инструкции по установке в Kubernetes, совместимый с Pod Security Standards уровня restricted. TLS завершается на Ingress (REVERSE_PROXY: true в секрете env-secret), nginx в контейнере слушает порт 8085:

yml
# Service для пода sboard-dev
apiVersion: v1
kind: Service
metadata:
  name: sboard-lb
  namespace: sboard-k8s-deploy
spec:
  selector:
    app: sboard-dev
  ports:
    - protocol: TCP
      port: 80
      targetPort: 8085
---
# Deployment docker
apiVersion: apps/v1
kind: Deployment
metadata:
  name: sboard-dev
  namespace: sboard-k8s-deploy
spec:
  replicas: 1
  selector:
    matchLabels:
      app: sboard-dev
  template:
    metadata:
      labels:
        app: sboard-dev
    spec:
      securityContext:
        runAsNonRoot: true
        runAsUser: 1000
        runAsGroup: 1000
        seccompProfile:
          type: RuntimeDefault
      containers:
        - name: sboard
          image: cr.yandex/crpqnc9iiqap7fs19jhl/sboard:latest
          imagePullPolicy: Always
          envFrom:
            - secretRef:
                name: env-secret
          env:
            - name: NGINX_HTTP_PORT
              value: '8085'
          ports:
            - containerPort: 8085
          securityContext:
            allowPrivilegeEscalation: false
            capabilities:
              drop:
                - ALL
      restartPolicy: Always

Сервис sboard-lb по-прежнему принимает трафик на порту 80, поэтому настройки Ingress менять не нужно.

Корневая файловая система только для чтения ​

Если ваша политика требует readOnlyRootFilesystem: true, смонтируйте в контейнер записываемый каталог /tmp:

yml
containers:
  - name: sboard
    # ...
    securityContext:
      readOnlyRootFilesystem: true
      allowPrivilegeEscalation: false
      capabilities:
        drop:
          - ALL
    volumeMounts:
      - name: tmp
        mountPath: /tmp
volumes:
  - name: tmp
    emptyDir:
      sizeLimit: 5Gi

В этом режиме в /tmp попадают и журналы процессов, поэтому храните emptyDir на диске (не используйте medium: Memory) и задайте ограничение размера.

Диагностика ​

  • Пользователь процессов: kubectl exec <под> -- id или docker exec <контейнер> id.
  • В режиме без root сгенерированная конфигурация nginx находится в /tmp/nginx/, а не в /etc/nginx/conf.d/.