Kasutusjuhend

Eesti

Kiirstart

# saada fail: parool luuakse automaatselt, kuvatakse link + parool
$ ttl send secret.pdf
No password provided. Generate one? [Y/n]:
Generated password: aB3kL9mXq7Rt
·✧★◉ Thank goodness, secret.pdf is in orbit (1.2 MB, expires 2026-10-08 12:00)
IMPORTANT! Save your password — required to download and decrypt the file.
Password: aB3kL9mXq7Rt
Manage key: k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz (ttl status / ttl delete -k)
https://ttlspaceusercontent.com/aBcDeFgHiJ

# allalaadimine: parooli küsitakse interaktiivselt
$ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ
Enter password: ********
Password verified
◉★✧· Phew, secret.pdf landed safe and sound (1.2 MB)

CLI tegeleb krüpteerimise, üleslaadimise, allalaadimise ja dekrüpteerimisega. Server ei näe kunagi teie parooli ega krüpteerimata andmeid.

Paigaldamine

Homebrew (macOS)

$ brew install tweenietomatoes/ttl/ttl

Scoop (Windows)

$ scoop bucket add ttl https://github.com/tweenietomatoes/scoop-ttl
$ scoop install ttl

Valmis käivitatav fail

# laadige oma platvormile mõeldud fail alla väljalaskelehelt (releases)
$ curl -Lo ttl.tar.gz \
  https://github.com/tweenietomatoes/ttl/releases/download/v1.6.2/ttl_1.6.2_linux_amd64.tar.gz
$ tar xzf ttl.tar.gz && sudo mv ttl /usr/local/bin/

Go install

$ go install github.com/tweenietomatoes/ttl/cmd/ttl@latest

Lähtekoodist

$ git clone https://github.com/tweenietomatoes/ttl
$ cd ttl && go build -o ttl ./cmd/ttl/
$ sudo mv ttl /usr/local/bin/

Kontrollimine

$ ttl version
ttl 1.6.2

Failide saatmine

Põhisaatmine

# parool luuakse automaatselt, vaikimisi TTL on 7d
$ ttl send report.xlsx

Kui terminalis parooli ei anta, küsib CLI:

No password provided. Generate one? [Y/n]:

Vajutage Enter või sisestage y, et parool automaatselt luua.

Oma parool

$ ttl send -p mySecretPass -t 1h document.pdf

Kustuta pärast lugemist

# kustutatakse pärast allalaadimist; katkenud allalaadimist saab jätkata ja see faili ära ei kasuta
$ ttl send -b photo.jpg

Oma TTL

$ ttl send -t 5m temp-credentials.txt   # aegub 5 minuti pärast
$ ttl send -t 30m meeting-link.txt      # aegub 30 minuti pärast
$ ttl send -t 6h backup.tar.gz          # aegub 6 tunni pärast
$ ttl send -t 1d daily-report.pdf       # aegub 1 päeva pärast
$ ttl send -t 3d project-archive.zip    # aegub 3 päeva pärast
$ ttl send -t 5d design-assets.zip      # aegub 5 päeva pärast
$ ttl send report.xlsx                  # aegub 7 päeva pärast (vaikimisi)

Suured failid

Kuni 16 MiB fail läheb ühe päringuga; suurem fail jätkatavate 16 MiB osadena, kaks korraga. Iga päring kontrollitakse SHA-256 räsiga ja teel ebaõnnestunud päring saadetakse uuesti; juba saadetud osad jäävad alles. Ctrl-C tühistab puhtalt.

Failide allalaadimine

Interaktiivne (terminal)

$ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ
Enter password: ********
Password verified
◉★✧· Phew, document.pdf landed safe and sound (4.2 MB)

Parooli terminalis ei kuvata. Algne failinimi säilitatakse; kui selline nimi väljundkaustas juba olemas on, salvestatakse fail nimega name (1).ext, mitte ei kirjutata üle.

Ainult tokeniga

# täieliku URL-i asemel võite kasutada ainult 10-märgilist tokenit
$ ttl get aBcDeFgHiJ

Väljundkaust

$ ttl get -o ~/Downloads aBcDeFgHiJ

Vaikimisi salvestatakse failid praegusesse kausta. Teise kausta määramiseks kasutage -o / --output.

Parooli valikuga

$ ttl get -p mySecretPass https://ttlspaceusercontent.com/aBcDeFgHiJ

Katkenud allalaadimised

Katkenud allalaadimine jätkub viimasest saadud baidist; iga 64 KiB tükk autentitakse eraldi, seega on tulemus identne katkematu ülekandega. Ühekordne (pärast lugemist kustutatav) fail kasutatakse ära, kui allalaadimine on selle tervikuna kätte saanud: katkenud allalaadimine jätkub sealt, kus see pooleli jäi, ja fail jääb järgmiseks katseks alles.

