Перейти к содержимому

Артефакты в системе

После apt install ololo-relay / dnf install ololo-relay на диске появляются следующие объекты:

  • /usr/bin/ololo-relay — бинарь серверного узла. Владелец root:root, права 0755.
  • /lib/systemd/system/ololo-relay.service — systemd-юнит (Type=simple, запускается от пользователя ololo-relay, ExecReload=/bin/kill -HUP $MAINPID для перечитывания сертификатов без разрыва сессий, TimeoutStopSec=35s под плавный дренаж соединений). Владелец root:root, права 0644.
  • /etc/ololo-relay/node.yaml — конфиг узла. Помечен conffile noreplace — обновления пакета его не перетирают. Владелец root:root, права 0644.
  • /etc/ololo-relay/initial-policy.yaml.example — шаблон политики для standalone-режима или первичной настройки мастера. Владелец root:root, права 0644.
  • /var/lib/ololo-relay/ — каталог состояния: policy.bbolt (база мастера), policy.snapshot (локальный кеш политики на узлах для старта при недоступном мастере) и опционально static/ (каталог статического сайта при настройке camouflage.static_dir). Владелец ololo-relay:ololo-relay, права 0750.

Артефакты десктоп-админки (ololo-relay-admin)

При установке пакета ololo-relay-admin на Linux создаются:

  • /opt/ololo-relay-admin/ — самодостаточная сборка приложения ololo-relay-admin, ресурсы и .proto-определения;
  • /usr/bin/ololo-relay-admin — симлинк через update-alternatives для запуска из терминала;
  • /etc/apparmor.d/ololo-relay-admin — профиль AppArmor для песочницы пользовательских пространств имён на Ubuntu 24.04+;
  • /usr/share/applications/ololo-relay-admin.desktop и иконка в /usr/share/icons/hicolor/512x512/apps/ololo-relay-admin.png.

Системный пользователь

Создаётся системный пользователь ololo-relay:

  • UID и GID из системного диапазона (useradd --system).
  • Без shell: /usr/sbin/nologin.
  • Домашний каталог: /var/lib/ololo-relay/.
  • Не используется ни для чего, кроме запуска сервиса.

Capabilities

Через setcap бинарю выдаются:

  • cap_net_admin — для управления TUN-устройством;
  • cap_net_bind_service — для прослушивания привилегированных портов (<1024), например, 443;
  • cap_net_raw — для работы с raw-сокетами (ICMP).

Это позволяет сервису запускаться от непривилегированного пользователя, не теряя возможности работать с сетью.

Изоляция systemd

В юнит включены ограничения:

NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true
ReadWritePaths=/var/lib/ololo-relay
RestrictAddressFamilies=AF_INET AF_INET6 AF_UNIX AF_NETLINK

Файловая система видна только на чтение, кроме /var/lib/ololo-relay/. Каталог /tmp — приватный, доступа к /home нет.

Что не делает postinstall

  • Не запускает сервис (systemctl enable / start) — конфиг должен быть отредактирован администратором; иначе сервис уйдёт в цикл перезапусков и съест место в журнале.
  • Не открывает порты в межсетевом экране — это решение администратора (зависит от выбранного порта и стека: ufw, firewalld, nftables).
  • Не создаёт TLS-сертификаты — relay предполагает, что они уже есть: от Let’s Encrypt, корпоративного CA или собственного.

Что происходит при удалении

  • При apt remove / dnf remove: останавливает и disable сервис (шаг preremove); после снятия пакета — daemon-reload (шаг postremove).
  • При apt purge / явном удалении конфигов: удаляет /etc/ololo-relay/.
  • Никогда не удаляет: системного пользователя ololo-relay, каталог /var/lib/ololo-relay/. Эти объекты переживают обновления типа remove+install и оставляются администратору.