From 79d2d45867cbbe12d9c617619bc91e9b1a06ab92 Mon Sep 17 00:00:00 2001
From: ed <s@ocv.me>
Date: Tue, 10 Oct 2023 03:17:33 +0000
Subject: [PATCH] r0c the web

---
 README.md           |   9 ++++-
 docs/r0cc.png       | Bin 0 -> 8150 bytes
 webtty/README.md    |  22 ++++++++++
 webtty/internals.sh |   1 +
 webtty/webr0c.sh    |  95 ++++++++++++++++++++++++++++++++++++++++++++
 5 files changed, 126 insertions(+), 1 deletion(-)
 create mode 100644 docs/r0cc.png
 create mode 100644 webtty/README.md
 create mode 120000 webtty/internals.sh
 create mode 100755 webtty/webr0c.sh

diff --git a/README.md b/README.md
index aa8c345..d06e22e 100644
--- a/README.md
+++ b/README.md
@@ -82,6 +82,12 @@ if you enable TLS with `-tpt 2424` (telnet) and/or `-tpn 1515` (netcat) you can
 
 the powershell client and bash client comes bundled with the server; see [protips](#protips)
 
+## connecting from a web browser
+
+![screenshot of chrome connecting to r0c through ttyd](docs/r0cc.png)
+
+oh you betcha! see the [webtty readme](webtty/)
+
 
 # installation
 
@@ -105,7 +111,7 @@ skip this section if:
 if you're using firewalld, and just want to open up the high ports (not 23 and 531) then this is probably enough:
 
 ```bash
-firewall-cmd --permanent --add-port={23,531,2323,1531,2424,1515}/tcp
+firewall-cmd --permanent --add-port={23,531,2323,1531,2424,1515,8023}/tcp
 firewall-cmd --reload
 ```
 
@@ -120,6 +126,7 @@ iptables -A INPUT -p tcp --dport 2323 -m state --state NEW -j ACCEPT
 iptables -A INPUT -p tcp --dport 1531 -m state --state NEW -j ACCEPT
 iptables -A INPUT -p tcp --dport 2424 -m state --state NEW -j ACCEPT  # tls telnet
 iptables -A INPUT -p tcp --dport 1515 -m state --state NEW -j ACCEPT  # tls netcat
+iptables -A INPUT -p tcp --dport 8023 -m state --state NEW -j ACCEPT  # http/ttyd
 iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 23 -j REDIRECT --to-port 2323
 iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 531 -j REDIRECT --to-port 1531
 ```
diff --git a/docs/r0cc.png b/docs/r0cc.png
new file mode 100644
index 0000000000000000000000000000000000000000..83fe1b39995fa1bdca25105f53c9dd0ce5389101
GIT binary patch
literal 8150
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
E55oI|vH$=8

literal 0
HcmV?d00001

diff --git a/webtty/README.md b/webtty/README.md
new file mode 100644
index 0000000..38f0193
--- /dev/null
+++ b/webtty/README.md
@@ -0,0 +1,22 @@
+# accessing r0c from a web browser
+
+![screenshot of chrome connecting to r0c through ttyd](../docs/r0cc.png)
+
+an actual web-UI will probably happen eventually, but now is not the time
+
+instead let's do something way more fun:
+
+first download [ttyd v1.7.1](https://github.com/tsl0922/ttyd/releases/tag/1.7.1), you probably want [ttyd.x86_64](https://github.com/tsl0922/ttyd/releases/download/1.7.1/ttyd.x86_64)
+* latest version is probably fine too but that only works on very recent browsers
+
+then drop that binary into this folder, and add r0c.py as well
+
+and finally run this command: [`./webr0c.sh`](webr0c.sh)
+
+now you can r0c from your browser at http://127.0.0.1:8023/
+
+
+## notes
+
+the ttyd binary shrinks to 50% when compressed with `upx --lzma ttyd.x86_64`
+
diff --git a/webtty/internals.sh b/webtty/internals.sh
new file mode 120000
index 0000000..3ccc7dc
--- /dev/null
+++ b/webtty/internals.sh
@@ -0,0 +1 @@
+../clients/bash.sh
\ No newline at end of file
diff --git a/webtty/webr0c.sh b/webtty/webr0c.sh
new file mode 100755
index 0000000..bccf4b9
--- /dev/null
+++ b/webtty/webr0c.sh
@@ -0,0 +1,95 @@
+#!/bin/bash
+set -e
+
+# fixed set of arguments to always give ttyd;
+# * don't reconnect if the user quits
+# * the bifrost color scheme :^)
+ttyd_fargs=(
+    -t disableReconnect=true
+    -t 'theme={"background":"#222","black":"#404040","red":"#f03669","green":"#b8e346","yellow":"#ffa402","blue":"#02a2ff","magenta":"#f65be3","cyan":"#3da698","white":"#d2d2d2","brightBlack":"#606060","brightRed":"#c75b79","brightGreen":"#c8e37e","brightYellow":"#ffbe4a","brightBlue":"#71cbff","brightMagenta":"#b67fe3","brightCyan":"#9cf0ed","brightWhite":"#fff"}'
+)
+
+# then the additional arguments to give ttyd by default;
+# * listen on port 8023, http://127.0.0.1:8023/
+# * window title = r0c
+# * disable some stuff we don't want
+ttyd_args=(
+    -p 8023
+    -t titleFixed=r0c
+    -t enableSixel=false
+    -t enableTrzsz=false
+    -t enableZmodem=false
+    -t disableResizeOverlay=true
+)
+
+# then the arguments to give r0c if nothing is given to the script;
+# --ara is recommended because otherwise everyone will be admin
+r0c_args=(
+    --ara
+)
+
+# now, if this script is executed with any arguments at all, then the
+# default r0c_args will be cleared and replaced with those, however
+# you can also specify ttyd_args by separating them with "--";
+# that way ttyd gets everything before that and r0c gets the rest:
+#  ./webr0c.sh -p 8023 -- --ara -tpt 2424 -tpn 1515
+
+if [ "$1" ]; then
+    r0c_args=()
+    while [ "$1" ]; do
+        [ "$1" = -- ] && {
+            ttyd_args=("${r0c_args[@]}")
+            r0c_args=()
+            shift
+            continue
+        }
+        r0c_args+=("$1")
+        shift
+    done
+fi
+
+ttyd_args+=("${ttyd_fargs[@]}")  # append the fixed set of args
+
+echo "will run ttyd with args [${ttyd_args[*]}]"
+echo "will run r0c with args [${r0c_args[*]}]"
+
+########################################################################
+
+# ensure we cleanup on exit
+pids=()
+trap 'kill ${pids[@]} 2>/dev/null;sleep 0.1' INT TERM EXIT
+
+# first check if ttyd is installed system-wide,
+# otherwise try ./ttyd.x86_64, and if that also fails
+# just assume exactly one other binary is present
+ttyd=$(command -v ttyd || echo ./ttyd.x86_64)
+[ -e $ttyd ] || ttyd=./ttyd.*
+
+if command -v telnet >/dev/null; then
+    # found telnet;
+    # connect to port 23 if root, 2323 otherwise
+    [ $(id -u) -eq 0 ] && p=23 || p=2323
+    $ttyd "${ttyd_args[@]}" telnet 127.0.0.1 $p &
+else
+    # telnet not found; using bash instead,
+    # connect to port 531 if root, 1531 otherwise
+    [ $(id -u) -eq 0 ] && p=531 || p=1531
+    $ttyd "${ttyd_args[@]}" ./internals.sh 127.0.0.1 $p &
+fi
+
+pids+=($!)
+
+# now it's time to start r0c,
+# first check if installed system-wide,
+# then try ./r0c.py, and panic if that also fails
+if python3 -c 'import r0c' 2>/dev/null; then
+    python3 -m r0c "${r0c_args[@]}" &
+else
+    python3 r0c.py "${r0c_args[@]}" &
+fi
+
+pids+=($!)
+
+# if either r0c or ttyd exits, kill the other
+wait -n
+kill ${pids[@]}