Brauser

Faile saate alla laadida ja dekrüpteerida ka brauseris, avades lingi otse. Veebiliides kasutab sama failivormingut ja algoritme (Argon2id, XChaCha20-Poly1305) ning küsib teie parooli. Tarkvara paigaldamine pole vajalik.

Haldusvõti

Igal üleslaadimisel on haldusvõti, mille ttl send väljastab ühe korra (manage_key režiimis --json). Server hoiab ainult selle räsi. Igas plaanis võimaldab see üleslaadimist jälgida või varem lõpetada; igaüks, kellel võti on, saab üleslaadimise kustutada, seega hoidke seda nagu parooli.

# oma üleslaadimise olek, allalaadimised ja aegumine
$ ttl status aBcDeFgHiJ -k k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz
Token:      aBcDeFgHiJ
State:      active
Size:       4.2 MB
Created:    2026-10-01 12:00
Expires:    2026-10-08 12:00
Downloads:  1 (last 2026-10-02 09:12)

# kustuta varem
$ ttl delete aBcDeFgHiJ -k k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz
Deleted: aBcDeFgHiJ

Olek on üks järgmistest: active, expired, burned või deleted.

Parooli käsitlemine

Parool on krüpteerimisvõtme lähtepunkt. See ei lahku kunagi teie seadmest ja seda ei saadeta kunagi serverisse. Seda saab anda kuuel viisil:

1. Automaatne loomine (ainult saatmisel)

$ ttl send notes.txt
No password provided. Generate one? [Y/n]: y
Generated password: aB3kL9mXq7Rt

Loob krüptograafiliselt juhusliku 12-märgilise parooli märkidest [0-9A-Za-z]. Saadaval ainult käsu send ajal (interaktiivselt või automaatselt režiimis --json).

2. Interaktiivne küsimine

$ ttl send notes.txt
No password provided. Generate one? [Y/n]: n
Enter password: ********
Confirm password: ********

$ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ
Enter password: ********

Parooli ei kuvata. Käsu send ajal valite, kas luua automaatselt; kui sisestate oma parooli, kinnitate selle. Käsu get ajal küsitakse parooli otse.

3. Valik: -p / --password

$ ttl send -p mySecretPass file.zip
$ ttl get --password mySecretPass https://ttlspaceusercontent.com/aBcDeFgHiJ
-p / --password on nähtav käsu ps aux väljundis ja võib salvestuda terminali käsuajalukku (~/.bash_history). Vältige seda jagatud keskkondades ja skriptides. Kasutage selle asemel --password-stdin või --password-file.

4. Stdin: --password-stdin

# edasta echo-st
$ echo "mySecretPass" | ttl send --password-stdin backup.tar.gz

# edasta paroolihaldurist
$ pass show ttl/key | ttl send --password-stdin data.zip

# edasta keskkonnamuutujast
$ printenv MY_SECRET | ttl get --password-stdin https://ttlspaceusercontent.com/aBcDeFgHiJ

# here-string
$ ttl send --password-stdin report.pdf <<<"mySecretPass"

Loeb esimese rea stdin-ist. Kasulik skriptides, CI/CD torujuhtmetes ja automatiseerimisel. Kui stdin ei ole terminal ja parooliallikat ei anta, lõpetab CLI veaga (v.a kui kasutatakse --json, mis loob parooli automaatselt).

5. Fail: --password-file

$ ttl send --password-file /run/secrets/key report.xlsx
$ ttl get --password-file ~/.ttl-key https://ttlspaceusercontent.com/aBcDeFgHiJ

Loeb faili esimese rea (lõpu reavahetus eemaldatakse). Ühildub Docker secretsiga (/run/secrets/), Vault agendi failidega ja sarnaste lahendustega.

6. Automaatselt leitud fail: ttl.password

Kui parooli selgesõnaliselt ei anta, otsib CLI faili ttl.password käivitatava faili kõrvalt, seejärel ~/.ttl/password. Esimest rida kasutatakse paroolina.

Korraga võib kasutada ainult ühte selgesõnalist parooliallikat. Valikute -p / --password, --password-stdin ja --password-file kombineerimine on viga. Automaatselt leitud faili ttl.password kontrollitakse ainult siis, kui ühtegi neist ei anta. Parooli minimaalne pikkus on 8 märki.

Valikute teatmik

Saatmisvalikud

ValikKirjeldusVaikimisi
-p, --password PKrüpteerimisparoolinteraktiivne
--password-stdinLoe parool stdin-ist
--password-file FLoe parool failist
-t, --ttl DUREluiga7d
-b, --burnKustuta pärast lugemist (üks allalaadimine)välja lülitatud
-u, --uploader-onlyAlla saab laadida ainult teie kontoga: teie kontolehelt või mõne konto API võtmega (Orbit; alias --private)välja lülitatud
--timeout DURÜlekande ajalõpppuudub
--server URLServeri URLhttps://ttl.space
-h3, --http3Proovi HTTP/3 (QUIC), vajadusel kasuta TCP-dvälja lülitatud
--jsonVäljasta JSON stdout-i (skriptide ja tehisintellekti agentide jaoks)välja lülitatud

