這篇文章會教你如何完整設定 Minecraft Proxy，包含安裝、基本配置與常見問題排解。

什麼是 Minecraft Proxy

上圖很好地說明了 Proxy 的運作方式。

玩家會先連線到 Proxy，接著由 Proxy 負責轉發連線，將玩家導向不同的子伺服器（例如生存服、建築服或小遊戲服）。

這種架構的好處是，玩家只需要記住一個入口 IP，就可以進入整個伺服器群組，不需要分別連線到不同伺服器。

為什麼你需要Proxy

如果你只有一個簡單的 Minecraft 伺服器，可能不一定需要 Proxy。

但當你的伺服器開始擴展，例如有生存服、建築服、小遊戲服等不同模式時，如果沒有 Proxy，玩家就必須分別連線不同的 IP，非常不方便。

透過 Proxy，你可以讓玩家只需要連進一個入口，就能在不同伺服器之間自由切換，同時也方便管理與擴充整個伺服器架構。

Proxy 也可以讓伺服器的管理更有彈性。

例如當某個子伺服器需要重啟或維護時，玩家可以先被引導到其他可用的伺服器，等維護完成後再重新連回原本的伺服器。

Proxy 架設流程

準備伺服器

在開始架設 Proxy 之前，你需要準備一台可以使用的伺服器。

一般來說，你可以使用 VPS（虛擬主機）或任何可以運行 Minecraft 伺服器的主機環境。

如果你已經有一台可以登入的伺服器，就可以直接進入下一步。

（簡單來說，就是一台可以一直開著、用來跑 Minecraft 伺服器的電腦）

下載 Proxy

接下來我們需要下載 Proxy 核心檔案。

目前常見的有 Velocity 和 BungeeCord，這裡我們以 Velocity 為例。

接著進入 Velocity 的官方下載頁面，下載最新版本的核心檔案（.jar）。

請點選最新版本的下載按鈕，下載完成後你會得到一個 .jar 檔案。

下載完成後，將這個 .jar 檔案放到你的伺服器資料夾中。

建議使用一個全英文名稱的空資料夾來存放，例如：proxy-server，避免之後出現路徑或編碼問題。

第一次啟動 Proxy

接下來，我們要第一次啟動 Proxy。

注意：如果你看不到 .txt 或副檔名，請先開啟「檔案副檔名顯示」，避免檔案變成 start.bat.txt。

首先，在伺服器資料夾中新增一個文字文件。

打開這個文字檔，輸入以下內容：

@echo off
java -Xms1G -Xmx1G -jar 你的檔案名稱.jar
pause

存檔後，再將檔案名稱改成 start.bat。(記得把.txt刪除)

如果系統跳出警告，請選擇「是」，允許更改副檔名。

完成 start.bat 之後，直接雙擊這個檔案來啟動 Proxy。

第一次啟動時，系統會自動產生設定檔與必要資料夾，這是正常現象。

如果看到黑色視窗一直跑文字，不要關掉，這代表 Proxy 正在正常運作。

確認 Proxy 可以正常啟動後，先將視窗關閉，準備進行設定。

設定 Proxy

在資料夾中，你會看到一個設定檔（通常是 velocity.toml）。

不要緊張，我們只需要修改其中幾個地方，不需要全部看懂。

找到設定檔中的 servers 區塊，這裡是用來設定你的子伺服器。

你可能會看到類似這樣的內容：

[servers]
# Configure your servers here. Each key represents the server's name, and the value
# represents the IP address of the server to connect to.
lobby = "127.0.0.1:30066"
factions = "127.0.0.1:30067"
minigames = "127.0.0.1:30068"

每一行代表一個子伺服器：

左邊的名稱（例如 lobby）是伺服器名稱
右邊的 IP:port 則是該伺服器的位置

如果你目前只有一個子伺服器，可以先刪除其他不需要的設定，只保留一個即可。

例如：

[servers]
lobby = "127.0.0.1:30066"

這代表玩家進入 Proxy 後，會被導向這個子伺服器。

在同一個設定檔中，再找到這一行：

player-info-forwarding-mode = "NONE"

改成：

player-info-forwarding-mode = "modern"

