İstifadə bələdçisi

Azərbaycan

Sürətli başlanğıc

# fayl göndər: parol avtomatik yaradılır, keçid + parol çap olunur
$ 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

# endir: parol interaktiv şəkildə soruşulur
$ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ
Enter password: ********
Password verified
◉★✧· Phew, secret.pdf landed safe and sound (1.2 MB)

CLI şifrələməni, yükləməni, endirməni və şifrənin açılmasını özü yerinə yetirir. Server parolunuzu və ya şifrələnməmiş məlumatlarınızı heç vaxt görmür.

Quraşdırma

Homebrew (macOS)

$ brew install tweenietomatoes/ttl/ttl

Scoop (Windows)

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

Hazır icra faylı

# platformanız üçün buraxılışlardan endirin
$ 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

Mənbə kodundan qurma

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

Yoxlama

$ ttl version
ttl 1.6.2

Faylların göndərilməsi

Sadə göndərmə

# parol avtomatik yaradılır, standart TTL 7 gündür
$ ttl send report.xlsx

Terminalda parol verilməyibsə, CLI soruşur:

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

Avtomatik yaratmaq üçün Enter düyməsinə basın və ya y yazın.

Fərdi parol

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

Oxunduqdan sonra sil

# endirildikdən sonra silinir; yarımçıq qalan endirmə davam edə bilər və faylı istifadə olunmuş saymır
$ ttl send -b photo.jpg

Fərdi TTL

$ ttl send -t 5m temp-credentials.txt   # müddəti 5 dəqiqəyə bitir
$ ttl send -t 30m meeting-link.txt      # müddəti 30 dəqiqəyə bitir
$ ttl send -t 6h backup.tar.gz          # müddəti 6 saata bitir
$ ttl send -t 1d daily-report.pdf       # müddəti 1 günə bitir
$ ttl send -t 3d project-archive.zip    # müddəti 3 günə bitir
$ ttl send -t 5d design-assets.zip      # müddəti 5 günə bitir
$ ttl send report.xlsx                  # müddəti 7 günə bitir (standart)

Böyük fayllar

16 MiB və ya daha kiçik fayl bir sorğuda göndərilir; daha böyük fayl isə davam etdirilə bilən 16 MiB-lıq hissələrlə, eyni anda ikisi göndərilir. Hər sorğu SHA-256 heşi ilə yoxlanılır, yolda uğursuz olan sorğu yenidən göndərilir; artıq göndərilmiş hissələr qalır. Ctrl-C göndərməni təmiz şəkildə ləğv edir.

Faylların endirilməsi

İnteraktiv (terminal)

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

Parol terminalda göstərilmir. Orijinal fayl adı qorunur; həmin ad çıxış qovluğunda artıq varsa, fayl üzərinə yazılmaq əvəzinə name (1).ext kimi saxlanılır.

Yalnız token ilə

# tam URL əvəzinə yalnız 10 simvolluq tokendən istifadə edə bilərsiniz
$ ttl get aBcDeFgHiJ

Çıxış qovluğu

$ ttl get -o ~/Downloads aBcDeFgHiJ

Standart olaraq fayllar cari qovluqda saxlanılır. Başqa qovluq göstərmək üçün -o / --output parametrindən istifadə edin.

Parol parametri ilə

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

Yarımçıq qalan endirmələr

Kəsilən endirmə son alınan baytdan davam edir; hər 64 KiB-lıq blok ayrıca autentifikasiya olunur, buna görə nəticə fasiləsiz ötürmə ilə eynidir. Birdəfəlik (oxunduqdan sonra silinən) fayl tam endirildikdən sonra istifadə olunmuş sayılır: yarımçıq qalan endirmə dayandığı yerdən davam edir, fayl isə növbəti cəhd üçün qalır.

Brauzer

Faylları keçidə birbaşa daxil olmaqla brauzerinizdə də endirə və şifrəsini aça bilərsiniz. Veb interfeys eyni fayl formatından və alqoritmlərdən (Argon2id, XChaCha20-Poly1305) istifadə edir və parolunuzu soruşur. Heç bir proqram quraşdırmaq lazım deyil.

