Что нужно серверу
Хватит одного сервера или ВМ с Ubuntu Server 26.04, 4 ядрами, 17 ГиБ памяти и пустым вторым диском, а входящие порты не нужны. Установка проверяет каждый пункт этой страницы, прежде чем что-то менять, и для каждого непройденного печатает, как его исправить. Проверки можно прогнать отдельно, за несколько дней до установки: как это сделать, показано на странице Установка ноды.
Сервер
- Сервер только для ноды.
detachbox-node-hostработает от root и выполняет команды, подписанные сервером detachbox, поэтому нода занимает его целиком. Рядом с ней ничего подобного быть не должно: ни Docker, ни LXD, ни своих Incus или cloudflared, ни другого пула ZFS. Проверка перечисляет всё, что нашла, вместе с командой, которая это удаляет. - Ubuntu Server 26.04 LTS на x86_64 (amd64), загруженная с systemd и cgroup v2, корневая файловая система на ext4 или xfs, не на ZFS. ВМ в вашем гипервизоре или облачном аккаунте подходит так же, как железо.
- 4 ядра CPU или больше. Два остаются системе, все остальные отдаются терминалам.
- Не меньше 17 ГиБ памяти, а по-настоящему нода окупается от 64 ГиБ. 8 ГиБ остаются системе и сборке базового образа. Кеш ZFS берёт шестнадцатую часть памяти, округлённую вниз до степени двойки, от 1 до 16 ГиБ. Остальное получают терминалы, а проверка печатает это деление для вашего сервера.
- Secure Boot выключен или ключ DKMS зарегистрирован. В Ubuntu 26.04 стоит ZFS 2.4.1, которая теряет блоки, записанные с дедупликацией, поэтому установщик собирает на сервере OpenZFS 2.4.4 и её модуль ядра. Заголовки работающего ядра должны быть в apt.
- Синхронизированные часы (NTP, UDP 123). Нода принимает запросы сервера detachbox, только если они расходятся с её часами не больше чем на 60 секунд.
Диск
Пулу ZFS ноды нужен второй диск целиком, пустой, от 100 ГиБ. 70 % пула становятся диском вашего аккаунта. На остальном месте лежат системные диски терминалов, базовые образы и свободное место, без которого ZFS замедляется. В пуле включены сжатие lz4, дедупликация и autotrim.
Установщик откажется от диска с таблицей разделов, файловой системой, меткой LVM, RAID или ZFS или чем-то смонтированным. Он никогда не уничтожает данные, и флага, который заставил бы его это сделать, нет. Если содержимое диска не нужно, очистите его сами:
sudo wipefs -a /dev/sdb # диск, который вы отдаёте пулу
sudo zpool destroy <pool> # сначала, если диск входит в пул ZFS
Сеть
Входящий порт ноде не нужен. Все соединения она открывает наружу:
| Куда · порт | Зачем |
|---|---|
api.detachbox.com · TCP 443 | Сервер detachbox: регистрация, выпуски node-host, отчёты |
region1.v2.argotunnel.com, region2.v2.argotunnel.com · TCP и UDP 7844 | Туннель Cloudflare ноды |
Ваше зеркало apt, archive.ubuntu.com, security.ubuntu.com · TCP 80 или 443 | Пакеты Ubuntu, на сервере и в базовом образе |
pkgs.zabbly.com · TCP 443 | Пакеты Incus |
pkg.cloudflare.com · TCP 443 | Пакеты cloudflared |
github.com, release-assets.githubusercontent.com, api.github.com · TCP 443 | Выпуск OpenZFS; инструменты базового образа |
images.linuxcontainers.org · TCP 443 | Образ Ubuntu, из которого собирается базовый образ |
download.docker.com, deb.nodesource.com, cli.github.com, gitlab.com · TCP 443 | Docker, Node.js и CLI GitHub и GitLab в базовом образе |
registry.npmjs.org, cdn.playwright.dev · TCP 443 | Codex, pnpm, yarn, Playwright и его браузер |
downloads.claude.ai, astral.sh, mise.run · TCP 443 | Claude Code, uv и mise |
Ваши серверы NTP (у Ubuntu: ntp.ubuntu.com) · UDP 123 | Часы |
s.appmaster.io · TCP 443 | Отчёты node-host и edge об ошибках для detachbox. Необязательно: нода работает и без этого адреса, и проверки его не проверяют |
Нода пересобирает базовый образ каждые 6 часов, так что эти адреса нужны и после установки.
Дайте терминалам такой же выход в интернет, как у ноутбука разработчика: агенты обращаются к своим провайдерам моделей, сборки тянут пакеты из реестров.
Пропускайте эти адреса без инспекции TLS. node-host и cloudflared принимают только сертификаты публичных центров, а если трафик кто-то переподписывает по пути, проверка называет центр, сертификат которого получила.
Браузеры ваших инженеров открывают кабинет на my.detachbox.com и api.detachbox.com и собственные адреса ноды под detachbox.dev; их список есть на странице Куда ходят терминалы.
Токен
Установке нужен токен регистрации от вашего контакта в detachbox. Он годится для одного сервера и одной установки. Зарегистрировать сервер с ним можно в течение 7 дней, а после регистрации токен ещё 7 дней принимает повторные запуски той же установки. Новый токен заменяет старый.