Cara Pasang Pelayan FiveM di VPS Ubuntu

Keperluan pelayan FiveM pada VPS

Pelayan FiveM pada VPS memerlukan satu pengguna Linux tanpa keistimewaan (unprivileged), satu binaan artifak daripada Cfx.re, satu kunci lesen, dan satu port yang dibuka pada kedua-dua protokol TCP dan UDP. Pemasangan mengambil masa kira-kira sepuluh minit. Bahagian panduan seterusnya merangkumi aspek yang menentukan sama ada pelayan tersebut boleh dimainkan: kelajuan teras CPU tunggal, memori yang diperlukan oleh sumber (resources) anda, dan panel pengurusan yang tidak sepatutnya dibiarkan terbuka pada alamat awam.

Tiga prasyarat adalah tetap. Binari pelayan, yang dipanggil artifak, diperoleh daripada senarai binaan rasmi Cfx.re. Kunci lesen diperoleh daripada portal Cfx.re di portal.cfx.re, perkhidmatan yang dipanggil sebagai keymaster dalam panduan lama, dan kunci tersebut terikat pada alamat mesin yang menggunakannya. Setiap pemain yang menyambung perlu mempunyai salinan sah GTA V (Grand Theft Auto V) mereka sendiri di Steam, Rockstar Games Launcher atau Epic Games, serta akaun Cfx.re percuma. Pelanggan (client) akan menyemak pemilikan permainan semasa ia bermula, jadi pelayan yang dibina atas apa-apa selain daripada itu tidak akan berfungsi, dan tiada kandungan penyelesaian (workaround) dalam apa jua bentuk yang diliputi di sini.

Menghoskan pelayan adalah tugas yang berbeza daripada bermain pada mesin tersebut, iaitu sama ada anda boleh menjalankan permainan itu sendiri pada VPS dan merupakan soalan berasingan dengan jawapan yang berbeza.

Mengapa kelajuan teras tunggal menentukan kelancaran pelayan FiveM

FXServer, iaitu binari pelayan FiveM, menjalankan logik permainan pada satu thread utama. Setiap skrip sumber, setiap pengendali acara dan setiap kemas kini status melalui gelung tunggal tersebut. Teras tambahan membantu kernel, pangkalan data dan stack rangkaian. Ia tidak memecahkan gelung permainan. Oleh itu, kotak 4 vCPU dengan teras yang perlahan akan mengalami sela (stutter) di bawah beban, manakala kotak 2 vCPU dengan teras yang pantas kekal lancar.

Ini menyongsangkan tabiat biasa membeli VPS, di mana jumlah teras menjadi angka utama. Semak kelajuan setiap teras sebelum anda melaburkan wang. Mulakan dengan model CPU:

lscpu | grep -E 'Model name|MHz'

Kemudian, cari skor thread tunggal yang diterbitkan untuk model tersebut. Penilaian thread tunggal PassMark dan skor teras tunggal Geekbench adalah umum, dan kedua-duanya mengukur satu teras yang sedang melakukan kerja, iaitu angka yang penting di sini. Selepas itu, ukur kotak yang sebenarnya diberikan kepada anda:

sudo apt update && sudo apt install -y sysbench
sysbench cpu --cpu-max-prime=20000 --threads=1 run

Baca baris events per second. Jalankan perintah yang sama pada dua penyedia calon dan anda boleh membandingkannya dengan jujur, kerana beban kerja adalah sama dan ia dihadkan kepada satu teras. Ujian penanda aras VPS yang boleh diulang menunjukkan cara untuk memastikan angka tersebut setara antara kotak.

Kemudian, pastikan teras tersebut benar-benar milik anda:

vmstat 1 5

Lajur terakhir, st, ialah steal time: bahagian masa CPU maya anda sedia untuk berjalan tetapi hypervisor membiarkannya menunggu. Angka yang stabil melebihi 1 atau 2 bermakna anda berkongsi teras fizikal dengan jiran yang sibuk, dan gelung permainan akan merasainya serta-merta sebagai rubber banding. Steal time daripada jiran yang bising merangkumi cara membaca lajur tersebut dan tindakan yang perlu diambil.

