使用宝塔（BT-Panel）面板搭建

大约 7 分钟

使用宝塔（BT-Panel）面板搭建

翼龙面板运行在您自己的 Web 服务器上。为了运行和使用这个面板，您需要对您的服务器具有 root 访问权限。

您需要了解如何阅读文档以使用此面板。我们花了很多时间详细介绍如何安装或升级我们的软件；所以你也要花点时间去阅读而不是复制粘贴，然后在事情不起作用时候而抱怨。此面板不作为运行服务器的拖放服务存在。这是一个高度复杂的系统，需要多个依赖项，并且使用搭建他的网站管理人员需要付出一些时间学习如何使用它。
如果您希望能够在一点一点一点都不了解基本 linux 系统管理的情况下来搭建翼龙面板，您现在应该停下来然后出门左拐。

选择服务器操作系统

翼龙可在多种操作系统上运行，因此请选择最适合您使用的操作系统。

注意

Pterodactyl 不支持大多数 OpenVZ 系统，因为它与 Docker 不兼容。如果你计划在基于 OpenVZ 的系统上运行这个软件，你很可能不会成功。
不过翼龙面板前端就没那么需求了，只要阁下前端服务器能装 BT-Panel，和 LNMP 或者 LAMP，就可以用来搭建翼龙面板前端了。一般服务器均能满足前端的搭建要求。

操作系统	版本	支持状况	注意事项
Ubuntu	20.04	✅	文档以 Ubuntu 20.04 操作系统为基本所编写的。
	22.04	✅	MariaDB 无需 repo 安装脚本即可安装。
	24.04	✅	MariaDB 无需 repo 安装脚本即可安装。
RHEL / Rocky Linux / AlmaLinux	8	✅	需要额外的存储库。
	9	✅
Debian	11	✅
	12	✅

安装宝塔面板

此界面提供的安装脚本具有时间局限性，可能落后于官方最新版本，有条件的话请去宝塔官网查看

# Centos安装脚本
yum install -y wget && wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh ed8484bec

# Ubuntu/Deepin安装脚本
wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh ed8484bec

# Debian安装脚本
wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && bash install.sh ed8484bec

# 万能安装脚本
if [ -f /usr/bin/curl ];then curl -sSO https://download.bt.cn/install/install_panel.sh;else wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh;fi;bash install_panel.sh ed8484bec

安装LNMP或LAMP基础环境

LNMP 和 LAMP 分别代表着 Linux Nginx\Apache Mysql PHP
阁下选择版本请务必保证 PHP版本 >= 8.1、 MySQL版本 >= 5.7
这一般会在阁下第一次登录宝塔面板时提示安装，我不在此赘述，若阁下错过提示，可点击 软件商店 自行安装
在安装完毕后，在 PHP 的禁用函数里删除 putenv、 exec、 proc_open、 shell_exec，并且在扩展里安装 fileinfo redis

新建站点并开始构建

新建站点

我觉得你应该会使用宝塔面板来新建一个网站

下载并上传程序文件至网站目录

国际源

https://github.com/pterodactyl-china/panel/releases/latest/download/panel.tar.gz

国内源

https://ghp.ci/https://github.com/pterodactyl-china/panel/releases/latest/download/panel.tar.gz

进入网站目录解压程序文件并设置环境文件

现在所有文件都已下载，我们需要进入网站目录解压刚刚上传的 panel.tar.gz 压缩包

然后将 .env.example 文件重命名为 .env

使用 Composer 安装相关依赖

点击网站的 设置 ，再点击 设置 里的 Composer

先点击 升级Composer 确保其为最新版本，并按红圈所示选择
在 补充命令 中输入以下命令后点击 执行 ，等待命令执行完成后关闭窗口即可。

composer install --no-dev --optimize-autoloader

注意

在进行以下步骤之前，请阁下为面板前端新建一个数据库，我相信阁下的聪明脑袋一定会用宝塔面板新建一个数据库吧。

伪静态及二级目录设置

点击网站的 设置 ，进入设置界面

