מדריך שימוש

עברית

התחלה מהירה

# ⁧שליחת קובץ: הסיסמה נוצרת אוטומטית, והקישור והסיסמה מודפסים⁩
$ 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

קובץ הפעלה מוכן

# ⁧הורדה לפלטפורמה שלך מדף ה-releases⁩
$ 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

$ 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 היא 7d⁩
$ 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       # ⁧פג תוקף בעוד יום אחד⁩
$ 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 במקום לדרוס אותו.

עם אסימון בלבד

# ⁧אפשר להשתמש באסימון בן 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 תווים.

מדריך עזר לאפשרויות

דגלי send

דגלתיאורברירת מחדל
-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כתובת השרתhttps://ttl.space
-h3, --http3ניסיון להשתמש ב-HTTP/3 (QUIC), עם חזרה ל-TCPכבוי
--jsonפלט JSON ל-stdout (לסקריפטים ולסוכני AI)כבוי

דגלי get

דגלתיאורברירת מחדל
-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

מחיקה לאחר קריאה: סוד חד-פעמי

$ 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"}

# ⁧הורדה (get)⁩
$ 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. נקודות הקצה שלהלן מיועדות לניהול קבצים ב-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 GB50 GB
TTL מרבי7 ימים30 יום או קבוע
העלאות ביום4ללא הגבלה
נפח העלאה ביום (לכל כתובת IP)6 GBללא הגבלה
העלאות במקביל2 לכל כתובת IP4 לכל מפתח API
מכסת אחסון✗1 TB
רשימת קבצים✗✓
מחיקה מוקדמת✓✓
קבצים פרטיים✗✓
אורך סיסמה מינימלי8 תווים
בקשות לכל כתובת IP300 ל-10 שניות
חיבורים לכל כתובת IP100 במקביל

הצפנה

הקבצים מוצפנים במכשיר שלך לפני ההעלאה. השרת שומר רק טקסט מוצפן ואינו יכול לפענח את הקבצים שלך.

רכיבאלגוריתם / ערך
גזירת מפתחArgon2id (time=3, memory=64 MiB, parallelism=1)
צופןXChaCha20-Poly1305 AEAD

כל שינוי בטקסט המוצפן גורם לפענוח להיכשל. השרת מוודא שמי שמוריד יודע את הסיסמה הנכונה לפני שהוא משחרר את הטקסט המוצפן, באמצעות אסימון חד-כיווני שנגזר ממפתח ההצפנה.