# SFTP-kapcsolat: FileZilla és Cyberduck

> Hogyan csatlakozz SFTP-n, SSH-kulccsal a FileZillával vagy a Cyberducckal, és mire figyelj WordPress-oldal fájljainál.

A **FileZilla** és a **Cyberduck** grafikus SFTP-kliens: az egyik oldalon a gépedet, a másikon a szervert látod, a fájlokat húzással mozgatod. Mindkettő ingyen letölthető, és mindkettő tud SSH-kulcsos belépést. Windowson a [WinSCP](https://hub.hellowp.io/hu/docs/hellohost/fejlesztoknek/winscp/) is jó választás.

Mielőtt nekilátsz, döntsd el, kell-e egyáltalán SFTP. Ha az oldal Git-repóból él, a fájlok a repón át mennek ki, és SFTP-vel ne írj rájuk. A részleteket a [Hozzáférés a szerverhez](https://hub.hellowp.io/hu/docs/operations/hozzaferes-a-szerverhez/) oldal írja le.

## Mi kell a csatlakozáshoz

- a szerver neve (hoszt), a port és a felhasználónév: ezeket a hozzáféréssel együtt kapod meg;
- SSH-kulcspár, és a publikus kulcs feltöltve a szerver felületére: [SSH-kulcs készítése](https://hub.hellowp.io/hu/docs/hellohost/fejlesztoknek/ssh-kulcs-generalas/).

Az útmutatóban `example.com` a szerver neve, `felhasznalo` a felhasználónév. Ezeket cseréld le a sajátodra.

## FileZilla

### Letöltés

A programot a gyártó oldaláról töltsd le: [filezilla-project.org](https://filezilla-project.org/download.php?type=client). A letöltőoldal a platformod szerint kínálja a fájlokat: Windowsra telepítő (setup) és zip, Macre tömörített alkalmazás, Linuxra tar.xz. A letöltőoldal JavaScriptet igényel, és hirdetés is megjelenik rajta.

> **Telepítéskor olvasd el a lépéseket**
>
> A letöltőoldalon hirdetés fut. A telepítőben ne kattints végig vakon a **Next** gombokon, és ha kiegészítő programot kínál, amit nem kértél, utasítsd el. Csak a gyártó oldaláról tölts le.

### Kapcsolat felvétele

A FileZilla a kapcsolatokat a **Site Manager** (Kapcsolatkezelő) ablakban tárolja.

1. Nyisd meg a **Site Manager** ablakot, és hozz létre új kapcsolatot (**New Site**).
2. A **Protocol** mezőben válaszd az **SFTP - SSH File Transfer Protocol** értéket.
3. A **Host** mezőbe írd be a szerver nevét (például `example.com`), a **Port** mezőbe a kapott portot.
4. A **Logon Type** mezőben válaszd a **Key file** lehetőséget.
5. A **User** mezőbe írd be a felhasználónevet, a **Key file** mezőnél pedig tallózd ki a privát kulcsod fájlját.
6. Kattints a **Connect** gombra.

Ha a program a szerver ujjlenyomatát mutatja, hasonlítsd össze a hozzáféréssel kapott ujjlenyomattal, és csak egyezésnél fogadd el.

## Cyberduck

A Cyberduck dokumentációja a [docs.cyberduck.io](https://docs.cyberduck.io/) oldalon van.

### Gyors csatlakozás

1. Válaszd a **File → Open Connection…** menüpontot (macOS-en ⌘O, Windowson Ctrl+O).
2. Válaszd ki a protokollt: **SFTP**.
3. Add meg a szerver nevét, a felhasználónevet, és az **SSH Private Key** mezőnél a privát kulcsod fájlját.
4. Csatlakozz.

### Könyvjelző

Ha gyakran csatlakozol ugyanoda, készíts könyvjelzőt: **Bookmark → New Bookmark**. A könyvjelző szerkesztőjében (**Bookmark → Edit Bookmark**) a **Server** mezőbe csak a szerver neve kerüljön, elérési út nélkül, az útvonal a **Path** mezőbe való. Az **SSH Private Key** mező csak SFTP-nél látszik; ha a kulcsot jelszó védi, a program a jelszót kéri.

### Kulcsformátumok

A Cyberduck dokumentációja szerint:

- az OpenSSH privát kulcsok közül az rsa, dsa, ecdsa és ed25519 típus működik;
- az új OpenSSH-formátum (`openssh-key-v1`) csak ecdsa és ed25519 kulcsnál támogatott;
- a PuTTY `.ppk` kulcs csak rsa típusnál működik, ed25519-nél nem.

A Cyberduck az `~/.ssh/config` fájlból is olvas (például `IdentityFile`, `User`, `ProxyJump`). Ha a fájlban használsz `Host` álnevet, azt írd a könyvjelző **Server** mezőjébe. Az első csatlakozáskor a Cyberduck is megmutatja a szerver ujjlenyomatát; hasonlítsd össze a kapottal.

## WordPress-oldal fájljai

**Hol vannak a fájlok.** Hagyományos telepítésben a bővítmények, témák és a feltöltések a `wp-content` mappában vannak (`plugins`, `themes`, `uploads`). [Bedrock](https://hub.hellowp.io/hu/knowledge-base/developer-tools/bedrock/) alapú oldalon `wp-content` nincs: helyette a `web/app` mappát nézd, a WordPress magja a `web/wp` alatt van.

**Jogosultságok.** A WordPress fejlesztői kézikönyve szerint a fájlok általában a te felhasználódhoz tartozzanak, és csak az írhassa őket. Az alapértelmezés mappáknál 755, fájloknál 644. A 777 jogosultságot ne használd, a kézikönyv külön fejezetben figyelmeztet a veszélyére. A `wp-config.php` fájlt szigorúbban védd, mint a többit.

**Tulajdonos.** Ha a feltöltött fájlt nem a webszervert futtató felhasználó írhatja, a WordPress nem tud rá írni. A tünet a hibás médiafeltöltés vagy a frissítés elakadása. Szerveren futtatott parancsok után ellenőrizd a tulajdonost is.

**Bedrock: bővítményt ne tölts fel kézzel.** Bedrocknál a bővítmények és témák a Composerből jönnek, a `plugins/` mappa alapból gitignore-olt. A kézzel feltöltött bővítmény a következő deploykor eltűnhet. A helyes út:

```bash title="Terminál"
composer require wp-plugin/akismet
```

Utána commit és push; a deploy kiteszi a változást. Az SFTP-t Bedrocknál legfeljebb nézegetésre vagy letöltésre használd.

## Mire figyelj

- **Éles oldalon ne szerkessz kézzel.** Egy elrontott fájl azonnal látszik az oldalon. Előbb tölts le másolatot a módosítandó fájlról.
- **A privát kulcsot ne oszd meg.** Csak a publikus kulcs való a szerverre. A privát kulcsot védd jelszóval.
- **Sima FTP-t nem használunk.** A szerverekhez csak SSH-n és SFTP-n át lehet hozzáférni.

## Hasznos linkek

- [FileZilla letöltés](https://filezilla-project.org/download.php?type=client)
- [FileZilla wiki](https://wiki.filezilla-project.org/)
- [Cyberduck dokumentáció: SFTP](https://docs.cyberduck.io/protocols/sftp/)
- [Cyberduck dokumentáció: könyvjelzők](https://docs.cyberduck.io/cyberduck/bookmarks/)
- [WordPress fejlesztői kézikönyv: fájljogosultságok](https://developer.wordpress.org/advanced-administration/server/file-permissions/)
- [Hozzáférés a szerverhez](https://hub.hellowp.io/hu/docs/operations/hozzaferes-a-szerverhez/)