Canllaw Defnydd

Cychwyn cyflym

# anfon ffeil: cyfrinair wedi'i greu'n awtomatig, yn argraffu dolen + cyfrinair
$ ttl send secret.pdf
No password provided. Generate one? [Y/n]:
Generated password: aB3kL9mXq7Rt
·✧★◉ Thank goodness, secret.pdf is in orbit (1.2 MB)
IMPORTANT! Save your password — required to download and decrypt the file.
Password: aB3kL9mXq7Rt
https://ttl.space/aBcDeFgHiJ

# lawrlwytho: yn gofyn am gyfrinair yn rhyngweithiol
$ ttl get https://ttl.space/aBcDeFgHiJ
Enter password: ********
Password verified
◉★✧· Phew, secret.pdf landed safe and sound (1.2 MB)

Mae'r CLI yn trin amgryptio, uwchlwytho, lawrlwytho, a dadgryptio. Nid yw'r gweinydd byth yn gweld eich cyfrinair na'ch data testun plaen.

Gosod

Homebrew (macOS)

$ brew install tweenietomatoes/ttl/ttl

Scoop (Windows)

$ scoop bucket add ttl https://github.com/tweenietomatoes/scoop-ttl
$ scoop install ttl

Deuaidd parod

# lawrlwytho ar gyfer eich platfform o'r datganiadau
$ curl -Lo ttl.tar.gz \
  https://github.com/tweenietomatoes/ttl/releases/download/v1.6.0/ttl_1.6.0_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

O'r cod ffynhonnell

$ git clone https://github.com/tweenietomatoes/ttl
$ cd ttl && go build -o ttl ./cmd/ttl/
$ sudo mv ttl /usr/local/bin/

Gwirio

$ ttl version
ttl 1.6.0

Anfon ffeiliau

Anfon sylfaenol

# creu cyfrinair yn awtomatig, TTL rhagosodedig 7d
$ ttl send report.xlsx

Pan na ddarperir cyfrinair mewn terfynell, mae'r CLI yn gofyn:

No password provided. Generate one? [Y/n]:

Pwyswch Enter neu deipiwch y i greu un yn awtomatig.

Cyfrinair personol

$ ttl send -p mySecretPass -t 1h document.pdf

Llosgi ar ol darllen

# caiff y ffeil ei defnyddio cyn gynted ag y bydd y lawrlwythiad cyntaf yn dechrau; os caiff ei dorri, dim ond y lawrlwythiad hwnnw all ailddechrau
$ ttl send -b photo.jpg

TTL personol

$ ttl send -t 5m temp-credentials.txt   # yn dod i ben mewn 5 munud
$ ttl send -t 30m meeting-link.txt      # yn dod i ben mewn 30 munud
$ ttl send -t 6h backup.tar.gz          # yn dod i ben mewn 6 awr
$ ttl send -t 1d daily-report.pdf       # yn dod i ben mewn 1 diwrnod
$ ttl send -t 3d project-archive.zip    # yn dod i ben mewn 3 diwrnod
$ ttl send -t 5d design-assets.zip      # yn dod i ben mewn 5 diwrnod
$ ttl send report.xlsx                  # yn dod i ben mewn 7 diwrnod (rhagosodedig)

Lawrlwytho ffeiliau

Rhyngweithiol (terfynell)

$ ttl get https://ttl.space/aBcDeFgHiJ
Enter password: ********
Password verified
◉★✧· Phew, document.pdf landed safe and sound (4.2 MB)

Ni chaiff y cyfrinair ei adleisio i'r derfynell. Cedwir yr enw ffeil gwreiddiol; os oes ffeil â'r enw hwnnw eisoes yn y cyfeiriadur allbwn, caiff y ffeil ei chadw fel name (1).ext yn hytrach na throsysgrifo'r un sy'n bodoli.

Tocyn yn unig

# gallwch ddefnyddio'r tocyn 10 nod yn unig yn lle'r URL llawn
$ ttl get aBcDeFgHiJ

Cyfeiriadur allbwn

$ ttl get -o ~/Downloads aBcDeFgHiJ

Yn ddiofyn, mae ffeiliau yn cael eu cadw yn y cyfeiriadur presennol. Defnyddiwch -o / --output i nodi cyfeiriadur gwahanol.

Gyda baner cyfrinair

$ ttl get -p mySecretPass https://ttl.space/aBcDeFgHiJ

Porwr

Gallwch hefyd lawrlwytho a dadgryptio ffeiliau yn eich porwr drwy ymweld â'r ddolen yn uniongyrchol. Mae'r rhyngwyneb gwe yn defnyddio'r un fformat ffeil a'r un algorithmau (Argon2id, XChaCha20-Poly1305) ac yn gofyn am eich cyfrinair. Dim angen gosod meddalwedd.

