Hem Storegate CLI Storegate CLI (sgcli) Användarmanual

Storegate CLI (sgcli) Användarmanual

Senast uppdaterad den Mar 02, 2026

Introduktion

Välkommen till användarmanualen för sgcli. Detta kommandoradsverktyg (CLI) låter dig interagera med ditt Storegate-konto direkt från din terminal. Det är ett kraftfullt verktyg för att hantera filer, skapa automatiserade skript och utföra snabba, server-sida-operationer.

Nyckelfunktioner:

  • Multiplattform: Fungerar på Windows, macOS och Linux.

  • Effektiva överföringar: Återupptar automatiskt avbrutna upp- och nedladdningar.

  • Rekursiva operationer: Ladda enkelt upp eller ner hela mappstrukturer.

  • Server-sida-hastighet: Kopiera, flytta och byt namn på filer direkt på servern utan att använda din lokala bandbredd.

  • Interaktiv & skriptbar: Använd verktyget interaktivt med frågor eller automatisera det i skript med --force-flaggan.

1. Installation

Du kan ladda ner en färdigkompilerad binärfil för ditt operativsystem.

Windows

  1. Ladda ner filen sgcli-windows-amd64.exe.

  2. För enklare användning kan du byta namn på den till sgcli.exe.

  3. Placera sgcli.exe-filen i en mapp som ingår i systemets PATH-miljövariabel (t.ex. C:\Windows\System32 eller en anpassad mapp som C:\Tools). Detta gör att du kan köra sgcli från vilken kommandotolk eller PowerShell-terminal som helst.

macOS

  1. Ladda ner filen sgcli-darwin-amd64 (för Intel Macar) eller sgcli-darwin-arm64 (för M1/M2/M3 Macar).

  2. Öppna din Terminal.

  3. Gör filen körbar:

    
chmod +x /sökväg/till/nedladdad/sgcli-darwin-arm64

  4. Flytta den till en katalog i din PATH, som /usr/local/bin, och byt namn på den till sgcli:

    
sudo mv /sökväg/till/nedladdad/sgcli-darwin-arm64 /usr/local/bin/sgcli

    Du kan nu köra sgcli från vilket terminalfönster som helst.

Linux

  1. Ladda ner filen sgcli-linux-amd64.

  2. Öppna din terminal.

  3. Gör filen körbar:

    
chmod +x /sökväg/till/nedladdad/sgcli-linux-amd64

  4. Flytta den till en katalog i din PATH, som /usr/local/bin:

    
sudo mv /sökväg/till/nedladdad/sgcli-linux-amd64 /usr/local/bin/sgcli

    Du kan nu köra sgcli från vilken terminal som helst.

2. Autentisering

Logga in

Innan du kan använda CLI-verktyget måste du logga in på ditt Storegate-konto. Denna process använder OAuth2 och kommer att öppna din webbläsare för autentisering.


sgcli login

Efter en lyckad inloggning kommer sgcli att spara en krypterad sessionsfil på din dator (~/.storegate_session.bin på macOS/Linux och %USERPROFILE%\.storegate_session.bin on Windows). Denna fil gör att du kan förbli inloggad mellan sessioner. Sessionen kommer automatiskt att uppdateras vid behov.

Logga ut

För att logga ut och radera den lokala sessionsfilen, kör:


sgcli logout

Detta återkallar sessionen på servern och tar bort dina lokala inloggningsuppgifter.

3. Kommandon

ls - Lista filer och mappar

Listar innehållet i en fjärrkatalog.

Användning:


sgcli ls [FJÄRRSÖKVÄG]

Om ingen sökväg anges listas innehållet i rotkatalogen.

Exempel:


# Lista innehållet i rotkatalogen

sgcli ls /

# Lista innehållet i en specifik mapp

sgcli ls /Dokument/Rapporter

put - Ladda upp en fil eller mapp

Laddar upp en lokal fil eller en hel mapp rekursivt till ditt Storegate-konto.

Användning:


sgcli put [LOKAL_SÖKVÄG] [FJÄRRSÖKVÄG]

Konflikthantering: Om en fil med samma namn redan finns på destinationen kommer du att bli ombedd att skriva över (overwrite), hoppa över (skip), tillämpa valet på alla (all) framtida konflikter, eller avsluta (quit) operationen.

Flaggor:

  • -f, --force: Skriver över befintliga filer utan att be om bekräftelse.

Exempel:


# Ladda upp en enskild fil till mappen "Videos"

sgcli put ./film.mp4 /Videos

# Ladda upp hela den lokala mappen "MittProjekt" till rotkatalogen

sgcli put ./MittProjekt /

# Ladda upp en fil och skriv över den om den finns

sgcli put config.json /Inställningar -f

