Notkunarleiðbeiningar
Íslenska
Fljótleg byrjun
# senda skrá: lykilorð búið til sjálfkrafa, prentar tengil + lykilorð $ 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 # hlaða niður: spyr um lykilorð gagnvirkt $ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ Enter password: ******** Password verified ◉★✧· Phew, secret.pdf landed safe and sound (1.2 MB)
CLI sér um dulkóðun, upphleðslu, niðurhal og afkóðun. Netþjónninn sér aldrei lykilorðið þitt eða ódulkóðuð gögn.
Uppsetning
Homebrew (macOS)
$ brew install tweenietomatoes/ttl/ttl
Scoop (Windows)
$ scoop bucket add ttl https://github.com/tweenietomatoes/scoop-ttl $ scoop install ttl
Tilbúin keyrsluskrá
# sæktu útgáfu fyrir þitt stýrikerfi af Releases-síðunni $ 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/
Uppsetning með Go
$ go install github.com/tweenietomatoes/ttl/cmd/ttl@latest
Úr frumkóða
$ git clone https://github.com/tweenietomatoes/ttl $ cd ttl && go build -o ttl ./cmd/ttl/ $ sudo mv ttl /usr/local/bin/
Staðfesting
$ ttl version ttl 1.6.2
Að senda skrár
Einföld sending
# búa til lykilorð sjálfkrafa, sjálfgefinn TTL 7d $ ttl send report.xlsx
Þegar ekkert lykilorð er gefið upp í skipanalínu spyr CLI:
No password provided. Generate one? [Y/n]:
Ýttu á Enter eða skrifaðu y til að búa það til sjálfkrafa.
Eigið lykilorð
$ ttl send -p mySecretPass -t 1h document.pdf
Eyða eftir lestur
# eytt eftir niðurhal; niðurhal sem rofnar getur haldið áfram og telst ekki með $ ttl send -b photo.jpg
Eigin TTL
$ ttl send -t 5m temp-credentials.txt # rennur út eftir 5 mínútur $ ttl send -t 30m meeting-link.txt # rennur út eftir 30 mínútur $ ttl send -t 6h backup.tar.gz # rennur út eftir 6 klukkustundir $ ttl send -t 1d daily-report.pdf # rennur út eftir 1 dag $ ttl send -t 3d project-archive.zip # rennur út eftir 3 daga $ ttl send -t 5d design-assets.zip # rennur út eftir 5 daga $ ttl send report.xlsx # rennur út eftir 7 daga (sjálfgefið)
Stórar skrár
Skrá allt að 16 MiB fer í einni beiðni; stærri skrá fer í hlutum sem hægt er að halda áfram með, 16 MiB hver, tveimur í einu. Hver beiðni er athuguð með SHA-256 tætigildi og beiðni sem mistekst á leiðinni er send aftur; hlutar sem þegar hafa verið sendir haldast. Ctrl-C hættir við á hreinan hátt.
Að hlaða niður skrám
Gagnvirkt (skipanalína)
$ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ Enter password: ******** Password verified ◉★✧· Phew, document.pdf landed safe and sound (4.2 MB)
Lykilorðið birtist ekki í skipanalínunni. Upprunalegt skráarnafn varðveitist; ef það nafn er þegar til í úttaksmöppunni er skráin vistuð sem name (1).ext í stað þess að skrifa yfir hana.
Aðeins með auðkenni
# þú getur notað bara 10 stafa auðkennið í stað allrar vefslóðarinnar $ ttl get aBcDeFgHiJ
Úttaksmappa
$ ttl get -o ~/Downloads aBcDeFgHiJ
Sjálfgefið eru skrár vistaðar í núverandi möppu. Notaðu -o / --output til að tilgreina aðra möppu.
Með lykilorðsrofa
$ ttl get -p mySecretPass https://ttlspaceusercontent.com/aBcDeFgHiJ
Niðurhal sem rofnar
Niðurhal sem rofnar heldur áfram frá síðasta móttekna bæti; hver 64 KiB hluti er sannvottaður sérstaklega, svo niðurstaðan er sú sama og í órofinni sendingu. Einnota skrá (eyða eftir lestur) er notuð upp þegar niðurhal hefur sótt hana alla: niðurhal sem rofnar heldur áfram þar sem það hætti og skráin helst fyrir næstu tilraun.
Vafri
Þú getur líka hlaðið niður og afkóðað skrár í vafranum með því að opna tengilinn beint. Vefviðmótið notar sama skráarsnið og sömu reiknirit (Argon2id, XChaCha20-Poly1305) og biður um lykilorðið þitt. Engin uppsetning á hugbúnaði er nauðsynleg.
Stjórnlykill
Hver upphleðsla fær stjórnlykil sem ttl send prentar einu sinni (manage_key í --json). Netþjónninn geymir aðeins tætigildi hans. Í hvaða áskrift sem er gerir hann þér kleift að fylgjast með upphleðslunni eða ljúka henni fyrr; hver sem hefur lykilinn getur eytt upphleðslunni, svo farðu með hann eins og lykilorð.
# staða, niðurhal og gildistími þinnar eigin upphleðslu $ 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) # eyða fyrr $ ttl delete aBcDeFgHiJ -k k7Qm2vXpL9aR4tB8cD1eF6gH3jK5mN0oP2qS4uV7wYz Deleted: aBcDeFgHiJ
Staðan er ein af active, expired, burned eða deleted.
Meðhöndlun lykilorða
Lykilorðið er fræ dulkóðunarlykilsins. Það fer aldrei úr tækinu þínu og er aldrei sent til netþjónsins. Það eru sex leiðir til að gefa það upp:
1. Búa til sjálfkrafa (aðeins við sendingu)
$ ttl send notes.txt No password provided. Generate one? [Y/n]: y Generated password: aB3kL9mXq7Rt
Býr til dulritunarlega tilviljanakennt 12 stafa lykilorð úr [0-9A-Za-z]. Aðeins í boði við send (gagnvirkt, eða sjálfkrafa í --json ham).
2. Gagnvirk fyrirspurn
$ ttl send notes.txt No password provided. Generate one? [Y/n]: n Enter password: ******** Confirm password: ******** $ ttl get https://ttlspaceusercontent.com/aBcDeFgHiJ Enter password: ********
Lykilorðið birtist ekki. Við send velurðu hvort það er búið til sjálfkrafa; ef þú skrifar þitt eigið staðfestirðu það. Við get er spurt beint.
3. Rofi: -p / --password
$ ttl send -p mySecretPass file.zip $ ttl get --password mySecretPass https://ttlspaceusercontent.com/aBcDeFgHiJ
-p / --password sést í úttaki ps aux og getur vistast í skeljarsögunni (~/.bash_history). Forðastu það í sameiginlegu umhverfi og í skriftum. Notaðu --password-stdin eða --password-file í staðinn.4. Staðalinntak: --password-stdin
# pípa úr echo $ echo "mySecretPass" | ttl send --password-stdin backup.tar.gz # pípa úr lykilorðastjóra $ pass show ttl/key | ttl send --password-stdin data.zip # pípa úr umhverfisbreytu $ printenv MY_SECRET | ttl get --password-stdin https://ttlspaceusercontent.com/aBcDeFgHiJ # here-string $ ttl send --password-stdin report.pdf <<<"mySecretPass"
Les fyrstu línuna úr stdin. Gagnlegt í skriftum, CI/CD-ferlum og sjálfvirkni. Þegar stdin er ekki skipanalína og enginn uppruni lykilorðs er gefinn upp hættir CLI með villu (nema --json sé notað, sem býr til lykilorð sjálfkrafa).
5. Skrá: --password-file
$ ttl send --password-file /run/secrets/key report.xlsx $ ttl get --password-file ~/.ttl-key https://ttlspaceusercontent.com/aBcDeFgHiJ
Les fyrstu línu skrárinnar (lokalínuskil eru fjarlægð). Samhæft við Docker secrets (/run/secrets/), skrár Vault-umboðsmanns og svipuð mynstur.
6. Sjálfgreind skrá: ttl.password
Ef ekkert skýrt lykilorð er gefið upp leitar CLI að skrá sem heitir ttl.password við hlið keyrsluskrárinnar, síðan að ~/.ttl/password. Fyrsta línan er notuð sem lykilorð.
-p / --password, --password-stdin og --password-file er villa. Sjálfgreinda skráin ttl.password er aðeins athuguð þegar ekkert af þessu er gefið upp. Lágmarkslengd lykilorðs er 8 stafir.Yfirlit yfir valkosti
Rofar fyrir send
| Rofi | Lýsing | Sjálfgefið |
|---|---|---|
-p, --password P | Dulkóðunarlykilorð | gagnvirkt |
--password-stdin | Lesa lykilorð úr stdin | |
--password-file F | Lesa lykilorð úr skrá | |
-t, --ttl DUR | Gildistími (TTL) | 7d |
-b, --burn | Eyða eftir lestur (eitt niðurhal) | slökkt |
-u, --uploader-only | Aðeins reikningurinn þinn getur hlaðið niður: reikningssíðan þín eða einhver API-lykill reikningsins (Orbit; samheiti --private) | slökkt |
--timeout DUR | Tímamörk flutnings | engin |
--server URL | Vefslóð netþjóns | https://ttl.space |
-h3, --http3 | Prófa HTTP/3 (QUIC), falla aftur á TCP | slökkt |
--json | Skrifa JSON á stdout (fyrir skriftur og gervigreindarfulltrúa) | slökkt |
Rofar fyrir get
| Rofi | Lýsing | Sjálfgefið |
|---|---|---|
-p, --password P | Afkóðunarlykilorð | gagnvirkt |
--password-stdin | Lesa lykilorð úr stdin | |
--password-file F | Lesa lykilorð úr skrá | |
-o, --output DIR | Úttaksmappa | núverandi mappa |
--timeout DUR | Tímamörk flutnings | engin |
--server URL | Netþjónn fyrir stakt auðkenni | https://ttl.space |
-h3, --http3 | Prófa HTTP/3 (QUIC), falla aftur á TCP | slökkt |
--json | Skrifa JSON á stdout (fyrir skriftur og gervigreindarfulltrúa) | slökkt |
TTL-gildi
Ókeypis: 5m 10m 15m 30m 1h 2h 3h 6h 12h 24h 1d 2d 3d 4d 5d 6d 7d
Orbit bætir við: 14d 15d 28d 30d permanent
Tímamörk
Sjálfgefið: engin. Flutningur sem stöðvast heldur áfram af sjálfu sér og gefst upp ef hann getur ekki haldið áfram. Settu mörk með --timeout 30m eða --timeout 2h.
Dæmi
Skrifta: öryggisafrit og upphleðsla
#!/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
Tengill á klippiborð (macOS)
$ ttl send -p mypass123 file.pdf | pbcopy
Tengill á klippiborð (Linux)
$ ttl send -p mypass123 file.pdf | xclip -sel clip
Eyða eftir lestur: einnota leyndarmál
$ echo "$DB_PASSWORD" | ttl send --password-stdin -b -t 5m credentials.env # tengillinn virkar nákvæmlega einu sinni, rennur út eftir 5 mínútur
JSON-hamur (skriftur & gervigreindarfulltrúar)
# senda: lykilorð búið til sjálfkrafa í JSON-ham $ 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"} # hlaða niður $ ttl --json get -p aB3kL9mXq7Rt xK9mQ2vLpA {"ok":true,"token":"xK9mQ2vLpA","filename":"report.pdf","size":2097152,"saved_to":"/home/user/report.pdf"} # staða með stjórnlyklinum $ 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}} # villur skila 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 ham er allt úttak skipulagt JSON á stdout. Ef ekkert lykilorð er gefið upp við sendingu er það búið til sjálfkrafa og fylgir svarinu. Skilakóði er 0 við árangur og 1 við villu.
Orbit-áskrift
Orbit opnar fyrir stærri skrár (50 GB), lengri varðveislu (30 daga, eða varanlega með áskriftinni), skrár sem eru læstar við reikninginn þinn (aðeins reikningurinn þinn getur hlaðið þeim niður) og skráastjórnun (listi & eyðing). Fullur samanburður: Eiginleikar.
API-lykillinn er sjálfkrafa fundinn úr umhverfisbreytunni TTL_API_KEY, úr ttl.key við hlið keyrsluskrárinnar eða úr ~/.ttl/key. Notaðu ttl activate til að vista lykilinn eða skrifaðu hann handvirkt á einhvern af þessum stöðum.
# virkja lykilinn: beðið um hann án endurómunar svo hann lendi ekki í skeljarsögunni $ ttl activate Enter Orbit API key: ******** Orbit plan activated. Key saved to /usr/local/bin/ttl.key # án gagnvirkni: ttl activate --key-stdin | ttl activate --key-file F # athuga áskrift og notkun $ 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 # senda með lengri TTL $ ttl send -t 30d large-backup.tar.gz # varanleg skrá (aðeins Orbit): enginn gildistími, geymd þar til þú eyðir henni eða áskriftinni lýkur $ ttl send -t permanent archive.tar.gz # senda einkaskrá: aðeins reikningurinn þinn getur hlaðið henni niður (aðeins Orbit) $ ttl send -u payroll.xlsx # listi yfir nýlegar upphleðslur $ 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 # eyða skrá fyrr (ttl list fer yfir allar síður; -n 5 stoppar eftir fimm skrár) $ ttl delete xK9mQ2vLpA Deleted: xK9mQ2vLpA # eða með stjórnlykli upphleðslunnar, í hvaða áskrift sem er: ttl delete xK9mQ2vLpA -k KEY # fjarlægja vistaðan lykil $ ttl deactivate Key file removed: /usr/local/bin/ttl.key
HTTP API
ttl send / ttl get eða --json ham fyrir skriftur. Endapunktarnir hér að neðan eru fyrir skráastjórnun í Orbit.Skrá yfir skrár (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} # næsta síða: aðeins þegar has_more er true; sendu next_cursor úr fyrra svari $ curl "https://ttl.space/v1/files?cursor=1711800600123456" -H "X-API-Key: ttl_orbit_..."
Skilar skrám sem var hlaðið upp með þessum lykli, nýjustu fyrst, 20 á hverja síðu. Þegar has_more er true inniheldur svarið líka next_cursor; sendu það sem ?cursor= til að sækja næstu síðu. Krefst Orbit-áskriftar.
Eyða skrá (Orbit)
$ curl -X DELETE https://ttl.space/v1/files/xK9mQ2vLpA -H "X-API-Key: ttl_orbit_..."
Skilar 204 No Content við árangur. Krefst Orbit-áskriftar. Skráin verður að tilheyra uppgefnum lykli.
Villusvör
| Staða | Merking |
|---|---|
401 | Ógildur eða útrunninn API-lykill |
403 | Eiginleikinn krefst Orbit-áskriftar |
404 | Skráin fannst ekki eða tilheyrir ekki þessum lykli |
429 | Takmörk á fjölda beiðna yfirstigin |
500 | Innri villa á netþjóni, reyndu aftur síðar |
502 | Geymsla tímabundið ekki tiltæk, reyndu aftur síðar |
Takmörk
| Takmörkun | Ókeypis | Orbit |
|---|---|---|
| Hámarksstærð skráar | 6 GB | 50 GB |
| Hámarks-TTL | 7 dagar | 30 dagar eða varanlegt |
| Upphleðslur á dag | 4 | Ótakmarkað |
| Upphleðslumagn á dag (á hverja IP-tölu) | 6 GB | Ótakmarkað |
| Samtímis upphleðslur | 2 á IP | 4 á API-lykil |
| Geymslukvóti | ✗ | 1 TB |
| Skráalisti | ✗ | ✓ |
| Snemmbúin eyðing | ✓ | ✓ |
| Skrár aðeins fyrir sendanda | ✗ | ✓ |
| Lágmarkslengd lykilorðs | 8 stafir | |
| Beiðnir á IP | 300 á 10 sekúndum | |
| Tengingar á IP | 100 samtímis | |
Dulkóðun
Skrár eru dulkóðaðar í tækinu þínu áður en þeim er hlaðið upp. Netþjónninn geymir aðeins dulkóðuð gögn og getur ekki afkóðað skrárnar þínar.
| Hluti | Reiknirit / gildi |
|---|---|
| Lyklaútleiðsla | Argon2id (time=3, memory=64 MiB, parallelism=1) |
| Dulmál | XChaCha20-Poly1305 AEAD |
Sérhver breyting á dulkóðuðu gögnunum veldur því að afkóðun mistekst. Netþjónninn staðfestir að sá sem hleður niður þekki rétt lykilorð áður en hann afhendir dulkóðuðu gögnin, með einstefnu-aðgangsteikni sem er leitt út úr dulkóðunarlyklinum.