Lietošanas rokasgrāmata

Latviešu

Ātrā sākšana

# nosūtīt failu: parole tiek izveidota automātiski, tiek izvadīta saite + parole
$ 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

# lejupielāde: parole tiek pieprasīta interaktīvi
$ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ
Enter password: ********
Password verified
◉★✧· Phew, secret.pdf landed safe and sound (1.2 MB)

CLI veic šifrēšanu, augšupielādi, lejupielādi un atšifrēšanu. Serveris nekad neredz ne jūsu paroli, ne nešifrētus datus.

Instalēšana

Homebrew (macOS)

$ brew install tweenietomatoes/ttl/ttl

Scoop (Windows)

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

Gatavs izpildāmais fails

# lejupielādējiet savai platformai paredzēto failu no laidieniem (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

No pirmkoda

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

Pārbaude

$ ttl version
ttl 1.6.2

Failu sūtīšana

Pamata sūtīšana

# parole tiek izveidota automātiski, noklusējuma TTL ir 7d
$ ttl send report.xlsx

Ja terminālī parole nav norādīta, CLI vaicā:

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

Nospiediet Enter vai ievadiet y, lai parole tiktu izveidota automātiski.

Pielāgota parole

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

Dzēst pēc izlasīšanas

# tiek dzēsts pēc lejupielādes; pārtraukta lejupielāde var tikt atsākta un failu neizlieto
$ ttl send -b photo.jpg

Pielāgots TTL

$ ttl send -t 5m temp-credentials.txt   # derīgums beigsies pēc 5 minūtēm
$ ttl send -t 30m meeting-link.txt      # derīgums beigsies pēc 30 minūtēm
$ ttl send -t 6h backup.tar.gz          # derīgums beigsies pēc 6 stundām
$ ttl send -t 1d daily-report.pdf       # derīgums beigsies pēc 1 dienas
$ ttl send -t 3d project-archive.zip    # derīgums beigsies pēc 3 dienām
$ ttl send -t 5d design-assets.zip      # derīgums beigsies pēc 5 dienām
$ ttl send report.xlsx                  # derīgums beigsies pēc 7 dienām (noklusējums)

Lieli faili

Failu līdz 16 MiB nosūta vienā pieprasījumā; lielāku failu nosūta atsākamās 16 MiB daļās, pa divām vienlaikus. Katrs pieprasījums tiek pārbaudīts ar SHA-256 kontrolsummu, un pieprasījums, kas pa ceļam neizdodas, tiek nosūtīts vēlreiz; jau nosūtītās daļas paliek. Ctrl-C korekti atceļ sūtīšanu.

Failu lejupielāde

Interaktīvi (terminālis)

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

Parole terminālī netiek attēlota. Sākotnējais faila nosaukums tiek saglabāts; ja šāds nosaukums izvades direktorijā jau pastāv, fails tiek saglabāts kā name (1).ext, nevis pārrakstīts.

Tikai ar marķieri

# pilnas URL vietā varat izmantot tikai 10 rakstzīmju marķieri
$ ttl get aBcDeFgHiJ

Izvades direktorijs

$ ttl get -o ~/Downloads aBcDeFgHiJ

Pēc noklusējuma faili tiek saglabāti pašreizējā direktorijā. Izmantojiet -o / --output, lai norādītu citu direktoriju.

Ar paroles parametru

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

Pārtrauktas lejupielādes

Pārtraukta lejupielāde tiek atsākta no pēdējā saņemtā baita; katrs 64 KiB bloks tiek autentificēts atsevišķi, tāpēc rezultāts ir identisks nepārtrauktai pārsūtīšanai. Vienreizējs (dzēšams pēc izlasīšanas) fails tiek izlietots, kad lejupielāde to ir saņēmusi pilnībā: pārtraukta lejupielāde turpinās no vietas, kur apstājās, un fails paliek nākamajam mēģinājumam.

Pārlūkprogramma

Failus varat lejupielādēt un atšifrēt arī pārlūkprogrammā, tieši atverot saiti. Tīmekļa saskarne izmanto to pašu failu formātu un algoritmus (Argon2id, XChaCha20-Poly1305) un pieprasa jūsu paroli. Programmatūras instalēšana nav nepieciešama.

Pārvaldības atslēga

Katrai augšupielādei ir pārvaldības atslēga, ko ttl send izvada vienu reizi (manage_key režīmā --json). Serveris glabā tikai tās jaucējvērtību. Jebkurā plānā tā ļauj sekot augšupielādei vai to agrāk beigt; ikviens, kam ir atslēga, var dzēst augšupielādi, tāpēc glabājiet to tāpat kā paroli.

# savas augšupielādes statuss, lejupielādes un derīguma termiņš
$ 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)

# dzēst agrāk
$ ttl delete aBcDeFgHiJ -k k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz
Deleted: aBcDeFgHiJ

Statuss ir viens no šiem: active, expired, burned vai deleted.

Paroles apstrāde

Parole ir šifrēšanas atslēgas pamats. Tā nekad neatstāj jūsu ierīci un nekad netiek sūtīta uz serveri. To var norādīt sešos veidos:

