diff --git a/README.md b/README.md index 286e87b..82d4417 100644 --- a/README.md +++ b/README.md @@ -28,7 +28,9 @@ LuCI роутера напрямую в интернет открывать не - Несколько роутеров в одной панели. - Online/offline по heartbeat. - В карточке роутера: аптайм, RAM, flash, температура, load, Xray/service. +- Температура подсвечивается цветом: зеленая, желтая, красная. - Кнопка `Админка` для входа в LuCI через VPS. +- Кнопка `SSH` открывает web-terminal прямо из карточки роутера. - Кнопка `OpenWrt config` с готовыми UCI-командами для роутера. - Кнопка `Client JSON` с клиентским Xray-конфигом. - Легкий агент на OpenWrt: shell + CGI, без тяжелого Lua-приложения. @@ -41,7 +43,7 @@ LuCI роутера напрямую в интернет открывать не ```sh sudo apt update -sudo apt install -y curl unzip python3 +sudo apt install -y curl unzip python3 openssh-client sudo bash -c "$(curl -L https://github.com/XTLS/Xray-install/raw/main/install-release.sh)" @ install xray version || /usr/local/bin/xray version ``` @@ -104,8 +106,10 @@ sudo /opt/owrt-remote/owrt-remote-hub.py add-router \ Порты не путать: - `entry_port` задается на VPS в карточке роутера. Он должен быть уникальным: `18080`, `18090`, `18100`. +- `ssh_entry_port` создается автоматически как `entry_port + 1000`: для `18080` будет `19080`, для `18090` будет `19090`. - `vps_port` на OpenWrt обычно один для всех роутеров: `8443`. - `admin_port` на OpenWrt обычно `80`, это локальный порт LuCI внутри роутера. +- `ssh_port` на OpenWrt обычно `22`, это локальный порт SSH/dropbear внутри роутера. Пример второго роутера: @@ -131,10 +135,10 @@ sudo systemctl restart owrt-remote-xray ```sh sudo /opt/owrt-remote/owrt-remote-hub.py render-xray --out /etc/xray/owrt-remote.json sudo systemctl restart owrt-remote-xray -sudo ss -lntp | grep -E ':(8443|18080|18090|18100|18095)\b' +sudo ss -lntp | grep -E ':(8443|18080|18090|18100|18095|19080|19090|19095)\b' ``` -Для роутера с `entry 18095` в выводе должен появиться `127.0.0.1:18095`. +Для роутера с `entry 18095` в выводе должны появиться `127.0.0.1:18095` для LuCI и `127.0.0.1:19095` для SSH. Сгенерировать Xray config для VPS: @@ -181,6 +185,8 @@ sudo ufw allow 8443/tcp | `18080/tcp` | VPS localhost | вход к первому роутеру через Hub | нет | | `18090/tcp` | VPS localhost | вход ко второму роутеру через Hub | нет | | `18100/tcp` | VPS localhost | вход к третьему роутеру через Hub | нет | +| `19080/tcp` | VPS localhost | SSH к первому роутеру через web-terminal | нет | +| `19090/tcp` | VPS localhost | SSH ко второму роутеру через web-terminal | нет | Если у VPS-провайдера есть отдельный firewall в личном кабинете, там тоже открой `8088/tcp` и `8443/tcp`. @@ -190,7 +196,38 @@ sudo ufw allow 8443/tcp sudo ss -lntp | grep -E ':(8088|8443|18080|18090|18100)\b' ``` -Порты `18080`, `18090`, `18100` должны слушать только `127.0.0.1`. Наружу нужны `8088` для Hub и `8443` для Xray. +Порты `18080`, `18090`, `18100`, `19080`, `19090` должны слушать только `127.0.0.1`. Наружу нужны `8088` для Hub и `8443` для Xray. + +## SSH web-terminal + +В карточке online-роутера кнопка `SSH` открывает терминал в браузере. + +Как это устроено: + +- LuCI идет через `entry_port`, например `18080`. +- SSH идет через `ssh_entry_port`, например `19080`. +- Hub сам подключается к `root@127.0.0.1:19080` на VPS. +- Через Xray reverse это попадает в SSH/dropbear роутера на `127.0.0.1:22`. + +После обновления обязательно обнови обе стороны: + +```sh +# VPS +sudo /opt/owrt-remote/owrt-remote-hub.py render-xray --out /etc/xray/owrt-remote.json +sudo systemctl restart owrt-remote-xray + +# OpenWrt +owrt-remote render-client +/etc/init.d/owrt-remote restart +owrt-remote heartbeat +``` + +Если кнопка `SSH` серая, проверь на роутере: + +```sh +/etc/init.d/dropbear status +owrt-remote heartbeat +``` ## Установка на OpenWrt diff --git a/files/etc/config/owrtremote b/files/etc/config/owrtremote index 983c629..697dcc3 100644 --- a/files/etc/config/owrtremote +++ b/files/etc/config/owrtremote @@ -16,5 +16,6 @@ config remote 'main' option reverse_tag 'reverse-in' option admin_host '127.0.0.1' option admin_port '80' + option ssh_host '127.0.0.1' + option ssh_port '22' option public_url '' - diff --git a/files/usr/sbin/owrt-remote b/files/usr/sbin/owrt-remote index 90608f0..650f459 100644 --- a/files/usr/sbin/owrt-remote +++ b/files/usr/sbin/owrt-remote @@ -268,7 +268,7 @@ service_enabled() { } render_client_config() { - local out stdout router_id vps_host vps_port uuid encryption flow reverse_tag admin_host admin_port xray_config + local out stdout router_id vps_host vps_port uuid encryption flow reverse_tag admin_host admin_port ssh_host ssh_port xray_config stdout="0" if [ "${1:-}" = "--stdout" ]; then stdout="1" @@ -283,6 +283,8 @@ render_client_config() { reverse_tag="$(safe_id "$(uci_get reverse_tag reverse-in)")" admin_host="$(uci_get admin_host 127.0.0.1)" admin_port="$(safe_num "$(uci_get admin_port 80)" 80)" + ssh_host="$(uci_get ssh_host 127.0.0.1)" + ssh_port="$(safe_num "$(uci_get ssh_port 22)" 22)" xray_config="$(uci_get xray_config /etc/xray/owrt-remote-client.json)" [ -n "$vps_host" ] || die "vps_host пустой" @@ -300,13 +302,18 @@ render_client_config() { "tag": "router-admin", "protocol": "freedom", "settings": { - "redirect": "$(json_escape "$admin_host"):$admin_port", "finalRules": [ { "action": "allow", "network": "tcp", "ip": "$(json_escape "$admin_host")", "port": "$admin_port" + }, + { + "action": "allow", + "network": "tcp", + "ip": "$(json_escape "$ssh_host")", + "port": "$ssh_port" } ] } @@ -409,6 +416,8 @@ heartbeat_json() { "public_url": $(json_string "$public_url"), "admin_host": $(json_string "$(uci_get admin_host 127.0.0.1)"), "admin_port": $(safe_num "$(uci_get admin_port 80)" 80), + "ssh_host": $(json_string "$(uci_get ssh_host 127.0.0.1)"), + "ssh_port": $(safe_num "$(uci_get ssh_port 22)" 22), "hub_url": $(json_string "$hub_url"), "uptime": $(safe_num "$(uptime_seconds)" 0), "load": $(json_string "$(load_text)"), diff --git a/files/www/cgi-bin/owrt-remote b/files/www/cgi-bin/owrt-remote index 968e758..7659c0a 100644 --- a/files/www/cgi-bin/owrt-remote +++ b/files/www/cgi-bin/owrt-remote @@ -2,7 +2,7 @@ KEY_FILE="${KEY_FILE:-/etc/owrt-remote/web.key}" AGENT="${AGENT:-/usr/sbin/owrt-remote}" -OWRT_REMOTE_UI_VERSION="2026-06-29-openwrt-remote-hub-v14" +OWRT_REMOTE_UI_VERSION="2026-06-29-ssh-terminal-v15" PARAMS_FILE="${TMPDIR:-/tmp}/owrt-remote-cgi.$$" RESULT_TITLE="" RESULT_BODY="" diff --git a/vps/owrt-remote-hub.py b/vps/owrt-remote-hub.py index 8898a6b..03d850f 100644 --- a/vps/owrt-remote-hub.py +++ b/vps/owrt-remote-hub.py @@ -1,5 +1,6 @@ #!/usr/bin/env python3 import argparse +import base64 import datetime as dt import hashlib import html @@ -7,7 +8,10 @@ import http.client import json import os import secrets +import select +import signal import sqlite3 +import struct import subprocess import sys import time @@ -28,7 +32,9 @@ DEFAULT_VLESS_PORT = int(os.environ.get("OWRT_REMOTE_VLESS_PORT", "8443")) PBKDF2_ITERATIONS = 240000 MIN_PASSWORD_LENGTH = 4 SESSION_COOKIE = "owrt_remote_session" +ROUTER_COOKIE = "owrt_remote_router" LUCI_ABSOLUTE_ROOTS = ("/ubus", "/cgi-bin/luci", "/luci-static") +WS_GUID = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11" def now_ts(): @@ -194,6 +200,9 @@ def init_db(conn): public_url text not null default '', admin_host text not null default '127.0.0.1', admin_port integer not null default 80, + ssh_entry_port integer not null default 0, + ssh_host text not null default '127.0.0.1', + ssh_port integer not null default 22, created_at integer not null, updated_at integer not null, last_seen integer, @@ -201,17 +210,40 @@ def init_db(conn): ) """ ) + ensure_column(conn, "routers", "ssh_entry_port", "integer not null default 0") + ensure_column(conn, "routers", "ssh_host", "text not null default '127.0.0.1'") + ensure_column(conn, "routers", "ssh_port", "integer not null default 22") + conn.execute( + """ + update routers + set ssh_entry_port = entry_port + 1000 + where entry_port > 0 and (ssh_entry_port is null or ssh_entry_port = 0) + """ + ) conn.commit() +def ensure_column(conn, table, column, definition): + cols = {row["name"] for row in conn.execute(f"pragma table_info({table})")} + if column not in cols: + conn.execute(f"alter table {table} add column {column} {definition}") + + def get_router(conn, router_id): return conn.execute("select * from routers where id = ?", (router_id,)).fetchone() def get_router_by_entry_port(conn, entry_port, exclude_id=""): return conn.execute( - "select * from routers where entry_port = ? and id != ?", - (int(entry_port), exclude_id), + "select * from routers where (entry_port = ? or ssh_entry_port = ?) and id != ?", + (int(entry_port), int(entry_port), exclude_id), + ).fetchone() + + +def get_router_by_any_port(conn, port, exclude_id=""): + return conn.execute( + "select * from routers where (entry_port = ? or ssh_entry_port = ?) and id != ?", + (int(port), int(port), exclude_id), ).fetchone() @@ -236,6 +268,7 @@ def row_to_router(row): data["online"] = online data["last_seen_iso"] = iso_time(last_seen) data["access_url"] = f"/access/{urllib.parse.quote(data['id'])}/" + data["ssh_url"] = f"/ssh/{urllib.parse.quote(data['id'])}/" data["config_url"] = f"/router/{urllib.parse.quote(data['id'])}/config" data["xray_client_url"] = f"/router/{urllib.parse.quote(data['id'])}/xray-client.json" data.pop("status_json", None) @@ -278,6 +311,9 @@ def upsert_router(conn, values): "public_url": keep_str("public_url", ""), "admin_host": keep_str("admin_host", "127.0.0.1"), "admin_port": keep_int("admin_port", 80), + "ssh_entry_port": keep_int("ssh_entry_port", int(values.get("entry_port") or 0) + 1000 if values.get("entry_port") else 0), + "ssh_host": keep_str("ssh_host", "127.0.0.1"), + "ssh_port": keep_int("ssh_port", 22), "updated_at": ts, } if current: @@ -297,6 +333,9 @@ def upsert_router(conn, values): public_url = :public_url, admin_host = :admin_host, admin_port = :admin_port, + ssh_entry_port = :ssh_entry_port, + ssh_host = :ssh_host, + ssh_port = :ssh_port, updated_at = :updated_at where id = :id """, @@ -309,11 +348,13 @@ def upsert_router(conn, values): insert into routers ( id, name, role, entry_port, vps_host, vless_port, vless_uuid, vless_encryption, vless_decryption, vless_flow, reverse_tag, - public_url, admin_host, admin_port, created_at, updated_at + public_url, admin_host, admin_port, ssh_entry_port, ssh_host, ssh_port, + created_at, updated_at ) values ( :id, :name, :role, :entry_port, :vps_host, :vless_port, :vless_uuid, :vless_encryption, :vless_decryption, :vless_flow, :reverse_tag, - :public_url, :admin_host, :admin_port, :created_at, :updated_at + :public_url, :admin_host, :admin_port, :ssh_entry_port, :ssh_host, :ssh_port, + :created_at, :updated_at ) """, payload, @@ -337,6 +378,8 @@ def heartbeat(conn, payload): "vps_host": payload.get("vps_host") or "", "admin_host": payload.get("admin_host") or "127.0.0.1", "admin_port": payload.get("admin_port") or 80, + "ssh_host": payload.get("ssh_host") or "127.0.0.1", + "ssh_port": payload.get("ssh_port") or 22, }, ) conn.execute( @@ -347,6 +390,8 @@ def heartbeat(conn, payload): public_url = coalesce(nullif(?, ''), public_url), admin_host = coalesce(nullif(?, ''), admin_host), admin_port = coalesce(?, admin_port), + ssh_host = coalesce(nullif(?, ''), ssh_host), + ssh_port = coalesce(?, ssh_port), last_seen = ?, status_json = ?, updated_at = ? @@ -358,6 +403,8 @@ def heartbeat(conn, payload): payload.get("public_url") or "", payload.get("admin_host") or "", int(payload["admin_port"]) if str(payload.get("admin_port", "")).isdigit() else None, + payload.get("ssh_host") or "", + int(payload["ssh_port"]) if str(payload.get("ssh_port", "")).isdigit() else None, ts, json.dumps(payload, ensure_ascii=False, separators=(",", ":")), ts, @@ -393,6 +440,7 @@ def make_server_xray_config(rows, listen_host="0.0.0.0", listen_port=DEFAULT_VLE entry_port = int(row["entry_port"] or 0) if entry_port <= 0: continue + ssh_entry_port = int(row["ssh_entry_port"] or 0) reverse_out = f"reverse-{router_id}" portal_in = f"entry-{router_id}" client = { @@ -425,6 +473,28 @@ def make_server_xray_config(rows, listen_host="0.0.0.0", listen_port=DEFAULT_VLE "outboundTag": reverse_out, } ) + if ssh_entry_port > 0: + ssh_in = f"ssh-{router_id}" + inbounds.append( + { + "tag": ssh_in, + "listen": "127.0.0.1", + "port": ssh_entry_port, + "protocol": "tunnel", + "settings": { + "allowedNetwork": "tcp", + "rewriteAddress": row["ssh_host"] or "127.0.0.1", + "rewritePort": int(row["ssh_port"] or 22), + }, + } + ) + rules.append( + { + "type": "field", + "inboundTag": [ssh_in], + "outboundTag": reverse_out, + } + ) return { "log": {"loglevel": "warning"}, @@ -445,13 +515,18 @@ def make_router_xray_config(row): "tag": "router-admin", "protocol": "freedom", "settings": { - "redirect": f"{row['admin_host']}:{int(row['admin_port'])}", "finalRules": [ { "action": "allow", "network": "tcp", "ip": row["admin_host"], "port": str(int(row["admin_port"])), + }, + { + "action": "allow", + "network": "tcp", + "ip": row["ssh_host"] or "127.0.0.1", + "port": str(int(row["ssh_port"] or 22)), } ], }, @@ -531,6 +606,8 @@ def make_openwrt_config(row, hub_url): f"uci set owrtremote.main.reverse_tag='{sh_quote(row['reverse_tag'])}'", f"uci set owrtremote.main.admin_host='{sh_quote(row['admin_host'])}'", f"uci set owrtremote.main.admin_port='{int(row['admin_port'])}'", + f"uci set owrtremote.main.ssh_host='{sh_quote(row['ssh_host'] or '127.0.0.1')}'", + f"uci set owrtremote.main.ssh_port='{int(row['ssh_port'] or 22)}'", f"uci set owrtremote.main.public_url='{sh_quote(row['public_url'])}'", "uci commit owrtremote", "owrt-remote render-client", @@ -559,12 +636,67 @@ def clean_forward_cookie(cookie_header): for chunk in (cookie_header or "").split(";"): if not chunk.strip(): continue - if chunk.strip().startswith("owrt_remote_admin=") or chunk.strip().startswith(f"{SESSION_COOKIE}="): + if ( + chunk.strip().startswith("owrt_remote_admin=") + or chunk.strip().startswith(f"{SESSION_COOKIE}=") + or chunk.strip().startswith(f"{ROUTER_COOKIE}=") + ): continue parts.append(chunk.strip()) return "; ".join(parts) +def current_router_cookie(router_id): + return f"{ROUTER_COOKIE}={urllib.parse.quote(router_id)}; HttpOnly; SameSite=Lax; Path=/" + + +def ws_accept_value(key): + raw = hashlib.sha1((key + WS_GUID).encode("ascii")).digest() + return base64.b64encode(raw).decode("ascii") + + +def recv_exact(sock, size): + chunks = [] + left = size + while left > 0: + chunk = sock.recv(left) + if not chunk: + raise ConnectionError("websocket closed") + chunks.append(chunk) + left -= len(chunk) + return b"".join(chunks) + + +def ws_read_frame(sock): + head = recv_exact(sock, 2) + first, second = head[0], head[1] + opcode = first & 0x0F + masked = bool(second & 0x80) + length = second & 0x7F + if length == 126: + length = struct.unpack("!H", recv_exact(sock, 2))[0] + elif length == 127: + length = struct.unpack("!Q", recv_exact(sock, 8))[0] + mask = recv_exact(sock, 4) if masked else b"" + payload = recv_exact(sock, length) if length else b"" + if masked and payload: + payload = bytes(b ^ mask[i % 4] for i, b in enumerate(payload)) + return opcode, payload + + +def ws_send_frame(sock, payload, opcode=1): + if isinstance(payload, str): + payload = payload.encode("utf-8", errors="replace") + length = len(payload) + if length < 126: + head = struct.pack("!BB", 0x80 | opcode, length) + elif length < 65536: + head = struct.pack("!BBH", 0x80 | opcode, 126, length) + else: + head = struct.pack("!BBQ", 0x80 | opcode, 127, length) + sock.sendall(head + payload) + + def dashboard_html(routers, username): routers_json = json.dumps(routers, ensure_ascii=False) safe_username = html.escape(username, quote=True) @@ -591,7 +723,7 @@ input,select{{min-width:0;border:1px solid var(--line);border-radius:8px;padding @keyframes onlineGlow{{0%,100%{{transform:scale(.9);opacity:.55}}50%{{transform:scale(1.08);opacity:1}}}} .cardTop{{display:flex;align-items:flex-start;justify-content:space-between;gap:12px}}.routerMark{{display:grid;place-items:center;width:46px;height:46px;border-radius:8px;border:1px solid rgba(255,255,255,.14);background:rgba(255,255,255,.08)}}.routerIcon{{position:relative;width:28px;height:18px;border:2px solid #ddd6fe;border-radius:5px}}.routerIcon::before,.routerIcon::after{{content:"";position:absolute;top:-9px;width:9px;height:9px;border-top:2px solid #ddd6fe}}.routerIcon::before{{left:2px;transform:rotate(-34deg)}}.routerIcon::after{{right:2px;transform:rotate(34deg)}}.routerIcon span{{position:absolute;left:5px;right:5px;bottom:4px;display:flex;justify-content:space-between}}.routerIcon span::before,.routerIcon span::after{{content:"";width:4px;height:4px;border-radius:50%;background:#ddd6fe}} .status{{display:inline-flex;align-items:center;gap:7px;border-radius:999px;border:1px solid rgba(34,197,94,.36);background:rgba(34,197,94,.14);padding:7px 10px;font-weight:900;font-size:12px;color:#bbf7d0}}.status i{{width:8px;height:8px;border-radius:50%;background:var(--green);box-shadow:0 0 13px var(--green);animation:statusPulse 1.6s ease-in-out infinite}}.status.off{{border-color:rgba(251,113,133,.36);background:rgba(251,113,133,.12);color:#fecdd3}}.status.off i{{background:var(--red);box-shadow:0 0 13px var(--red);animation:none}}.status.warn i{{background:var(--amber);box-shadow:0 0 13px var(--amber)}}@keyframes statusPulse{{0%,100%{{transform:scale(1);opacity:.75}}50%{{transform:scale(1.45);opacity:1}}}}.name{{margin:12px 0 0;font-size:19px;font-weight:900;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}}.metaLine{{margin-top:3px;color:var(--muted)}}.tagRow{{display:flex;gap:8px;flex-wrap:wrap;margin-top:12px}}.tag{{border:1px solid var(--line);border-radius:999px;padding:5px 9px;background:rgba(255,255,255,.06);color:#ddd6fe;font-size:12px;font-weight:750}} -.metrics{{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px;margin-top:14px}}.metric{{border:1px solid var(--line);border-radius:8px;background:rgba(255,255,255,.055);padding:9px}}.metric.span2{{grid-column:span 2}}.metric span{{display:block;color:var(--muted);font-size:11px}}.metric strong{{display:block;margin-top:2px;font-size:14px;word-break:break-word}}.actions{{display:flex;gap:8px;flex-wrap:wrap;margin-top:14px}}.empty{{grid-column:1/-1;border:1px dashed var(--line);border-radius:8px;padding:30px;background:linear-gradient(180deg,rgba(255,255,255,.08),rgba(255,255,255,.045)),var(--panel);text-align:center;color:var(--muted)}}.hint{{margin-top:16px;padding:13px;border:1px solid var(--line);border-radius:8px;background:linear-gradient(180deg,rgba(255,255,255,.08),rgba(255,255,255,.045)),var(--panel);color:var(--muted)}}code{{background:rgba(255,255,255,.10);border-radius:6px;padding:2px 5px;color:#f3e8ff}} +.metrics{{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px;margin-top:14px}}.metric{{border:1px solid var(--line);border-radius:8px;background:rgba(255,255,255,.055);padding:9px}}.metric.span2{{grid-column:span 2}}.metric.temp-ok{{border-color:rgba(34,197,94,.48);background:rgba(34,197,94,.12)}}.metric.temp-ok strong{{color:#bbf7d0}}.metric.temp-warn{{border-color:rgba(245,158,11,.58);background:rgba(245,158,11,.13)}}.metric.temp-warn strong{{color:#fde68a}}.metric.temp-bad{{border-color:rgba(251,113,133,.58);background:rgba(251,113,133,.14)}}.metric.temp-bad strong{{color:#fecdd3}}.metric span{{display:block;color:var(--muted);font-size:11px}}.metric strong{{display:block;margin-top:2px;font-size:14px;word-break:break-word}}.actions{{display:flex;gap:8px;flex-wrap:wrap;margin-top:14px}}.empty{{grid-column:1/-1;border:1px dashed var(--line);border-radius:8px;padding:30px;background:linear-gradient(180deg,rgba(255,255,255,.08),rgba(255,255,255,.045)),var(--panel);text-align:center;color:var(--muted)}}.hint{{margin-top:16px;padding:13px;border:1px solid var(--line);border-radius:8px;background:linear-gradient(180deg,rgba(255,255,255,.08),rgba(255,255,255,.045)),var(--panel);color:var(--muted)}}code{{background:rgba(255,255,255,.10);border-radius:6px;padding:2px 5px;color:#f3e8ff}} @media(max-width:980px){{.cards{{grid-template-columns:repeat(2,minmax(0,1fr))}}.toolbar,.authGrid{{grid-template-columns:1fr 1fr}}.card.main{{grid-column:span 2}}.top{{flex-direction:column}}.headerActions{{padding-top:0;justify-content:flex-start}}}} @media(max-width:680px){{.wrap{{padding:14px}}.cards,.toolbar,.authGrid{{grid-template-columns:1fr}}.card.main{{grid-column:span 1}}.top,.sectionHead{{align-items:flex-start;flex-direction:column}}.headerActions,.summary{{justify-content:flex-start}}.links a,.badge{{width:100%;min-width:0}}h1{{font-size:24px}}}} @@ -683,6 +815,14 @@ function metric(label, value, cls = '') {{ return `