Skip to content

connect agent share

connect agent share

Instantly share a local file or directory via a secure tunnel

Synopsis

Share a local file or directory by establishing a reverse tunnel and printing the public URL. The tunnel is active until interrupted with Ctrl+C.

By default the tunnel is reachable at share..dioad.dev. Use --subdomain to request a specific name (honoured by the server if you have the privilege).

For single files, the URI path is prefixed with the first 16 hex characters of the file's SHA-256 digest, making the URL unguessable and letting recipients verify integrity. Disable with --sha-path=false.

Use --count to limit how many times the file may be downloaded before the tunnel stops automatically (single files only).

Each download is logged to stdout with the timestamp, client IP, user agent, status code, bytes transferred, and duration.

connect agent share <path> [flags]

Options

  -c, --config string           config file (default "$HOME/.config/dioad/connect/agent.yaml")
      --count int               Limit downloads to N (files only, 0 = unlimited)
  -h, --help[=true|false]       help for share
      --qr[=true|false]         Print a QR code for the share URL
      --sha-path[=true|false]   Prefix URI path with file SHA-256 (default: true) (default true)
      --subdomain string        Requested tunnel subdomain (default: "share")

SEE ALSO