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.
-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
| Parametrs | Apraksts | Noklusējums |
|---|---|---|
-p, --password P | Šifrēšanas parole | interaktīvi |
--password-stdin | Nolasīt paroli no stdin | |
--password-file F | Nolasīt paroli no faila | |
-t, --ttl DUR | Derīguma termiņš | 7d |
-b, --burn | Dzēst pēc izlasīšanas (viena lejupielāde) | izslēgts |
-u, --uploader-only | Lejupielā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 DUR | Pārsūtīšanas noildze | nav |
--server URL | Servera URL | https://ttl.space |
-h3, --http3 | Mēģināt HTTP/3 (QUIC), nepieciešamības gadījumā atgriezties pie TCP | izslēgts |
--json | Izvadīt JSON uz stdout (skriptiem un MI aģentiem) | izslēgts |
Lejupielādes parametri
| Parametrs | Apraksts | Noklusējums |
|---|---|---|
-p, --password P | Atšifrēšanas parole | interaktīvi |
--password-stdin | Nolasīt paroli no stdin | |
--password-file F | Nolasīt paroli no faila | |
-o, --output DIR | Izvades direktorijs | pašreizējais direktorijs |
--timeout DUR | Pārsūtīšanas noildze | nav |
--server URL | Serveris, ja norādīts tikai marķieris | https://ttl.space |
-h3, --http3 | Mēģināt HTTP/3 (QUIC), nepieciešamības gadījumā atgriezties pie TCP | izslēgts |
--json | Izvadī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
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
| Statuss | Nozīme |
|---|---|
401 | Nederīga API atslēga vai beidzies tās derīguma termiņš |
403 | Funkcijai nepieciešams Orbit plāns |
404 | Fails nav atrasts vai nepieder šai atslēgai |
429 | Pārsniegts pieprasījumu ātruma limits |
500 | Iekšēja servera kļūda, mēģiniet vēlāk |
502 | Krātuve īslaicīgi nav pieejama, mēģiniet vēlāk |
Limiti
| Ierobežojums | Bezmaksas | Orbit |
|---|---|---|
| Maksimālais faila izmērs | 6 GB | 50 GB |
| Maksimālais TTL | 7 dienas | 30 dienas vai pastāvīgi |
| Augšupielādes dienā | 4 | Neierobežoti |
| Augšupielāžu apjoms dienā (uz IP) | 6 GB | Neierobežots |
| Vienlaicīgas augšupielādes | 2 uz IP | 4 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 garums | 8 rakstzīmes | |
| Pieprasījumi uz IP | 300 uz 10 sekundēm | |
| Savienojumi uz IP | 100 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.
| Komponents | Algoritms / vērtība |
|---|---|
| Atslēgas atvasināšana | Argon2id (time=3, memory=64 MiB, parallelism=1) |
| Šifrs | XChaCha20-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.