Allalaadimisvalikud

ValikKirjeldusVaikimisi
-p, --password PDekrüpteerimisparoolinteraktiivne
--password-stdinLoe parool stdin-ist
--password-file FLoe parool failist
-o, --output DIRVäljundkaustpraegune kaust
--timeout DURÜlekande ajalõpppuudub
--server URLServer paljale tokenilehttps://ttl.space
-h3, --http3Proovi HTTP/3 (QUIC), vajadusel kasuta TCP-dvälja lülitatud
--jsonVäljasta JSON stdout-i (skriptide ja tehisintellekti agentide jaoks)välja lülitatud

TTL väärtused

Tasuta: 5m 10m 15m 30m 1h 2h 3h 6h 12h 24h 1d 2d 3d 4d 5d 6d 7d

Orbit lisab: 14d 15d 28d 30d permanent

Ajalõpp

Vaikimisi: puudub. Seiskunud ülekanne jätkub ise ja loobub, kui ei saa jätkata. Määrake piirang valikuga --timeout 30m või --timeout 2h.

Näited

Skript: varundamine ja üleslaadimine

#!/bin/bash
tar czf /tmp/backup.tar.gz /data
echo "$BACKUP_KEY" | ttl send --password-stdin -t 6h /tmp/backup.tar.gz
rm /tmp/backup.tar.gz

Lingi suunamine lõikelauale (macOS)

$ ttl send -p mypass123 file.pdf | pbcopy

Lingi suunamine lõikelauale (Linux)

$ ttl send -p mypass123 file.pdf | xclip -sel clip

Kustutamine pärast lugemist: ühekordne saladus

$ echo "$DB_PASSWORD" | ttl send --password-stdin -b -t 5m credentials.env
# link töötab täpselt ühe korra, aegub 5 minuti pärast

JSON-režiim (skriptid ja tehisintellekti agendid)

# saada: JSON-režiimis luuakse parool automaatselt
$ ttl --json send report.pdf
{"ok":true,"link":"https://ttlspaceusercontent.com/xK9mQ2vLpA","token":"xK9mQ2vLpA","filename":"report.pdf","size":2097152,"ttl":"7d","expires_in":604800,"expires_at":1760011200,"burn":false,"uploader_only":false,"is_permanent":false,"manage_key":"k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz","password":"aB3kL9mXq7Rt"}

# laadi alla (get)
$ ttl --json get -p aB3kL9mXq7Rt xK9mQ2vLpA
{"ok":true,"token":"xK9mQ2vLpA","filename":"report.pdf","size":2097152,"saved_to":"/home/user/report.pdf"}

# olek haldusvõtmega
$ ttl --json status xK9mQ2vLpA -k k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz
{"ok":true,"token":"xK9mQ2vLpA","status":{"state":"active","size_bytes":2097152,"created_at":1759406400,"expires_at":1760011200,"permanent":false,"burn":false,"note":false,"uploader_only":false,"downloads":1,"last_download_at":1759492800,"part_reads":0,"last_part_at":0}}

# vead tagastavad ok:false
{"ok":false,"error":"Link not found. The file may have expired, been downloaded already (burn after reading), or be private (uploader-only)"}

Režiimis --json on kogu väljund struktureeritud JSON stdout-is. Kui saatmisel parooli ei anta, luuakse see automaatselt ja lisatakse vastusesse. Väljumiskood on edu korral 0, vea korral 1.

Orbit-plaan

Orbit avab suuremad failid (50 GB), pikema säilitamise (30 päeva või tellimusega püsivalt), teie kontole lukustatud failid (neid saab alla laadida ainult teie konto) ja failihalduse (loend ja kustutamine). Täielik võrdlus: Funktsioonid.

API võti tuvastatakse automaatselt keskkonnamuutujast TTL_API_KEY, failist ttl.key käivitatava faili kõrval või failist ~/.ttl/key. Võtme salvestamiseks kasutage ttl activate või kirjutage see käsitsi mõnda neist asukohtadest.

# aktiveerige oma võti: küsitakse kuvamata, nii et see ei satu käsuajalukku
$ ttl activate
Enter Orbit API key: ********
Orbit plan activated. Key saved to /usr/local/bin/ttl.key
# mitteinteraktiivselt: ttl activate --key-stdin  |  ttl activate --key-file F

