Тема
Запуск без прав 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:trueKubernetes
Пример для развёртывания из инструкции по установке в 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/.