Foydalanish qoʻllanmasi
Oʻzbekcha
Tez boshlash
# fayl yuborish: parol avtomatik yaratiladi, havola va parol ekranga chiqariladi $ 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 # yuklab olish: parol interaktiv soʻraladi $ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ Enter password: ******** Password verified ◉★✧· Phew, secret.pdf landed safe and sound (1.2 MB)
CLI shifrlash, yuklash, yuklab olish va shifrni ochishni bajaradi. Server parolingizni ham, shifrlanmagan maʼlumotlaringizni ham hech qachon koʻrmaydi.
Oʻrnatish
Homebrew (macOS)
$ brew install tweenietomatoes/ttl/ttl
Scoop (Windows)
$ scoop bucket add ttl https://github.com/tweenietomatoes/scoop-ttl $ scoop install ttl
Tayyor bajariladigan fayl
# platformangiz uchun releases sahifasidan yuklab oling $ 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 orqali oʻrnatish
$ go install github.com/tweenietomatoes/ttl/cmd/ttl@latest
Manba kodidan
$ git clone https://github.com/tweenietomatoes/ttl $ cd ttl && go build -o ttl ./cmd/ttl/ $ sudo mv ttl /usr/local/bin/
Tekshirish
$ ttl version ttl 1.6.2
Fayllarni yuborish
Oddiy yuborish
# parol avtomatik yaratiladi, standart TTL 7d $ ttl send report.xlsx
Terminalda parol berilmasa, CLI soʻraydi:
No password provided. Generate one? [Y/n]:
Avtomatik yaratish uchun Enter tugmasini bosing yoki y kiriting.
Oʻzingizning parolingiz
$ ttl send -p mySecretPass -t 1h document.pdf
Oʻqilgach oʻchirish
# yuklab olingach oʻchiriladi; uzilib qolgan yuklab olish davom ettirilishi mumkin va uni ishlatib yubormaydi $ ttl send -b photo.jpg
Maxsus TTL
$ ttl send -t 5m temp-credentials.txt # 5 daqiqadan keyin tugaydi $ ttl send -t 30m meeting-link.txt # 30 daqiqadan keyin tugaydi $ ttl send -t 6h backup.tar.gz # 6 soatdan keyin tugaydi $ ttl send -t 1d daily-report.pdf # 1 kundan keyin tugaydi $ ttl send -t 3d project-archive.zip # 3 kundan keyin tugaydi $ ttl send -t 5d design-assets.zip # 5 kundan keyin tugaydi $ ttl send report.xlsx # 7 kundan keyin tugaydi (standart)
Katta fayllar
16 MiB gacha boʻlgan fayl bitta soʻrovda yuboriladi; kattaroq fayl davom ettiriladigan 16 MiB boʻlaklarda, bir vaqtda ikkitadan yuboriladi. Har bir soʻrov SHA-256 xeshi bilan tekshiriladi, yoʻlda muvaffaqiyatsiz boʻlgani qayta yuboriladi; allaqachon yuborilgan boʻlaklar saqlanib qoladi. Ctrl-C jarayonni xavfsiz bekor qiladi.
Fayllarni yuklab olish
Interaktiv (terminal)
$ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ Enter password: ******** Password verified ◉★✧· Phew, document.pdf landed safe and sound (4.2 MB)
Parol terminalda koʻrsatilmaydi. Asl fayl nomi saqlanadi; agar bunday nom chiqish jildida allaqachon mavjud boʻlsa, fayl ustiga yozilmasdan name (1).ext nomi bilan saqlanadi.
Faqat token bilan
# toʻliq URL oʻrniga faqat 10 belgili tokendan foydalanishingiz mumkin $ ttl get aBcDeFgHiJ
Chiqish jildi
$ ttl get -o ~/Downloads aBcDeFgHiJ
Odatda fayllar joriy jildga saqlanadi. Boshqa jildni koʻrsatish uchun -o / --outputdan foydalaning.
Parol flagi bilan
$ ttl get -p mySecretPass https://ttlspaceusercontent.com/aBcDeFgHiJ
Uzilib qolgan yuklab olishlar
Uzilib qolgan yuklab olish oxirgi qabul qilingan baytdan davom etadi; har bir 64 KiB boʻlak alohida autentifikatsiya qilinadi, shuning uchun natija uzilishsiz uzatishniki bilan bir xil boʻladi. Bir martalik (oʻqilgach oʻchiriladigan) fayl yuklab olish uni toʻliq olgandagina ishlatilgan hisoblanadi: uzilgani toʻxtagan joyidan davom etadi va fayl yana bir urinish uchun qoladi.
Brauzer
Fayllarni havolaning oʻziga kirib, brauzerda ham yuklab olish va shifrini ochish mumkin. Veb-interfeys xuddi shu fayl formati va algoritmlardan (Argon2id, XChaCha20-Poly1305) foydalanadi va parolingizni soʻraydi. Dastur oʻrnatish shart emas.
Boshqaruv kaliti
Har bir yuklamaga boshqaruv kaliti beriladi, uni ttl send bir marta ekranga chiqaradi (manage_key maydoni, --json rejimida). Server faqat uning xeshini saqlaydi. Har qanday tarifda u yuklamani kuzatish yoki erta tugatish imkonini beradi; kalitga ega har kim yuklamani oʻchira oladi, shuning uchun uni parol kabi saqlang.
# oʻzingiz yuklagan faylning holati, yuklab olishlari va muddati $ 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) # erta oʻchirish $ ttl delete aBcDeFgHiJ -k k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz Deleted: aBcDeFgHiJ
Holat quyidagilardan biri: active, expired, burned yoki deleted.
Parol bilan ishlash
Parol shifrlash kalitining asosidir. U qurilmangizdan hech qachon chiqmaydi va serverga yuborilmaydi. Uni berishning olti usuli bor:
1. Avtomatik yaratish (faqat yuborishda)
$ ttl send notes.txt No password provided. Generate one? [Y/n]: y Generated password: aB3kL9mXq7Rt
[0-9A-Za-z] belgilaridan kriptografik tasodifiy 12 belgili parol yaratadi. Faqat send paytida mavjud (interaktiv yoki --json rejimida avtomatik).
2. Interaktiv soʻrov
$ 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 koʻrsatilmaydi. send paytida avtomatik yaratishni yoki yaratmaslikni tanlaysiz; oʻzingiznikini kiritsangiz, uni tasdiqlaysiz. get paytida parol toʻgʻridan-toʻgʻri soʻraladi.
3. Flag: -p / --password
$ ttl send -p mySecretPass file.zip $ ttl get --password mySecretPass https://ttlspaceusercontent.com/aBcDeFgHiJ
-p / --password ps aux natijasida koʻrinadi va shell tarixida (~/.bash_history) saqlanishi mumkin. Umumiy muhitlarda va skriptlarda undan qoching. Buning oʻrniga --password-stdin yoki --password-filedan foydalaning.4. Stdin: --password-stdin
# echo buyrugʻidan uzatish $ echo "mySecretPass" | ttl send --password-stdin backup.tar.gz # parol menejeridan uzatish $ pass show ttl/key | ttl send --password-stdin data.zip # muhit oʻzgaruvchisidan uzatish $ printenv MY_SECRET | ttl get --password-stdin https://ttlspaceusercontent.com/aBcDeFgHiJ # here-string $ ttl send --password-stdin report.pdf <<<"mySecretPass"
stdindan birinchi qatorni oʻqiydi. Skriptlar, CI/CD jarayonlari va avtomatlashtirishda foydali. stdin terminal boʻlmasa va parol manbai berilmagan boʻlsa, CLI xato bilan chiqadi (--json ishlatilmasa; u parolni avtomatik yaratadi).
5. Fayl: --password-file
$ ttl send --password-file /run/secrets/key report.xlsx $ ttl get --password-file ~/.ttl-key https://ttlspaceusercontent.com/aBcDeFgHiJ
Fayldan birinchi qatorni oʻqiydi (oxiridagi yangi qator olib tashlanadi). Docker secrets (/run/secrets/), Vault agent fayllari va shunga oʻxshash usullar bilan mos.
6. Avtomatik aniqlanadigan fayl: ttl.password
Aniq parol berilmasa, CLI bajariladigan fayl yonidagi ttl.password faylini, soʻng ~/.ttl/passwordni qidiradi. Birinchi qator parol sifatida ishlatiladi.
-p / --password, --password-stdin va --password-fileni birga ishlatish xato hisoblanadi. Avtomatik aniqlanadigan ttl.password fayli faqat bularning hech biri berilmaganda tekshiriladi. Parolning minimal uzunligi 8 ta belgi.Parametrlar maʼlumotnomasi
send flaglari
| Flag | Tavsif | Standart |
|---|---|---|
-p, --password P | Shifrlash paroli | interaktiv |
--password-stdin | Parolni stdindan oʻqish | |
--password-file F | Parolni fayldan oʻqish | |
-t, --ttl DUR | Yashash vaqti | 7d |
-b, --burn | Oʻqilgach oʻchirish (bir marta yuklab olish) | oʻchiq |
-u, --uploader-only | Faqat sizning hisobingiz yuklab ola oladi: hisob sahifangizdan yoki uning istalgan API kaliti bilan (Orbit; sinonim: --private) | oʻchiq |
--timeout DUR | Uzatish vaqt chegarasi | yoʻq |
--server URL | Server URL manzili | https://ttl.space |
-h3, --http3 | HTTP/3 (QUIC)ni sinab koʻrish, boʻlmasa TCPga qaytish | oʻchiq |
--json | JSONni stdoutga chiqarish (skriptlar va AI agentlar uchun) | oʻchiq |
get flaglari
| Flag | Tavsif | Standart |
|---|---|---|
-p, --password P | Shifrni ochish paroli | interaktiv |
--password-stdin | Parolni stdindan oʻqish | |
--password-file F | Parolni fayldan oʻqish | |
-o, --output DIR | Chiqish jildi | joriy jild |
--timeout DUR | Uzatish vaqt chegarasi | yoʻq |
--server URL | Faqat token berilganda ishlatiladigan server | https://ttl.space |
-h3, --http3 | HTTP/3 (QUIC)ni sinab koʻrish, boʻlmasa TCPga qaytish | oʻchiq |
--json | JSONni stdoutga chiqarish (skriptlar va AI agentlar uchun) | oʻchiq |
TTL qiymatlari
Bepul: 5m 10m 15m 30m 1h 2h 3h 6h 12h 24h 1d 2d 3d 4d 5d 6d 7d
Orbit qoʻshadi: 14d 15d 28d 30d permanent
Vaqt chegarasi
Standart: yoʻq. Toʻxtab qolgan uzatish oʻzi davom etadi va davom eta olmasa, toʻxtaydi. Chegarani --timeout 30m yoki --timeout 2h bilan belgilang.
Misollar
Skript: zaxira nusxa va yuklash
#!/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
Havolani almashish buferiga nusxalash (macOS)
$ ttl send -p mypass123 file.pdf | pbcopy
Havolani almashish buferiga nusxalash (Linux)
$ ttl send -p mypass123 file.pdf | xclip -sel clip
Oʻqilgach oʻchirish: bir martalik sir
$ echo "$DB_PASSWORD" | ttl send --password-stdin -b -t 5m credentials.env # havola aynan bir marta ishlaydi, 5 daqiqadan keyin tugaydi
JSON rejimi (skriptlar va AI agentlar)
# yuborish: JSON rejimida parol avtomatik yaratiladi $ 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"} # yuklab olish (get) $ ttl --json get -p aB3kL9mXq7Rt xK9mQ2vLpA {"ok":true,"token":"xK9mQ2vLpA","filename":"report.pdf","size":2097152,"saved_to":"/home/user/report.pdf"} # boshqaruv kaliti bilan holat $ 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}} # xatolar ok:false qaytaradi {"ok":false,"error":"Link not found. The file may have expired, been downloaded already (burn after reading), or be private (uploader-only)"}
--json rejimida barcha chiqish stdoutdagi tuzilmali JSON boʻladi. Yuborish paytida parol berilmasa, u avtomatik yaratiladi va javobga kiritiladi. Chiqish kodi muvaffaqiyatda 0, xatoda 1.
Orbit tarifi
Orbit kattaroq fayllar (50 GB), uzoqroq saqlash (30 kun yoki obunada doimiy), hisobingizga bogʻlangan shaxsiy fayllar (ularni faqat sizning hisobingiz yuklab ola oladi) va fayllarni boshqarish (roʻyxat & oʻchirish) imkonini beradi. Toʻliq taqqoslash: Imkoniyatlar.
API kaliti TTL_API_KEY muhit oʻzgaruvchisidan, bajariladigan fayl yonidagi ttl.keydan yoki ~/.ttl/keydan avtomatik aniqlanadi. Kalitni saqlash uchun ttl activatedan foydalaning yoki uni shu joylarning birortasiga qoʻlda yozing.
# kalitni faollashtirish: ekranda koʻrsatilmasdan soʻraladi, shuning uchun shell tarixiga tushmaydi $ ttl activate Enter Orbit API key: ******** Orbit plan activated. Key saved to /usr/local/bin/ttl.key # interaktiv boʻlmagan usul: ttl activate --key-stdin | ttl activate --key-file F # tarif va foydalanishni tekshirish $ 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 # uzaytirilgan TTL bilan yuborish $ ttl send -t 30d large-backup.tar.gz # doimiy fayl (faqat Orbit): muddatsiz, oʻzingiz oʻchirguningizcha yoki obuna tugaguncha saqlanadi $ ttl send -t permanent archive.tar.gz # shaxsiy fayl yuborish: uni faqat sizning hisobingiz yuklab ola oladi (faqat Orbit) $ ttl send -u payroll.xlsx # soʻnggi yuklamalar roʻyxati $ 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 # faylni erta oʻchirish (ttl list har bir sahifani aylanib chiqadi; -n 5 beshta fayldan keyin toʻxtaydi) $ ttl delete xK9mQ2vLpA Deleted: xK9mQ2vLpA # yoki yuklamaning boshqaruv kaliti bilan, istalgan tarifda: ttl delete xK9mQ2vLpA -k KEY # saqlangan kalitni olib tashlash $ ttl deactivate Key file removed: /usr/local/bin/ttl.key
HTTP API
ttl send / ttl get yoki --json rejimidan foydalaning. Quyidagi endpointlar Orbit fayllarini boshqarish uchun.Fayllar roʻyxati (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} # keyingi sahifa: faqat has_more true boʻlganda; oldingi javobdagi next_cursor qiymatini bering $ curl "https://ttl.space/v1/files?cursor=1711800600123456" -H "X-API-Key: ttl_orbit_..."
Shu kalit bilan yuklangan fayllarni, yangilari birinchi, har sahifada 20 tadan qaytaradi. has_more true boʻlsa, javobda next_cursor ham boʻladi; keyingi sahifani olish uchun uni ?cursor= sifatida bering. Orbit tarifi talab qilinadi.
Faylni oʻchirish (Orbit)
$ curl -X DELETE https://ttl.space/v1/files/xK9mQ2vLpA -H "X-API-Key: ttl_orbit_..."
Muvaffaqiyatda 204 No Content qaytaradi. Orbit tarifi talab qilinadi. Fayl berilgan kalitga tegishli boʻlishi kerak.
Xato javoblari
| Holat | Maʼnosi |
|---|---|
401 | API kaliti notoʻgʻri yoki muddati tugagan |
403 | Bu imkoniyat Orbit tarifini talab qiladi |
404 | Fayl topilmadi yoki bu kalitga tegishli emas |
429 | Soʻrovlar chegarasidan oshib ketdi |
500 | Serverning ichki xatosi, keyinroq qayta urinib koʻring |
502 | Xotira vaqtincha mavjud emas, keyinroq qayta urinib koʻring |
Cheklovlar
| Cheklov | Bepul | Orbit |
|---|---|---|
| Maks. fayl hajmi | 6 GB | 50 GB |
| Maks. TTL | 7 kun | 30 kun yoki doimiy |
| Kuniga yuklashlar | 4 | Cheksiz |
| Kunlik yuklash hajmi (har bir IP uchun) | 6 GB | Cheksiz |
| Bir vaqtdagi yuklashlar | har bir IP uchun 2 ta | har bir API kaliti uchun 4 ta |
| Xotira kvotasi | ✗ | 1 TB |
| Fayllar roʻyxati | ✗ | ✓ |
| Erta oʻchirish | ✓ | ✓ |
| Shaxsiy fayllar | ✗ | ✓ |
| Parolning minimal uzunligi | 8 ta belgi | |
| Har bir IP uchun soʻrovlar | 10 soniyada 300 ta | |
| Har bir IP uchun ulanishlar | bir vaqtda 100 ta | |
Shifrlash
Fayllar yuklashdan oldin qurilmangizda shifrlanadi. Server faqat shifrlangan matnni saqlaydi va fayllaringizning shifrini ocha olmaydi.
| Komponent | Algoritm / Qiymat |
|---|---|
| Kalit hosil qilish | Argon2id (time=3, memory=64 MiB, parallelism=1) |
| Shifr | XChaCha20-Poly1305 AEAD |
Shifrlangan matnga kiritilgan har qanday oʻzgartirish shifrni ochib boʻlmasligiga olib keladi. Server shifrlangan matnni berishdan oldin, shifrlash kalitidan hosil qilingan bir tomonlama token yordamida yuklab oluvchi toʻgʻri parolni bilishini tekshiradi.