翼龙面板运行在您自己的 Web 服务器上。为了运行和使用这个面板,您需要对您的服务器具有 root 访问权限。
您需要了解如何阅读文档以使用此面板。我们花了很多时间详细介绍如何安装或升级我们的软件; 所以你也要花点时间去阅读而不是复制粘贴,然后在事情不起作用时候而抱怨。 此面板不作为运行服务器的拖放服务存在。 这是一个高度复杂的系统,需要多个依赖项,并且使用搭建他的网站管理人员需要付出一些时间学习如何使用它。如果您希望能够在不了解基本 linux 系统管理的情况下安装它,您现在应该停下来然后出门左拐。
选择服务器操作系统
翼龙可在多种操作系统上运行,因此请选择最适合您使用的操作系统。
注意
Pterodactyl 不支持大多数 OpenVZ 系统,因为它与 Docker 不兼容。如果你计划在基于 OpenVZ 的系统上运行这个软件,你很可能不会成功。
安装 Docker
如需快速安装 Docker 社区版,您可以执行以下命令:
curl -sSL https://get.docker.com/ | CHANNEL=stable bash -s docker --mirror Aliyun
如果您希望手动安装,请参考官方 Docker 文档了解如何在您的服务器上安装 Docker 社区版。
检查你的内核
请注意,某些主机安装了不支持 docker 重要功能的修改内核。 请通过运行 uname -r
检查您的内核。 如果您的内核以 -xxxx-grs-ipv6-64
或 -xxxx-mod-std-ipv6-64
结尾,您可能使用的是不受支持的内核。 查看我们的 内核修改 指南了解详细信息。
在启动时启动 Docker
如果您使用的是带有 systemd 的操作系统(Ubuntu 16+、Debian 8+、CentOS 7+),请运行以下命令以在您启动机器时启动 Docker。
systemctl enable --now docker
安装 Docker Compose
虽然 yum
apt
有快速安装的软件包,但版本一般不是最新的。最新发行的版本地址:https://github.com/docker/compose/releases。
运行以下命令来下载 Docker Compose 的当前稳定版本:
curl -L "https://ghfast.top/https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
# 将可执行权限应用于二进制文件并创建软链
chmod +x /usr/local/bin/docker-compose
ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
下载文件
在进行此步骤之前,我们要为 docker-compose.yml
创建一个放置目录。
此过程的第一步是创建面板所在的文件夹,然后进入新创建的文件夹中。以下是如何执行此操作的示例。
注意
以下命令使用的路径仅为示例,阁下大可自己自定义路径,但是我在此提醒您,若您不用我示例使用的路径,请务必记住自己设置的程序所在的目录,并在后续各种涉及到程序运行目录的地方灵活操作!
mkdir -p /var/www/pterodactyl
cd /var/www/pterodactyl
在为面板创建好它的放置目录后,我们将使用 curl
命令,从 Github 拉取翼龙中国汉化完成的 docker-compose.yml
文件并赋予该文件的可执行权限。
curl -Lo docker-compose.yml https://ghfast.top/https://raw.githubusercontent.com/pterodactyl-china/panel/1.0-develop/docker-compose.example.yml
# 将可执行权限应用于yml文件
chmod +x docker-compose.yml
环境变量
当您不提供自己的 .env
文件时,有多个环境变量可以配置面板,有关每个可用选项的详细信息
在 docker-compose.yml
文件中可以设置,具体变量的详细信息可查看 在 GitHub 仓库中提供的文档 或查看 Gitee 镜像仓库中提供的文档(可能不是最新的)
如果你想变更数据的存储目录,可以自行查看文件,如果你并不会或不懂,请不要更改
提示
请注意!docker-compose.yml
文件中 APP_URL
变量一定要修改成你实际访问到面板的外网地址。否则你在配置后端时会出错!
如果想使用非 80
端口,比如你服务器IP为 192.168.1.255
端口为 10000
,请在 docker-compose.yml
文件中 services.panel.ports
将 80:80
修改成 10000:80
,并且 APP_URL
填写成 http://192.168.1.255:10000
。
部署运行
在设置完环境变量,我们就可以通过 Docker Compose 使用 docker-compose.yml
文件来启动面板了
# 在后台执行该服务
# -d 参数是让该程序在后台执行,如果你需要排查错误等情况你可以去除该参数
docker-compose up -d
添加首位用户
您需要为面板创建一个管理用户,以便您可以登录面板。 为此,请运行以下命令。 并保证账户密码满足以下要求:8 个字符,大小写混合,至少一个数字。(此指令需在上文中含有 docker-compose.yml
的同级目录中执行)
docker-compose exec panel php artisan p:user:make
现在,你已经全部设置完毕,直接输入你的网站地址,即可访问翼龙面板
================================================================================================================================
Wings 是翼龙的下一代服务器管理平台。使用 Go 重构,并从我们的第一个 Node.js 守护进程中吸取了教训。
注意
只有在运行 翼龙 1.x 时才应安装 Wings。不要为以前版本的翼龙安装此软件。
支持的系统
以下是支持的操作系统列表。请注意,这不是完整列表,您可能可以轻松地在其他 Linux 发行版上运行该软件。您需要确定这些系统上可能需要哪些软件包。以下受支持操作系统的新版本也很有可能正常工作,您在安装是包括但不限于以下列出的版本。
操作系统 | 版本 | 支持状况 | 注意事项 |
---|---|---|---|
Ubuntu | 20.04 | ✅ | 文档基于 Ubuntu 20.04 作为操作系统所编写的。 |
22.04 | ✅ | ||
24.04 | ✅ | ||
RHEL / Rocky Linux / AlmaLinux | 8 | ✅ | |
9 | ✅ | ||
Debian | 11 | ✅ | |
12 | ✅ | ||
Windows | All | ❌ | 该软件将无法在 Windows 环境中运行。 |
系统要求
要运行 Wings,您需要一个能够运行 Docker 镜像的 Linux 系统。大多数 VPS 和几乎所有专用服务器都应该能够运行 Docker,但也有一些极端情况。
当您的供应商使用 Virtuozzo
、OpenVZ
(或 OVZ
)或 LXC
虚拟化时,您很可能无法运行 Wings。一些提供商已经对嵌套虚拟化进行了必要的更改以支持 Docker。请咨询您的提供商的支持团队。KVM 保证可以工作。
最简单的检查方法是输入 systemd-detect-virt
。 如果结果不包含 OpenVZ
或 LXC
,应该没问题。当运行没有任何虚拟化的专用硬件时,将出现 none
的结果。
如果由于某种原因不能正常工作,或者您仍然不确定,您也可以运行以下命令。
dane@pterodactyl:~$ sudo dmidecode -s system-manufacturer
VMware, Inc.
依赖项
- curl
- Docker
安装 Docker
如需快速安装 Docker 社区版,您可以执行以下命令:
curl -sSL https://get.docker.com/ | CHANNEL=stable bash -s docker --mirror Aliyun
如果您希望手动安装,请参考官方 Docker 文档了解如何在您的服务器上安装 Docker 社区版。
检查你的内核
请注意,某些主机安装了不支持 docker 重要功能的修改内核。 请通过运行 uname -r
检查您的内核。 如果您的内核以 -xxxx-grs-ipv6-64
或 -xxxx-mod-std-ipv6-64
结尾,您可能使用的是不受支持的内核。 查看我们的 内核修改 指南了解详细信息。
使 Docker 开机自启动
如果您使用的是带有 systemd 的操作系统(Ubuntu 16+、Debian 8+、CentOS 7+),请运行以下命令以开机自启动 Docker。
sudo systemctl enable --now docker
启用虚拟内存
最新的 Linux 内核
自 Linux 内核 6.1 版本起,交换分区默认启用。如果您运行的是 6.1 或更新版本的内核,则可以跳过此步骤。要检查您的内核版本,请运行 uname -r
。
在大多数系统上,默认情况下 Docker 无法设置交换空间。您可以通过运行 docker info
并在底部附近查找 WARNING: No swap limit support
的输出来确认这一点。
启用虚拟内存是完全可选的,但如果您要为他人托管并防止出现 OOM 错误,我们建议您开启。
要启用虚拟内存,请以 root 用户身份打开 /etc/default/grub
并找到以 GRUB_CMDLINE_LINUX_DEFAULT
为开头的一行。确保该行在双引号内的某处包含 swapaccount=1
。
之后,运行 sudo update-grub
然后运行 sudo reboot
重启服务器以启用虚拟内存。 下面是该行内容示例,请勿逐字复制此行。 它通常具有其他特定于操作系统的参数。
GRUB_CMDLINE_LINUX_DEFAULT="swapaccount=1"
GRUB 配置
一些 Linux 发行版可能会忽略 GRUB_CMDLINE_LINUX_DEFAULT
。因此,如果默认的不适合您,您可能不得不使用 GRUB_CMDLINE_LINUX
。
安装 Wings
安装 Wings 的第一步是确保我们已经设置了所需的目录结构。为此,请运行以下命令,这将创建基本目录并下载 wings 可执行文件。
警告
Wings 及配置文件路径,如果你不懂请不要尝试更改路径。(当然,你可以修改配置中的所有设置)
并且 wings 文件和配置文件占用空间很低,在配置完设置后可以自行备份配置文件以防不测(如果真没了,那也是整个服务器没了吧...)。
sudo mkdir -p /etc/pterodactyl
curl -L -o /usr/local/bin/wings "https://ghfast.top/https://github.com/pterodactyl-china/wings/releases/latest/download/wings_linux_$([[ "$(uname -m)" == "x86_64" ]] && echo "amd64" || echo "arm64")"
sudo chmod u+x /usr/local/bin/wings
OVH/SYS 服务器
如果您使用的是 OVH 或 SoYouStart 提供的服务器,请注意您的主驱动器空间可能分配给 /home
,而不是默认分配给 /
。 请考虑使用 /home/daemon-data
来存储服务器数据。在创建节点时可以轻松设置。
配置
安装 Wings 和所需组件后,下一步是在已安装的面板上创建一个节点。转到您的面板管理窗口,从侧边栏中选择节点,然后在右侧单击创建新按钮。
创建节点后,单击它,将出现一个名为“配置”的选项卡。复制代码块内容,将其粘贴到 /etc/pterodactyl
中的一个名为 config.yml
的新文件中并保存。
或者,您可以单击 “生成自动部署指令” 按钮,复制 bash 命令并将其粘贴到终端中。
注意
当您的面板使用 SSL 时,Wings 节点就必须使用域名解析,并为其域名也创建一个 SSL。在继续之前,请参阅 创建 SSL 证书 文档页面了解如何创建这些证书。
启动 Wings
要启动 Wings,只需运行以下命令,它将以调试模式启动。一旦你确认它运行没有错误,使用 CTRL+C
来终止进程并按照下面的说明使用守护进程。根据您服务器的互联网连接,第一次拉取和启动 Wings 可能需要几分钟时间。
sudo wings --debug
您可以选择添加 --debug
参数以在调试模式下运行 Wings。
守护进程(使用 systemd)
在后台运行 Wings 是一项简单的任务,只需在执行此操作之前确保它运行无误即可。将下面的内容放在 /etc/systemd/system
目录下的 wings.service
文件中。
[Unit]
Description=Pterodactyl Wings Daemon
After=docker.service
Requires=docker.service
PartOf=docker.service
[Service]
User=root
WorkingDirectory=/etc/pterodactyl
LimitNOFILE=4096
PIDFile=/var/run/wings/daemon.pid
ExecStart=/usr/local/bin/wings
Restart=on-failure
StartLimitInterval=180
StartLimitBurst=30
RestartSec=5s
[Install]
WantedBy=multi-user.target
然后,运行以下命令重新加载 systemd 并启动 Wings。
sudo systemctl enable --now wings
节点分配
分配是 IP 和端口的组合,您可以分配给服务器。 每个创建的服务器必须至少有一个分配。 分配将是您的网络接口的 IP 地址。 在某些情况下,例如在使用了 NAT 的情况下,它将是内部 IP。 要创建新分配,请转到节点 > 您的节点 > 分配。
输入 hostname -I | awk '{print $1}'
查找要用于分配的 IP。或者,您可以输入 ip addr | grep "inet "
查看所有可用的接口和 IP 地址。不要使用 127.0.0.1 进行分配。
评论
发表评论