RU
EUR
Бесплатная редакцияБесплатно Установить

Требования

Supported systems, ports, privileges and dependencies: what the installers check, install or expect, and what each component needs. Read it before you plan an installation.

All ways to install

Какую версию вы устанавливаете

Публичная версия — версия для разработки с именем 0.3.0-dev. Её имя не меняется: каждая публикация заменяет предыдущую, а два выпуска различает идентификатор сборки. Стабильной версии пока нет: её опубликуют, только когда каждая система и каждый пакет пройдут сквозное тестирование. Поэтому команды на этой странице устанавливают продукт из канала dev. Версия для разработки может содержать ошибки: прежде чем на неё полагаться, попробуйте её на тестовом сайте.

At a glance

  • A 64-bit server (amd64 or arm64) running Linux (systemd 239+, glibc 2.28+, kernel 4.18+) or Windows, with root or administrator rights.
  • Ports: 80 and 443 (web traffic), 9443 (console, restrict it to your admin network), 9444 (API used by nodes and agents: open it only from your own servers), 127.0.0.1:9101 (local health). UDP 443 stays closed: HTTP/3 is not implemented.
  • No runtime to install: self-contained binaries, data in SQLite, no database server.
  • The installer checks free disk space, DNS and the clock; memory is not checked.

Требования и зависимости

Что нужно вашему серверу, что добавляет установщик и что остаётся необязательным.

Поддерживаемые системы

Linux с systemd 239 или новее и glibc 2.28 или новее на amd64 или arm64: AlmaLinux, Rocky Linux, RHEL и Oracle Linux 8–10, CentOS Stream, Fedora, Amazon Linux 2023, Debian 11–13, Ubuntu 20.04–26.04, openSUSE и Arch (полная таблица ниже). Windows 10, 11 и Server 2016–2025 (ещё не запускалось на реальном хосте Windows). Установщик проверяет вашу систему до каких-либо изменений. Серверы, которые вы добавляете из консоли: агент хоста существует для Linux (amd64, arm64) и Windows (amd64).

Сетевые порты

80 и 443: веб-трафик (data plane). 9443: консоль (меняется ключом --cp-port). 9444: API для узлов data plane и агентов серверов; установщик его не открывает, разрешайте доступ только со своих серверов. 127.0.0.1:9101: локальная проверка состояния. UDP 443 остаётся закрытым (HTTP/3 не реализован). Агенты серверов делают только исходящие соединения на порт 9444.

Что делает установщик

Нужны права root или администратора и исходящий HTTPS для загрузки релиза. Устанавливает curl, tar и libcap, если их нет (и policycoreutils-python-utils в системах с SELinux), создаёт непривилегированного пользователя toutwaf и один каталог установки (/var/toutwaf с bin, conf, data и logs; --home DIR меняет его, а более старая установка сохраняет свои пути), ставит усиленные службы systemd (службы Windows в Windows), позволяет data plane занимать порты 80 и 443 без root, по умолчанию открывает брандмауэр, если активен firewalld или ufw (80, 443 и порт консоли; --console-from ограничивает консоль, --no-firewall отключает), размечает файлы для SELinux и проверяет суммы SHA-256.

Язык установщика

По умолчанию английский; установщик определяет язык системы. Задайте язык ключами --fr --de --es --it --pt --nl --ru --zh --ar или --en (Windows: -Fr и т. д. либо переменная TOUTWAF_LANG).

Самодостаточные бинарные файлы

Data plane написан на Rust, control plane и агент — на Go, консоль встроена в control plane. Не нужно устанавливать среды выполнения Python, Node.js или Java и сервер баз данных: данные хранятся в SQLite. Data plane на Rust требует glibc 2.28 или новее. Основные сторонние компоненты: tokio, hyper и rustls (Rust), Svelte и xterm.js (консоль).

Необязательные компоненты

ClamAV для антивирусной проверки хостов Linux (консоль может установить его за вас); Microsoft Defender в Windows. openssl нужен, только если включить проверку подписи релизов, а cosign — только если вы хотите проверять подписи с его помощью. Docker не требуется: манифесты Docker и Kubernetes — альтернативные способы развёртывания.

ToutPanel (сервер веб-хостинга)

