Anmeldeskripte für FTP-Proxyserver
Das Anmeldeskript legt fest, wie der FTP-Client mit dem FTP-Proxyserver kommuniziert, um sich mit dem gewünschten FTP-Server zu verbinden. Der FTP-Proxyserver verhält sich wie ein FTP-Server. Der Client verbindet sich mit ihm und übermittelt alle nötigen Parameter: Benutzername und Passwort für den Proxyserver (optional), Adresse und Port des gewünschten FTP-Servers sowie Benutzername und Passwort für diesen. Der Proxyserver verbindet sich mit dem gewünschten FTP-Server und leitet alle Befehle und Antworten zwischen Client und Server weiter.
Beschreibung des Anmeldeskripts
Die erste Zeile des Anmeldeskripts lautet immer „Connect to:“, gefolgt von Serveradresse und Port, getrennt durch „:“. Adresse und Port bestimmen das Verbindungsziel des FTP-Clients. Die Serveradresse muss angegeben werden. Fehlt der Port, wird 21 angenommen.
Alle weiteren Zeilen enthalten an den Server gesendete Befehle. Jede Zeile enthält nur einen Befehl. Zeilen können Variablen enthalten, die vor dem Senden ersetzt werden.
Es gibt optionale und obligatorische Variablen. Sie unterscheiden sich im Verhalten, wenn eine Variable in einem Befehl verwendet, aber vom Benutzer nicht definiert wurde. Bei fehlenden optionalen Variablen wird die ganze Zeile übersprungen. Bei fehlenden obligatorischen Variablen öffnet sich ein Dialog; der Benutzer muss einen Wert eingeben oder die Verbindung abbrechen. Variablen beginnen mit „$“ und stehen in Klammern, etwa „$(Password)“. Die Escape-Sequenz für „$“ lautet „$$“.
Mit „3xx:“ beginnende Zeilen werden übersprungen, wenn der Befehl der vorherigen Zeile übersprungen wurde oder dessen Serverantwort nicht 3xx war. 3xx bedeutet, dass die erste Ziffer der FTP-Antwort „3“ ist („Teilerfolg“). Dies wird in Befehlsfolgen verwendet und bedeutet: Mit dem nächsten Befehl fortfahren, etwa nach akzeptiertem Benutzernamen das Passwort senden.
Einschränkungen der ersten Skriptzeile: Die Serveradresse darf nur als Text ohne Variablen oder mit ausschließlich der Variable ProxyHost bzw. Host angegeben werden; der Port nur als Dezimalzahl oder Variable ProxyPort bzw. Port.
Die Anmeldung gilt als erfolgreich und der Benutzer als mit dem FTP-Server verbunden, wenn keine Antwort auf gesendete Befehle 4xx oder 5xx lautet und die Antwort auf den letzten Befehl 2xx ist. 4xx bedeutet vorübergehender Fehler, 5xx dauerhafter Fehler, 2xx Erfolg.
Variablen
Folgende Variablen stehen zur Verfügung:
| Variable | Beschreibung |
|---|---|
| ProxyHost | obligatorisch; Name oder IP-Adresse des Proxyservers (Firewall) |
| ProxyPort | immer definiert; Port, an dem der Proxyserver (Firewall) lauscht; Standard ist 21, sofern nicht vom Benutzer angegeben |
| ProxyUser | optional; Benutzername für den Proxyserver (Firewall) |
| ProxyPassword | obligatorisch; Passwort für den Proxyserver (Firewall) |
| Host | immer definiert; Name oder IP-Adresse des gewünschten FTP-Servers |
| Port | immer definiert; Port, an dem der gewünschte FTP-Server lauscht; Standard ist 21, sofern nicht vom Benutzer angegeben |
| User | obligatorisch; Benutzername für den gewünschten FTP-Server |
| Password | obligatorisch; Passwort für den gewünschten FTP-Server |
| Account | obligatorisch; Konto für den gewünschten FTP-Server |
Beispiele
Anmeldeskript für eine direkte Verbindung ohne Proxyserver:
Connect to: $(Host):$(Port) USER $(User) 3xx: PASS $(Password) 3xx: ACCT $(Account)
Anmeldeskript für den FTP-Proxyservertyp „USER user@host:port“:
Connect to: $(ProxyHost):$(ProxyPort) USER $(ProxyUser) 3xx: PASS $(ProxyPassword) USER $(User)@$(Host):$(Port) 3xx: PASS $(Password) 3xx: ACCT $(Account)
Siehe auch
Dialog Proxyserver hinzufügen/bearbeiten
From the Sally manual (GPL-2.0-or-later), © 1997-2023 Open Salamander Authors; © 2025-2026 Elias Bachaalany. Source: manual source (zip) · original page in the Sally repository