გამოყენების სახელმძღვანელო

ქართული

სწრაფი დაწყება

# ფაილის გაგზავნა: პაროლი ავტომატურად იქმნება, იბეჭდება ბმული და პაროლი
$ 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

ქმნის კრიპტოგრაფიულად შემთხვევით 12-სიმბოლოიან პაროლს [0-9A-Za-z] სიმბოლოებიდან. ხელმისაწვდომია მხოლოდ 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სერვერის URLhttps://ttl.space
-h3, --http3HTTP/3-ის (QUIC) გამოყენების მცდელობა, საჭიროებისას TCP-ზე გადასვლაგამორთული
--jsonJSON-ის გამოტანა stdout-ში (სკრიპტებისა და AI აგენტებისთვის)გამორთული

მიღების პარამეტრები

პარამეტრიაღწერანაგულისხმევი
-p, --password Pგაშიფვრის პაროლიინტერაქტიული
--password-stdinპაროლის წაკითხვა stdin-დან
--password-file Fპაროლის წაკითხვა ფაილიდან
-o, --output DIRგამოტანის საქაღალდემიმდინარე საქაღალდე
--timeout DURგადაცემის ლოდინის ვადაარ არის
--server URLსერვერი მხოლოდ ტოკენის შემთხვევაშიhttps://ttl.space
-h3, --http3HTTP/3-ის (QUIC) გამოყენების მცდელობა, საჭიროებისას TCP-ზე გადასვლაგამორთული
--jsonJSON-ის გამოტანა stdout-ში (სკრიპტებისა და AI აგენტებისთვის)გამორთული

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 რეჟიმი (სკრიპტები და AI აგენტები)

# გაგზავნა: 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 რეჟიმში მთელი გამოტანა სტრუქტურირებული JSON-ია stdout-ში. თუ გაგზავნისას პაროლი მითითებული არ არის, ის ავტომატურად იქმნება და პასუხში შედის. გასვლის კოდი წარმატებისას 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

ატვირთვა და ჩამოტვირთვა საჭიროებს CLI-ის დაშიფვრის დამუშავების ჯაჭვს (Argon2id + XChaCha20-Poly1305 + ბლოკებად დაყოფილი AEAD). სკრიპტებისთვის გამოიყენეთ 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 გეგმა. ფაილი უნდა ეკუთვნოდეს მითითებულ გასაღებს.

შეცდომის პასუხები

სტატუსიმნიშვნელობა
401API გასაღები არასწორია ან ვადაგასულია
403ფუნქციას Orbit გეგმა სჭირდება
404ფაილი ვერ მოიძებნა ან ამ გასაღებს არ ეკუთვნის
429მოთხოვნების ლიმიტი გადაჭარბებულია
500სერვერის შიდა შეცდომა, სცადეთ მოგვიანებით
502საცავი დროებით მიუწვდომელია, სცადეთ მოგვიანებით

ლიმიტები

შეზღუდვაუფასოOrbit
ფაილის მაქს. ზომა6 GB50 GB
მაქს. TTL7 დღე30 დღე ან მუდმივად
ატვირთვები დღეში4შეუზღუდავი
ატვირთვის მოცულობა დღეში (IP-ზე)6 GBშეუზღუდავი
ერთდროული ატვირთვები2 თითო IP-ზე4 თითო API გასაღებზე
საცავის კვოტა✗1 TB
ფაილების სია✗✓
ვადაზე ადრე წაშლა✓✓
მხოლოდ ავტორისთვის განკუთვნილი ფაილები✗✓
პაროლის მინ. სიგრძე8 სიმბოლო
მოთხოვნები IP-ზე300 ყოველ 10 წამში
კავშირები IP-ზე100 ერთდროულად

დაშიფვრა

ფაილები ატვირთვამდე თქვენს მოწყობილობაზე დაიშიფრება. სერვერი მხოლოდ შიფროტექსტს ინახავს და თქვენი ფაილების გაშიფვრა არ შეუძლია.

კომპონენტიალგორითმი / მნიშვნელობა
გასაღების გამოთვლაArgon2id (time=3, memory=64 MiB, parallelism=1)
შიფრიXChaCha20-Poly1305 AEAD

შიფროტექსტის ნებისმიერი ცვლილების შემთხვევაში გაშიფვრა ვერ ხერხდება. შიფროტექსტის გაცემამდე სერვერი ამოწმებს, რომ ჩამოტვირთვის მსურველმა სწორი პაროლი იცის, დაშიფვრის გასაღებიდან მიღებული ცალმხრივი ტოკენის გამოყენებით.