İdarəetmə açarı

Hər yükləmə ilə bir idarəetmə açarı gəlir; onu ttl send bir dəfə çap edir (manage_key sahəsi, --json rejimində). Server yalnız onun heşini saxlayır. İstənilən planda o, yükləməni izləməyə və ya vaxtından əvvəl sonlandırmağa imkan verir; açarı olan hər kəs yükləməni silə bilər, ona görə onu parol kimi qoruyun.

# öz yükləmənizin vəziyyəti, endirmələri və müddəti
$ 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)

# vaxtından əvvəl sil
$ ttl delete aBcDeFgHiJ -k k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz
Deleted: aBcDeFgHiJ

Vəziyyət bunlardan biridir: active, expired, burned və ya deleted.

Parolla işləmə

Parol şifrələmə açarının əsasıdır. O, cihazınızı heç vaxt tərk etmir və serverə heç vaxt göndərilmir. Onu vermək üçün altı yol var:

1. Avtomatik yaratma (yalnız göndərmədə)

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

[0-9A-Za-z] simvollarından kriptoqrafik təsadüfi 12 simvollu parol yaradır. Yalnız send zamanı mövcuddur (interaktiv şəkildə və ya --json rejimində avtomatik).

2. İnteraktiv sorğu

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

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

Parol ekranda göstərilmir. send zamanı avtomatik yaradılıb-yaradılmamasını özünüz seçirsiniz; öz parolunuzu yazırsınızsa, onu təsdiqləyirsiniz. get zamanı parol birbaşa soruşulur.

3. Parametr: -p / --password

$ ttl send -p mySecretPass file.zip
$ ttl get --password mySecretPass https://ttlspaceusercontent.com/aBcDeFgHiJ
-p / --password ps aux çıxışında görünür və shell tarixçəsində (~/.bash_history) saxlanıla bilər. Ortaq mühitlərdə və skriptlərdə istifadə etməyin. Əvəzinə --password-stdin və ya --password-file parametrindən istifadə edin.

4. Standart giriş (stdin): --password-stdin

# echo vasitəsilə ötürmə
$ echo "mySecretPass" | ttl send --password-stdin backup.tar.gz

# parol meneceri vasitəsilə ötürmə
$ pass show ttl/key | ttl send --password-stdin data.zip

# mühit dəyişəni vasitəsilə ötürmə
$ printenv MY_SECRET | ttl get --password-stdin https://ttlspaceusercontent.com/aBcDeFgHiJ

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

Stdin-dən ilk sətri oxuyur. Skriptlərdə, CI/CD proseslərində və avtomatlaşdırmada faydalıdır. Stdin terminal deyilsə və parol mənbəyi verilməyibsə, CLI xəta ilə çıxır (parolu avtomatik yaradan --json istifadə olunmursa).

5. Fayl: --password-file

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

Faylın ilk sətrini oxuyur (sondakı yeni sətir silinir). Docker secrets (/run/secrets/), Vault agent faylları və oxşar yanaşmalarla uyğundur.

6. Avtomatik tapılan fayl: ttl.password

Parol açıq şəkildə verilməyibsə, CLI icra faylının yanında ttl.password faylını, sonra isə ~/.ttl/password faylını axtarır. İlk sətir parol kimi istifadə olunur.

Eyni anda yalnız bir açıq şəkildə göstərilmiş parol mənbəyindən istifadə etmək olar. -p / --password, --password-stdin və --password-file parametrlərini birləşdirmək xətadır. Avtomatik tapılan ttl.password faylı yalnız bunların heç biri verilmədikdə yoxlanılır. Parolun minimum uzunluğu 8 simvoldur.

Parametrlər üzrə sənəd

Göndərmə parametrləri