# vaadake plaani ja kasutust
$ ttl plan
Plan: orbit
Max file size: 50.0 GB
Max TTL: 30 days (or permanent)
Uploads per day: 1000000
Storage quota: 1024.0 GB

Usage:
  Uploads today: 3
  Active storage: 1.2 GB / 1024.0 GB

# saada pikema TTL-iga
$ ttl send -t 30d large-backup.tar.gz
# püsifail (ainult Orbit): aegumist pole, säilitatakse, kuni selle kustutate või tellimus lõpeb
$ ttl send -t permanent archive.tar.gz
# saada privaatne fail: seda saab alla laadida ainult teie konto (ainult Orbit)
$ ttl send -u payroll.xlsx

# viimaste üleslaadimiste loend
$ ttl list
  xK9mQ2vLpA    4.2 MB  2026-03-16 10:30 → 2026-04-15 10:30  [active]
  https://ttlspaceusercontent.com/xK9mQ2vLpA
  rT7bNw3KpF  912.0 KB  2026-03-15 14:20 → 2026-03-17 14:20  [active (burn)]
  https://ttlspaceusercontent.com/rT7bNw3KpF

# kustuta fail varem (ttl list käib läbi kõik lehed; -n 5 peatub viie faili järel)
$ ttl delete xK9mQ2vLpA
Deleted: xK9mQ2vLpA
# või üleslaadimise haldusvõtmega, igas plaanis: ttl delete xK9mQ2vLpA -k KEY

# eemalda salvestatud võti
$ ttl deactivate
Key file removed: /usr/local/bin/ttl.key

HTTP API

Üleslaadimine ja allalaadimine nõuavad CLI krüpteerimistorustikku (Argon2id + XChaCha20-Poly1305 + tükeldatud AEAD). Skriptimiseks kasutage ttl send / ttl get või režiimi --json. Allolevad lõpp-punktid on mõeldud Orbit-failihalduseks.

Failide loend (Orbit)

$ curl https://ttl.space/v1/files -H "X-API-Key: ttl_orbit_..."
{"files":[{"token":"xK9mQ2vLpA","link":"https://ttlspaceusercontent.com/xK9mQ2vLpA","size_bytes":1048576,"created_at":1711800600,"expires_at":1714392600,"burn":false,"expired":false,"uploader_only":false,"is_permanent":false,"is_note":false,"perm_grace_until":0}],"has_more":false}

# järgmine leht: ainult kui has_more on true; edastage eelmisest vastusest next_cursor
$ curl "https://ttl.space/v1/files?cursor=1711800600123456" -H "X-API-Key: ttl_orbit_..."

Tagastab selle võtmega üleslaaditud failid, uuemad enne, 20 lehe kohta. Kui has_more on true, sisaldab vastus ka next_cursor; edastage see kujul ?cursor=, et saada järgmine leht. Nõuab Orbit-plaani.

Faili kustutamine (Orbit)

$ curl -X DELETE https://ttl.space/v1/files/xK9mQ2vLpA -H "X-API-Key: ttl_orbit_..."

Edu korral tagastab 204 No Content. Nõuab Orbit-plaani. Fail peab kuuluma antud võtmele.

Veavastused

OlekTähendus
401Vigane või aegunud API võti
403Funktsioon nõuab Orbit-plaani
404Faili ei leitud või see ei kuulu sellele võtmele
429Päringute piir ületatud
500Serveri sisemine viga, proovige hiljem uuesti
502Salvestusruum on ajutiselt kättesaamatu, proovige hiljem uuesti

Piirangud

PiirangTasutaOrbit
Maksimaalne failisuurus6 GB50 GB
Maksimaalne TTL7 päeva30 päeva või püsivalt
Üleslaadimisi päevas4Piiramatu
Üleslaadimismaht päevas (IP kohta)6 GBPiiramatu
Samaaegsed üleslaadimised2 IP kohta4 API võtme kohta
Salvestuskvoot✗1 TB
Failide loend✗✓
Varajane kustutamine✓✓
Ainult üleslaadijale mõeldud failid✗✓
Parooli minimaalne pikkus8 märki
Päringuid IP kohta300 kümne sekundi jooksul
Ühendusi IP kohta100 samaaegset

Krüpteerimine

Failid krüpteeritakse teie seadmes enne üleslaadimist. Server hoiab ainult krüpteeritud andmeid ega saa teie faile dekrüpteerida.

KomponentAlgoritm / väärtus
Võtme tuletamineArgon2id (time=3, memory=64 MiB, parallelism=1)
ŠifferXChaCha20-Poly1305 AEAD

Igasugune krüpteeritud andmete muutmine põhjustab dekrüpteerimise ebaõnnestumise. Enne krüpteeritud andmete väljastamist kontrollib server, et allalaadija teab õiget parooli, kasutades krüpteerimisvõtmest tuletatud ühesuunalist tokenit.