Memori berskala mengikut sumber yang anda jalankan, bukan sekadar slot. Data pelayan asas daripada Cfx.re berjalan dalam beberapa ratus megabait. Rangka kerja main peranan (roleplay) dengan empat puluh atau lima puluh sumber dan pangkalan data MariaDB pada kotak yang sama adalah mesin yang berbeza: 4 GB ialah lantai yang munasabah, dan 8 GB adalah selesa pada 32 hingga 64 slot. Itu adalah angka tipikal yang diterbitkan oleh persediaan komuniti, jadi anggap ia sebagai titik permulaan dan pantau free -m di bawah beban pemain sebenar.

Cipta pengguna dan pasang dependensi

Jalankan pelayan sebagai pengguna biasa, jangan sekali-kali sebagai root. Terdapat dua sebab. Root ialah tabiat buruk bagi mana-mana servis yang menghadap internet. Selain itu, artifak Linux tersebut berjalan di dalam sistem fail root Alpine Linux yang dibundel, jadi fail yang dinyahzip oleh root tidak boleh dilaksanakan oleh orang lain. Ini merupakan punca paling biasa mengapa pemasangan baharu gagal bermula.

sudo adduser --disabled-password --gecos "" fivem
sudo apt update
sudo apt install -y git xz-utils curl tcpdump
sudo -iu fivem

Segala arahan di bawah dijalankan sebagai pengguna fivem. xz-utils diperlukan kerana muat turun tersebut merupakan arkib .tar.xz, dan git digunakan untuk mengklon data pelayan asas.

Muat turun binaan artifak yang dipinkan

Binaan Linux terletak dalam saluran build_proot_linux pada pelayan artifak Cfx.re. Senarai tersebut menandakan satu binaan sebagai binaan terkini yang disyorkan, dan label itu berpindah ke binaan baharu setiap beberapa minggu. Sebaliknya, pin folder bernombor tersebut. Membina semula pelayan anda pada bulan hadapan akan memberikan anda binari yang sama dengan yang anda uji bulan ini, dan naik taraf menjadi keputusan yang anda buat dengan sengaja.

mkdir -p ~/FXServer/server
cd ~/FXServer/server
curl -fLO https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/25770-8ddccd4e4dfd6a760ce18651656463f961cc4761/fx.tar.xz
tar xf fx.tar.xz
ls

Binaan 25770 membawa label yang disyorkan semasa saya membaca senarai tersebut pada Ogos 2026. Buka direktori yang sama dalam pelayar untuk melihat binaan semasa, kemudian tampal nama folder tersebut, iaitu nombor binaan berserta hash komit, ke dalam URL.

ls kini sepatutnya memaparkan run.sh dan direktori alpine. Direktori itu adalah kunci utama: artifak Linux tersebut menghantar sistem fail root Alpine kecilnya sendiri dan memulakan pelayan di dalamnya menggunakan proot, iaitu alat ruang pengguna yang meniru chroot tanpa keistimewaan root. Itulah sebabnya satu muat turun boleh dijalankan pada Ubuntu, Debian dan Rocky tanpa pakej khusus pengedaran.

Sekarang, klon data pelayan asas yang menyimpan sumber lalai yang dimulakan oleh server.cfg anda:

git clone https://github.com/citizenfx/cfx-server-data.git ~/FXServer/server-data

Dapatkan kunci lesen dan tulis server.cfg

Log masuk ke portal.cfx.re menggunakan akaun Cfx.re anda dan cipta kunci pelayan. Portal tersebut akan meminta alamat IP mesin yang akan menggunakannya, dan kunci tersebut akan terikat pada alamat itu. Berpindah ke VPS baharu bermakna anda perlu menyunting kunci tersebut di dalam portal, bukannya mencipta kunci kedua. Suntingan tersebut berkuat kuasa serta-merta, tetapi FXServer hanya akan melakukan pengesahan semula apabila ia dimulakan semula.

Tulis ~/FXServer/server-data/server.cfg:

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap

sv_hostname "My FiveM server"
sv_maxclients 48
set onesync on
sv_scriptHookAllowed false

sv_licenseKey ChangeMe

add_ace group.admin command allow
add_principal identifier.fivem:1 group.admin