Trin cyfrineiriau

Y cyfrinair yw hedyn yr allwedd amgryptio. Nid yw byth yn gadael eich dyfais ac ni chaiff byth ei anfon i'r gweinydd. Mae chwe ffordd o'i ddarparu:

1. Creu'n awtomatig (anfon yn unig)

$ ttl send notes.txt
No password provided. Generate one? [Y/n]: y
Generated password: aB3kL9mXq7Rt

Yn creu cyfrinair 12 nod ar hap yn gryptograffig o [0-9A-Za-z]. Ar gael yn unig wrth wneud send (yn rhyngweithiol, neu'n awtomatig ym modd --json).

2. Anogwr rhyngweithiol

$ ttl send notes.txt
No password provided. Generate one? [Y/n]: n
Enter password: ********
Confirm password: ********

$ ttl get https://ttl.space/aBcDeFgHiJ
Enter password: ********

Ni chaiff y cyfrinair ei adleisio. Wrth wneud send, dewiswch yn gyntaf a ydych am greu un yn awtomatig. Wrth wneud get, cewch eich annog yn uniongyrchol.

3. Baner: -p / --password

$ ttl send -p mySecretPass file.zip
$ ttl get --password mySecretPass https://ttl.space/aBcDeFgHiJ

4. Stdin: --password-stdin

# peipio o echo
$ echo "mySecretPass" | ttl send --password-stdin backup.tar.gz

# peipio o reolwr cyfrineiriau
$ pass show ttl/key | ttl send --password-stdin data.zip

# peipio o newidyn amgylchedd
$ printenv MY_SECRET | ttl get --password-stdin https://ttl.space/aBcDeFgHiJ

# heredoc
$ ttl send --password-stdin report.pdf <<<"mySecretPass"

Yn darllen y llinell gyntaf o stdin. Defnyddiol mewn sgriptiau, piblinellau CI/CD, ac awtomeiddio. Pan nad yw stdin yn derfynell a heb ffynhonnell cyfrinair, mae'r CLI yn gorffen gyda gwall (ac eithrio gyda --json, sy'n cynhyrchu cyfrinair yn awtomatig).

5. Ffeil: --password-file

$ ttl send --password-file /run/secrets/key report.xlsx
$ ttl get --password-file ~/.ttl-key https://ttl.space/aBcDeFgHiJ

