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.

Vienu metu galima naudoti tik vieną aiškų slaptažodžio šaltinį. -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

ParametrasAprašasNumatytoji reikšmė
-p, --password PŠifravimo slaptažodisinteraktyviai
--password-stdinNuskaityti slaptažodį iš stdin
--password-file FNuskaityti slaptažodį iš failo
-t, --ttl DURGaliojimo laikas7d
-b, --burnIštrinti perskaičius (vienas atsisiuntimas)išjungta
-u, --uploader-onlyAtsisiųsti gali tik jūsų paskyra: jūsų paskyros puslapyje arba bet kuriuo jos API raktu (Orbit; sinonimas --private)išjungta
--timeout DURPerdavimo laiko limitasnėra
--server URLServerio URLhttps://ttl.space
-h3, --http3Bandyti HTTP/3 (QUIC), nepavykus – naudoti TCPišjungta
--jsonIšvesti JSON į stdout (scenarijams ir DI agentams)išjungta

Atsisiuntimo parametrai

ParametrasAprašasNumatytoji reikšmė
-p, --password PIššifravimo slaptažodisinteraktyviai
--password-stdinNuskaityti slaptažodį iš stdin
--password-file FNuskaityti slaptažodį iš failo
-o, --output DIRIšvesties katalogasdabartinis katalogas
--timeout DURPerdavimo laiko limitasnėra
--server URLServeris, kai nurodytas tik žetonashttps://ttl.space
-h3, --http3Bandyti HTTP/3 (QUIC), nepavykus – naudoti TCPišjungta
--jsonIš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

Įkėlimui ir atsisiuntimui reikalingas CLI šifravimo procesas (Argon2id + XChaCha20-Poly1305 + dalimis veikiantis AEAD). Scenarijams naudokite 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ūsenaReikšmė
401Netinkamas arba nebegaliojantis API raktas
403Funkcijai reikalingas Orbit planas
404Failas nerastas arba nepriklauso šiam raktui
429Viršytas užklausų dažnio limitas
500Vidinė serverio klaida, bandykite vėliau
502Saugykla laikinai nepasiekiama, bandykite vėliau

Apribojimai

ApribojimasNemokamasOrbit
Didžiausias failo dydis6 GB50 GB
Didžiausias TTL7 dienos30 dienų arba visam laikui
Įkėlimai per dieną4Neribota
Įkėlimų apimtis per dieną (vienam IP)6 GBNeribota
Vienu metu vykstantys įkėlimai2 vienam IP4 vienam API raktui
Saugyklos kvota✗1 TB
Failų sąrašas✗✓
Ankstyvas ištrynimas✓✓
Failai tik įkėlėjui✗✓
Mažiausias slaptažodžio ilgis8 simboliai
Užklausos vienam IP300 per 10 sekundžių
Ryšiai vienam IP100 vienu metu

Šifravimas

Failai šifruojami jūsų įrenginyje prieš įkeliant. Serveris saugo tik šifrogramą ir negali iššifruoti jūsų failų.

KomponentasAlgoritmas / reikšmė
Rakto išvedimasArgon2id (time=3, memory=64 MiB, parallelism=1)
ŠifrasXChaCha20-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.