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.
-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
| Valik | Kirjeldus | Vaikimisi |
|---|---|---|
-p, --password P | Krüpteerimisparool | interaktiivne |
--password-stdin | Loe parool stdin-ist | |
--password-file F | Loe parool failist | |
-t, --ttl DUR | Eluiga | 7d |
-b, --burn | Kustuta pärast lugemist (üks allalaadimine) | välja lülitatud |
-u, --uploader-only | Alla 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õpp | puudub |
--server URL | Serveri URL | https://ttl.space |
-h3, --http3 | Proovi HTTP/3 (QUIC), vajadusel kasuta TCP-d | välja lülitatud |
--json | Väljasta JSON stdout-i (skriptide ja tehisintellekti agentide jaoks) | välja lülitatud |
Allalaadimisvalikud
| Valik | Kirjeldus | Vaikimisi |
|---|---|---|
-p, --password P | Dekrüpteerimisparool | interaktiivne |
--password-stdin | Loe parool stdin-ist | |
--password-file F | Loe parool failist | |
-o, --output DIR | Väljundkaust | praegune kaust |
--timeout DUR | Ülekande ajalõpp | puudub |
--server URL | Server paljale tokenile | https://ttl.space |
-h3, --http3 | Proovi HTTP/3 (QUIC), vajadusel kasuta TCP-d | välja lülitatud |
--json | Vä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
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
| Olek | Tähendus |
|---|---|
401 | Vigane või aegunud API võti |
403 | Funktsioon nõuab Orbit-plaani |
404 | Faili ei leitud või see ei kuulu sellele võtmele |
429 | Päringute piir ületatud |
500 | Serveri sisemine viga, proovige hiljem uuesti |
502 | Salvestusruum on ajutiselt kättesaamatu, proovige hiljem uuesti |
Piirangud
| Piirang | Tasuta | Orbit |
|---|---|---|
| Maksimaalne failisuurus | 6 GB | 50 GB |
| Maksimaalne TTL | 7 päeva | 30 päeva või püsivalt |
| Üleslaadimisi päevas | 4 | Piiramatu |
| Üleslaadimismaht päevas (IP kohta) | 6 GB | Piiramatu |
| Samaaegsed üleslaadimised | 2 IP kohta | 4 API võtme kohta |
| Salvestuskvoot | ✗ | 1 TB |
| Failide loend | ✗ | ✓ |
| Varajane kustutamine | ✓ | ✓ |
| Ainult üleslaadijale mõeldud failid | ✗ | ✓ |
| Parooli minimaalne pikkus | 8 märki | |
| Päringuid IP kohta | 300 kümne sekundi jooksul | |
| Ühendusi IP kohta | 100 samaaegset | |
Krüpteerimine
Failid krüpteeritakse teie seadmes enne üleslaadimist. Server hoiab ainult krüpteeritud andmeid ega saa teie faile dekrüpteerida.
| Komponent | Algoritm / väärtus |
|---|---|
| Võtme tuletamine | Argon2id (time=3, memory=64 MiB, parallelism=1) |
| Šiffer | XChaCha20-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.