Naudojimo vadovas
Lietuvių
Greita pradžia
# išsiųskite failą: slaptažodis sukuriamas automatiškai, išvedama nuoroda + slaptažodis $ 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 # atsisiuntimas: slaptažodžio prašoma interaktyviai $ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ Enter password: ******** Password verified ◉★✧· Phew, secret.pdf landed safe and sound (1.2 MB)
CLI atlieka šifravimą, įkėlimą, atsisiuntimą ir iššifravimą. Serveris niekada nemato nei jūsų slaptažodžio, nei neužšifruotų duomenų.
Diegimas
Homebrew (macOS)
$ brew install tweenietomatoes/ttl/ttl
Scoop (Windows)
$ scoop bucket add ttl https://github.com/tweenietomatoes/scoop-ttl $ scoop install ttl
Paruoštas vykdomasis failas
# atsisiųskite savo platformai skirtą failą iš leidimų (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
Iš šaltinio kodo
$ git clone https://github.com/tweenietomatoes/ttl $ cd ttl && go build -o ttl ./cmd/ttl/ $ sudo mv ttl /usr/local/bin/
Patikrinimas
$ ttl version ttl 1.6.2
Failų siuntimas
Pagrindinis siuntimas
# slaptažodis sukuriamas automatiškai, numatytasis TTL yra 7d $ ttl send report.xlsx
Kai terminale slaptažodis nenurodytas, CLI paklausia:
No password provided. Generate one? [Y/n]:
Paspauskite Enter arba įveskite y, kad slaptažodis būtų sukurtas automatiškai.
Pasirinktas slaptažodis
$ ttl send -p mySecretPass -t 1h document.pdf
Ištrinti perskaičius
# ištrinama atsisiuntus; nutrūkęs atsisiuntimas gali būti tęsiamas ir failo nesunaudoja $ ttl send -b photo.jpg
Pasirinktas TTL
$ ttl send -t 5m temp-credentials.txt # nustos galioti po 5 minučių $ ttl send -t 30m meeting-link.txt # nustos galioti po 30 minučių $ ttl send -t 6h backup.tar.gz # nustos galioti po 6 valandų $ ttl send -t 1d daily-report.pdf # nustos galioti po 1 dienos $ ttl send -t 3d project-archive.zip # nustos galioti po 3 dienų $ ttl send -t 5d design-assets.zip # nustos galioti po 5 dienų $ ttl send report.xlsx # nustos galioti po 7 dienų (numatyta)
Dideli failai
Iki 16 MiB dydžio failas siunčiamas viena užklausa; didesnis siunčiamas tęsiamomis 16 MiB dalimis, po dvi vienu metu. Kiekviena užklausa tikrinama SHA-256 santrauka, o pakeliui nepavykusi siunčiama iš naujo; jau išsiųstos dalys lieka. Ctrl-C švariai atšaukia siuntimą.
Failų atsisiuntimas
Interaktyviai (terminalas)
$ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ Enter password: ******** Password verified ◉★✧· Phew, document.pdf landed safe and sound (4.2 MB)
Slaptažodis terminale nerodomas. Išsaugomas pradinis failo pavadinimas; jei toks pavadinimas išvesties kataloge jau yra, failas išsaugomas kaip name (1).ext, o ne perrašomas.
Tik su žetonu
# vietoj viso URL galite naudoti vien 10 simbolių žetoną $ ttl get aBcDeFgHiJ
Išvesties katalogas
$ ttl get -o ~/Downloads aBcDeFgHiJ
Pagal numatytuosius nustatymus failai išsaugomi dabartiniame kataloge. Kitam katalogui nurodyti naudokite -o / --output.
Su slaptažodžio parametru
$ ttl get -p mySecretPass https://ttlspaceusercontent.com/aBcDeFgHiJ
Nutrūkę atsisiuntimai
Nutrūkęs atsisiuntimas tęsiamas nuo paskutinio gauto baito; kiekviena 64 KiB dalis autentifikuojama atskirai, todėl rezultatas identiškas nenutrūkusiam perdavimui. Vienkartinis (ištrinamas perskaičius) failas sunaudojamas, kai atsisiuntimas gauna jį visą: nutrūkęs atsisiuntimas tęsiamas ten, kur sustojo, o failas lieka kitam bandymui.
Naršyklė
Failus taip pat galite atsisiųsti ir iššifruoti naršyklėje, tiesiog atidarę nuorodą. Žiniatinklio sąsaja naudoja tą patį failo formatą ir algoritmus (Argon2id, XChaCha20-Poly1305) ir paprašo jūsų slaptažodžio. Nieko diegti nereikia.
Valdymo raktas
Kiekvienas įkėlimas turi valdymo raktą, kurį ttl send išveda vieną kartą (manage_key režime --json). Serveris saugo tik jo maišos reikšmę. Bet kuriame plane jis leidžia stebėti įkėlimą arba jį anksčiau užbaigti; bet kas, turintis raktą, gali ištrinti įkėlimą, todėl saugokite jį kaip slaptažodį.
# savo įkėlimo būsena, atsisiuntimai ir galiojimo pabaiga $ 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) # ištrinti anksčiau $ ttl delete aBcDeFgHiJ -k k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz Deleted: aBcDeFgHiJ
Būsena yra viena iš active, expired, burned arba deleted.
Slaptažodžio tvarkymas
Slaptažodis yra šifravimo rakto pagrindas. Jis niekada nepalieka jūsų įrenginio ir niekada nesiunčiamas į serverį. Jį galima nurodyti šešiais būdais:
1. Automatinis sukūrimas (tik siunčiant)
$ ttl send notes.txt No password provided. Generate one? [Y/n]: y Generated password: aB3kL9mXq7Rt
Sukuria kriptografiškai atsitiktinį 12 simbolių slaptažodį iš [0-9A-Za-z]. Galima tik vykdant send (interaktyviai arba automatiškai --json režimu).
2. Interaktyvus klausimas
$ ttl send notes.txt No password provided. Generate one? [Y/n]: n Enter password: ******** Confirm password: ******** $ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ Enter password: ********
Slaptažodis nerodomas. Vykdant send, pasirenkate, ar kurti automatiškai; jei renkate savo, jį patvirtinate. Vykdant get, slaptažodžio paprašoma tiesiogiai.
3. Parametras: -p / --password
$ ttl send -p mySecretPass file.zip $ ttl get --password mySecretPass https://ttlspaceusercontent.com/aBcDeFgHiJ
-p / --password matomas ps aux išvestyje ir gali būti išsaugotas terminalo komandų istorijoje (~/.bash_history). Venkite jo bendrose aplinkose ir scenarijuose. Vietoj to naudokite --password-stdin arba --password-file.4. Stdin: --password-stdin
# perduoti iš echo $ echo "mySecretPass" | ttl send --password-stdin backup.tar.gz # perduoti iš slaptažodžių tvarkyklės $ pass show ttl/key | ttl send --password-stdin data.zip # perduoti iš aplinkos kintamojo $ printenv MY_SECRET | ttl get --password-stdin https://ttlspaceusercontent.com/aBcDeFgHiJ # here-string $ ttl send --password-stdin report.pdf <<<"mySecretPass"
Nuskaito pirmą eilutę iš stdin. Naudinga scenarijuose, CI/CD procesuose ir automatizavime. Kai stdin nėra terminalas ir slaptažodžio šaltinis nenurodytas, CLI baigia darbą su klaida (nebent naudojamas --json, kuris sukuria slaptažodį automatiškai).
5. Failas: --password-file
$ ttl send --password-file /run/secrets/key report.xlsx $ ttl get --password-file ~/.ttl-key https://ttlspaceusercontent.com/aBcDeFgHiJ
Nuskaito pirmą failo eilutę (galinis eilutės pabaigos simbolis pašalinamas). Suderinama su Docker secrets (/run/secrets/), Vault agento failais ir panašiais sprendimais.
6. Automatiškai aptinkamas failas: ttl.password
Jei slaptažodis aiškiai nenurodytas, CLI ieško failo ttl.password šalia vykdomojo failo, tada ~/.ttl/password. Pirma eilutė naudojama kaip slaptažodis.
-p / --password, --password-stdin ir --password-file derinimas yra klaida. Automatiškai aptinkamas ttl.password failas tikrinamas tik tada, kai nenurodytas nė vienas iš jų. Mažiausias slaptažodžio ilgis yra 8 simboliai.Parametrų žinynas
Siuntimo parametrai
| Parametras | Aprašas | Numatytoji reikšmė |
|---|---|---|
-p, --password P | Šifravimo slaptažodis | interaktyviai |
--password-stdin | Nuskaityti slaptažodį iš stdin | |
--password-file F | Nuskaityti slaptažodį iš failo | |
-t, --ttl DUR | Galiojimo laikas | 7d |
-b, --burn | Ištrinti perskaičius (vienas atsisiuntimas) | išjungta |
-u, --uploader-only | Atsisiųsti gali tik jūsų paskyra: jūsų paskyros puslapyje arba bet kuriuo jos API raktu (Orbit; sinonimas --private) | išjungta |
--timeout DUR | Perdavimo laiko limitas | nėra |
--server URL | Serverio URL | https://ttl.space |
-h3, --http3 | Bandyti HTTP/3 (QUIC), nepavykus – naudoti TCP | išjungta |
--json | Išvesti JSON į stdout (scenarijams ir DI agentams) | išjungta |
Atsisiuntimo parametrai
| Parametras | Aprašas | Numatytoji reikšmė |
|---|---|---|
-p, --password P | Iššifravimo slaptažodis | interaktyviai |
--password-stdin | Nuskaityti slaptažodį iš stdin | |
--password-file F | Nuskaityti slaptažodį iš failo | |
-o, --output DIR | Išvesties katalogas | dabartinis katalogas |
--timeout DUR | Perdavimo laiko limitas | nėra |
--server URL | Serveris, kai nurodytas tik žetonas | https://ttl.space |
-h3, --http3 | Bandyti HTTP/3 (QUIC), nepavykus – naudoti TCP | išjungta |
--json | Išvesti JSON į stdout (scenarijams ir DI agentams) | išjungta |
TTL reikšmės
Nemokama: 5m 10m 15m 30m 1h 2h 3h 6h 12h 24h 1d 2d 3d 4d 5d 6d 7d
Orbit prideda: 14d 15d 28d 30d permanent
Laiko limitas
Numatytoji reikšmė: nėra. Sustojęs perdavimas atsinaujina pats, o jei tęsti neįmanoma, nutraukiamas. Limitą nustatykite naudodami --timeout 30m arba --timeout 2h.
Pavyzdžiai
Scenarijus: atsarginė kopija ir įkėlimas
#!/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
Nuorodos perdavimas į iškarpinę (macOS)
$ ttl send -p mypass123 file.pdf | pbcopy
Nuorodos perdavimas į iškarpinę (Linux)
$ ttl send -p mypass123 file.pdf | xclip -sel clip
Ištrynimas perskaičius: vienkartinė paslaptis
$ echo "$DB_PASSWORD" | ttl send --password-stdin -b -t 5m credentials.env # nuoroda veikia tik vieną kartą, nustoja galioti po 5 minučių
JSON režimas (scenarijai ir DI agentai)
# siuntimas: JSON režimu slaptažodis sukuriamas automatiškai $ 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"} # atsisiuntimas (get) $ ttl --json get -p aB3kL9mXq7Rt xK9mQ2vLpA {"ok":true,"token":"xK9mQ2vLpA","filename":"report.pdf","size":2097152,"saved_to":"/home/user/report.pdf"} # būsena su valdymo raktu $ 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}} # klaidos grąžina ok:false {"ok":false,"error":"Link not found. The file may have expired, been downloaded already (burn after reading), or be private (uploader-only)"}
--json režimu visa išvestis yra struktūrizuotas JSON į stdout. Jei siunčiant slaptažodis nenurodytas, jis sukuriamas automatiškai ir įtraukiamas į atsakymą. Sėkmės atveju išėjimo kodas yra 0, klaidos atveju 1.
Orbit planas
Orbit atrakina didesnius failus (50 GB), ilgesnį saugojimą (30 dienų arba visam laikui su prenumerata), failus, priskirtus jūsų paskyrai (juos gali atsisiųsti tik jūsų paskyra), ir failų valdymą (sąrašas ir ištrynimas). Visas palyginimas: Funkcijos.
API raktas aptinkamas automatiškai iš aplinkos kintamojo TTL_API_KEY, failo ttl.key šalia vykdomojo failo arba ~/.ttl/key. Raktui išsaugoti naudokite ttl activate arba įrašykite jį rankiniu būdu į bet kurią iš šių vietų.
# aktyvuokite raktą: jo paprašoma nerodant įvedamų simbolių, todėl jis nepatenka į komandų istoriją $ ttl activate Enter Orbit API key: ******** Orbit plan activated. Key saved to /usr/local/bin/ttl.key # neinteraktyviai: ttl activate --key-stdin | ttl activate --key-file F # patikrinkite planą ir naudojimą $ 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 # siuntimas su ilgesniu TTL $ ttl send -t 30d large-backup.tar.gz # nuolatinis failas (tik Orbit): be galiojimo pabaigos, saugomas, kol jį ištrinsite arba pasibaigs prenumerata $ ttl send -t permanent archive.tar.gz # privataus failo siuntimas: jį gali atsisiųsti tik jūsų paskyra (tik Orbit) $ ttl send -u payroll.xlsx # naujausių įkėlimų sąrašas $ 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 # ištrinti failą anksčiau (ttl list peržiūri visus puslapius; -n 5 sustoja po penkių failų) $ ttl delete xK9mQ2vLpA Deleted: xK9mQ2vLpA # arba su įkėlimo valdymo raktu, bet kuriame plane: ttl delete xK9mQ2vLpA -k KEY # pašalinti išsaugotą raktą $ ttl deactivate Key file removed: /usr/local/bin/ttl.key
HTTP API
ttl send / ttl get arba --json režimą. Toliau pateikti galiniai taškai skirti Orbit failų valdymui.Failų sąrašas (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} # kitas puslapis: tik kai has_more yra true; perduokite next_cursor iš ankstesnio atsakymo $ curl "https://ttl.space/v1/files?cursor=1711800600123456" -H "X-API-Key: ttl_orbit_..."
Grąžina su šiuo raktu įkeltus failus, naujausi pirmiausia, po 20 viename puslapyje. Kai has_more yra true, atsakyme taip pat yra next_cursor; perduokite jį kaip ?cursor=, kad gautumėte kitą puslapį. Reikalingas Orbit planas.
Failo ištrynimas (Orbit)
$ curl -X DELETE https://ttl.space/v1/files/xK9mQ2vLpA -H "X-API-Key: ttl_orbit_..."
Sėkmės atveju grąžina 204 No Content. Reikalingas Orbit planas. Failas turi priklausyti nurodytam raktui.
Klaidų atsakymai
| Būsena | Reikšmė |
|---|---|
401 | Netinkamas arba nebegaliojantis API raktas |
403 | Funkcijai reikalingas Orbit planas |
404 | Failas nerastas arba nepriklauso šiam raktui |
429 | Viršytas užklausų dažnio limitas |
500 | Vidinė serverio klaida, bandykite vėliau |
502 | Saugykla laikinai nepasiekiama, bandykite vėliau |
Apribojimai
| Apribojimas | Nemokamas | Orbit |
|---|---|---|
| Didžiausias failo dydis | 6 GB | 50 GB |
| Didžiausias TTL | 7 dienos | 30 dienų arba visam laikui |
| Įkėlimai per dieną | 4 | Neribota |
| Įkėlimų apimtis per dieną (vienam IP) | 6 GB | Neribota |
| Vienu metu vykstantys įkėlimai | 2 vienam IP | 4 vienam API raktui |
| Saugyklos kvota | ✗ | 1 TB |
| Failų sąrašas | ✗ | ✓ |
| Ankstyvas ištrynimas | ✓ | ✓ |
| Failai tik įkėlėjui | ✗ | ✓ |
| Mažiausias slaptažodžio ilgis | 8 simboliai | |
| Užklausos vienam IP | 300 per 10 sekundžių | |
| Ryšiai vienam IP | 100 vienu metu | |
Šifravimas
Failai šifruojami jūsų įrenginyje prieš įkeliant. Serveris saugo tik šifrogramą ir negali iššifruoti jūsų failų.
| Komponentas | Algoritmas / reikšmė |
|---|---|
| Rakto išvedimas | Argon2id (time=3, memory=64 MiB, parallelism=1) |
| Šifras | XChaCha20-Poly1305 AEAD |
Bet koks šifrogramos pakeitimas lemia iššifravimo nesėkmę. Prieš išduodamas šifrogramą, serveris patikrina, ar atsisiunčiantysis žino teisingą slaptažodį, naudodamas vienakryptį žetoną, išvestą iš šifravimo rakto.