Brick CLI
Vad är Brick CLI?
Brick CLI är kommandoradsklienten för Brick. brick håller en lokal mapp i dubbelriktad synk med din Brick-lagring: den laddar upp filer som bara finns lokalt, laddar ner filer som bara finns på servern, och sprider raderingar åt båda hållen — att radera en fil eller mapp lokalt flyttar den till papperskorgen på servern, och en fil eller mapp som slängs på Brick tas bort lokalt. Om båda sidor redigerar samma fil vinner serverns kopia. Efter den första genomgången bevakar brick mappen för filsystemändringar och pollar Brick regelbundet, så båda sidor hålls synkroniserade tills du stoppar den.
brick hanterar även inloggning och vilket konto som är aktivt för synkronisering.
Installation
Snabb installation
Installera senaste versionen på macOS eller Linux så här:
curl -fsSL https://raw.githubusercontent.com/requestbite/brick/main/install.sh | bash
Binären installeras till ~/.local/bin som standard.
Anpassad installationsmapp
För att installera senaste versionen till en anpassad mapp, gör så här:
curl -fsSL https://raw.githubusercontent.com/requestbite/brick/main/install.sh | bash -s -- --prefix $HOME/bin
Installera äldre version
För att installera en specifik version (i det här exemplet version 0.0.1), gör så här:
curl -fsSL https://raw.githubusercontent.com/requestbite/brick/main/install.sh | bash -s -- --version 0.0.1
Manuell nedladdning
Ladda ner färdigbyggda binärer från GitHub Releases.
Plattformar som stöds:
- macOS (amd64, arm64)
- Linux (amd64)
- Windows (amd64)
Användning
Kontohantering
==============
--login Logga in via webbläsaren
--switch-accounts Byt aktivt konto
--whoami Visa inloggad användare och kontouppgifter
Lagringssynk
============
Att köra brick utan andra flaggor synkar storageSyncFolder med Brick och bevakar ändringar
-r, --remote-control Tillåt Brick att fjärrlista/bläddra/överföra filer på den här enheten
--agent-root PATH Extra mapp att exponera för fjärrklienter när fjärrstyrning är aktiverat (kan upprepas)
Övrigt
======
--no-upgrade-check Inaktivera automatisk uppdateringskontroll
--uninstall Avinstallera brick
-h, --help Visa hjälpinformation
-v, --version Visa versionsinformation
Logga in, välj konto, och synka:
brick --login
brick --switch-accounts # behövs bara om din användare har fler än ett konto
brick
Vid första körningen frågar brick efter vilken lokal mapp som ska synkroniseras och kommer ihåg den (storageSyncFolder i ~/.config/brick/config.yaml) för framtida körningar.
Ange -r/--remote-control för att även tillåta Brick att fjärrlista, fjärrbläddra och överföra filer på den här enheten under synkronisering. Utan den nekar den lokala agenten alla sådana förfrågningar.
Exkludera mappar från synk
För att exkludera mappar från synkronisering (selektiv synk i Dropbox-stil), lägg till en lista excludeDirs i ~/.config/brick/config.yaml, med sökvägar relativa till storageSyncFolder:
excludeDirs:
- mapp/undermapp
- annan-mapp
Filer i en exkluderad mapp (eller någon mapp under den) laddas aldrig upp eller ner; ändringar i dem upptäcks och loggas, men ignoreras i övrigt.
Demonläge
Ange -d/--daemon för att köra varje interaktivt steg (inloggning, val av synkmapp, första körningens introduktion) i den aktuella terminalen som vanligt, och sedan koppla loss till bakgrunden när brick är inloggad och Brick går att nå, och lämna tillbaka kontrollen till skalet. Stöds inte i Windows.
Lokalt kontroll-API
Under synkronisering kör brick ett lokalt kontroll-API, endast tillgängligt via loopback, så att en annan lokal process på samma maskin — till exempel skrivbordsappen — kan läsa live-synkstatus och skicka kommandon, utan att röra terminalen brick är kopplad till.
Det är aktiverat som standard; inaktivera det med --no-control-api om du inte vill ha någon lokal IPC-yta (till exempel när brick körs obevakat på en server). API:et serveras över ett Unix domain socket och binds aldrig till en nätverksåtkomlig adress.
Endpoints:
| Metod | Sökväg | Beskrivning |
|---|---|---|
| GET | /v1/health | Livskontroll; ingen autentisering krävs. |
| GET | /v1/status | Aktuellt synkläge, räknare, pågående överföring, senaste fel. |
| GET | /v1/activity | Senaste upplaggnings-/nedladdnings-/raderingshändelser. |
| GET | /v1/account | Det inloggade kontots/klientens ID. |
| GET | /v1/quota | Kontots lagringskvot och användning. |
| POST | /v1/pause | Stoppa synkronisering tills den återupptas (filövervakningen fortsätter). |
| POST | /v1/resume | Återuppta synkronisering omedelbart. |
| POST | /v1/quit | Avsluta brick snyggt (samma väg som Ctrl+C). |
TIP
Även om den fullständiga dokumentationen för Brick CLI finns här, hittar du källkoden till appen på GitHub. Om du har frågor eller problem, skapa gärna en GitHub-fråga (issue).