Устанавливается из консоли по SSH или собственным установщиком. Linux: Debian 11–13, Ubuntu 20.04–24.04, AlmaLinux, Rocky Linux и RHEL 9 и 10, Fedora 40 и новее. Windows 10 и 11, Windows Server 2016–2025. Нужны root и bash (Linux) или PowerShell 5.1+ от администратора (Windows), Python 3.9–3.14 (ставится скриптом, если есть в дистрибутиве), не менее 1 ГБ ОЗУ (2 ГБ рекомендуется с MariaDB и PHP), 2 ГБ свободного места плюс ваши сайты и исходящий HTTPS. Панель по умолчанию слушает порт 8888; порты 80 и 443 обслуживают сайты. Источник: README ToutPanel.

ToutWAF пока не публикует минимальные требования к процессору, ОЗУ и диску: подберите размер сервера тестом на собственном трафике.

Поддерживаемые системы

Проверяются установщиком до каких-либо изменений. Статусы берутся из собственных данных установщика.

  • tested Полный тест установки в контейнере пройден именно на этой версии.
  • expected То же семейство, достаточно новые glibc и systemd, но полный тест не выполнялся.
  • unsupported Отклоняется до каких-либо изменений (можно обойти на свой риск через --skip-os-check).
amd64supportedarm64supportedarm32unsupported
ДистрибутивВерсии
AlmaLinux10tested9tested8tested
Rocky Linux10tested9tested8tested
Red Hat Enterprise Linux10tested9tested8tested7unsupported
CentOS Stream10tested9tested8unsupported7unsupported
Oracle Linux10tested9tested8tested7unsupported
Fedora44tested43tested42tested41tested
Amazon Linux2023tested2unsupported
Debian13tested12tested11tested10unsupported
Ubuntu26.04tested25.10tested24.04tested22.04tested20.04tested18.04unsupported
Linux Mint / LMDEвсе версииexpected
Pop!_OSвсе версииexpected
Zorin OSвсе версииexpected
elementary OSвсе версииexpected
Kali Linuxrollingexpected
Raspberry Pi OS (32-bit, Raspbian)все версииunsupported
Devuanвсе версииunsupported
openSUSE Leap16.0tested15.6tested
openSUSE Tumbleweedrollingtested
openSUSE Slowrollrollingexpected
SUSE Linux Enterprise Server16.0expected15.7expected15.6expected
SUSE Linux Micro / MicroOS / Aeonвсе версииunsupported
openSUSE MicroOS / Aeon / Kalpaвсе версииunsupported
Arch Linuxrollingtested
Manjarorollingexpected
EndeavourOSrollingexpected
Garuda Linuxrollingexpected
CachyOSrollingexpected
Artix Linuxвсе версииunsupported
Alpine Linuxвсе версииunsupported
Void Linuxвсе версииunsupported
NixOSвсе версииunsupported
WindowsWindows 11expectedWindows 10expectedWindows Server 2025expectedWindows Server 2022expectedWindows Server 2019expectedWindows Server 2016expected
Проверка без установки: sudo bash install.sh --check-compat (Windows: -CheckCompat). Код возврата 0, если система совместима, иначе 3. Чтобы продолжить на свой риск в неподдерживаемой системе, используйте --skip-os-check: это никогда не происходит молча и не обходит отказ для 32-разрядного ARM.
Raspberry Pi и другие серверы arm64: Raspberry Pi 3, 4, 5 и Zero 2 W требуют 64-разрядной ОС (Raspberry Pi OS 64-bit, Ubuntu или Debian arm64). Сборка arm64 запускалась только в эмуляции, никогда на реальном оборудовании, тестов производительности нет. 32-разрядный ARM отклоняется.
Windows 10 (1809 и новее), 11 и Server 2016–2025 имеют статус expected: установщик Windows не запускался на реальном хосте Windows. Сборка Windows ARM64 только кросс-скомпилирована и ни разу не запускалась.
Docker: образ «всё в одном» проверен только на Linux amd64. Mac на Apple Silicon и Intel не проверялись, нативный macOS не поставляется.

What is not verified

We prefer to say it plainly.

  • ToutWAF does not publish minimum CPU, RAM or disk figures yet: size your server with a test on your own traffic.
  • The “tested” and “expected” statuses of the table mean: full installation passed in a container with systemd, or same family without that test. Windows is “expected” everywhere.

Other ways to install

Learn more in the documentation