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: aB3kL9mX
·✧★◉ Thank goodness, secret.pdf is in orbit (1.2 MB)
IMPORTANT! Save your password — required to download and decrypt the file.
Password: aB3kL9mX
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/latest/download/ttl_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 v1.3.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 dileu'n barhaol ar ol y lawrlwythiad cyntaf
$ 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.

Tocyn yn unig

# gallwch ddefnyddio'r tocyn 10 nod yn unig yn lle'r URL llawn
$ ttl get aBcDeFgHiJ
Enter password: ********
Password verified
◉★✧· Phew, document.pdf landed safe and sound (4.2 MB)

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 llyfrgell amgryptio 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 pum 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: aB3kL9mX

Yn creu cyfrinair 8 nod ar hap yn gryptograffig o [0-9A-Za-z]. Ar gael yn unig wrth wneud send mewn terfynell.

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

Terfyn amser

Rhagosodiad: awtomatig — wedi'i amcangyfrif o faint y ffeil gan dybio 1 Mbps + 2 funud o ymyl (lleiafswm 5 munud). Diystyru gyda --timeout 10m neu --timeout 1h.

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,"password":"aB3kL9mX"}

# llwytho i lawr
$ ttl --json get -p aB3kL9mX 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

Orbit yn datgloi ffeiliau mwy (10 GB), cadw hirach (30 diwrnod) a rheoli ffeiliau (rhestru a dileu).

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
$ ttl activate ttl_orbit_aBcDeFgHiJ...
Orbit plan activated. Key saved to /usr/local/bin/ttl.key

# gwirio cynllun a defnydd
$ ttl plan
Plan: orbit
Max file size: 10.0 GB
Max TTL: 30 days
Uploads per day: Unlimited

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

# anfon gyda TTL estynedig
$ ttl send -t 30d large-backup.tar.gz

# 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}]}

Yn dychwelyd yr holl ffeiliau a uwchlwythwyd gyda'r allwedd hon. 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.