გამოყენების სახელმძღვანელო
ქართული
სწრაფი დაწყება
# ფაილის გაგზავნა: პაროლი ავტომატურად იქმნება, იბეჭდება ბმული და პაროლი $ 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 | სერვერის URL | https://ttl.space |
-h3, --http3 | HTTP/3-ის (QUIC) გამოყენების მცდელობა, საჭიროებისას TCP-ზე გადასვლა | გამორთული |
--json | JSON-ის გამოტანა stdout-ში (სკრიპტებისა და AI აგენტებისთვის) | გამორთული |
მიღების პარამეტრები
| პარამეტრი | აღწერა | ნაგულისხმევი |
|---|---|---|
-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-ში (სკრიპტებისა და 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
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 | შეუზღუდავი |
| ერთდროული ატვირთვები | 2 თითო IP-ზე | 4 თითო API გასაღებზე |
| საცავის კვოტა | ✗ | 1 TB |
| ფაილების სია | ✗ | ✓ |
| ვადაზე ადრე წაშლა | ✓ | ✓ |
| მხოლოდ ავტორისთვის განკუთვნილი ფაილები | ✗ | ✓ |
| პაროლის მინ. სიგრძე | 8 სიმბოლო | |
| მოთხოვნები IP-ზე | 300 ყოველ 10 წამში | |
| კავშირები IP-ზე | 100 ერთდროულად | |
დაშიფვრა
ფაილები ატვირთვამდე თქვენს მოწყობილობაზე დაიშიფრება. სერვერი მხოლოდ შიფროტექსტს ინახავს და თქვენი ფაილების გაშიფვრა არ შეუძლია.
| კომპონენტი | ალგორითმი / მნიშვნელობა |
|---|---|
| გასაღების გამოთვლა | Argon2id (time=3, memory=64 MiB, parallelism=1) |
| შიფრი | XChaCha20-Poly1305 AEAD |
შიფროტექსტის ნებისმიერი ცვლილების შემთხვევაში გაშიფვრა ვერ ხერხდება. შიფროტექსტის გაცემამდე სერვერი ამოწმებს, რომ ჩამოტვირთვის მსურველმა სწორი პაროლი იცის, დაშიფვრის გასაღებიდან მიღებული ცალმხრივი ტოკენის გამოყენებით.