# 安裝翅膀

Wings 是 Pterodactyl 的下一代伺服器控制平面。它是從 使用 Go 進行基礎構建,並從我們的第一個 Nodejs 守護進程中吸取經驗教訓。

::: 警告 僅當您執行 Pterodactyl 1.x 時才應安裝 Wings。不要安裝這個軟體 對於早期版本的 Pterodactyl。 :::

# 支援的系統

以下是支援的作業系統清單。請注意,這並不是一份詳盡的清單, 您很有可能可以毫不費力地在其他 Linux 發行版上運行該軟體。 您負責確定這些系統可能需要哪些軟體包。還有一個非常 以下受支援作業系統的新版本很有可能可以正常運作,您不限於 僅以下列出的版本。

作業系統 版本 支援 筆記
Ubuntu 20.04 20.04 ✅ 假設 Ubuntu 20.04 作為基本作業系統編寫的文檔。
22.04 22.04 ✅
24.04
RHEL / Rocky Linux / AlmaLinux 8
9
Debian 11 11 ✅
12 12 ✅
13
Windows 全部 該軟體不能在 Windows 環境中運作。

# 系統需求

要運行 Wings,您需要一個能夠運行 Docker 容器的 Linux 系統。大多數 VPS 和幾乎所有 專用伺服器應該能夠運行 Docker,但也存在一些邊緣情況。

當您的提供者使用 VirtuozzoOpenVZ (或 OVZ )或 LXC 虛擬化時,您很可能無法 運行翅膀。一些提供者已對巢狀虛擬化進行了必要的更改以支援 Docker。請詢問您的提供者的支援團隊以進行確認。 KVM 保證工作。

最簡單的檢查方法是輸入 systemd-detect-virt 。 如果結果不包含 OpenVZLXC ,應該沒問題。當執行沒有任何虛擬化的專用硬體時,會出現 none 的結果。

如果由於某種原因不起作用,或者您仍然不確定,您也可以執行下面的命令。

dane@pterodactyl:~$ sudo dmidecode -s system-manufacturer
VMware, Inc.

# 依賴關係

  • 捲曲
  • 碼頭工人

# 安裝 Docker

若要快速安裝 Docker CE,可以執行下列命令:

curl -sSL https://get.docker.com/ | CHANNEL=stable bash

如果您希望手動安裝,請參考 official Docker documentation (opens new window) 以了解如何在您的伺服器上安裝 Docker CE。

::: 警告 檢查你的內核 請注意,某些主機安裝了不支援重要 docker 功能的修改後的核心。請 透過執行 uname -r 檢查您的核心。如果你的核心以 -xxxx-grs-ipv6-64-xxxx-mod-std-ipv6-64 結尾,那麼你就是 可能使用不受支援的內核。有關詳細信息,請查看我們的 Kernel Modifications 指南。 :::

# 在啟動時啟動 Docker

如果您使用的是具有 systemd 的作業系統(Ubuntu 16+、Debian 8+、CentOS 7+),請執行以下命令,以便在啟動電腦時啟動 Docker。

sudo systemctl enable --now docker

# 啟用交換

::: 提示 最近的 Linux 內核 從Linux核心6.1版本開始,swap預設是開啟的。如果您執行的是 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可執行檔。

sudo mkdir -p /etc/pterodactyl
curl -L -o /usr/local/bin/wings "https://github.com/pterodactyl/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 命令並將其貼上到終端中。

example image of wings configuration

::: 警告 當您的面板使用 SSL 時,Wings 也必須為其 FQDN 建立一個 SSL。在繼續之前,請參閱 Creating SSL Certificates 文件頁面以了解如何建立這些證書。 :::

# 起始翅膀

要啟動 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。若要建立新分配,請前往「節點」>「您的節點」>「分配」。

example image of node allocations

鍵入 hostname -I | awk '{print $1}' 以尋找要用於指派的 IP。或者,您可以輸入 ip addr | grep "inet " 查看所有可用的介面和 IP 位址。不要使用 127.0.0.1 進行分配。