sv_maxclients menerima nilai daripada 1 hingga 2048. Nilai 32 atau lebih memerlukan onesync ditetapkan kepada on atau legacy, dan nilai melebihi 64 memerlukan on. OneSync ialah mod kesedaran status pelayan, dan ia membolehkan pelayan melepasi had slot kecil permainan asas. Menetapkan 128 slot dengan OneSync dimatikan tidak akan memberikan anda 128 slot, sebaliknya ia memberikan konfigurasi yang akan ditolak oleh pelayan.

sv_licenseKey mengambil kunci tersebut tanpa tanda petikan dan tanpa ruang kosong di hujungnya. FXServer memisahkan baris tersebut berdasarkan ruang kosong, jadi satu aksara tambahan akan merosakkan pengesahan dan pelayan akan enggan bermula.

rcon_password sengaja ditinggalkan daripada fail tersebut. RCON (konsol jauh) hanya dihidupkan apabila pemboleh ubah tersebut ditetapkan, dan ia kemudiannya mendengar pada port UDP yang sama dengan permainan. Kata laluan RCON pada port awam merupakan saluran arahan jauh ke dalam pelayan anda. Biarkan ia tidak ditetapkan melainkan anda mempunyai keperluan khusus, dan pastikan ia panjang serta rawak jika anda perlu menetapkannya.

sv_scriptHookAllowed kekal false. Dokumentasi rasmi menandakannya sebagai tidak disyorkan, kerana membenarkan klien Script Hook V mendedahkan pelayan kepada penyalahgunaan pihak klien.

add_principal identifier.fivem:1 memberikan hak pentadbir kepada ID akaun Cfx.re 1. Gantikan 1 dengan ID angka anda sendiri, jika tidak, anda telah memberikan hak pentadbir kepada akaun orang lain dan tiada hak untuk diri sendiri.

Mulakan pelayan sekali secara manual:

cd ~/FXServer/server-data
bash ~/FXServer/server/run.sh +exec server.cfg

Daripada sesi SSH kedua, tanya pelayan tentang status dirinya:

curl -s http://127.0.0.1:30120/info.json | head -c 200

JSON yang menamakan pemboleh ubah dan sumber pelayan anda bermakna FXServer telah terikat dan memberikan respons. Connection refused bermakna ia tidak berjaya mengikat port tersebut, jadi baca output konsol dan jangan membuat andaian.

Pelayan tanpa kunci akan mencetak mesej ini dan berhenti:

This server does not have a license key specified. Please set the sv_licenseKey console variable to a key from https://keymaster.fivem.net/.

Mesej tersebut masih menamakan alamat keymaster yang lama. Alamat tersebut membawa ke portal Cfx.re yang sama. Jika kunci telah ditetapkan dan pelayan masih enggan berjalan, punca lazimnya ialah alamat IP yang didaftarkan pada kunci tersebut tidak lagi sepadan dengan mesin ini.

Port manakah yang perlu dibuka untuk pelayan FiveM?

Port 30120, pada TCP (transmission control protocol) dan UDP (user datagram protocol). FiveM menggunakan satu nombor port untuk dua protokol dan ia memerlukan kedua-duanya. Jika anda hanya membuka TCP, simptomnya akan mengelirukan: http://your.ip:30120/info.json akan menjawab dalam pelayar, jadi pelayan kelihatan sihat, manakala klien permainan akan terhenti pada Failed to get info from server dan tidak dapat menyertai, kerana pertanyaan klien dan trafik permainannya berjalan melalui UDP.

sudo ufw allow OpenSSH
sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw enable
sudo ufw status verbose

Pastikan sesi SSH kedua sentiasa terbuka semasa anda mendayakan sebarang firewall. Asas ufw untuk VPS menerangkan polisi deny lalai yang menjadikan peraturan di atas mencukupi dengan sendirinya.

Kebanyakan penyedia juga menjalankan firewall rangkaian di luar tetamu, yang dikawal daripada panel dan bukannya daripada shell. Peraturan ufw tidak membuktikan apa-apa tentang lapisan tersebut. Apabila TCP menjawab dari luar tetapi pemain masih tidak dapat menyambung, pantau trafik rangkaian semasa seseorang mencuba:

sudo tcpdump -ni any udp port 30120

Jika paket sampai, bermakna firewall luaran berfungsi dengan baik dan ralat berlaku di dalam pelayan. Jika tiada trafik, bermakna sesuatu di hadapan pelayan sedang menggugurkan paket tersebut, jadi periksa panel penyedia seterusnya.

Mengurus pelayan dengan txAdmin tanpa mendedahkannya

txAdmin disertakan di dalam artifak yang telah anda muat turun. Mulakan run.sh tanpa sebarang argumen +exec dan ia akan memaparkan panel web pada port TCP 40120, kemudian mencetak URL panel serta PIN jangka hayat pendek ke konsol. Anda menggunakan PIN tersebut sekali untuk memautkan akaun Cfx.re anda, dan selepas itu anda log masuk menggunakan akaun pentadbir yang diciptanya.

txAdmin tidak mempunyai kata laluan lalai, jadi risikonya bukanlah kelayakan yang anda terlupa tukar. Risikonya ialah fungsi panel itu sendiri: sebuah konsol kawalan jauh. Ia boleh memulakan semula pelayan, menyunting server.cfg, menggunakan data pelayan dan menjalankan arahan sebagai pengguna pelayan anda. Membiarkan port 40120 boleh dicapai dari internet meletakkan halaman log masuk untuk semua fungsi tersebut pada alamat awam, dan pengimbas akan menemui port panel yang terbuka dalam masa beberapa jam. Jangan buka port 40120 dalam firewall. Capainya melalui terowong SSH dari mesin anda sendiri:

ssh -N -L 40120:127.0.0.1:40120 fivem@YOUR_SERVER_IP

Kemudian buka http://127.0.0.1:40120 dalam pelayar anda. Trafik panel bergerak di dalam sambungan SSH, dan port tersebut kekal tertutup kepada orang lain.

Satu perangkap perlu diketahui sebelum anda cuba membetulkan perkara ini dengan cara lain. txAdmin membaca TXHOST_INTERFACE (lalai 0.0.0.0) untuk menentukan antara muka mana yang perlu diikat (bind), dan dokumentasi menyatakan dengan jelas bahawa nilai yang sama dipaksa ke atas FXServer. Tetapkan ia kepada 127.0.0.1 untuk menyembunyikan panel dan anda juga akan mengikat pelayan permainan kepada loopback, jadi tiada pemain yang boleh mencapai pelayan tersebut sama sekali. Tutup port panel dengan firewall, bukan dengan pemboleh ubah tersebut. Untuk memindahkan panel ke port lain, tetapkan TXHOST_TXA_PORT, yang menerima apa sahaja kecuali 30120. Convar +set txAdminPort yang lebih lama muncul dalam banyak panduan; dokumentasi txAdmin sendiri menandakannya sebagai tidak lagi disokong (deprecated) dan menyatakan ia akan berhenti berfungsi dalam keluaran akan datang.

Pastikan pelayan terus berjalan selepas anda log keluar

bash run.sh akan tamat apabila sesi SSH anda berakhir. tmux sesuai digunakan semasa anda membuat pengujian: jalankan tmux new -s fivem, mulakan pelayan, tekan Ctrl-b kemudian d untuk menyahlampir (detach), dan gunakan tmux attach -t fivem untuk kembali semula. Sesi tmux tidak akan bertahan selepas but semula (reboot), jadi sebarang perkara penting harus diletakkan di dalam unit systemd.

Tulis /etc/systemd/system/fivem.service:

[Unit]
Description=FiveM FXServer
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=fivem
Environment=HOME=/home/fivem
WorkingDirectory=/home/fivem/FXServer/server-data
ExecStart=/bin/bash /home/fivem/FXServer/server/run.sh +exec server.cfg
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now fivem
systemctl status fivem
journalctl -u fivem -f

