מדריך שימוש
עברית
התחלה מהירה
# שליחת קובץ: הסיסמה נוצרת אוטומטית, והקישור והסיסמה מודפסים $ 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
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 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 |
כל שינוי בטקסט המוצפן גורם לפענוח להיכשל. השרת מוודא שמי שמוריד יודע את הסיסמה הנכונה לפני שהוא משחרר את הטקסט המוצפן, באמצעות אסימון חד-כיווני שנגזר ממפתח ההצפנה.