1. Automātiska izveide (tikai sūtīšanai)

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

Izveido kriptogrāfiski nejaušu 12 rakstzīmju paroli no [0-9A-Za-z]. Pieejams tikai send laikā (interaktīvi vai automātiski režīmā --json).

2. Interaktīva uzvedne

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

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

Parole netiek attēlota. Izpildot send, jūs izvēlaties, vai izveidot automātiski; ja ievadāt savu paroli, to apstiprināt. Izpildot get, parole tiek pieprasīta tieši.

3. Parametrs: -p / --password

$ ttl send -p mySecretPass file.zip
$ ttl get --password mySecretPass https://ttlspaceusercontent.com/aBcDeFgHiJ
-p / --password ir redzams ps aux izvadē un var tikt saglabāts termināļa komandu vēsturē (~/.bash_history). Izvairieties no tā koplietošanas vidēs un skriptos. Tā vietā izmantojiet --password-stdin vai --password-file.

4. Stdin: --password-stdin

# pārsūtīt no echo
$ echo "mySecretPass" | ttl send --password-stdin backup.tar.gz

# pārsūtīt no paroļu pārvaldnieka
$ pass show ttl/key | ttl send --password-stdin data.zip

# pārsūtīt no vides mainīgā
$ printenv MY_SECRET | ttl get --password-stdin https://ttlspaceusercontent.com/aBcDeFgHiJ

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

Nolasa pirmo rindu no stdin. Noder skriptos, CI/CD konveijeros un automatizācijā. Ja stdin nav terminālis un paroles avots nav norādīts, CLI beidz darbu ar kļūdu (ja vien netiek izmantots --json, kas paroli izveido automātiski).

5. Fails: --password-file

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

Nolasa faila pirmo rindu (beigu rindas pārnesums tiek noņemts). Saderīgs ar Docker secrets (/run/secrets/), Vault aģenta failiem un līdzīgiem risinājumiem.

6. Automātiski atrasts fails: ttl.password

Ja skaidri nav norādīta parole, CLI meklē failu ttl.password blakus izpildāmajam failam, pēc tam ~/.ttl/password. Pirmā rinda tiek izmantota kā parole.

Vienlaikus var izmantot tikai vienu skaidri norādītu paroles avotu. -p / --password, --password-stdin un --password-file apvienošana ir kļūda. Automātiski atrastais fails ttl.password tiek pārbaudīts tikai tad, ja nav norādīts neviens no šiem. Minimālais paroles garums ir 8 rakstzīmes.

Parametru atsauce

Sūtīšanas parametri

ParametrsAprakstsNoklusējums
-p, --password PŠifrēšanas paroleinteraktīvi
--password-stdinNolasīt paroli no stdin
--password-file FNolasīt paroli no faila
-t, --ttl DURDerīguma termiņš7d
-b, --burnDzēst pēc izlasīšanas (viena lejupielāde)izslēgts
-u, --uploader-onlyLejupielādēt var tikai jūsu konts: jūsu konta lapā vai ar jebkuru tā API atslēgu (Orbit; sinonīms --private)izslēgts
--timeout DURPārsūtīšanas noildzenav
--server URLServera URLhttps://ttl.space
-h3, --http3Mēģināt HTTP/3 (QUIC), nepieciešamības gadījumā atgriezties pie TCPizslēgts
--jsonIzvadīt JSON uz stdout (skriptiem un MI aģentiem)izslēgts

Lejupielādes parametri

ParametrsAprakstsNoklusējums
-p, --password PAtšifrēšanas paroleinteraktīvi
--password-stdinNolasīt paroli no stdin
--password-file FNolasīt paroli no faila
-o, --output DIRIzvades direktorijspašreizējais direktorijs
--timeout DURPārsūtīšanas noildzenav
--server URLServeris, ja norādīts tikai marķierishttps://ttl.space
-h3, --http3Mēģināt HTTP/3 (QUIC), nepieciešamības gadījumā atgriezties pie TCPizslēgts
--jsonIzvadīt JSON uz stdout (skriptiem un MI aģentiem)izslēgts

TTL vērtības

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

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

Noildze

Noklusējums: nav. Apstājusies pārsūtīšana atsākas pati un padodas, ja nevar turpināt. Ierobežojumu iestatiet ar --timeout 30m vai --timeout 2h.

Piemēri

Skripts: dublēšana un augšupielāde

#!/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

Saites pārsūtīšana uz starpliktuvi (macOS)

$ ttl send -p mypass123 file.pdf | pbcopy

Saites pārsūtīšana uz starpliktuvi (Linux)

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

Dzēšana pēc izlasīšanas: vienreizējs noslēpums

$ echo "$DB_PASSWORD" | ttl send --password-stdin -b -t 5m credentials.env
# saite darbojas tieši vienu reizi, derīgums beidzas pēc 5 minūtēm

JSON režīms (skripti un MI aģenti)

# nosūtīt: JSON režīmā parole tiek izveidota automātiski
$ 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"}

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

# statuss ar pārvaldības atslēgu
$ 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}}

