FiveM 伺服器完整指南：在 Ubuntu 上使用 txAdmin 架設與管理
什麼是 FiveM？什麼是 txAdmin？
FiveM 是一套允許玩家建立自訂遊戲模式的 GTA V 伺服器平台，廣泛用於角色扮演伺服器 (Roleplay)、賽車、死鬥等玩法。
txAdmin 是 FiveM 官方內建的網頁版伺服器管理面板，提供以下功能：
- 透過網頁介面啟動、重啟、關閉伺服器
- 即時監控伺服器資源使用情況 (CPU、記憶體、玩家數量)
- 管理伺服器配置檔案 (server.cfg)
- 踢人、封禁、警告玩家
- 自動備份資料
- 快速部署熱門伺服器模板 (QBCore、ESX 等)
核心優勢：不需要複雜的網頁伺服器設置，FiveM 內建就有，啟動後立刻可用。
前置需求
硬體要求
- 作業系統：Ubuntu 20.04 LTS 或更新版本 (推薦 22.04/24.04)
- CPU：最少 2 核心 (建議 4+ 核心)
- RAM：最少 4GB (建議 8GB 以上)
- 硬碟：最少 20GB 可用空間 (建議使用 SSD)
- 網路：穩定的網際網路連線
帳號與金鑰
- Cfx.re 帳號 (免費註冊)：造訪 https://cfx.re/ 並登入或建立帳號
- License Key (免費生成)：登入後前往 https://keymaster.fivem.net/ 生成伺服器金鑰
步驟 1：準備 Ubuntu 環境
首先，更新系統並安裝必要的工具：
sudo apt update && sudo apt upgrade -y
sudo apt install -y git wget xz-utils screen curl
各工具說明：
git/wget/curl：用於下載伺服器檔案xz-utils：用於解壓縮伺服器核心screen：讓伺服器在背景執行，即使關閉 SSH 終端機也不會停止
建立一個專門放伺服器檔案的目錄：
mkdir -p ~/fivem/server
cd ~/fivem/server
步驟 2：下載 FiveM 伺服器核心
前往 FiveM 官方 Artifacts 頁面取得最新的伺服器構建版本。
對於 Linux (推薦)：
# 進入你的伺服器目錄
cd ~/fivem/server
# 訪問此連結取得最新版：https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/
# 複製 Latest Recommended (或最新版本) 的連結並下載
# 範例 (連結會因版本更新而改變，請務必複製最新的)
wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/[最新版本號]/fx.tar.xz
# 解壓縮
tar xf fx.tar.xz
# 刪除壓縮檔
rm fx.tar.xz
如何確認最新版本：
- 開啟瀏覽器訪問 https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/
- 找到資料夾名稱最大的版本 (通常最下方)
- 進入該資料夾，複製
fx.tar.xz的完整 URL
步驟 3：啟動伺服器並進入 txAdmin 設置
使用 screen 在背景執行伺服器，這樣即使關閉 SSH 連線伺服器也會持續運行。
# 進入 screen 虛擬視窗 (命名為 fivem)
screen -S fivem
# 進入伺服器目錄
cd ~/fivem/server
# 執行啟動腳本
./run.sh
稍待幾秒，你會看到類似以下的輸出：
^3┌────────────────────────────────────────────────────┐
│ txAdmin is starting... Please wait... │
│ URL: http://你的伺服器IP:40120 │
│ PIN: 1234 │
└────────────────────────────────────────────────────┘^0
重要：記下顯示的 PIN 碼 和 URL。
暫時離開 screen (保持伺服器執行)
按下 Ctrl + A，然後按下 D (Detach)。這樣會回到一般的終端機，但伺服器會在背景執行。
# 驗證 screen 有在執行
screen -list
# 應該會看到一個名為 fivem 的 screen session
步驟 4：進入 txAdmin 網頁面板設置
- 開啟瀏覽器，輸入網址：
http://你的伺服器IP:40120- 如果是在本機測試，用
http://localhost:40120
- 如果是在本機測試，用
- 輸入 PIN 碼：貼上剛剛看到的 4 位數 PIN 碼
- 綁定 Cfx.re 帳號：
- 系統會要求你登入 Cfx.re (FiveM 官方帳號)
- 按下 “Link Account” 完成驗證
- 建立 Master 帳號：
- 設定一個用於登入 txAdmin 的使用者名稱和密碼
- 這就是你以後管理伺服器的登入帳號
- Server Setup Wizard (伺服器設置精靈)：進入後會看到 “Go to Setup” 或 “Deploy Server” 按鈕，點擊進入精靈。
- Server Name：幫你的伺服器取名字 (例如：「My Roleplay Server」)
- Deployment Type：選擇 “Popular Recipes” (推薦新手)
- Choose a Recipe：
- QBCore Framework (推薦)：功能齊全的角色扮演框架，社群大
- ESX Framework：另一套熱門框架
- Minimal / Blank：如果你想從零開始建置
- Data Location：保持預設值，直接點 “Next”
- 生成或輸入 License Key：
- 如果你還沒有 License Key，前往 https://keymaster.fivem.net/
- 登入 Cfx.re 帳號，點擊 “New Server”
- Server Type 選 “VPS” (虛擬私人伺服器)
- 將生成的金鑰複製回 txAdmin
- 執行 Recipe 部署：
- txAdmin 會自動下載所有必要的資源和配置檔案
- 這可能需要 1-5 分鐘，取決於網速和伺服器選擇
- 完成設置：
- 檢查所有設置無誤後，點擊 “Save & Start Server”
- 伺服器會自動啟動！
步驟 5：設定防火牆與連接埠
為了讓玩家能連線到你的伺服器，需要開放以下連接埠 (Port)：
開放 UFW 防火牆 (Ubuntu 內建)
# 開放遊戲連接埠 (30120)
sudo ufw allow 30120
# 開放 txAdmin 管理面板連接埠 (40120/TCP)
sudo ufw allow 40120/tcp
# 重新載入防火牆設定
sudo ufw reload
# 驗證開放的連接埠
sudo ufw status
如果使用雲端服務商 (AWS / GCP / Azure / Linode)
進入你的雲服務後台，在 Security Group 或 防火牆設定 中新增以下規則：
| 連接埠 | 協議 | 允許範圍 | 用途 |
|---|---|---|---|
| 30120 | TCP/UDP | 0.0.0.0/0 (任何人) | 遊戲連線 |
| 40120 | TCP | 0.0.0.0/0 或限制 IP | txAdmin 面板 |
安全建議：txAdmin 面板 (40120) 可以只允許你的 IP 連線，不需要對全世界開放。
步驟 6：驗證伺服器是否正常運行
- 確認伺服器在執行：
# 回到 screen 視窗查看伺服器狀態 screen -r fivem你應該會看到伺服器的實時日誌。如果看不到任何錯誤，表示伺服器正常運行。
按Ctrl + A再按D回到終端機。 - 檢查 txAdmin 面板：重新打開瀏覽器進入
http://你的伺服器IP:40120，用你設定的帳號密碼登入。你應該可以看到：- 伺服器是否在線
- 目前玩家數量
- CPU、RAM、網路使用情況
- 資源列表
- 在 GTA V 中連線測試：如果你有 GTA V，可以嘗試連線到你的伺服器：
- 在 GTA V 中按
F8開啟主機連線視窗 - 輸入：
connect 你的伺服器IP:30120 - 如果能進入遊戲就表示成功！
- 在 GTA V 中按
txAdmin 基本操作介紹
| 功能 | 位置 | 說明 |
|---|---|---|
| 重啟伺服器 | Dashboard > 綠色按鈕 | 立即重啟，玩家會被踢出 |
| 停止伺服器 | Dashboard > 紅色按鈕 | 關閉伺服器 |
| 管理資源 | Resources > 資源清單 | 啟用、禁用、更新資源 |
| 玩家管理 | Players > 在線玩家清單 | 踢人、封禁、警告 |
| 編輯配置 | CFG Editor | 修改 server.cfg 設定檔 |
| 備份 | Backups | 手動備份或設定自動備份 |
| 日誌檢視 | Logs | 查看伺服器執行日誌 |
常見問題 (Q&A)
Q1：伺服器啟動後，玩家無法連線怎麼辦？
A：按照以下步驟排查：
- 確認伺服器在執行
- 進入 txAdmin 面板，檢查伺服器狀態是否為「Running」
- 檢查防火牆設定
sudo ufw status # 確認 30120 (TCP & UDP) 與 40120 (TCP) 都已開放 - 檢查 License Key 是否有效
- 進入 txAdmin 的 “Server” 分頁，查看是否有紅色警告訊息
- 確保你在 https://keymaster.fivem.net/ 生成的金鑰已正確輸入
- 如果使用雲服務商，檢查 Security Group
- AWS / GCP / Azure 可能有額外的防火牆規則，確認 30120 已開放
Q2：忘記 txAdmin 登入密碼怎麼辦？
A：刪除 txData 資料夾重新初始化：
cd ~/fivem/server
# 停止伺服器 (進入 screen 後按 Ctrl + C)
screen -r fivem
# 刪除 txData 資料夾 (會遺失所有 txAdmin 設定)
rm -rf txData
# 重新執行伺服器，會重新要求 PIN 碼和設置
./run.sh
警告：刪除 txData 會遺失所有你在 txAdmin 面板中的設定，建議先備份重要資料。
Q3：伺服器效能不好，玩家遊戲卡頓怎麼辦？
A：幾種改善方向：
- 檢查資源占用
- 進入 txAdmin > Dashboard，查看 CPU、RAM、網路使用率
- 如果某些資源占用過高，可以在 “Resources” 分頁禁用它
- 升級伺服器規格
- 如果 CPU/RAM 經常達到 80-90%，需要升級主機方案
- 建議至少 4 核心 CPU + 8GB RAM
- 優化 server.cfg
- 減少伺服器的最大玩家人數
- 禁用不必要的資源
- 增加 “sv_maxClients” 的值要謹慎，玩家太多會卡
- 使用 SSD 主機
- 相比傳統硬碟，SSD 能大幅提升資源加載速度
Q4：我想安裝自訂資源 (Mods)，該怎麼做？
A：安裝資源有兩種方式：
方法 1：透過 txAdmin (推薦新手)
- 進入 txAdmin > Resources
- 點擊 “Create Resource”，輸入資源名稱
- 會建立一個資源資料夾，將資源檔案上傳進去
- 在 txAdmin 中重啟伺服器
方法 2：手動上傳
- 用 FTP 或 SFTP 連線到你的伺服器
- 進入
~/fivem/server/resources資料夾 - 將資源資料夾複製進去
- 在 server.cfg 加入
ensure 資源名稱(通常資源內會有說明) - 重啟伺服器
提示：大部分資源會有 README 檔案，說明如何安裝與配置。
Q5：server.cfg 中的哪些設定最重要？
A：以下是常見且重要的設定：
# 伺服器顯示名稱
sv_projectName "你的伺服器名稱"
# 伺服器描述 (玩家在列表中看到)
sv_projectDesc "你的伺服器描述"
# 伺服器連接埠
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
# 最大玩家人數
sv_maxClients 32
# License Key (從 keymaster.fivem.net 取得)
sv_licenseKey "你的金鑰"
# 語言
set locale "zh-TW"
# 資源
ensure qb-core # 若使用 QBCore
ensure es_extended # 若使用 ESX
詳細設定說明請參考 FiveM 官方文件。
Q6：定期備份資料很重要嗎？
A：非常重要。建議設定自動備份：
- 進入 txAdmin > Backups
- 點擊 “Settings” 設定自動備份排程
- 建議每天在玩家較少的時段備份 (例如凌晨 3 點)
自動備份會備份：
- server.cfg 配置檔
- 所有資源檔案
- 遊戲資料庫 (如果使用 MySQL)
如果伺服器發生問題或資料遺失，可以快速還原到之前的版本。
Q7：如何限制伺服器只有白名單玩家可進？
A：可以在 txAdmin 設定白名單，或在資源中實現。txAdmin 的方法最簡單：
- 進入 txAdmin > Settings > Whitelist
- 啟用白名單模式
- 新增玩家到白名單 (可透過玩家名稱或 Steam ID)
進階方法可以使用白名單資源，例如 qb-whitelist 或 esx_whitelist。
Q8：server.cfg 修改後要重啟伺服器嗎？
A：通常 需要重啟。大部分設定要在伺服器啟動時才會讀取。
做法：
- 在 txAdmin > CFG Editor 修改設定檔
- 按下 “Save”
- 回到 Dashboard，點擊 “Restart Server” (或 “Stop” 再 “Start”)
- 伺服器會在玩家離線後重新啟動
提示：部分資源可能支援熱重載 (不需重啟)，但大多數不支援。
Q9：伺服器突然沒反應，該怎麼強制重啟？
A：可以用 SSH 指令或 txAdmin：
方法 1：透過 txAdmin (最簡單)
- 進入 Dashboard，點擊紅色的 “Stop Server” 按鈕
- 等 5-10 秒後，點擊綠色的 “Start Server” 按鈕
方法 2：透過 SSH 終端機
# 進入 screen 視窗
screen -r fivem
# 按 Ctrl + C 強制停止伺服器
# 重新執行
./run.sh
Q10：我想移到另一台伺服器，該怎麼遷移？
A：完整遷移步驟：
- 在舊伺服器備份
- 進入 txAdmin > Backups，建立一份完整備份
- 或手動複製整個
~/fivem/server資料夾
- 在新伺服器設置 FiveM
- 按照本指南的步驟 1-3 重新建置
- 恢復資料
- 如果使用 txAdmin 備份：進入 Backups，點擊 “Restore”
- 如果手動複製：將舊伺服器的資源和 server.cfg 複製到新伺服器
- 測試
- 重啟伺服器並驗證所有資源和資料是否正確
Q11：如何修改伺服器的連接埠 (不是 30120)？
A：修改 server.cfg 中的端點設定：
# 預設設定
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
# 改為例如 30121
endpoint_add_tcp "0.0.0.0:30121"
endpoint_add_udp "0.0.0.0:30121"
重要：
- 修改後要重啟伺服器
- 務必在防火牆中開放新的連接埠
- 玩家連線時要用新連接埠 (例如
connect 伺服器IP:30121)
Q12：txAdmin 面板無法存取 (顯示連線被拒絕) 怎麼辦？
A：排查步驟：
# 確認伺服器有在執行
screen -list
# 確認有 txAdmin 的 screen session 在執行
# 如果沒有，用以下指令重新啟動
screen -S fivem
cd ~/fivem/server
./run.sh
進一步檢查：
- 檢查防火牆：
sudo ufw status確認 40120 有開放 - 檢查雲服務商設定：AWS / Azure 等都要設定 Security Group
- 嘗試不同的連線方式：
- 本機：
http://localhost:40120 - 遠端：
http://你的伺服器公開IP:40120
- 本機：
- 檢查 txAdmin 連接埠是否被佔用：更改連接埠重試
# 修改 server.cfg 或啟動時指定連接埠
./run.sh +set txAdminPort 50120
日常伺服器維護檢查清單
| 項目 | 頻率 | 操作 |
|---|---|---|
| 檢查伺服器狀態 | 每天 | 登入 txAdmin 確認在線 |
| 檢查資源錯誤 | 每天 | 查看 Logs 有無異常 |
| 自動備份 | 每天 | txAdmin 自動執行 (設定好後) |
| 重啟伺服器 | 每週 1-2 次 | 清理記憶體洩漏 |
| 檢查玩家反饋 | 每週 | 收集故障報告並修復 |
| 更新資源/FiveM | 每月 | 檢查有無重要更新 |
| 整理過期備份 | 每月 | 刪除舊備份節省空間 |
進階話題：多個伺服器、Pterodactyl 面板、VPS 優化
如果你想要：
- 同時管理 多個 FiveM 伺服器
- 使用更強大的 Pterodactyl 面板 (也能管理 Minecraft、Rust 等其他遊戲)
- 優化 雲端基礎設施 (Auto Scaling、負載平衡)
這些都超出此入門指南的範圍，但都是可行的。如果有需要，可以聯絡我們提供進階方案。
額外資源與求助
- FiveM 官方文件：https://docs.fivem.net/
- FiveM 官方論壇：https://forum.cfx.re/
- Cfx.re Keymaster：https://keymaster.fivem.net/
- QBCore 文件：https://github.com/qbcore-framework/qbcore