ParametrTəsvirStandart
-p, --password PŞifrələmə paroluinteraktiv
--password-stdinParolu stdin-dən oxu
--password-file FParolu fayldan oxu
-t, --ttl DURYaşama müddəti7d
-b, --burnOxunduqdan sonra sil (tək endirmə)deaktiv
-u, --uploader-onlyYalnız sizin hesabınız endirə bilər: hesab səhifəniz və ya onun istənilən API açarı (Orbit; ləqəb: --private)deaktiv
--timeout DURÖtürmə üçün vaxt həddiyoxdur
--server URLServer URL-ihttps://ttl.space
-h3, --http3HTTP/3 (QUIC) sına, alınmasa TCP-yə keçdeaktiv
--jsonJSON-u stdout-a çıxar (skriptlər və süni intellekt agentləri üçün)deaktiv

Endirmə parametrləri

ParametrTəsvirStandart
-p, --password PŞifrəni açma paroluinteraktiv
--password-stdinParolu stdin-dən oxu
--password-file FParolu fayldan oxu
-o, --output DIRÇıxış qovluğucari qovluq
--timeout DURÖtürmə üçün vaxt həddiyoxdur
--server URLYalnız token verildikdə serverhttps://ttl.space
-h3, --http3HTTP/3 (QUIC) sına, alınmasa TCP-yə keçdeaktiv
--jsonJSON-u stdout-a çıxar (skriptlər və süni intellekt agentləri üçün)deaktiv

TTL dəyərləri

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

Orbit əlavə edir: 14d 15d 28d 30d permanent

Vaxt həddi

Standart: yoxdur. İlişib qalan ötürmə öz-özünə davam edir, davam edə bilmirsə, dayanır. Limiti --timeout 30m və ya --timeout 2h ilə təyin edin.

Nümunələr

Skript: ehtiyat nüsxə və yükləmə

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

Keçidi mübadilə buferinə ötür (macOS)

$ ttl send -p mypass123 file.pdf | pbcopy

Keçidi mübadilə buferinə ötür (Linux)

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

Burn: birdəfəlik sirr

$ echo "$DB_PASSWORD" | ttl send --password-stdin -b -t 5m credentials.env
# keçid dəqiq bir dəfə işləyir, müddəti 5 dəqiqəyə bitir

JSON rejimi (skriptlər & süni intellekt agentləri)

# göndər: JSON rejimində parol avtomatik yaradılır
$ 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"}

# endir
$ ttl --json get -p aB3kL9mXq7Rt xK9mQ2vLpA
{"ok":true,"token":"xK9mQ2vLpA","filename":"report.pdf","size":2097152,"saved_to":"/home/user/report.pdf"}

# idarəetmə açarı ilə status
$ 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}}

# xətalar ok:false qaytarır
{"ok":false,"error":"Link not found. The file may have expired, been downloaded already (burn after reading), or be private (uploader-only)"}

--json rejimində bütün çıxış stdout-da strukturlaşdırılmış JSON-dur. Göndərmə zamanı parol verilməyibsə, o avtomatik yaradılır və cavaba daxil edilir. Çıxış kodu uğurlu olduqda 0, xəta olduqda 1-dir.

Orbit Plan

Orbit daha böyük faylları (50 GB), daha uzun saxlamanı (30 gün və ya abunəlikdə daimi), hesabınıza bağlı faylları (onları yalnız sizin hesabınız endirə bilər) və fayl idarəetməsini (siyahı & silmə) açır. Tam müqayisə: Xüsusiyyətlər.

API açarı TTL_API_KEY mühit dəyişənindən, icra faylının yanındakı ttl.key faylından və ya ~/.ttl/key yolundan avtomatik tapılır. Açarı saxlamaq üçün ttl activate əmrindən istifadə edin və ya onu bu yerlərdən birinə əl ilə yazın.

# açarınızı aktivləşdirin: ekranda göstərilmədən soruşulur, buna görə shell tarixçəsinə düşmür
$ ttl activate
Enter Orbit API key: ********
Orbit plan activated. Key saved to /usr/local/bin/ttl.key
# interaktiv olmayan: ttl activate --key-stdin  |  ttl activate --key-file F

