SFTP (SSH File Transfer Protocol) je šifrovaný síťový protokol pro přenos souborů přes připojení SSH. Umožňuje bezpečnou výměnu souborů mezi tvým počítačem a herním serverem. Pomocí SFTP můžeš přistupovat k souborům serveru a spravovat je – ať už chceš soubory nahrávat a stahovat, nebo je přímo upravovat.
Herní servery ZapX podporují výhradně přístup přes SFTP. Klasické, nešifrované FTP není podporováno.
Pro přístup přes SFTP potřebuješ vhodného SFTP klienta. Na výběr je mnoho klientů, mezi nejznámější a nejdéle používané patří FileZilla a WinSCP.
| SFTP klient | Stažení |
|---|---|
| FileZilla | Oficiální web |
| WinSCP | Oficiální web |
K přístupu k hernímu serveru přes SFTP potřebuješ správné přihlašovací údaje. Najdeš je v administraci svého herního serveru na kartě Soubory v části Externí přístup.
Externí přístup není ve výchozím nastavení připravený (stav Nepřipraveno). Klikni v části Externí přístup na Aktivovat SFTP a nastav ho. Stav se poté změní na Připraveno.
Pokud se místo toho v této části zobrazuje stav Nepodporováno, externí přístup přes SFTP na nodu tvého herního serveru momentálně není k dispozici.
Jakmile bude přístup připravený, ZapX ti zobrazí tyto údaje:
- Hostitel – adresa, ke které se tvůj klient připojí
- Port – port SFTP tvého nodu. Není pevně daný, ale závisí na nodu a zobrazí se ti individuálně
- Uživatelské jméno – tvé přihlašovací jméno pro SFTP
- Heslo – zobrazíš ho kliknutím na ikonu oka a kliknutím na ikonu kopírování ho zkopíruješ do schránky
Každou hodnotu můžeš převzít přímo kliknutím na ikonu kopírování. Pomocí možnosti Obnovit přihlašovací údaje si můžeš kdykoli vygenerovat nové heslo, například pokud jsi mezitím přístup sdílel s někým jiným.
Místo ručního zadávání můžeš v části Externí přístup kliknout na Rychlé připojení. Tlačítko otevře výchozího SFTP klienta registrovaného v tvém systému (např. FileZilla) a automaticky vyplní hostitele, port a uživatelské jméno. Heslo pak musíš do klienta zadat ručně.
V části Nová relace vyber jako protokol přenosu souborů SFTP a zadej hostitele, port, uživatelské jméno a heslo z části Externí přístup. Poté klikni na Přihlásit se.
Než provedeš větší změny v souborech serveru, nezapomeň server zastavit. Běžící procesy mohou soubory uzamknout, takže se změny nemusí podařit uložit nebo se mohou ztratit.
Stejně jako FileZilla je i WinSCP rozdělený na dvě části: vlevo je tvůj počítač, vpravo server. Kliknutím pravým tlačítkem na soubor nebo složku můžeš soubory nahrávat a stahovat, upravovat, přejmenovávat nebo přesouvat.
Zkontroluj, jestli jsou hostitel, port, uživatelské jméno a heslo správné a úplné. Pokud si nejsi jistý, v části Externí přístup použij možnost Obnovit přihlašovací údaje, abys získal nové heslo.
Ve FiveM přes SFTP přistupuješ hlavně ke svým resources, souboru server.cfg a datům txAdmin. Připojení i přihlašovací údaje fungují přesně podle výše uvedeného postupu. I když se často používá označení „FiveM FTP“, u ZapX se vždy připojuješ přes SFTP.
Po přihlášení najdeš soubory FiveM ve složce fivem a v ní ve složce své varianty, například fivem/standard. Najdeš tam:
| Složka / soubor | Obsah |
|---|---|
<Name>_<Code>.base (např. Qbox_E99E54.base) | Složka serveru, kterou txAdmin vytvoří při nastavení pomocí receptu. Najdeš v ní server.cfg a složku resources. |
default | Profil txAdmin s nastaveními (config.json), daty a protokoly |
admins.json | Účty správců txAdmin |
server-data | Další složka serveru s vlastním souborem server.cfg a vlastní složkou resources |
artifacts | Soubory serveru FiveM (FXServer). Tady nemusíš nic měnit. |
U ZapX není samostatná složka txData. Data txAdmin jsou uložená přímo ve složce dané varianty.
Která složka serveru je právě aktivní, zjistíš v txAdmin v části Settings → FXServer v poli Server Data Folder. Změny v souboru server.cfg v jiné složce se neprojeví.
- Rozbal staženou resource na svém počítači. Přímo ve složce resource musí být soubor
fxmanifest.lua(u starších resources__resource.lua). - Zastav server.
- Nahraj složku přes SFTP do složky
resourcesv aktivní složce serveru. - Přidej resource do souboru
server.cfgpomocístart <ordnername>a spusť server.
Podrobné informace najdeš v návodu FiveM: Instalace resources.
- Než změníš soubor
server.cfg, soubory ve složcedefaultnebo souboradmins.json, zastav server. Server a txAdmin do těchto souborů zapisují a změny provedené za běhu serveru se mohou přepsat. - Nejdřív si stáhni kopii souboru, abys ho v případě chyby mohl vrátit do původního stavu.
- Menší změny v souboru
server.cfgmůžeš provádět také přímo v CFG Editoru txAdmin.
Ve FiveM se zvětšuje hlavně složka cache v adresáři serveru (<Name>_<Code>.base/cache). Když je server zastavený, můžeš tuto složku smazat. FiveM ji při příštím spuštění vytvoří znovu. Smazat můžeš také starší soubory protokolů ve složce default/logs. Složku artifacts a ostatní soubory txAdmin neměň.
Zkontroluj, jestli název složky přesně odpovídá názvu v příkazu start (záleží na velikosti písmen) a jestli je soubor fxmanifest.lua přímo ve složce, ne v její podsložce. Další problémy najdeš v článku FiveM: Časté problémy.