Een FTP-server instellen voor Shareboxed

Shareboxed uploadt rechtstreeks naar een FTP-server: een NAS, de ruimte die bij je hosting hoort, een machine die iemand van IT draaiend houdt. Bestanden houden hun eigen naam in een map die je met elke FTP-client kunt doorbladeren.

Veld	Waarde
Server	de host, zonder scheme
Security	welke TLS de server spreekt, zie hieronder
Port	leeg laten voor 21 (990 voor TLS on its own port)
Username + Password	een account dat mag schrijven
Folder	optioneel, een map om in te schrijven

1. Kies de juiste soort TLS

Instelling	Wat het betekent	Gebruikelijke poort
TLS	De verbinding begint onversleuteld en wordt vóór het wachtwoord opgewaardeerd.	21
TLS on its own port	Versleuteld vanaf de eerste byte. Nog altijd gangbaar op NAS-apparaten.	990
None	Helemaal geen versleuteling.	21

Probeer eerst TLS; mislukt de test op het endpoint, probeer dan TLS on its own port. Kies None alleen voor een server op je eigen netwerk: het wachtwoord en elke byte gaan leesbaar over de lijn.

2. Zoek de accountgegevens op

Een hostingaccount (cPanel, DirectAdmin, Plesk): de pagina FTP accounts. Maak een apart account voor Shareboxed en laat de home directory ervan naar de uploadmap wijzen.
Een NAS (Synology, QNAP, Unraid): zet de FTP-service aan en maak een gebruiker met schrijfrechten op één gedeelde map. Synology's FTPS (explicit) is hier de instelling TLS.
Een server die je zelf draait: elke gebruiker die in de map mag schrijven. vsftpd en pure-ftpd doen allebei explicit TLS met een Let's Encrypt-certificaat.

3. Zet de passieve poortrange open

Uploads gebruiken passive mode: de server noemt een tweede poort en Shareboxed verbindt daarmee. Een server achter zijn eigen firewall heeft die range open nodig en moet zijn publieke adres aankondigen (pasv_min_port/pasv_max_port op vsftpd, Passive port range op een NAS). Zonder dat lukt de login en blijft elke overdracht hangen.

Geen deelbare links

De schakelaar Sharing wordt niet aangeboden voor FTP. Een downloadlink werkt doordat één verzoek voor één bestand ondertekend kan worden zonder het account uit handen te geven. FTP heeft niets om mee te ondertekenen. Wijs ontvangers naar wat de map al over HTTP serveert, of gebruik een S3- of R2-connectie voor batches die een link nodig hebben.

Als iets niet werkt

Druk eerst op Test Connection. Wat het kan zeggen:

Test Connection zegt	Oplossing
Missing credentials	Het veld Username of Password is leeg of is niet opgeslagen.
Invalid endpoint	Typefout in de server, of de verkeerde soort TLS: probeer de andere TLS-instelling en controleer het certificaat.
Invalid credentials	De server weigerde deze gebruikersnaam en dit wachtwoord.
Insufficient permissions	De map bestaat niet, of dit account kan er niet in.
Not reachable	Er antwoordde niets op die host en poort: een typefout, een firewall, of een server die alleen op een ander netwerk oplost.

Nog één die pas later opduikt:

Test slaagt, uploads blijven op 0% hangen: de passieve poortrange is dicht, of de server kondigt een privéadres aan. Zie stap 3 hierboven; dit is een serverinstelling, niets waar een client omheen kan werken.