get - Ladda ner en fil eller mapp

Laddar ner en fjärrfil eller en hel mapp rekursivt till din lokala maskin.

Användning:


sgcli get [FJÄRRSÖKVÄG] [LOKAL_SÖKVÄG]

Konflikthantering: I likhet med put kommer du att bli tillfrågad om en fil med samma namn redan finns lokalt.

Flaggor:

  • -f, --force: Skriver över befintliga lokala filer utan att fråga.

Exempel:


# Ladda ner en rapport till den nuvarande lokala katalogen (.)

sgcli get /Dokument/rapport.pdf .

# Ladda ner hela mappen "Foton" till en lokal "Nedladdningar"-katalog

sgcli get /Foton ./Nedladdningar

# Ladda ner och skriv över eventuella lokala filer

sgcli get /Foton ./Nedladdningar -f

cp - Kopiera på servern

Kopierar en fil eller mapp från en fjärrplats till en annan. Detta är en server-sida-operation och är extremt snabb eftersom den inte använder din lokala internetanslutning för överföringen.

Användning:


sgcli cp [FJÄRRKÄLLA] [FJÄRRDESTINATION]

Flaggor:

  • -f, --force: Skriver över destinationsfiler om de existerar.

Exempel:


# Kopiera en fil till en "Arkiv"-mapp

sgcli cp /Dokument/rapport.pdf /Arkiv/

# Kopiera en hel mapp till en ny plats

sgcli cp /Foton /Backup/Foton_Kopia

mv - Flytta eller byt namn

Flyttar en fil eller mapp till en ny fjärrplats, eller byter namn på den. Detta är också en snabb server-sida-operation.

Användning:


sgcli mv [FJÄRRKÄLLA] [FJÄRRDESTINATION]

Flaggor:

  • -f, --force: Utför flytten/namnbytet utan bekräftelse.

Exempel:


# Byt namn på en fil

sgcli mv /Dokument/utkast.txt /Dokument/slutgiltig_rapport.txt

# Flytta en fil till en annan mapp

sgcli mv /bild.jpg /Foton/

# Flytta en mapp

sgcli mv /Gamla_Projekt /Arkiv/Gamla_Projekt

rm - Ta bort en fil eller mapp

Tar permanent bort en fil eller mapp från ditt Storegate-konto.

Användning:


sgcli rm [FJÄRRSÖKVÄG]

Flaggor:

  • -f, --force: Tar bort utan att be om bekräftelse. Använd med försiktighet!

Exempel:


# Ta bort en specifik fil

sgcli rm /Papperskorgen/gammal_fil.txt

# Ta bort en hel mapp och dess innehåll utan en prompt

sgcli rm /Tillfälliga_Filer -f

touch - Skapa en tom fil

Skapar en ny, tom fil på fjärrservern. Om filen redan finns blir du ombedd att bekräfta överskrivning.

Användning:


sgcli touch [FJÄRRSÖKVÄG]

Flaggor:

  • -f, --force: Skriver över en befintlig fil utan bekräftelse.

Exempel:


# Skapa en ny placeholder-fil

sgcli touch /Dokument/ny_fil.txt

open - Öppna en fjärrfil (Endast läsning)

Laddar ner en fjärrfil till en tillfällig plats och öppnar den med din dators standardprogram för den filtypen.

⚠️ Viktigt: Detta kommando är endast till för visning. Eventuella ändringar du gör i filen kommer INTE att sparas tillbaka till Storegate.

Om du behöver redigera en fil och spara ändringarna till molnet, använd istället funktionen Redigera (F4) i sgcli tui.

Användning:


sgcli open [FJÄRRSÖKVÄG]

Exempel:


# Öppna ett kalkylark för visning

sgcli open /Ekonomi/budget.xlsx

mkdir - Skapa en mapp

Skapar en ny, tom mapp. Den kan också skapa nästlade föräldrakataloger om de inte redan finns.

Användning:


sgcli mkdir [FJÄRRSÖKVÄG]

Exempel:


# Skapa en ny projektmapp

sgcli mkdir /Projekt/Nytt_Kundprojekt

diff - Jämför lokalt och fjärran

Jämför en lokal katalog med en fjärrkatalog och visar skillnaderna.

Statusförklaringar:

  • ✅ OK: Filen finns på båda platserna med samma storlek och ändringstid.

  • 👉 SAKNAS (Fjärr): Filen finns lokalt men inte på servern.

  • 👈 SAKNAS (Lokalt): Filen finns på servern men inte lokalt.

  • ⚠️ STORLEK: Filen finns på båda platserna men storlekarna skiljer sig åt.

  • ⏰ TID: Filernas storlekar är desamma, men ändringstiderna skiljer sig åt.

  • ❌ TYP: Objektet är en fil på ett ställe och en mapp på det andra.