enable --now melakukan dua tugas: ia memulakan servis dengan serta-merta, dan ia mengaktifkan semula servis selepas but semula. Pelayan yang dimulakan secara manual akan hilang selepas kemas kini kernel yang seterusnya. journalctl -u fivem -f kini menjadi konsol anda, kerana servis systemd tidak mempunyai terminal untuk anda menaip. Jika anda menguruskan pelayan melalui txAdmin sebaliknya, alihkan +exec server.cfg daripada ExecStart dan halakan WorkingDirectory kepada /home/fivem/FXServer/server, kerana txAdmin memulakan pelayan permainan itu sendiri dan menyimpan folder datanya bersebelahan dengan run.sh.

Perkara yang perlu disandarkan, dan lokasinya

Artifak tidak perlu disandarkan kerana anda boleh memuat turun semula binaan yang dipinkan dalam masa seminit. Empat perkara berikut adalah milik anda sepenuhnya.

• ~/FXServer/server-data/resources: setiap sumber yang anda pasang, beli atau tulis.
• server.cfg, di mana sahaja ia berada: keseluruhan konfigurasi pelayan, termasuk prinsipal pentadbir anda.
• ~/FXServer/server/txData: konfigurasi, senarai pentadbir dan log txAdmin. Dengan artifak Linux, folder ini dicipta bersebelahan dengan run.sh.
• Pangkalan data MariaDB atau MySQL, jika rangka kerja anda menggunakannya. Watak, wang, kenderaan dan inventori disimpan di sana dan tidak di tempat lain, jadi sandaran sumber tanpa dump pangkalan data akan memulihkan dunia yang kosong.

mkdir -p ~/backups
mysqldump -u fivem -p --single-transaction fivem_db > ~/backups/fivem-$(date +%F).sql

Fail dump yang disimpan pada cakera yang sama dengan pelayan bukanlah sandaran, kerana cakera itulah yang sering mengalami kegagalan. Pindahkan fail tersebut keluar dari pelayan mengikut jadual, iaitu tujuan utama sandaran restic daripada VPS.

Mod kegagalan dan rentetan yang akan anda lihat

Permission denied pada loader. Pelayan berhenti serta-merta dengan baris seperti ini:

run.sh: line 8: /home/fivem/FXServer/server/alpine/opt/cfx-server/ld-musl-x86_64.so.1: Permission denied

Ini berlaku kerana arkib telah diekstrak dengan sudo, jadi segala-galanya di bawah alpine/ dimiliki oleh root dan pengguna fivem tidak boleh melaksanakan loader di dalamnya. Betulkan pemilikan dengan sudo chown -R fivem:fivem /home/fivem/FXServer, atau padam folder tersebut dan ekstrak semula sebagai fivem.

tar enggan membuka muat turun. tar (child): xz: Cannot exec: No such file or directory bermaksud pakej xz-utils tiada, jadi tar tidak boleh menyahmampat arkib .tar.xz. Pasang pakej tersebut dan ekstrak semula. Muat turun yang selesai terlalu cepat biasanya merupakan halaman ralat HTML yang disimpan sebagai fx.tar.xz, dan tar melaporkan perkara itu sebagai arkib yang rosak.

Pelayan berjalan dan tiada sesiapa boleh menyertai. Semak port dahulu, mengikut urutan ini: peraturan ufw untuk kedua-dua TCP dan UDP pada 30120, kemudian firewall rangkaian penyedia itu sendiri, seterusnya IP yang didaftarkan bagi kunci lesen. curl terhadap info.json dari luar kotak memisahkan masalah rangkaian daripada masalah pelayan dalam satu arahan.

Masa tick meningkat apabila pemain tiba. Panel prestasi txAdmin menunjukkan masa tick pelayan. Apabila ia meningkat mengikut bilangan pemain sementara penggunaan CPU keseluruhan kelihatan rendah, satu sumber sedang menepukan thread utama. Ingat pengiraan ini: pada kotak 4 vCPU, satu teras yang dimuatkan sepenuhnya dibaca sebagai kira-kira 25 peratus jumlah CPU dalam top, yang kelihatan melahu sedangkan sebenarnya tidak. Hentikan sumber satu demi satu dan perhatikan masa tick untuk mencari sumber yang membebankan anda.

Menentukan saiz berbanding pelayan permainan lain