伪静态设置

点击 设置 里的 伪静态

先点击左上角的伪静态模板，并使用 laravel5 伪静态模板点击 保存 即可设置成功。

二级目录设置

点击 设置 里的 网站目录

点击 运行目录 一栏，并选择 /public 点击 保存 即可设置成功。

生成APP_KEY并进行环境配置

现在我们要开始输入一些指令了，请阁下先记住在宝塔新建站点时设置的站点目录

#进入站点目录
cd {阁下在宝塔新建站点时设置的站点目录}
# 例如 cd /www/wwwroot/pterodactyl

# 注意，以下指令仅针对于第一次安装部署翼龙面板前端
# 且对应数据库内无数据时执行，若阁下并非第一次安装且数据库内有数据，请忽略此指令
php artisan key:generate --force

#下面两个指令是设置一些基础信息和数据库配置，阁下应该在此步骤之前为面板前端新建一个数据库
php artisan p:environment:setup
php artisan p:environment:database

# 下面这个指令是配置面板的发件系统，如果阁下不需要可忽略
# 若使用 PHP 自带的 mail 拓展 (不推荐使用), 请在执行以下指令后选择 "mail"。
# 若使用自定义 SMTP 服务器，请在执行以下指令后选择 "smtp"。
php artisan p:environment:mail

现在我们要将面板所有的核心数据写入我们之前为面板准备的数据库内。

此步骤可能花费较长时间来进行执行，花费的时间取决于您的主机性能，主机与数据库主机的网络连接状态等因素。请耐心等待数据导入完成，切勿中途使用 CTRL+C 强制中断执行！

php artisan migrate --seed --force

添加首位用户

数据库配置完成后，您需要为面板创建一个管理用户，以便您可以登录面板。为此，请运行以下命令。并保证账户密码满足以下要求：8 个字符，大小写混合，至少一个数字。

php artisan p:user:make

设置程序文件权限

我们需要进入网站目录并全选设置文件权限为 755 所有者为 www

注册队列监听服务

我们使用队列来使应用程序更快，并在后台处理发送电子邮件和其他操作。您需要设置工作队列以处理这些操作。

Crontab 定时任务设置

我们需要做的第一件事是创建一个新的 Cronjob，它每分钟运行一次以处理特定的任务，例如会话清理并将计划任务发送到守护进程。您需要使用 sudo crontab -e 打开您的 crontab，然后将以下字符串以新一行粘贴进去，并保存更改。

* * * * * php /www/wwwroot/pterodactyl/artisan schedule:run >> /dev/null 2>&1

创建队列监听服务

接下来，您需要创建一个新的 systemd 来保持我们的队列进程在后台运行。该队列负责发送电子邮件并为翼龙面板处理许多其他后台任务。

在 /etc/systemd/system 文件夹中创建一个名为 pteroq.service 的文件，其内容如下。

# 翼龙工作队列文件
# ----------------------------------

[Unit]
Description=Pterodactyl Queue Worker
# After=redis-server.service

[Service]
# 在某些系统上用户和组可能不同。
# 有些系统使用 `apache` 或 `nginx` 作为用户和组。
User=www
Group=www
Restart=always
ExecStart=/usr/bin/php /www/wwwroot/pterodactyl/artisan queue:work --queue=high,standard,low --sleep=3 --tries=3
StartLimitInterval=180
StartLimitBurst=30
RestartSec=5s

[Install]
WantedBy=multi-user.target

提示

你在 PHP 安装 redis 拓展时应该自动安装了 redis 并启动了，但如果发现应用商店中没有或未启动 redis ，你应该启动它。
如果你的面板路径并不是 /www/wwwroot/pterodactyl/，请替换为你面板的绝对路径，否则邮件服务将无法使用。
如果你宝塔默认命令行使用的并不是 8.1PHP 可以尝试使用绝对路径，将 /usr/bin/php 改为 /www/server/php/81/bin/php

最后，启动队列监听服务并设置开启自动启动

sudo systemctl enable --now pteroq.service