Requisitos
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.
A versão que instala
A versão pública é uma versão de desenvolvimento, chamada 0.3.0-dev. O nome não muda: cada publicação substitui a anterior e um identificador de compilação distingue duas compilações. Ainda não existe nenhuma versão estável: só será publicada quando cada sistema e cada pacote tiverem sido testados de ponta a ponta. Por isso, os comandos desta página instalam a partir do canal dev. Uma versão de desenvolvimento pode conter erros: experimente-a num site de teste antes de depender dela.
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.
Requisitos e dependências
O que o seu servidor precisa, o que o instalador acrescenta e o que é opcional.
Sistemas suportados
Linux com systemd 239 ou posterior e glibc 2.28 ou posterior, em amd64 ou arm64: AlmaLinux, Rocky Linux, RHEL e Oracle Linux 8 a 10, CentOS Stream, Fedora, Amazon Linux 2023, Debian 11 a 13, Ubuntu 20.04 a 26.04, openSUSE e Arch (tabela completa abaixo). Windows 10, 11 e Server 2016 a 2025 (ainda não executado num anfitrião Windows real). O instalador verifica o seu sistema antes de alterar o que quer que seja. Servidores que adiciona a partir da consola: o agente de anfitrião existe para Linux (amd64, arm64) e Windows (amd64).
Portas de rede
80 e 443: tráfego web (data plane). 9443: consola (alterável com --cp-port). 9444: API usada pelos nós data plane e pelos agentes de servidores; o instalador não a abre, permita-a apenas a partir dos seus servidores. 127.0.0.1:9101: ponto de saúde local. O UDP 443 permanece fechado (HTTP/3 não está implementado). Os agentes de servidores só fazem ligações de saída para a porta 9444.
O que faz o instalador
Requer direitos de root ou administrador e HTTPS de saída para descarregar a versão. Instala curl, tar e libcap se faltarem (e policycoreutils-python-utils em sistemas SELinux), cria um utilizador toutwaf sem privilégios e uma pasta de instalação única (/var/toutwaf com bin, conf, data e logs; --home DIR altera-a, e uma instalação anterior mantém os seus caminhos), instala serviços systemd reforçados (serviços do Windows no Windows), permite ao data plane usar as portas 80 e 443 sem root, abre o firewall por padrão quando o firewalld ou o ufw está ativo (80, 443 e a porta da console; --console-from restringe a console, --no-firewall desativa), etiqueta os ficheiros para SELinux e verifica as somas SHA-256.
Idioma do instalador
Inglês por predefinição; o instalador deteta o idioma do sistema. Force um com --fr --de --es --it --pt --nl --ru --zh --ar ou --en (Windows: -Fr, etc., ou a variável TOUTWAF_LANG).
Binários autónomos
O data plane é escrito em Rust, o control plane e o agente em Go, e a consola está integrada no control plane. Não é preciso instalar runtime de Python, Node.js ou Java nem servidor de base de dados: os dados ficam em SQLite. O data plane em Rust requer glibc 2.28 ou superior. Principais componentes de terceiros: tokio, hyper e rustls (Rust), Svelte e xterm.js (consola).
Componentes opcionais
ClamAV para as análises antivírus dos hosts Linux (a consola pode instalá-lo por si); Microsoft Defender no Windows. openssl apenas se ativar a verificação da assinatura das versões, e cosign apenas se quiser que verifique assinaturas. O Docker não é necessário: os manifestos Docker e Kubernetes são formas alternativas de implementação.
ToutPanel (servidor de alojamento web)
Instala-se a partir da consola por SSH, ou com o seu próprio instalador. Linux: Debian 11 a 13, Ubuntu 20.04 a 24.04, AlmaLinux, Rocky Linux e RHEL 9 e 10, Fedora 40 e posteriores. Windows 10 e 11, Windows Server 2016 a 2025. Requer root e bash (Linux) ou PowerShell 5.1+ como administrador (Windows), Python 3.9 a 3.14 (instalado pelo seu script quando a distribuição o fornece), pelo menos 1 GB de RAM (2 GB recomendados com MariaDB e PHP), 2 GB de disco livre mais os seus sites e HTTPS de saída. O seu painel escuta por predefinição na porta 8888; as portas 80 e 443 servem os sites. Fonte: o README do ToutPanel.
O ToutWAF ainda não publica valores mínimos de CPU, RAM ou disco: dimensione o seu servidor com um teste sobre o seu próprio tráfego.
Sistemas suportados
Verificados pelo instalador antes de alterar o que quer que seja. Os estados vêm dos dados do próprio instalador.
- tested O teste de instalação completo em contentor passou nessa versão exata.
- expected Mesma família, glibc e systemd suficientemente recentes, mas o teste completo não foi executado.
- unsupported Recusado antes de qualquer alteração (contornável por sua conta e risco com --skip-os-check).
| Distribuição | Versões |
|---|---|
| AlmaLinux | 10tested9tested8tested |
| Rocky Linux | 10tested9tested8tested |
| Red Hat Enterprise Linux | 10tested9tested8tested7unsupported |
| CentOS Stream | 10tested9tested8unsupported7unsupported |
| Oracle Linux | 10tested9tested8tested7unsupported |
| Fedora | 44tested43tested42tested41tested |
| Amazon Linux | 2023tested2unsupported |
| Debian | 13tested12tested11tested10unsupported |
| Ubuntu | 26.04tested25.10tested24.04tested22.04tested20.04tested18.04unsupported |
| Linux Mint / LMDE | todas as versõesexpected |
| Pop!_OS | todas as versõesexpected |
| Zorin OS | todas as versõesexpected |
| elementary OS | todas as versõesexpected |
| Kali Linux | rollingexpected |
| Raspberry Pi OS (32-bit, Raspbian) | todas as versõesunsupported |
| Devuan | todas as versõesunsupported |
| openSUSE Leap | 16.0tested15.6tested |
| openSUSE Tumbleweed | rollingtested |
| openSUSE Slowroll | rollingexpected |
| SUSE Linux Enterprise Server | 16.0expected15.7expected15.6expected |
| SUSE Linux Micro / MicroOS / Aeon | todas as versõesunsupported |
| openSUSE MicroOS / Aeon / Kalpa | todas as versõesunsupported |
| Arch Linux | rollingtested |
| Manjaro | rollingexpected |
| EndeavourOS | rollingexpected |
| Garuda Linux | rollingexpected |
| CachyOS | rollingexpected |
| Artix Linux | todas as versõesunsupported |
| Alpine Linux | todas as versõesunsupported |
| Void Linux | todas as versõesunsupported |
| NixOS | todas as versõesunsupported |
| Windows | Windows 11expectedWindows 10expectedWindows Server 2025expectedWindows Server 2022expectedWindows Server 2019expectedWindows Server 2016expected |
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.