Användning:


sgcli diff [LOKAL_SÖKVÄG] [FJÄRRSÖKVÄG]

Exempel:


# Jämför lokala "Foton" med fjärrmappen "Backup/Foton"

sgcli diff ./Foton /Backup/Foton

df - Visa lagringsutrymme

Visar den totala lagringskapaciteten, använt utrymme och tillgängligt utrymme för ditt Storegate-konto.

Användning:


sgcli df

du - Visa diskanvändning

Beräknar och visar den totala storleken för en specifik fjärrfil eller mapp.

Användning:


sgcli du [FJÄRRSÖKVÄG]

Exempel:


# Hämta storleken på mappen "Videos"

sgcli du /Videos

cat - Visa filinnehåll

Laddar ner och skriver ut innehållet i en fjärrfil direkt till terminalen.

Användning:


sgcli cat [FJÄRRFILENS_SÖKVÄG]

Exempel:


# Visa innehållet i en konfigurationsfil

sgcli cat /Inställningar/config.txt

web - Öppna i webbläsare

Öppnar ditt Storegate-konto i din standardwebbläsare.

Användning:


sgcli web

tui - Terminalbaserat Användargränssnitt

Startar det interaktiva filhanteringsläget med dubbla paneler.

Användning:


sgcli tui

(Eller kör bara sgcli om det är konfigurerat som standard)

Kortkommandon:

  • Tab: Växla mellan Vänster (Lokal) och Höger (Fjärr) panel.

  • F1: Visa Hjälp.

  • F2: Växla Sortering (Namn -> Storlek -> Datum).

  • F3: Visa filinnehåll (intern visare för text, extern app för andra).

  • F4: Redigera fil. Öppnar i din standardredigerare. Låser automatiskt filen på servern och laddar upp vid sparande.

  • F5: Kopiera markerade objekt. Öppnar en dialog där du kan ändra målvägen (möjliggör "Kopiera som").

  • F6: Flytta markerade objekt. Öppnar en dialog där du kan ändra målvägen (möjliggör flytt till annan mapp och namnbyte samtidigt).

  • Ctrl+E: Byt namn på det markerade objektet direkt på plats.

  • F7: Skapa Mapp.

  • F8 / Del: Ta bort markerade objekt.

  • F9: Markera filer genom mönstermatchning (glob, t.ex. *.zip).

  • F10: Avsluta.

  • Ctrl+C: Avbryt pågående överföring eller avsluta programmet.

  • Ctrl+N: Skapa en ny tom fil (Touch).

  • F12: Växla aktiv panel mellan Lokal/Fjärr-vy.

  • Space: Markera/Avmarkera fil.

  • Ctrl+A: Markera alla.

  • +/-: Markera med mönster (t.ex. *.txt).

  • *****: Invertera markering.

4. Skal-autokomplettering

sgcli kan generera skript för autokomplettering för olika skal, vilket rekommenderas starkt för en bättre användarupplevelse. Det gör att du kan komplettera kommandon och fjärrsökvägar genom att trycka på Tab-tangenten.

Generera skriptet

Kör först kommandot completion följt av namnet på ditt skal.

  • Bash: sgcli completion bash

  • Zsh: sgcli completion zsh

  • Fish: sgcli completion fish

  • PowerShell: sgcli completion powershell

Permanent installation

Bash (Linux/macOS)

Lägg till följande rad i din ~/.bash_profile eller ~/.bashrc:


source <(sgcli completion bash)

Ladda om ditt skal med source ~/.bash_profile eller öppna en ny terminal.

Zsh (macOS/Linux)

Lägg till följande rad i din ~/.zshrc:


source <(sgcli completion zsh)

Ladda om ditt skal med source ~/.zshrc eller öppna en ny terminal.

Fish (Linux/macOS)

Kör detta kommando en gång i din terminal:


sgcli completion fish > ~/.config/fish/completions/sgcli.fish

Detta skapar kompletteringsfilen i rätt katalog.

PowerShell (Windows)

  1. Open your PowerShell profile script for editing:

    
notepad $PROFILE

  2. Lägg till följande rad i filen och spara den:

    
. (sgcli completion powershell | Out-String)

  3. Ladda om din profil eller öppna en ny PowerShell-terminal.

5. Globala flaggor

Dessa flaggor kan användas med vilket kommando som helst.

  • --no-log: Inaktiverar skrivning av loggfiler till disken. (Loggar lagras normalt i en systemspecifik loggkatalog).

  • --help: Visar hjälp för sgcli eller ett specifikt kommando.

  • --version: Visar den aktuella versionen av sgcli.