# kļūdas atgriež 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žīmā --json visa izvade ir strukturēts JSON uz stdout. Ja sūtīšanas laikā parole nav norādīta, tā tiek izveidota automātiski un iekļauta atbildē. Izejas kods ir 0 veiksmes gadījumā un 1 kļūdas gadījumā.

Orbit plāns

Orbit atbloķē lielākus failus (50 GB), ilgāku glabāšanu (30 dienas vai pastāvīgi ar abonementu), failus, kas piesaistīti jūsu kontam (tos var lejupielādēt tikai jūsu konts), un failu pārvaldību (saraksts un dzēšana). Pilns salīdzinājums: Funkcijas.

API atslēga tiek automātiski nolasīta no vides mainīgā TTL_API_KEY, faila ttl.key blakus izpildāmajam failam vai ~/.ttl/key. Izmantojiet ttl activate, lai saglabātu atslēgu, vai ierakstiet to jebkurā no šīm vietām manuāli.

# aktivizējiet atslēgu: tiek pieprasīta bez atbalss, tāpēc tā nenokļūst komandu vēsturē
$ ttl activate
Enter Orbit API key: ********
Orbit plan activated. Key saved to /usr/local/bin/ttl.key
# neinteraktīvi: ttl activate --key-stdin  |  ttl activate --key-file F

# pārbaudiet plānu un lietojumu
$ 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

# sūtīt ar pagarinātu TTL
$ ttl send -t 30d large-backup.tar.gz
# pastāvīgs fails (tikai Orbit): bez derīguma termiņa, glabājas, līdz to izdzēšat vai beidzas abonements
$ ttl send -t permanent archive.tar.gz
# nosūtīt privātu failu: to var lejupielādēt tikai jūsu konts (tikai Orbit)
$ ttl send -u payroll.xlsx

# jaunāko augšupielāžu saraksts
$ 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

# dzēst failu agrāk (ttl list apstaigā visas lapas; -n 5 apstājas pēc pieciem failiem)
$ ttl delete xK9mQ2vLpA
Deleted: xK9mQ2vLpA
# vai ar augšupielādes pārvaldības atslēgu jebkurā plānā: ttl delete xK9mQ2vLpA -k KEY

# noņemt saglabāto atslēgu
$ ttl deactivate
Key file removed: /usr/local/bin/ttl.key

HTTP API

Augšupielādei un lejupielādei nepieciešams CLI šifrēšanas konveijers (Argon2id + XChaCha20-Poly1305 + sadalīts AEAD). Skriptēšanai izmantojiet ttl send / ttl get vai režīmu --json. Tālāk norādītie galapunkti paredzēti Orbit failu pārvaldībai.

Failu saraksts (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}

# nākamā lapa: tikai tad, ja has_more ir true; nododiet next_cursor no iepriekšējās atbildes
$ curl "https://ttl.space/v1/files?cursor=1711800600123456" -H "X-API-Key: ttl_orbit_..."

Atgriež ar šo atslēgu augšupielādētos failus, jaunākie vispirms, pa 20 lapā. Ja has_more ir true, atbildē ir arī next_cursor; nododiet to kā ?cursor=, lai iegūtu nākamo lapu. Nepieciešams Orbit plāns.

Faila dzēšana (Orbit)

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

Veiksmes gadījumā atgriež 204 No Content. Nepieciešams Orbit plāns. Failam jāpieder norādītajai atslēgai.

Kļūdu atbildes

StatussNozīme
401Nederīga API atslēga vai beidzies tās derīguma termiņš
403Funkcijai nepieciešams Orbit plāns
404Fails nav atrasts vai nepieder šai atslēgai
429Pārsniegts pieprasījumu ātruma limits
500Iekšēja servera kļūda, mēģiniet vēlāk
502Krātuve īslaicīgi nav pieejama, mēģiniet vēlāk

Limiti

IerobežojumsBezmaksasOrbit
Maksimālais faila izmērs6 GB50 GB
Maksimālais TTL7 dienas30 dienas vai pastāvīgi
Augšupielādes dienā4Neierobežoti
Augšupielāžu apjoms dienā (uz IP)6 GBNeierobežots
Vienlaicīgas augšupielādes2 uz IP4 uz API atslēgu
Krātuves kvota✗1 TB
Failu saraksts✗✓
Dzēšana pirms termiņa✓✓
Faili tikai augšupielādētājam✗✓
Minimālais paroles garums8 rakstzīmes
Pieprasījumi uz IP300 uz 10 sekundēm
Savienojumi uz IP100 vienlaicīgi

Šifrēšana

Faili tiek šifrēti jūsu ierīcē pirms augšupielādes. Serveris glabā tikai šifrētus datus un nevar atšifrēt jūsu failus.

KomponentsAlgoritms / vērtība
Atslēgas atvasināšanaArgon2id (time=3, memory=64 MiB, parallelism=1)
ŠifrsXChaCha20-Poly1305 AEAD

Jebkāda šifrēto datu modificēšana izraisa atšifrēšanas kļūmi. Pirms šifrēto datu izsniegšanas serveris pārbauda, vai lejupielādētājs zina pareizo paroli, izmantojot vienvirziena marķieri, kas atvasināts no šifrēšanas atslēgas.