diff options
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 19 |
1 files changed, 14 insertions, 5 deletions
@@ -1,4 +1,9 @@ -![backend](https://github.com/tsl0922/ttyd/workflows/backend/badge.svg) ![frontend](https://github.com/tsl0922/ttyd/workflows/frontend/badge.svg) [![Packaging status](https://repology.org/badge/tiny-repos/ttyd.svg)](https://repology.org/project/ttyd/versions) +![backend](https://github.com/tsl0922/ttyd/workflows/backend/badge.svg) +![frontend](https://github.com/tsl0922/ttyd/workflows/frontend/badge.svg) +[![GitHub Releases](https://img.shields.io/github/downloads/tsl0922/ttyd/total)](https://github.com/tsl0922/ttyd/releases) +[![Docker Pulls](https://img.shields.io/docker/pulls/tsl0922/ttyd)](https://hub.docker.com/r/tsl0922/ttyd) +[![Packaging status](https://repology.org/badge/tiny-repos/ttyd.svg)](https://repology.org/project/ttyd/versions) +![GitHub](https://img.shields.io/github/license/tsl0922/ttyd) # ttyd - Share your terminal over the web @@ -32,7 +37,8 @@ ttyd is a simple command-line tool for sharing terminal over the web. - Install the snap: `sudo snap install ttyd --classic` - Build from source (debian/ubuntu): ```bash - sudo apt-get install build-essential cmake git libjson-c-dev libwebsockets-dev + sudo apt-get update + sudo apt-get install -y build-essential cmake git libjson-c-dev libwebsockets-dev git clone https://github.com/tsl0922/ttyd.git cd ttyd && mkdir build && cd build cmake .. @@ -59,12 +65,15 @@ USAGE: OPTIONS: -p, --port Port to listen (default: 7681, use `0` for random port) -i, --interface Network interface to bind (eg: eth0), or UNIX domain socket path (eg: /var/run/ttyd.sock) - -c, --credential Credential for Basic Authentication (format: username:password) + -U, --socket-owner User owner of the UNIX domain socket file, when enabled (eg: user:group) + -c, --credential Credential for basic authentication (format: username:password) + -H, --auth-header HTTP Header name for auth proxy, this will configure ttyd to let a HTTP reverse proxy handle authentication -u, --uid User id to run with -g, --gid Group id to run with -s, --signal Signal to send to the command when exit it (default: 1, SIGHUP) + -w, --cwd Working directory to be set for the child program -a, --url-arg Allow client to send command line arguments in URL (eg: http://localhost:7681?arg=foo&arg=bar) - -R, --readonly Do not allow clients to write to the TTY + -W, --writable Allow clients to write to the TTY (readonly by default) -t, --client-option Send option to client (format: key=value), repeat to add more options -T, --terminal-type Terminal type to report, default: xterm-256color -O, --check-origin Do not allow websocket connection from different origin @@ -73,7 +82,7 @@ OPTIONS: -B, --browser Open terminal with the default system browser -I, --index Custom index.html path -b, --base-path Expected base path for requests coming from a reverse proxy (eg: /mounted/here, max length: 128) - -P, --ping-interval Websocket ping interval(sec) (default: 300) + -P, --ping-interval Websocket ping interval(sec) (default: 5) -6, --ipv6 Enable IPv6 support -S, --ssl Enable SSL -C, --ssl-cert SSL certificate file path |