Anleitung: Installation eines FTP-Servers auf einem Raspberry Pi 5

Mit einem Raspberry Pi 5 lässt sich schnell ein FTP-Server einrichten, um Dateien im Netzwerk bereitzustellen oder von anderen Geräten auf den Pi hochzuladen. Für diese Anleitung wird der Dienst vsftpd verwendet, da er schlank, stabil und unter Raspberry Pi OS direkt über die Paketverwaltung verfügbar ist.

Ziel dieser Anleitung: Du lernst, wie du auf einem Raspberry Pi 5 einen FTP-Server installierst, konfigurierst, einen Benutzer für den Dateizugriff anlegst und die Verbindung testest.

1. Voraussetzungen

Raspberry Pi 5 mit installiertem Raspberry Pi OS
Netzwerkverbindung per LAN oder WLAN
Benutzerkonto mit sudo-Rechten
Zugriff auf das Terminal direkt am Gerät oder per SSH

Tipp: Die IP-Adresse des Raspberry Pi kannst du vorab mit hostname -I anzeigen. Diese Adresse brauchst du später für den Verbindungsaufbau mit dem FTP-Client.

2. FTP kurz erklärt

Begriff	Bedeutung
FTP	Ein älteres Protokoll zur Dateiübertragung im Netzwerk.
vsftpd	Ein weit verbreiteter und sicherheitsorientierter FTP-Server für Linux.
SFTP	Eine verschlüsselte Alternative über SSH, meist sicherer als klassisches FTP.

FTP ist einfach einzurichten, aber standardmäßig nicht verschlüsselt. Für interne Testumgebungen ist es oft ausreichend. Für produktive oder internetseitig erreichbare Systeme sollte eher SFTP verwendet werden.

3. FTP-Server installieren

Öffne ein Terminal auf dem Raspberry Pi und aktualisiere zuerst die Paketlisten:

sudo apt update
sudo apt upgrade -y

Installiere anschließend den FTP-Dienst:

sudo apt install -y vsftpd

Danach kannst du prüfen, ob der Dienst aktiv ist:

sudo systemctl status vsftpd

Erwartung: Der Dienst sollte als active (running) erscheinen.

4. Originalkonfiguration sichern

Bevor du Änderungen machst, solltest du die Standardkonfiguration sichern:

sudo cp /etc/vsftpd.conf /etc/vsftpd.conf.bak

5. FTP-Server konfigurieren

Öffne die Konfigurationsdatei:

sudo nano /etc/vsftpd.conf

Setze oder ergänze folgende Einträge:

listen=NO
listen_ipv6=YES
anonymous_enable=NO
local_enable=YES
write_enable=YES
local_umask=022
dirmessage_enable=YES
use_localtime=YES
xferlog_enable=YES
connect_from_port_20=YES
chroot_local_user=YES
allow_writeable_chroot=YES
pasv_enable=YES
pasv_min_port=40000
pasv_max_port=40010
ssl_enable=NO

Bedeutung wichtiger Einträge

anonymous_enable=NO: anonyme Logins werden deaktiviert
local_enable=YES: lokale Linux-Benutzer dürfen sich anmelden
write_enable=YES: Schreiben und Hochladen wird erlaubt
chroot_local_user=YES: Benutzer bleiben in ihrem Verzeichnis eingeschlossen
pasv_enable=YES: aktiviert den Passivmodus für viele FTP-Clients

Wichtig: Wenn du den Passivmodus nutzt, müssen die Ports 40000 bis 40010 in der Firewall beziehungsweise im Router ebenfalls freigegeben werden.

6. FTP-Benutzer anlegen

Lege einen Benutzer für den FTP-Zugriff an:

sudo adduser ftpuser

Vergib beim Anlegen ein Passwort. Mit diesem Benutzer meldest du dich später im FTP-Client an.

7. Verzeichnisstruktur für Uploads erstellen

Erzeuge einen Ordner für den FTP-Zugriff und einen Unterordner für Uploads:

sudo mkdir -p /home/ftpuser/ftp/upload
sudo chown nobody:nogroup /home/ftpuser/ftp
sudo chmod a-w /home/ftpuser/ftp
sudo chown ftpuser:ftpuser /home/ftpuser/ftp/upload

Diese Struktur wird oft verwendet, damit der Benutzer zwar in einem begrenzten Bereich arbeitet, aber nur im Unterordner upload schreiben darf.

8. Startverzeichnis für den Benutzer festlegen

Ergänze in der Datei /etc/vsftpd.conf zusätzlich folgende Zeilen:

user_sub_token=$USER
local_root=/home/$USER/ftp

9. Änderungen speichern und Dienst neu starten

In nano speicherst du mit:

Strg + O zum Speichern
Enter zum Bestätigen
Strg + X zum Beenden

Danach den Dienst neu starten und beim Booten aktivieren:

sudo systemctl restart vsftpd
sudo systemctl enable vsftpd

10. Firewall freigeben

Falls auf dem Raspberry Pi ufw verwendet wird, gib die FTP-Ports frei:

sudo ufw allow 20/tcp
sudo ufw allow 21/tcp
sudo ufw allow 40000:40010/tcp
sudo ufw reload

11. Verbindung testen

Teste die Verbindung mit einem FTP-Client wie zum Beispiel FileZilla.

Server: IP-Adresse des Raspberry Pi
Port: 21
Benutzername: ftpuser
Passwort: das vergebene Kennwort

Tipp: Wenn die Anmeldung funktioniert, aber kein Upload möglich ist, prüfe die Ordnerrechte und ob du wirklich in den Unterordner upload schreibst.

12. Einrichtung mit GUI-Unterstützung

Die eigentliche Installation erfolgt zwar per Terminal, aber einige Schritte lassen sich grafisch kontrollieren.

Terminal über die Oberfläche öffnen

Raspberry Pi Desktop starten
Im Menü Zubehör oder Accessories das Terminal öffnen
Die Befehle aus den vorherigen Schritten eingeben

Ordner im Dateimanager prüfen

Dateimanager öffnen
Zu /home/ftpuser wechseln
Prüfen, ob die Ordner ftp und upload existieren

Verbindung mit FileZilla aufbauen

FileZilla auf einem anderen Rechner öffnen
Host, Benutzername, Passwort und Port eintragen
Verbindung herstellen
Testdatei in den Upload-Ordner übertragen

13. Häufige Fehler

Der Dienst läuft nicht: sudo systemctl status vsftpd prüfen
Port 21 oder der Passivbereich ist durch Firewall oder Router blockiert
Benutzerrechte im Verzeichnis stimmen nicht
Falsche IP-Adresse oder falscher Benutzername verwendet
Der Client schreibt nicht in den erlaubten Unterordner upload

Zur Fehlersuche helfen diese Befehle:

sudo journalctl -u vsftpd
sudo tail -f /var/log/vsftpd.log

Sicherheitshinweis: Klassisches FTP überträgt Daten und Passwörter unverschlüsselt. Wenn der Server nicht nur im internen Testnetz genutzt wird, ist SFTP über SSH meist die bessere und sicherere Lösung.

14. Fazit

Mit vsftpd lässt sich auf einem Raspberry Pi 5 schnell ein FTP-Server einrichten. Für einfache Dateiübertragungen im lokalen Netzwerk reicht das oft aus. Wer mehr Sicherheit benötigt, sollte statt FTP lieber SFTP verwenden.