获取 WardPane
同一个发布包,可以用一条命令安装,也可以通过邮件获取压缩包后安装。两种方式都会要求您提供邮箱并做出两项确认:邮箱用于接收安全通知,同意记录则是法律的要求。
一条命令
在全新的 Ubuntu 24.04 服务器上,以 root 身份或通过 sudo 运行:
$ curl -fsSL https://wardpane.com/install | sudo bash
版本发布后可用。
运行前可以先阅读该脚本: curl -fsSL https://wardpane.com/install | less
- 检查系统是否为 Ubuntu 24.04,以及是否已安装 curl 和 tar。
- 要求您输入邮箱,并显示使用条款、隐私政策和同意书的链接。
- 询问您是否接受使用条款和隐私政策,然后询问您是否同意处理个人数据。回答“否”将终止安装。
- 询问是否向您发送有关新版本和安全修复的消息。默认回答为“否”。
- 向您的邮箱发送六位数验证码。验证码有效期为 15 分钟,最多可尝试 5 次。
- 通过 HTTPS 下载压缩包,校验其 SHA-256,解压后运行 install.sh。
安装程序选项
在命令末尾的 bash -s -- 之后添加选项。下面的示例还会安装 PHP:
curl -fsSL https://wardpane.com/install | sudo bash -s -- --php
| 选项 | 作用 |
|---|---|
--email EMAIL | Let's Encrypt 账户使用的邮箱。不指定时,安装程序会询问。 |
--php | 安装 PHP(php-fpm),让网站可以运行 PHP,每个网站都在各自的沙箱中。 |
--no-php | 不安装 PHP,也不询问。 |
--user NAME | 面板用户名。不指定时,安装程序会提供一个随机用户名。 |
--password PASS | 面板密码。在提示时输入更安全,因为其他用户可以在 ps 中看到命令选项。 |
--ip ADDRESS | 服务器的公网 IPv4 地址,用于自动检测选错地址的情况。 |
--root-login | 允许使用服务器的 root 密码以 root 身份登录面板。 |
--no-root-login | 不允许 root 登录,也不询问。 |
--staging | 使用 Let's Encrypt 的 staging 测试环境。 |
--no-ufw | 保持防火墙原样。 |
--force | 跳过操作系统版本检查。 |
-y, --yes | 从不提问,使用默认答案和随机密码。 |
通过邮件获取压缩包
我们会通过邮件向您发送下载链接。链接有效期为 24 小时,且只能下载一次。
请查收邮件
- 链接有效期为 24 小时,且只能下载一次。
- 如果下载中断,请在同一网络中再次打开同一链接以继续下载。
- 没有收到?请检查垃圾邮件,邮件来自 [email protected]。
- 如果您订阅了新闻,请通过第二封邮件确认订阅。
安装程序会做哪些更改
- 为面板安装 Node.js,如果您需要,还会安装 PHP(php-fpm)。
- 为面板创建系统用户 wardpane,并创建拥有新网站的 Linux 用户 www-root。
- 安装 wardpane 服务,将面板放在 /opt/wardpane,数据放在 /var/lib/wardpane;网站位于 /var/www。
- 配置 ufw,放行 SSH、80、443 和 1500。使用 --no-ufw 可保持防火墙不变。
- 询问面板登录信息和 Let's Encrypt 账户的邮箱。
- 每次更新前在 /var/backups/wardpane 中保留备份。日志:journalctl -u wardpane。
- 使用 sudo /opt/wardpane/uninstall.sh 删除全部内容;/var/www 中的网站文件会保留。
系统要求
- 系统
- 全新的 Ubuntu 24.04 LTS,x86_64 或 arm64
- 内存
- 1 GB RAM 可运行十几个小型网站;使用 GeoLite2 Country 数据库时 512 MB 即可
- 端口
- 80 和 443 空闲供网站使用,1500 供面板使用
- 访问权限
- root 或 sudo,以及用于 Let's Encrypt 和更新的出站 HTTPS
- 可选
- 一个域名、一个 Cloudflare API 令牌、一个用于 GeoIP 更新的免费 MaxMind 密钥
校验和
每个发布压缩包旁边都附有一个 .sha256 文件,其中是它的 SHA-256 校验和,上方也显示了同一个值。一条命令安装程序会自动校验。要校验通过邮件获得的压缩包,请将 .sha256 文件下载到同一文件夹中,然后运行:
将校验和与 .sha256 文件进行比较:
sha256sum -c wardpane-2.0.0.tar.gz.sha256
如果校验和不一致,请不要运行该压缩包,并写信至 [email protected]。
源代码
WardPane 是采用 GNU Affero General Public License 第 3 版的自由软件。目前没有公开的代码仓库:每个发布压缩包都包含该版本的完整源代码,包括 install.sh;安装脚本本身也是纯文本,运行前可以先阅读。
阅读 AGPL-3.0 许可证新增内容
阅读更新日志从 Small Web Panel 1.x 升级
WardPane 2.0 就是更名后的 Small Web Panel。新的安装程序会就地接管 1.x 安装,先备份所有内容,如果新版本无法启动则自动回滚。