FerryDock — Brugervejledning
FerryDock gør din Mac til en server til FTP, FTPS og SFTP. Enheder og programmer i dit netværk kan lægge filer der eller hente dem: scannere, kameraer, andre computere, FTP- og SFTP-programmer. Denne vejledning beskriver alt, hvad FerryDock kan, i den rækkefølge, man normalt har brug for det.
1 — Første start
FerryDock åbner intet vindue ved start. Den viser sig øverst til højre i menulinjen som et lille færgesymbol. I færgens skrog sidder en prik: grøn, så snart en af de to servere kører, ellers rød.
FerryDock indeholder to servere, der kører uafhængigt af hinanden: FTP-serveren, der også arbejder krypteret som FTPS, og SFTP-serveren. Før nogen kan logge ind, skal FerryDock have mindst én brugerkonto med en delt mappe. Til FTP er det også nok at slå den anonyme adgang til. Sådan går det hurtigst:
- Klik på færgesymbolet, og vælg Indstillinger.
- Opret en konto på fanen Brugere, se kapitel 4.
- Vælg Start FTP-serveren eller Start SFTP-serveren i menuen ved færgesymbolet.
Under Indstillinger › Om finder du links til denne vejledning, til produktsiden og til webstedet, hver på FerryDocks sprog.
2 — Menuen ved færgesymbolet
Et klik på færgesymbolet åbner en menu med:
- Om FerryDock — et lille vindue med version og links;
- for hver server tilstanden, for eksempel FTP-serveren kører på port 21 eller SFTP-serveren er stoppet;
- for hver server et punkt til at starte den, med rød prik, eller stoppe den, med grøn prik;
- antallet af forbundne klienter på begge servere;
- Åbn vindue til hovedvinduet, se kapitel 8;
- Indstillinger og Slut FerryDock.
Menuen bygges op på ny, hver gang den åbnes. Tilstand og antal klienter passer derfor altid.
3 — Start og stop serverne
FTP- og SFTP-serveren starter og stopper du hver for sig: fra menuen ved færgesymbolet eller med knappen i serverens linje i hovedvinduet. Når en server stoppes, afbrydes dens klienter; den andens forbliver forbundet.
Skal en server starte af sig selv, hver gang FerryDock åbnes, så slå Start FTP-serveren, når FerryDock åbnes til under Indstillinger › FTP(S), eller Start SFTP-serveren, når FerryDock åbnes under Indstillinger › SFTP. Sammen med Start ved login (kapitel 9) er serverne klar, så snart du logger ind på din Mac.
Kan en server ikke starte, fortæller FerryDock hvorfor:
- Der findes endnu ingen brugerkonto og ingen anonym adgang.
- SFTP-serveren kræver mindst én konto med en mappe, der kan nås. Den anonyme adgang tæller ikke med.
- Ingen af de delte mapper kan nås, for eksempel fordi en ekstern disk mangler. Vælg mapperne igen under Indstillinger › Brugere.
- Porten bruges allerede af et andet program.
- macOS tillader ikke den valgte port. Vælg i så fald en port over 1023.
- Certifikatet til FTPS kan ikke bruges, se kapitel 10.
- Prøveperioden er udløbet, se kapitel 12.
4 — Brugerkonti
Konti administreres under Indstillinger › Brugere. Tilføj opretter en ny, Rediger ændrer den valgte, Slet fjerner den efter en bekræftelse. Hver konto gælder for FTP, FTPS og SFTP på samme måde.
Til hver konto hører:
- Brugernavn — skal være entydigt, uanset store og små bogstaver. „anonymous“ og „ftp“ er reserveret til anonym adgang.
- Adgangskode — lad feltet være tomt ved redigering for at beholde den nuværende.
- Delt mappe — via Vælg. For klienten er denne mappe den øverste mappe „/“; højere op kommer den ikke.
- Skrivebeskyttet — klienten må se og hente filer, men ikke uploade, omdøbe eller slette noget.
- SSH-nøgler til SFTP (valgfrit) — se nedenfor.
Ændringer gælder straks for nye logins, også mens serverne kører. Den, der allerede er logget ind, beholder sin hidtidige konto til logout. Når en konto slettes, forbliver mappen og dens filer urørt.
Flyttes eller omdøbes en delt mappe, finder FerryDock den selv igen ved næste serverstart.
SSH-nøgler til SFTP
Med en gemt nøgle logger et SFTP-program ind uden adgangskode. Kontoens adgangskode virker fortsat ved siden af. En konto kan have flere nøgler, for eksempel én pr. computer.
- Tilføj nøgle … åbner filvalget i mappen
.sshi din brugermappe. Vælg filen, der ender på.pub, for eksempelid_ed25519.pub. - Fra udklipsholderen overtager en nøgle, du har kopieret forinden, for eksempel fra en anden computer.
- Hver nøgle vises i listen med type, navn og fingeraftryk. Knappen til højre fjerner den.
FerryDock tager imod nøgler af typerne Ed25519 og ECDSA, men ikke
RSA-nøgler. Vælger du ved en fejl filen uden .pub, altså den
private nøgle, gør FerryDock opmærksom på det og gemmer den ikke.
5 — Anonym adgang
Under kontolisten findes området Anonym adgang. Med Tillad anonym adgang kan alle logge ind som „anonymous“ eller „ftp“ med en vilkårlig adgangskode. Første gang du slår den til, åbnes mappevalget med det samme.
- Anonym adgang findes kun via FTP og FTPS, ikke via SFTP.
- Den anonyme adgang er altid kun til læsning.
- Den har sin egen mappe, adskilt fra kontiene.
- Står krypteringen på Kræv, bestemmer kontakten Tillad anonym adgang uden kryptering, om anonyme klienter alligevel må komme ind ukrypteret, se kapitel 10.
- Mange programmer sender en mailadresse som adgangskode. Den står i logfilen; i sessionsloggen forbliver den skjult.
- Slår du adgangen fra, forbliver mappen gemt.
6 — Adgang via FTP og FTPS
Et FTP-program eller en enhed forbinder sig til FerryDock. Der angiver du:
| Felt | Indhold |
|---|---|
| Protokol | FTP, eller til den krypterede forbindelse FTP med eksplicit TLS (ofte kaldt „FTPS“ eller „FTPES“) |
| Server | din Macs adresse, for eksempel 192.168.1.20 eller Min-Mac.local |
| Port | porten fra Indstillinger › FTP(S), standard 21 — den samme for FTP og FTPS |
| Bruger og adgangskode | fra en konto, eller „anonymous“ |
| Tilstand | passiv |
Din Macs adresse finder du under Systemindstillinger › Netværk, navnet med „.local“ under Systemindstillinger › Generelt › Deling.
FerryDock arbejder i passiv tilstand (PASV og EPSV). Mappelister leveres i klassisk og maskinlæsbar form, så både ældre enheder og nye programmer kan bruge dem. Et program, der understøtter det, genoptager en afbrudt overførsel, hvor den stoppede.
Første gang det forbinder krypteret, viser programmet som regel FerryDocks certifikat og spørger, om det skal stole på det. Sammenlign fingeraftrykket med det under Indstillinger › FTP(S), og bekræft. FerryDock tilbyder FTPS eksplicit på FTP-porten; implicit FTPS på en separat port findes ikke.
7 — Adgang via SFTP
Et SFTP-program forbinder sig til FerryDock. Der angiver du:
| Felt | Indhold |
|---|---|
| Protokol | SFTP |
| Server | din Macs adresse, som i kapitel 6 |
| Port | porten fra Indstillinger › SFTP, standard 2222 |
| Bruger | brugernavnet på en konto |
| Login | kontoens adgangskode eller en gemt SSH-nøgle, se kapitel 4 |
Første gang det forbinder, viser programmet fingeraftrykket af FerryDocks værtsnøgle og spørger, om det skal stole på den. Sammenlign det med det under Indstillinger › SFTP, og bekræft. Derefter spørger programmet ikke igen, så længe værtsnøglen er den samme.
I Terminal for eksempel med
sftp -P 2222 brugernavn@Min-Mac.local.
8 — Hovedvindue og sessionslog
Hovedvinduet åbnes med Åbn vindue i menuen ved færgesymbolet eller med et klik på Dock-symbolet.
- Øverst står én linje pr. server med tilstand, port og knappen til at starte eller stoppe den.
- Derunder står Klienter med brugernavn (eller ikke logget ind), forbindelsestype, adresse og klokkeslæt. Forbindelsestypen er FTP, FTPS eller SFTP; skifter en FTP-klient til kryptering, bliver FTP til FTPS.
- Ved siden af overskriften står, hvor mange forbindelser der er i brug, og hvor mange der er tilladt, for eksempel 3 af 20 forbindelser. Er grænsen nået, bliver angivelsen orange.
- Afbrudte klienter er markeret som afbrudt og bliver stående, til du vælger Fjern afbrudte.
- Vælger du en klient, viser Sessionslog nedenunder med klokkeslæt, hvad der sker i sessionen. Ved FTP og FTPS er det hver kommando fra klienten (med „>“) og hvert svar fra serveren (med „<“), ved SFTP login og filhandlinger. Adgangskoder vises som „****“.
Hver session beholder sine sidste 2000 linjer, afbrudte sessioner deres sidste 100. Klienter, der kun forbinder og afbryder igen uden at sende en kommando, vises slet ikke.
9 — Indstillinger › Generelt
På fanen Indstillinger › Generelt:
- Vis symbol i Dock — slået fra lever FerryDock kun i menulinjen. FerryDocks egen menulinje øverst til venstre forsvinder da; alt nødvendigt findes i menuen ved færgesymbolet.
- Start ved login — FerryDock starter, når du logger ind på din Mac, uden at åbne et vindue. Mangler macOS stadig din godkendelse, står der en note nedenunder sammen med knappen Åbn Login-emner.
Derunder står de indstillinger, der gælder for FTP og SFTP i fællesskab:
| Indstilling | Standard | Træder i kraft |
|---|---|---|
| Afbryd inaktive klienter efter (minutter) | 15 | ved klientens næste kommando |
| Højst antal samtidige forbindelser | 20 | med det samme for nye forbindelser |
| Før sessionslog | til | med det samme |
- Tidsgrænsen går fra 0 til 1440 minutter; 0 betyder aldrig. Igangværende overførsler afbrydes aldrig.
- Det højeste antal går fra 1 til 500. Det tæller alle forbindelser på begge servere sammen, uden FTP's dataforbindelser. Yderligere klienter afvises.
Nederst vælger du Sprog, se kapitel 13.
10 — Indstillinger › FTP(S)
Øverst på fanen står alt om FTP-serveren:
| Indstilling | Standard | Træder i kraft |
|---|---|---|
| Start FTP-serveren, når FerryDock åbnes | fra | ved næste start af FerryDock |
| Port | 21 | ved næste start af FTP-serveren |
| Passive porte fra … til | 50000 til 50100 | ved næste start af FTP-serveren |
- Porte ligger mellem 1 og 65535. Den første passive port må ikke være højere end den sidste, og serverens port må ikke ligge i det passive område.
- Kører FTP-serveren stadig med andre værdier, vises den orange note Gælder først efter en genstart af serveren. med knappen Genstart serveren. Knappen genstarter kun FTP-serveren. Er der klienter forbundet, spørger den først, for de afbrydes undervejs.
Kryptering (FTPS)
Derunder bestemmer du, om FerryDock tilbyder kryptering:
- Fra — FerryDock tilbyder ingen kryptering. Kun til ældre enheder, der ikke kan håndtere tilbuddet.
- Tillad (standard) — klienten bestemmer. Både krypterede og ukrypterede forbindelser virker.
- Kræv — intet login uden kryptering. Også filer overføres kun krypteret. Er den anonyme adgang slået til, vises kontakten Tillad anonym adgang uden kryptering; den er slået til som standard, fordi der anonymt ikke er nogen adgangskode at beskytte, og netop simple enheder bruger denne adgang.
Ændringer af kryptering og certifikat gælder straks for nye forbindelser, uden genstart. Eksisterende forbindelser beholder deres tilstand.
Certifikat
FerryDock opretter selv certifikatet til FTPS, så snart serveren første gang kører med kryptering. Der vises oprindelse, navn, udløbsdato og Fingeraftryk (SHA-256), som Kopiér lægger i udklipsholderen.
- Opret nyt… erstatter certifikatet efter en bekræftelse. Klienterne spørger derefter én gang igen, om de stoler på det.
- Indlæs certifikat… overtager dit eget certifikat fra en
.p12-fil. Den skal indeholde certifikat og privat nøgle; efter filvalget spørger FerryDock efter dens adgangskode.
11 — Indstillinger › SFTP
| Indstilling | Standard | Træder i kraft |
|---|---|---|
| Start SFTP-serveren, når FerryDock åbnes | fra | ved næste start af FerryDock |
| Port | 2222 | ved næste start af SFTP-serveren |
- SFTP-porten må hverken være lig med FTP-porten eller ligge i området for de passive porte.
- Kører SFTP-serveren stadig med en anden port, vises den orange note med knappen Genstart serveren, som i kapitel 10. Den genstarter kun SFTP-serveren.
Værtsnøgle
Med værtsnøglen identificerer FerryDock sig over for SFTP-programmerne. FerryDock opretter den selv første gang, SFTP-serveren starter. Fanen viser dens fingeraftryk, som Kopiér lægger i udklipsholderen.
- Opret nyt… erstatter nøglen efter en bekræftelse. Klienterne melder derefter én gang en ændret værtsnøgle.
- Sikkerhedskopiér … skriver nøglen til en fil. Først vælger du, hvor den skal gemmes, derefter angiver du en adgangskode og gentager den. Filen krypteres med denne adgangskode og gemmes i OpenSSH-format; uden adgangskoden kan den ikke gendannes.
- Gendan … indlæser en sådan sikkerhedskopi. Efter adgangskoden viser FerryDock fingeraftrykket af den gemte nøgle og spørger, om den skal erstatte den nuværende.
Hvad det er godt for: flytter du til en ny Mac og gendanner sikkerhedskopien der, forbliver fingeraftrykket det samme. Klienterne mærker intet til flytningen og spørger ikke igen. En ny eller gendannet nøgle gælder straks for nye forbindelser.
12 — Prøveperiode og fuld version
Du kan prøve FerryDock uden begrænsninger i 7 dage. Derefter kræves den fulde version for at arbejde videre — et engangskøb i App Store.
På fanen Indstillinger › Pro:
- I prøveperioden står der, hvor mange dage og timer der er tilbage, med en bjælke nedenunder.
- Køb fuld version køber den fulde version; prisen står i knappen.
- Gendan køb henter et tidligere køb tilbage, for eksempel på en anden Mac eller efter en geninstallation.
- Efter købet står der Fuld version låst op.
Når prøveperioden er udløbet, stopper FerryDock begge servere, og de kan ikke længere startes. Der vises et vindue med Køb fuld version, Gendan køb og Afslut. Kører FerryDock, når prøveperioden udløber, kommer vinduet senest efter en time. Efter købet starter de servere igen, der kørte før.
13 — Sprog
FerryDock findes på syv sprog: dansk, engelsk, fransk, italiensk, portugisisk, spansk og tysk. Under Indstillinger › Generelt › Sprog vælger du et af dem eller Systemsprog. Med systemsproget tager FerryDock det første sprog fra din liste i Systemindstillinger, som det tilbyder, ellers engelsk.
FerryDocks tekster skifter med det samme, også menuerne. Dialoger, der kommer fra macOS, for eksempel mappevalget, følger ved næste start.
14 — Logfil
Under Indstillinger › Log skriver FerryDock en logfil. Den hjælper, når noget ikke virker som forventet, og du kontakter support.
- Skriv logfil slår den til og fra; som standard er den slået til.
- Niveau bestemmer, hvor meget der skrives: Fejl, Advarsler, Info (standard) eller Detaljeret. På Detaljeret står også hver kommando fra klienterne i den.
- Vis åbner vinduet Logfil med farvede linjer. Med Live vises nye linjer straks, Genindlæs læser filen forfra.
- Vis i Finder åbner mappen med filen, for eksempel for at vedhæfte den til en e-mail.
- Ryd sletter alle hidtidige linjer.
Linjerne er på engelsk, så en indsendt fil kan læses af alle. Filen vokser ikke ubegrænset: ved 1 MB begynder en ny, og den forrige gemmes som en anden fil.
15 — Sikkerhed
- FerryDock gemmer kun adgangskoder som saltede hashværdier, aldrig i klartekst. Af SSH-nøgler gemmer den kun den offentlige del.
- Efter tre forkerte adgangskoder afbryder FerryDock forbindelsen, ved FTP som ved SFTP. Hvert mislykket login forsinkes desuden med et sekund.
- En klient ser kun sin delte mappe og mapperne i den.
FTP uden kryptering overfører brugernavne, adgangskoder og filer i klartekst. Brug det kun i dit eget netværk. Hvor programmerne og enhederne understøtter det, så sæt krypteringen under Indstillinger › FTP(S) til Kræv, eller brug SFTP.
Er macOS' firewall slået til, skal FerryDock have lov til at tage imod indgående forbindelser.
16 — Taster i overblik
| Til hvad | Taster |
|---|---|
| Indstillinger | ⌘, |
| Luk vindue | ⌘W |
| Minimer vindue | ⌘M |
| Slut FerryDock | ⌘Q |
Tasterne virker, mens FerryDock er det forreste program. Uden Dock-symbol når du Indstillinger og Slut via menuen ved færgesymbolet.
17 — Ofte stillede spørgsmål
Jeg kan ikke finde FerryDock.
FerryDock åbner intet vindue ved start. Kig efter færgesymbolet øverst til højre i menulinjen. Vises Dock-symbolet, åbner et klik på det hovedvinduet.
Programmet kan ikke oprette forbindelse.
Tjek i hovedvinduet, om den rigtige server kører — FTP og SFTP startes hver for sig. Tjek adresse og port; SFTP har sin egen port, standard 2222. Ved FTP skal programmet bruge passiv tilstand. I sessionsloggen kan du se, om der overhovedet kommer noget frem.
Login afvises.
Tjek brugernavn og adgangskode. Ved „anonymous“ skal den anonyme adgang være slået til. Står krypteringen på Kræv, skal programmet forbinde krypteret. Efter tre mislykkede forsøg afbryder FerryDock forbindelsen; forbind igen.
Anonym adgang via SFTP virker ikke.
Anonym adgang findes kun via FTP og FTPS. Til SFTP skal du bruge en konto.
Min SSH-nøgle bliver ikke accepteret.
FerryDock tager kun imod Ed25519- og ECDSA-nøgler, ikke RSA-nøgler. Opret
om nødvendigt en ny med ssh-keygen -t ed25519, og gem filen
id_ed25519.pub i kontoen.
SFTP-programmet melder en ændret værtsnøgle.
Det sker, når værtsnøglen under
Indstillinger › SFTP er oprettet på ny, eller en
anden er gendannet. Sammenlign fingeraftrykket der med det meldte, og
fjern den gamle post i programmet. I Terminal:
ssh-keygen -R "[Min-Mac.local]:2222".
Download virker, upload gør ikke.
Kontoen er sat til Skrivebeskyttet, eller det er den anonyme adgang. Ved FTP står der så „550 Permission denied“ i sessionsloggen.
Nye klienter afvises.
Det højeste antal samtidige forbindelser er nået; i hovedvinduet er angivelsen så orange. Sæt værdien højere under Indstillinger › Generelt, eller afbryd klienter, du ikke længere har brug for.
En klient forsvinder efter et stykke tid.
Den var inaktiv længere end angivet under Afbryd inaktive klienter efter (minutter). Sæt værdien højere eller til 0.
Sessionsloggen forbliver tom.
Tjek, om Før sessionslog er slået til under Indstillinger › Generelt, og om en klient er valgt i listen.
En ændring af porten virker ikke.
Porte gælder fra næste start af den pågældende server. Klik på Genstart serveren i den orange note.
Serverne kan ikke startes, og et købsvindue vises.
Prøveperioden er udløbet. Med den fulde version kan serverne startes igen, se kapitel 12. Har du allerede købt den, så vælg Gendan køb.