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ð.

Aðeins má nota einn skýran uppruna lykilorðs í einu. Að blanda saman -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

RofiLýsingSjálfgefið
-p, --password PDulkóðunarlykilorðgagnvirkt
--password-stdinLesa lykilorð úr stdin
--password-file FLesa lykilorð úr skrá
-t, --ttl DURGildistími (TTL)7d
-b, --burnEyða eftir lestur (eitt niðurhal)slökkt
-u, --uploader-onlyAðeins reikningurinn þinn getur hlaðið niður: reikningssíðan þín eða einhver API-lykill reikningsins (Orbit; samheiti --private)slökkt
--timeout DURTímamörk flutningsengin
--server URLVefslóð netþjónshttps://ttl.space
-h3, --http3Prófa HTTP/3 (QUIC), falla aftur á TCPslökkt
--jsonSkrifa JSON á stdout (fyrir skriftur og gervigreindarfulltrúa)slökkt

Rofar fyrir get

RofiLýsingSjálfgefið
-p, --password PAfkóðunarlykilorðgagnvirkt
--password-stdinLesa lykilorð úr stdin
--password-file FLesa lykilorð úr skrá
-o, --output DIRÚttaksmappanúverandi mappa
--timeout DURTímamörk flutningsengin
--server URLNetþjónn fyrir stakt auðkennihttps://ttl.space
-h3, --http3Prófa HTTP/3 (QUIC), falla aftur á TCPslökkt
--jsonSkrifa 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

Upphleðsla og niðurhal krefjast dulkóðunarferlis CLI (Argon2id + XChaCha20-Poly1305 + AEAD í hlutum). Notaðu 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ðaMerking
401Ógildur eða útrunninn API-lykill
403Eiginleikinn krefst Orbit-áskriftar
404Skráin fannst ekki eða tilheyrir ekki þessum lykli
429Takmörk á fjölda beiðna yfirstigin
500Innri villa á netþjóni, reyndu aftur síðar
502Geymsla tímabundið ekki tiltæk, reyndu aftur síðar

Takmörk

TakmörkunÓkeypisOrbit
Hámarksstærð skráar6 GB50 GB
Hámarks-TTL7 dagar30 dagar eða varanlegt
Upphleðslur á dag4Ótakmarkað
Upphleðslumagn á dag (á hverja IP-tölu)6 GBÓtakmarkað
Samtímis upphleðslur2 á IP4 á API-lykil
Geymslukvóti✗1 TB
Skráalisti✗✓
Snemmbúin eyðing✓✓
Skrár aðeins fyrir sendanda✗✓
Lágmarkslengd lykilorðs8 stafir
Beiðnir á IP300 á 10 sekúndum
Tengingar á IP100 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.

HlutiReiknirit / gildi
LyklaútleiðslaArgon2id (time=3, memory=64 MiB, parallelism=1)
DulmálXChaCha20-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.