Yn darllen llinell gyntaf y ffeil (llinell newydd ar y diwedd wedi'i thynnu). Yn gydnaws a chyfrinachau Docker (/run/secrets/), ffeiliau asiant Vault, a phatrymau tebyg.

6. Ffeil a ganfuwyd yn awtomatig: ttl.password

Os na roddir cyfrinair penodol, mae'r CLI yn chwilio am ffeil ttl.password wrth ymyl y rhaglen, yna ~/.ttl/password. Defnyddir y llinell gyntaf fel cyfrinair.

Cyfeirnod dewisiadau

Baneri anfon

Baneri lawrlwytho

Gwerthoedd TTL

Am ddim: 5m 10m 15m 30m 1h 2h 3h 6h 12h 24h 1d 2d 3d 4d 5d 6d 7d

Orbit yn ychwanegu: 14d 15d 28d 30d permanent

Terfyn amser

Rhagosodiad: dim terfyn. Mae trosglwyddiad sy'n stopio yn ailddechrau ohono'i hun, ac yn rhoi'r gorau iddi os na all barhau. Gosodwch derfyn gyda --timeout 30m neu --timeout 2h.

Enghreifftiau

Sgript: gwneud copi wrth gefn ac uwchlwytho

#!/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

Peipio dolen i'r clipfwrdd (macOS)

$ ttl send -p mypass123 file.pdf | pbcopy

Peipio dolen i'r clipfwrdd (Linux)

$ ttl send -p mypass123 file.pdf | xclip -sel clip

Llosgi: cyfrinach un tro

$ echo "$DB_PASSWORD" | ttl send --password-stdin -b -t 5m credentials.env
# mae'r ddolen yn gweithio unwaith yn unig, yn dod i ben mewn 5 munud

Modd JSON (sgriptiau & asiantau DA)

# anfon: cyfrinair yn cael ei gynhyrchu'n awtomatig yn y modd JSON
$ ttl --json send report.pdf
{"ok":true,"link":"https://ttl.space/xK9mQ2vLpA","filename":"report.pdf","size":2097152,"ttl":"7d","burn":false,"uploader_only":false,"is_permanent":false,"password":"aB3kL9mXq7Rt"}

# llwytho i lawr
$ ttl --json get -p aB3kL9mXq7Rt xK9mQ2vLpA
{"ok":true,"filename":"report.pdf","size":2097152,"saved_to":"/home/user/report.pdf"}

# mae gwallau yn dychwelyd ok:false
{"ok":false,"error":"Link not found"}

Ym modd --json, mae'r holl allbwn yn JSON strwythuredig ar stdout. Os na ddarperir cyfrinair wrth anfon, caiff un ei gynhyrchu'n awtomatig a'i gynnwys yn yr ymateb. Y cod ymadael yw 0 ar lwyddiant, 1 ar wall.

Cynllun Orbit

Mae Orbit yn datgloi ffeiliau mwy (10 GB), cadw hirach (30 diwrnod, neu barhaol), ffeiliau i'r uwchlwythwr yn unig (dim ond eich allwedd API chi all eu lawrlwytho) a rheoli ffeiliau (rhestru a dileu). Cymhariaeth lawn: Features.

Mae'r allwedd API yn cael ei chanfod yn awtomatig: newidyn amgylchedd TTL_API_KEY, ttl.key wrth ymyl y rhaglen neu ~/.ttl/key. Defnyddiwch ttl activate i gadw'r allwedd neu ysgrifennwch hi â llaw i un o'r lleoliadau hyn.

# actifadu'ch allwedd: gofynnir amdani heb ei hadleisio, felly nid yw'n mynd i hanes y plisgyn
$ ttl activate
Enter Orbit API key: ********
Orbit plan activated. Key saved to /usr/local/bin/ttl.key
# anrhyngweithiol: ttl activate --key-stdin  |  ttl activate --key-file F

# gwirio cynllun a defnydd
$ ttl plan
Plan: orbit
Max file size: 10.0 GB
Max TTL: 30 days (or permanent)
Uploads per day: 1000000

Usage:
  Uploads today: 3
  Active storage: 1.2 GB / 500.0 GB

# anfon gyda TTL estynedig
$ ttl send -t 30d large-backup.tar.gz
# ffeil barhaol (Orbit yn unig): dim dod i ben, yn cael ei chadw nes i chi ei dileu neu i'ch tanysgrifiad ddod i ben
$ ttl send -t permanent archive.tar.gz
# anfon ffeil breifat: dim ond eich allwedd API chi all ei lawrlwytho (Orbit yn unig)
$ ttl send -u payroll.xlsx

# rhestru uwchlwythiadau diweddar
$ ttl list
  xK9mQ2vLpA    4.2 MB  2026-03-16 10:30 → 2026-04-15 10:30  [active]
  https://ttl.space/xK9mQ2vLpA
  rT7bNw3KpF  912.0 KB  2026-03-15 14:20 → 2026-03-17 14:20  [active (burn)]
  https://ttl.space/rT7bNw3KpF

# dileu ffeil
$ ttl delete xK9mQ2vLpA
Deleted: xK9mQ2vLpA

# tynnu allwedd wedi'i chadw
$ ttl deactivate
Key file removed: /usr/local/bin/ttl.key

HTTP API

Rhestru ffeiliau (Orbit)

$ curl https://ttl.space/v1/files -H "X-API-Key: ttl_orbit_..."
{"files":[{"token":"xK9mQ2vLpA","link":"https://ttl.space/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}

# y dudalen nesaf: dim ond pan fo has_more yn true; pasiwch next_cursor o'r ymateb blaenorol
$ curl "https://ttl.space/v1/files?cursor=1711800600123456" -H "X-API-Key: ttl_orbit_..."

Yn dychwelyd y ffeiliau a uwchlwythwyd gyda'r allwedd hon, y diweddaraf yn gyntaf, 20 y dudalen. Pan fo has_more yn true, mae'r ymateb hefyd yn cynnwys next_cursor; pasiwch ef fel ?cursor= i gael y dudalen nesaf. Mae angen cynllun Orbit.

Dileu ffeil (Orbit)

$ curl -X DELETE https://ttl.space/v1/files/xK9mQ2vLpA -H "X-API-Key: ttl_orbit_..."

Yn dychwelyd 204 No Content ar lwyddiant. Mae angen cynllun Orbit. Rhaid i'r ffeil berthyn i'r allwedd hon.

Ymatebion gwall

Terfynau

Amgryptio

Caiff ffeiliau eu hamgryptio ar eich dyfais cyn eu huwchlwytho. Dim ond testun seiffr y mae'r gweinydd yn ei storio ac ni all ddadgryptio'ch ffeiliau.

Mae unrhyw addasiad i'r testun seiffr yn achosi i'r dadgryptio fethu. Mae'r gweinydd yn gwirio bod y llwythwr i lawr yn gwybod y cyfrinair cywir cyn rhyddhau'r testun seiffr, gan ddefnyddio tocyn unffordd a ddeillir o'r allwedd amgryptio.