系统要求
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.
您安装的是哪个版本
目前公开的是名为 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.
要求与依赖
您的服务器需要什么、安装程序会添加什么，以及哪些是可选的。
支持的系统
带 systemd 239 或更高版本和 glibc 2.28 或更高版本的 Linux，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：网页流量（数据平面）。9443：控制台（可用 --cp-port 修改）。9444：供数据平面节点和服务器代理使用的 API；安装程序不会开放它，请仅对您自己的服务器放行。127.0.0.1:9101：本地健康检查端点。UDP 443 保持关闭（未实现 HTTP/3）。服务器代理只向 9444 端口发起出站连接。
安装程序会做什么
需要 root 或管理员权限以及用于下载版本的出站 HTTPS。若缺少则安装 curl、tar 和 libcap（SELinux 系统上还有 policycoreutils-python-utils），创建无特权的 toutwaf 用户和唯一的安装主目录（/var/toutwaf，含 bin、conf、data 和 logs；可用 --home DIR 更改，较早的安装保留其路径），安装加固的 systemd 服务（Windows 上为 Windows 服务），让数据平面无需 root 即可绑定 80 和 443 端口，在 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 中。Rust 数据平面需要 glibc 2.28 或更新版本。主要第三方组件：tokio、hyper 和 rustls（Rust），Svelte 和 xterm.js（控制台）。
可选组件
ClamAV 用于 Linux 主机的杀毒扫描（控制台可为您安装）；Windows 上使用 Microsoft Defender。仅在启用发行版签名校验时才需要 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 GB 内存（配合 MariaDB 和 PHP 建议 2 GB）、2 GB 可用磁盘外加您的站点，以及出站 HTTPS。其面板默认监听 8888 端口；80 和 443 端口用于站点。来源：ToutPanel 的 README。
ToutWAF 目前尚未公布最低 CPU、内存或磁盘要求：请用您自己的流量测试来确定服务器规格。
支持的系统
由安装程序在修改任何内容之前检查。状态来自安装程序自身的数据。
- tested 完整的容器安装测试已在该确切版本上通过。
- expected 同一系列，glibc 和 systemd 足够新，但未运行完整测试。
- unsupported 在任何修改之前被拒绝（可自担风险用 --skip-os-check 绕过）。
| 发行版 | 版本 |
|---|---|
| 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 | 所有版本expected |
| Pop!_OS | 所有版本expected |
| Zorin OS | 所有版本expected |
| elementary OS | 所有版本expected |
| Kali Linux | rollingexpected |
| Raspberry Pi OS (32-bit, Raspbian) | 所有版本unsupported |
| Devuan | 所有版本unsupported |
| openSUSE Leap | 16.0tested15.6tested |
| openSUSE Tumbleweed | rollingtested |
| openSUSE Slowroll | rollingexpected |
| SUSE Linux Enterprise Server | 16.0expected15.7expected15.6expected |
| SUSE Linux Micro / MicroOS / Aeon | 所有版本unsupported |
| openSUSE MicroOS / Aeon / Kalpa | 所有版本unsupported |
| Arch Linux | rollingtested |
| Manjaro | rollingexpected |
| EndeavourOS | rollingexpected |
| Garuda Linux | rollingexpected |
| CachyOS | rollingexpected |
| Artix Linux | 所有版本unsupported |
| Alpine Linux | 所有版本unsupported |
| Void Linux | 所有版本unsupported |
| NixOS | 所有版本unsupported |
| 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.