連接子伺服器

關閉驗證

在連接之前，我們需要先設定子伺服器，讓 Proxy 可以正常轉發玩家連線。

打開你的 Paper 子伺服器資料夾，找到 server.properties。

找到以下這一行：

online-mode=true

將它改成：

online-mode=false

這是因為驗證會由 Proxy 負責處理，子伺服器不需要再進行驗證。

設定子伺服器 Port

接下來設定子伺服器的埠號（Port）。

打開 server.properties，找到：

server-port=25565

將它改成未被使用的埠號，例如： (記得與Proxy配置一致)

server-port=30066

啟用 Velocity 支援

打開 config/paper-global.yml，找到 proxies.velocity。

  velocity:
    enabled: false
    online-mode: true
    secret: ''

修改成

  velocity:
    enabled: true
    online-mode: true
    secret: ''

設定 Velocity Secret

接下來需要讓子伺服器與 Proxy 進行驗證連線。

在 Proxy 資料夾中，你會找到一個 forwarding.secret 檔案。

打開這個檔案，複製裡面的內容（這是一串隨機字串）。

kMxrNO9L8qem

然後回到 paper-global.yml，填入：

  velocity:
    enabled: true
    online-mode: true
    secret: '剛剛複製的內容'

這樣 Proxy 才能確認這台子伺服器是可信的。

檢查連線是否成功

完成所有設定後，我們來測試 Proxy 是否正常運作。

開啟 Minecraft，輸入 Proxy 的 IP 進入伺服器。

如果你是在同一台電腦測試，可以直接輸入：

127.0.0.1

如果是遠端伺服器，則輸入你的伺服器 IP。

如果成功進入，代表你的 Minecraft Proxy 已經架設完成。

延伸應用（新增子伺服器）

如果之後要新增子伺服器，只需要修改 Proxy 的設定檔即可。

打開 velocity.toml，找到 [servers] 區塊。

新增伺服器的格式如下：

servername = "IP:port"

例如：

[servers]
lobby = "127.0.0.1:30066"
minigames = "127.0.0.1:30067"

其中 127.0.0.1 代表「本機電腦」，也就是 Proxy 和子伺服器在同一台主機時使用。

如果你的子伺服器在不同主機，這裡就要改成對應的內網或外網 IP。

常見問題檢查清單

如果無法連線，可以依照以下項目檢查：

Java 版本是否符合 Minecraft / Velocity 要求

防火牆是否允許對應的 port（例如 25565、30066）

子伺服器 IP 是否正確（本機為 127.0.0.1，遠端需改成實際 IP）

Proxy 與子伺服器是否在同一台主機

所有伺服器是否已重新啟動（設定改完一定要重啟）

如需技術協助（Proxy / 外網 / 伺服器設定）
可透過 Discord Ticket 聯繫
會依問題提供報價與處理方式

• 本教學適用Ubuntu noble 24.04 不保證其他版本可順利操作
• 請使用root登入你的SSH來操作

為什麼?

每天網路上都有成千萬的網路嗅探器在工作，如果你的伺服器使用密碼登入，很容易受到攻擊，因為密碼可以直接使用爆破攻擊爆破，如果你使用SSH key呢，爆破成功的機率大約是3.09 × 10⁻⁶¹⁷，基本上可以說是不可能。

影片教學

未完待續

執行指令

#生成密鑰
ssh-keygen -t ed25519 -C "yourmail@gmail.com" -f /root/.ssh/sshkey -N ""

#將密鑰寫入文件並且加上授權
cat ~/.ssh/sshkey.pub >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys

拷貝金鑰

你可以透過Termius或WinSCP等….工具在/root/.ssh/ 底下找到一個叫做sshkey的文件或你也可以通過查看金鑰

cat ~/.ssh/sshkey

繼續執行

#這邊使用nano編輯器你可以換成你自己喜歡的編輯器
nano /etc/ssh/sshd_config

然後呢修改設定到底下那樣
PermitRootLogin prohibit-password
PasswordAuthentication no
PubkeyAuthentication yes
ChallengeResponseAuthentication no #這個設定有可能會沒有

載入配置

systemctl restart ssh #有些系統會叫sshd