# plan və istifadəni yoxla
$ 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

# uzadılmış TTL ilə göndər
$ ttl send -t 30d large-backup.tar.gz
# daimi fayl (yalnız Orbit): müddəti yoxdur, siz silənədək və ya abunəliyiniz bitənədək saxlanılır
$ ttl send -t permanent archive.tar.gz
# şəxsi fayl göndər: onu yalnız sizin hesabınız endirə bilər (yalnız Orbit)
$ ttl send -u payroll.xlsx

# son yükləmələrin siyahısı
$ 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

# faylı vaxtından əvvəl sil (ttl list bütün səhifələri gəzir; -n 5 beş fayldan sonra dayanır)
$ ttl delete xK9mQ2vLpA
Deleted: xK9mQ2vLpA
# və ya yükləmənin idarəetmə açarı ilə, istənilən planda: ttl delete xK9mQ2vLpA -k KEY

# saxlanılmış açarı sil
$ ttl deactivate
Key file removed: /usr/local/bin/ttl.key

HTTP API

Yükləmə və endirmə CLI-nin şifrələmə konveyerini (Argon2id + XChaCha20-Poly1305 + hissələrə bölünmüş AEAD) tələb edir. Skriptlər üçün ttl send / ttl get və ya --json rejimindən istifadə edin. Aşağıdakı endpoint-lər Orbit fayl idarəetməsi üçündür.

Faylların siyahısı (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övbəti səhifə: yalnız has_more true olduqda; əvvəlki cavabdakı next_cursor dəyərini ötürün
$ curl "https://ttl.space/v1/files?cursor=1711800600123456" -H "X-API-Key: ttl_orbit_..."

Bu açarla yüklənmiş faylları qaytarır, ən yenisi birinci, hər səhifədə 20. has_more true olduqda cavab next_cursor sahəsini də ehtiva edir; növbəti səhifəni almaq üçün onu ?cursor= kimi ötürün. Orbit Plan tələb olunur.

Faylın silinməsi (Orbit)

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

Uğurlu olduqda 204 No Content qaytarır. Orbit Plan tələb olunur. Fayl verilmiş açara aid olmalıdır.

Xəta cavabları

StatusMənası
401API açarı yanlışdır və ya müddəti bitib
403Bu funksiya Orbit Plan tələb edir
404Fayl tapılmadı və ya bu açara aid deyil
429Sorğu limiti aşıldı
500Daxili server xətası, sonra yenidən cəhd edin
502Yaddaş müvəqqəti əlçatan deyil, sonra yenidən cəhd edin

Limitlər

MəhdudiyyətPulsuzOrbit
Maks. fayl ölçüsü6 GB50 GB
Maks. TTL7 gün30 gün və ya daimi
Gündəlik yükləmə sayı4Limitsiz
Gündəlik yükləmə həcmi (IP başına)6 GBLimitsiz
Eyni vaxtda yükləmələrIP başına 2API açarı başına 4
Yaddaş kvotası✗1 TB
Fayl siyahısı✗✓
Vaxtından əvvəl silmə✓✓
Yalnız yükləyən üçün fayllar✗✓
Parolun min. uzunluğu8 simvol
IP başına sorğu10 saniyədə 300
IP başına bağlantıeyni vaxtda 100

Şifrələmə

Fayllar yükləmədən əvvəl cihazınızda şifrələnir. Server yalnız şifrəli mətni saxlayır və fayllarınızın şifrəsini aça bilmir.

KomponentAlqoritm / Dəyər
Açarın əldə edilməsiArgon2id (time=3, memory=64 MiB, parallelism=1)
Şifrələmə alqoritmiXChaCha20-Poly1305 AEAD

Şifrəli mətnə edilən hər hansı dəyişiklik şifrənin açılmasının uğursuz olmasına səbəb olur. Server şifrəli mətni verməzdən əvvəl, şifrələmə açarından əldə edilən birtərəfli tokendən istifadə edərək, endirən şəxsin düzgün parolu bildiyini yoxlayır.