Пайдалану нұсқаулығы
Қазақ тілі
Жылдам бастау
# файл жіберу: құпия сөз автоматты түрде жасалады, сілтеме мен құпия сөз шығарылады $ 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 # жүктеп алу: құпия сөз интерактивті түрде сұралады $ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ Enter password: ******** Password verified ◉★✧· Phew, secret.pdf landed safe and sound (1.2 MB)
CLI шифрлауды, жүктеп салуды, жүктеп алуды және шифрды ашуды өзі орындайды. Сервер құпия сөзіңізді де, шифрланбаған деректеріңізді де ешқашан көрмейді.
Орнату
Homebrew (macOS)
$ brew install tweenietomatoes/ttl/ttl
Scoop (Windows)
$ scoop bucket add ttl https://github.com/tweenietomatoes/scoop-ttl $ scoop install ttl
Дайын орындалатын файл
# платформаңызға арналған файлды релиздерден жүктеп алыңыз $ 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
Бастапқы кодтан құрастыру
$ git clone https://github.com/tweenietomatoes/ttl $ cd ttl && go build -o ttl ./cmd/ttl/ $ sudo mv ttl /usr/local/bin/
Тексеру
$ ttl version ttl 1.6.2
Файл жіберу
Қарапайым жіберу
# құпия сөз автоматты түрде жасалады, әдепкі TTL 7 күн $ ttl send report.xlsx
Терминалда құпия сөз берілмесе, CLI сұрайды:
No password provided. Generate one? [Y/n]:
Автоматты түрде жасау үшін Enter пернесін басыңыз немесе y теріңіз.
Өз құпия сөзіңіз
$ ttl send -p mySecretPass -t 1h document.pdf
Оқығаннан кейін жою
# жүктеп алынғаннан кейін жойылады; үзілген жүктеп алу жалғаса алады және файл пайдаланылған болып саналмайды $ ttl send -b photo.jpg
Өз TTL мәніңіз
$ ttl send -t 5m temp-credentials.txt # 5 минуттан кейін мерзімі аяқталады $ ttl send -t 30m meeting-link.txt # 30 минуттан кейін мерзімі аяқталады $ ttl send -t 6h backup.tar.gz # 6 сағаттан кейін мерзімі аяқталады $ ttl send -t 1d daily-report.pdf # 1 күннен кейін мерзімі аяқталады $ ttl send -t 3d project-archive.zip # 3 күннен кейін мерзімі аяқталады $ ttl send -t 5d design-assets.zip # 5 күннен кейін мерзімі аяқталады $ ttl send report.xlsx # 7 күннен кейін мерзімі аяқталады (әдепкі)
Үлкен файлдар
16 MiB немесе одан кіші файл бір сұраумен жіберіледі; үлкенірек файл жалғастыруға болатын 16 MiB бөліктермен, бір уақытта екеуден жіберіледі. Әр сұрау SHA-256 хэшімен тексеріледі, жолда сәтсіз аяқталған сұрау қайта жіберіледі; жіберіліп қойған бөліктер сақталады. Ctrl-C жіберуді таза тоқтатады.
Файл жүктеп алу
Интерактивті (терминал)
$ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ Enter password: ******** Password verified ◉★✧· Phew, document.pdf landed safe and sound (4.2 MB)
Құпия сөз терминалда көрсетілмейді. Файлдың бастапқы атауы сақталады; егер бұл атау шығыс қалтасында бұрыннан бар болса, файл үстінен жазылмай, name (1).ext ретінде сақталады.
Тек токенмен
# толық URL орнына тек 10 таңбалы токенді пайдалануға болады $ ttl get aBcDeFgHiJ
Шығыс қалтасы
$ ttl get -o ~/Downloads aBcDeFgHiJ
Әдепкі бойынша файлдар ағымдағы қалтаға сақталады. Басқа қалтаны көрсету үшін -o / --output пайдаланыңыз.
Құпия сөз параметрімен
$ ttl get -p mySecretPass https://ttlspaceusercontent.com/aBcDeFgHiJ
Үзілген жүктеп алулар
Үзілген жүктеп алу соңғы алынған байттан жалғасады; әр 64 KiB блок жеке аутентификацияланады, сондықтан нәтиже үзіліссіз жіберумен бірдей болады. Бір реттік (оқығаннан кейін жойылатын) файл толық жүктеп алынғаннан кейін пайдаланылған болып саналады: үзілген жүктеп алу тоқтаған жерінен жалғасады, ал файл келесі әрекет үшін қалады.
Браузер
Файлдарды сілтемеге тікелей өту арқылы браузерде де жүктеп алып, шифрын аша аласыз. Веб-интерфейс сол файл пішімі мен алгоритмдерді (Argon2id, XChaCha20-Poly1305) пайдаланады және құпия сөзіңізді сұрайды. Ешқандай бағдарлама орнатудың қажеті жоқ.
Басқару кілті
Әр жүктеп салумен бірге басқару кілті беріледі; оны ttl send бір рет шығарады (manage_key өрісі, --json режимінде). Сервер оның тек хэшін сақтайды. Кез келген жоспарда ол жүктеп салуды қадағалауға немесе мерзімінен бұрын аяқтауға мүмкіндік береді; кілті бар кез келген адам жүктеп салуды жоя алады, сондықтан оны құпия сөз сияқты сақтаңыз.
# өз жүктеп салуыңыздың күйі, жүктеп алулары және мерзімі $ 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) # мерзімінен бұрын жою $ ttl delete aBcDeFgHiJ -k k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz Deleted: aBcDeFgHiJ
Күй мыналардың бірі болады: active, expired, burned немесе deleted.
Құпия сөзбен жұмыс
Құпия сөз шифрлау кілтінің негізі болып табылады. Ол құрылғыңыздан ешқашан шықпайды және серверге ешқашан жіберілмейді. Оны беру үшін алты жол бар:
1. Автоматты түрде жасау (тек жіберу кезінде)
$ ttl send notes.txt No password provided. Generate one? [Y/n]: y Generated password: aB3kL9mXq7Rt
[0-9A-Za-z] таңбаларынан криптографиялық кездейсоқ 12 таңбалы құпия сөз жасайды. Тек send кезінде қолжетімді (интерактивті түрде немесе --json режимінде автоматты түрде).
2. Интерактивті сұрау
$ ttl send notes.txt No password provided. Generate one? [Y/n]: n Enter password: ******** Confirm password: ******** $ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ Enter password: ********
Құпия сөз экранда көрсетілмейді. send кезінде автоматты түрде жасау-жасамауды өзіңіз таңдайсыз; өз құпия сөзіңізді теріп жатсаңыз, оны растайсыз. get кезінде құпия сөз тікелей сұралады.
3. Параметр: -p / --password
$ ttl send -p mySecretPass file.zip $ ttl get --password mySecretPass https://ttlspaceusercontent.com/aBcDeFgHiJ
-p / --password ps aux шығысында көрінеді және shell тарихында (~/.bash_history) сақталуы мүмкін. Ортақ орталар мен скрипттерде пайдаланбаңыз. Оның орнына --password-stdin немесе --password-file пайдаланыңыз.4. Стандартты енгізу (stdin): --password-stdin
# echo арқылы беру $ echo "mySecretPass" | ttl send --password-stdin backup.tar.gz # құпия сөз менеджері арқылы беру $ pass show ttl/key | ttl send --password-stdin data.zip # орта айнымалысы арқылы беру $ printenv MY_SECRET | ttl get --password-stdin https://ttlspaceusercontent.com/aBcDeFgHiJ # here-string $ ttl send --password-stdin report.pdf <<<"mySecretPass"
Stdin-нен бірінші жолды оқиды. Скрипттерде, CI/CD процестерінде және автоматтандыруда пайдалы. Stdin терминал болмаса және құпия сөз көзі берілмесе, CLI қатемен аяқталады (құпия сөзді автоматты түрде жасайтын --json пайдаланылмаса).
5. Файл: --password-file
$ ttl send --password-file /run/secrets/key report.xlsx $ ttl get --password-file ~/.ttl-key https://ttlspaceusercontent.com/aBcDeFgHiJ
Файлдың бірінші жолын оқиды (соңындағы жаңа жол алынып тасталады). Docker secrets (/run/secrets/), Vault agent файлдарымен және осыған ұқсас шешімдермен үйлесімді.
6. Автоматты табылатын файл: ttl.password
Құпия сөз тікелей берілмесе, CLI орындалатын файлдың жанынан ttl.password файлын, содан кейін ~/.ttl/password жолын іздейді. Бірінші жол құпия сөз ретінде пайдаланылады.
-p / --password, --password-stdin және --password-file параметрлерін біріктіру қате болып табылады. Автоматты табылатын ttl.password файлы тек осылардың ешқайсысы берілмегенде тексеріледі. Құпия сөздің ең аз ұзындығы 8 таңба.Параметрлер анықтамасы
Жіберу параметрлері
| Параметр | Сипаттама | Әдепкі |
|---|---|---|
-p, --password P | Шифрлау құпия сөзі | интерактивті |
--password-stdin | Құпия сөзді stdin-нен оқу | |
--password-file F | Құпия сөзді файлдан оқу | |
-t, --ttl DUR | Өмір сүру уақыты | 7d |
-b, --burn | Оқығаннан кейін жою (бір рет жүктеп алу) | өшірулі |
-u, --uploader-only | Тек сіздің тіркелгіңіз жүктеп ала алады: тіркелгі бетіңізден немесе оның кез келген API кілтімен (Orbit; баламасы --private) | өшірулі |
--timeout DUR | Тасымалдаудың күту уақыты | жоқ |
--server URL | Сервер URL-ы | https://ttl.space |
-h3, --http3 | HTTP/3 (QUIC) қолданып көру, болмаса TCP-ге өту | өшірулі |
--json | JSON-ды stdout-қа шығару (скрипттер мен жасанды интеллект агенттері үшін) | өшірулі |
Жүктеп алу параметрлері
| Параметр | Сипаттама | Әдепкі |
|---|---|---|
-p, --password P | Шифрды ашу құпия сөзі | интерактивті |
--password-stdin | Құпия сөзді stdin-нен оқу | |
--password-file F | Құпия сөзді файлдан оқу | |
-o, --output DIR | Шығыс қалтасы | ағымдағы қалта |
--timeout DUR | Тасымалдаудың күту уақыты | жоқ |
--server URL | Тек токен берілгендегі сервер | https://ttl.space |
-h3, --http3 | HTTP/3 (QUIC) қолданып көру, болмаса TCP-ге өту | өшірулі |
--json | JSON-ды stdout-қа шығару (скрипттер мен жасанды интеллект агенттері үшін) | өшірулі |
TTL мәндері
Тегін: 5m 10m 15m 30m 1h 2h 3h 6h 12h 24h 1d 2d 3d 4d 5d 6d 7d
Orbit қосады: 14d 15d 28d 30d permanent
Күту уақыты
Әдепкі: жоқ. Тоқтап қалған тасымалдау өздігінен жалғасады, ал жалғаса алмаса, бас тартады. Шекті --timeout 30m немесе --timeout 2h арқылы орнатыңыз.
Мысалдар
Скрипт: сақтық көшірме және жүктеп салу
#!/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
Сілтемені буферге көшіру (macOS)
$ ttl send -p mypass123 file.pdf | pbcopy
Сілтемені буферге көшіру (Linux)
$ ttl send -p mypass123 file.pdf | xclip -sel clip
Burn: бір реттік құпия
$ echo "$DB_PASSWORD" | ttl send --password-stdin -b -t 5m credentials.env # сілтеме дәл бір рет жұмыс істейді, 5 минуттан кейін мерзімі аяқталады
JSON режимі (скрипттер & жасанды интеллект агенттері)
# жіберу: JSON режимінде құпия сөз автоматты түрде жасалады $ 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"} # жүктеп алу $ ttl --json get -p aB3kL9mXq7Rt xK9mQ2vLpA {"ok":true,"token":"xK9mQ2vLpA","filename":"report.pdf","size":2097152,"saved_to":"/home/user/report.pdf"} # басқару кілтімен күй $ 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}} # қателер 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 режимінде барлық шығыс stdout-та құрылымдалған JSON болады. Жіберу кезінде құпия сөз берілмесе, ол автоматты түрде жасалып, жауапқа қосылады. Шығу коды сәтті болғанда 0, қате болғанда 1.
Orbit жоспары
Orbit үлкенірек файлдарды (50 GB), ұзағырақ сақтауды (30 күн немесе жазылыммен тұрақты), тіркелгіңізге бекітілген файлдарды (оларды тек сіздің тіркелгіңіз жүктеп ала алады) және файлдарды басқаруды (тізім & жою) ашады. Толық салыстыру: Мүмкіндіктер.
API кілті TTL_API_KEY орта айнымалысынан, орындалатын файлдың жанындағы ttl.key файлынан немесе ~/.ttl/key жолынан автоматты түрде табылады. Кілтті сақтау үшін ttl activate пайдаланыңыз немесе оны осы орындардың біріне қолмен жазыңыз.
# кілтіңізді белсендіру: экранда көрсетілмей сұралады, сондықтан shell тарихына түспейді $ ttl activate Enter Orbit API key: ******** Orbit plan activated. Key saved to /usr/local/bin/ttl.key # интерактивсіз: ttl activate --key-stdin | ttl activate --key-file F # жоспар мен пайдалануды тексеру $ 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 # ұзартылған TTL-мен жіберу $ ttl send -t 30d large-backup.tar.gz # тұрақты файл (тек Orbit): мерзімі жоқ, сіз жойғанша немесе жазылымыңыз аяқталғанша сақталады $ ttl send -t permanent archive.tar.gz # жеке файл жіберу: оны тек сіздің тіркелгіңіз жүктеп ала алады (тек Orbit) $ ttl send -u payroll.xlsx # соңғы жүктеп салулар тізімі $ 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 # файлды мерзімінен бұрын жою (ttl list барлық беттерді аралайды; -n 5 бес файлдан кейін тоқтайды) $ ttl delete xK9mQ2vLpA Deleted: xK9mQ2vLpA # немесе жүктеп салудың басқару кілтімен, кез келген жоспарда: ttl delete xK9mQ2vLpA -k KEY # сақталған кілтті жою $ ttl deactivate Key file removed: /usr/local/bin/ttl.key
HTTP API
ttl send / ttl get немесе --json режимін пайдаланыңыз. Төмендегі endpoint-тер Orbit файлдарын басқаруға арналған.Файлдар тізімі (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} # келесі бет: тек has_more true болғанда; алдыңғы жауаптағы next_cursor мәнін беріңіз $ curl "https://ttl.space/v1/files?cursor=1711800600123456" -H "X-API-Key: ttl_orbit_..."
Осы кілтпен жүктеп салынған файлдарды қайтарады, ең жаңасы бірінші, бір бетте 20. has_more мәні true болғанда жауапта next_cursor өрісі де болады; келесі бетті алу үшін оны ?cursor= ретінде беріңіз. Orbit жоспары қажет.
Файлды жою (Orbit)
$ curl -X DELETE https://ttl.space/v1/files/xK9mQ2vLpA -H "X-API-Key: ttl_orbit_..."
Сәтті болғанда 204 No Content қайтарады. Orbit жоспары қажет. Файл берілген кілтке тиесілі болуы керек.
Қате жауаптары
| Күй | Мағынасы |
|---|---|
401 | API кілті жарамсыз немесе мерзімі өткен |
403 | Бұл мүмкіндік Orbit жоспарын талап етеді |
404 | Файл табылмады немесе осы кілтке тиесілі емес |
429 | Сұраулар шегінен асып кетті |
500 | Сервердің ішкі қатесі, кейінірек қайталап көріңіз |
502 | Сақтау орны уақытша қолжетімсіз, кейінірек қайталап көріңіз |
Шектеулер
| Шектеу | Тегін | Orbit |
|---|---|---|
| Файлдың ең үлкен өлшемі | 6 GB | 50 GB |
| Ең ұзақ TTL | 7 күн | 30 күн немесе тұрақты |
| Күніне жүктеп салулар | 4 | Шектеусіз |
| Күніне жүктеп салу көлемі (бір IP үшін) | 6 GB | Шектеусіз |
| Бір уақыттағы жүктеп салулар | Бір IP-ге 2 | Бір API кілтіне 4 |
| Сақтау орны квотасы | ✗ | 1 TB |
| Файлдар тізімі | ✗ | ✓ |
| Мерзімінен бұрын жою | ✓ | ✓ |
| Тек жүктеп салушыға арналған файлдар | ✗ | ✓ |
| Құпия сөздің ең аз ұзындығы | 8 таңба | |
| Бір IP-ге сұраулар | 10 секундта 300 | |
| Бір IP-ге қосылымдар | Бір уақытта 100 | |
Шифрлау
Файлдар жүктеп салынбай тұрып құрылғыңызда шифрланады. Сервер тек шифрмәтінді сақтайды және файлдарыңыздың шифрын аша алмайды.
| Құрамдас | Алгоритм / Мән |
|---|---|
| Кілтті алу | Argon2id (time=3, memory=64 MiB, parallelism=1) |
| Шифрлау алгоритмі | XChaCha20-Poly1305 AEAD |
Шифрмәтінге енгізілген кез келген өзгеріс шифрды ашуды сәтсіз етеді. Шифрмәтінді беру алдында сервер шифрлау кілтінен алынған бір бағытты токен арқылы жүктеп алушының дұрыс құпия сөзді білетінін тексереді.