Pelayan FiveM yang boleh dimainkan memerlukan teras tunggal yang pantas serta memori yang mencukupi untuk senarai sumber yang anda jalankan. Bilangan slot bergantung kepada kedua-dua faktor ini, dan penambahan vCPU tidak akan menyelesaikan masalah teras yang perlahan. Memilih VPS untuk pelayan permainan membincangkan pertukaran tersebut bagi kumpulan pelayan yang pelbagai, dan menjalankan pelayan Minecraft pada VPS mempunyai struktur asas yang sama: satu gelung tick utama, jadi kelajuan setiap teras juga menentukan had maksimum di situ.

FAQ

Berapakah keperluan CPU dan RAM untuk pelayan FiveM?

Satu teras yang pantas adalah lebih penting daripada beberapa teras yang perlahan, kerana FXServer menjalankan logik permainannya pada satu thread utama. Bandingkan skor single thread yang diterbitkan bagi model CPU tersebut, kemudian sahkan pada pelayan dengan sysbench cpu --threads=1 run dan pastikan vmstat menunjukkan steal time yang hampir sifar. Bagi memori, data pelayan asas Cfx.re berjalan dalam beberapa ratus megabait, manakala kerangka kerja roleplay dengan empat puluh atau lima puluh sumber serta pangkalan data tempatan selesa pada 8 GB dan terhad di bawah 4 GB. Itu adalah angka komuniti yang tipikal, jadi pantau free -m semasa waktu puncak dan jangan hanya bergantung pada angka tersebut.

Adakah pemain perlu memiliki GTA V untuk menyertai pelayan FiveM saya?

Ya. Setiap pemain yang ingin menyambung perlu mempunyai salinan GTA V yang sah dan berlesen di Steam, Rockstar Games Launcher atau Epic Games, serta akaun Cfx.re percuma. Pelanggan FiveM akan menyemak pemilikan permainan sebelum ia membenarkan sambungan. Tiada cara yang disokong untuk mengelakkan perkara ini, dan menjalankan pelayan yang cuba memintas syarat tersebut adalah di luar daripada apa yang dibenarkan oleh Cfx.re.

Apakah port yang perlu dibuka untuk pelayan FiveM?

Port 30120 pada TCP dan UDP, kedua-duanya. Endpoint HTTP seperti info.json dan muat turun sumber menggunakan TCP, manakala trafik permainan pelanggan menggunakan UDP. Membuka TCP sahaja akan menyebabkan situasi mengelirukan di mana pelayan menjawab pelayar web tetapi pemain melihat Failed to get info from server. txAdmin memerlukan TCP 40120, dan port tersebut harus kekal tertutup daripada internet.

Adakah selamat untuk membiarkan txAdmin boleh dicapai pada port 40120?

Tidak. txAdmin ialah konsol kawalan jauh yang boleh memulakan semula pelayan, menyunting konfigurasi dan menjalankan arahan, jadi panel yang terdedah bermakna satah kawalan keseluruhan pelayan permainan turut terdedah. Tiada kata laluan lalai, tetapi halaman log masuk awam mengundang serangan kelayakan yang tidak dapat anda lihat. Biarkan 40120 tertutup dalam firewall dan capai panel tersebut melalui terowong SSH dengan ssh -N -L 40120:127.0.0.1:40120 user@server, kemudian layari ke http://127.0.0.1:40120. Jangan ikat (bind) txAdmin kepada 127.0.0.1 dengan TXHOST_INTERFACE, kerana tetapan tersebut juga memaksa pelayan permainan ke loopback dan tiada pemain yang akan dapat menyambung.

Patutkah saya menetapkan (pin) binaan artifak atau sentiasa mengambil versi terkini yang disyorkan?

Tetapkan folder binaan bernombor. Label yang disyorkan akan berpindah ke binaan baharu secara berkala, jadi skrip yang mengambil binaan disyorkan boleh memberikan anda binari yang berbeza pada setiap binaan semula, dan pelayan yang berfungsi semalam boleh rosak semasa redeploy atas sebab yang tidak berkaitan dengan perubahan anda. Rekodkan nombor binaan dan commit hash yang telah anda uji, lakukan naik taraf secara sengaja, dan simpan folder sebelumnya pada cakera supaya anda boleh bertukar kembali dengan menyunting satu path dalam unit systemd anda.