From ef6d9e7d7607689b650fcf4bcbb7338cbff854b9 Mon Sep 17 00:00:00 2001 From: kzolotarev95 Date: Tue, 30 Jun 2026 11:15:09 +0400 Subject: [PATCH] Add one-command uninstall docs --- README.md | 114 +++++++++++++++++++++++++++++++++++++++++-- vps/uninstall-vps.sh | 99 +++++++++++++++++++++++++++++++++++++ 2 files changed, 208 insertions(+), 5 deletions(-) create mode 100755 vps/uninstall-vps.sh diff --git a/README.md b/README.md index 1999db8..94c05fb 100644 --- a/README.md +++ b/README.md @@ -10,14 +10,23 @@ ## Что это -Схема работы: +`OpenWrt Remote Hub` - это легкая панель для удаленного доступа к OpenWrt через свой VPS. +Роутер сам подключается к VPS изнутри сети, поэтому наружу LuCI и SSH на роутере открывать не нужно. -```text -Браузер -> VPS Hub -> Xray reverse -> OpenWrt LuCI / SSH +## Схема работы + +```mermaid +flowchart LR + browser["Браузер / телефон"] --> hub["VPS
OpenWrt Remote Hub
80 / 8088"] + hub --> luciEntry["127.0.0.1:18080
LuCI entry-port"] + hub --> sshEntry["127.0.0.1:19080
SSH entry-port"] + luciEntry --> xray["Xray VLESS reverse
8443"] + sshEntry --> xray + xray --> router["OpenWrt роутер"] + router --> luci["LuCI
127.0.0.1:80"] + router --> ssh["Dropbear SSH
127.0.0.1:22"] ``` -Роутер сам подключается к VPS изнутри сети. Наружу LuCI и SSH на роутере открывать не нужно. - В панели VPS можно: - видеть все роутеры красивыми карточками; @@ -36,6 +45,45 @@ Пароль можно поменять в панели Hub. +## Дерево проекта + +```text +. +├── install.sh +│ └── установка агента на OpenWrt +├── uninstall.sh +│ └── удаление агента с OpenWrt +├── files/ +│ ├── usr/sbin/owrt-remote +│ │ └── CLI-агент, heartbeat, render-client, doctor +│ ├── etc/init.d/owrt-remote +│ │ └── procd-сервис OpenWrt +│ ├── www/cgi-bin/owrt-remote +│ │ └── веб-панель на роутере +│ ├── usr/share/luci/menu.d/luci-app-owrt-remote.json +│ │ └── пункт меню LuCI: Службы -> OpenWrt Remote +│ └── usr/share/rpcd/acl.d/luci-app-owrt-remote.json +│ └── права LuCI/rpcd +└── vps/ + ├── install-vps.sh + │ └── установка Hub на VPS одной командой + ├── uninstall-vps.sh + │ └── удаление Hub с VPS одной командой + ├── owrt-remote-hub.py + │ └── веб-панель VPS, карточки роутеров, proxy, SSH terminal + └── owrt-remote.service + └── systemd-сервис Hub +``` + +## Быстрые команды + +| Задача | Где запускать | Команда | +| --- | --- | --- | +| Поставить Hub | VPS | `curl -fsSL https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/install-vps.sh \| sudo sh` | +| Поставить агент | OpenWrt | `wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/install.sh?v=$(date +%s)" \| sh` | +| Удалить Hub полностью | VPS | `curl -fsSL https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/uninstall-vps.sh \| sudo sh` | +| Удалить агент полностью | OpenWrt | `wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/uninstall.sh?v=$(date +%s)" \| PURGE=1 sh` | + ## Быстрая установка VPS Подходит для Ubuntu/Debian VPS. Команды выполнять под `root` или через `sudo`. @@ -416,6 +464,62 @@ http://YOUR_VPS_IP:8088/ Важно: нормальный доверенный SSL на голый IP обычно не выпускается. Для красивого `https://` нужен домен. +## Удаление + +### Удалить Hub с VPS полностью + +Одна команда на VPS: + +```sh +curl -fsSL https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/uninstall-vps.sh | sudo sh +``` + +Что удалится: + +- сервис `owrt-remote`; +- сервис `owrt-remote-xray`; +- файлы `/opt/owrt-remote`; +- конфиг `/etc/xray/owrt-remote.json`; +- база роутеров `/var/lib/owrt-remote`; +- правила `ufw` для `80/tcp`, `8088/tcp`, `8443/tcp`. + +Если хочешь удалить Hub, но оставить базу роутеров: + +```sh +curl -fsSL https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/uninstall-vps.sh | sudo env PURGE=0 sh +``` + +Если хочешь дополнительно удалить сам Xray binary с VPS: + +```sh +curl -fsSL https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/vps/uninstall-vps.sh | sudo env REMOVE_XRAY=1 sh +``` + +### Удалить агент с OpenWrt полностью + +Одна команда на роутере: + +```sh +wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/uninstall.sh?v=$(date +%s)" | PURGE=1 sh +``` + +Что удалится: + +- `/usr/sbin/owrt-remote`; +- `/etc/init.d/owrt-remote`; +- `/www/cgi-bin/owrt-remote`; +- пункт меню LuCI; +- rpcd ACL; +- `/etc/config/owrtremote`; +- `/etc/owrt-remote/web.key`; +- `/etc/xray/owrt-remote-client.json`. + +Если хочешь удалить только файлы панели, но оставить конфиг: + +```sh +wget -O - "https://raw.githubusercontent.com/kzolotarev95/luci-app-owrt-remote/main/uninstall.sh?v=$(date +%s)" | sh +``` + ## Обновление Обновить VPS: diff --git a/vps/uninstall-vps.sh b/vps/uninstall-vps.sh new file mode 100755 index 0000000..c4f5c55 --- /dev/null +++ b/vps/uninstall-vps.sh @@ -0,0 +1,99 @@ +#!/bin/sh +set -u + +APP_NAME="OpenWrt Remote Hub" +STATE_DIR="${OWRT_REMOTE_STATE_DIR:-/var/lib/owrt-remote}" +PURGE="${PURGE:-1}" +REMOVE_XRAY="${REMOVE_XRAY:-0}" + +if [ "$(id -u)" -eq 0 ]; then + SUDO="" +else + SUDO="sudo" +fi + +info() { + printf '%s\n' "$*" +} + +warn() { + printf 'WARN: %s\n' "$*" >&2 +} + +stop_service() { + name="$1" + if command -v systemctl >/dev/null 2>&1; then + $SUDO systemctl stop "$name" >/dev/null 2>&1 || true + $SUDO systemctl disable "$name" >/dev/null 2>&1 || true + fi +} + +remove_ufw_rule() { + port="$1" + if command -v ufw >/dev/null 2>&1; then + $SUDO ufw --force delete allow "$port/tcp" >/dev/null 2>&1 || true + fi +} + +remove_xray_binary() { + if [ "$REMOVE_XRAY" != "1" ]; then + return + fi + if ! command -v curl >/dev/null 2>&1; then + warn "curl не найден, Xray binary не удален" + return + fi + info "Удаляю Xray binary через официальный installer..." + $SUDO bash -c "$(curl -fsSL https://github.com/XTLS/Xray-install/raw/main/install-release.sh)" @ remove >/dev/null 2>&1 || true +} + +main() { + info "Удаляю $APP_NAME с VPS..." + + stop_service owrt-remote + stop_service owrt-remote-xray + + $SUDO rm -f /etc/systemd/system/owrt-remote.service + $SUDO rm -f /etc/systemd/system/owrt-remote-xray.service + $SUDO rm -rf /opt/owrt-remote + $SUDO rm -f /etc/xray/owrt-remote.json + + if [ "$PURGE" = "1" ]; then + $SUDO rm -rf "$STATE_DIR" + fi + + remove_ufw_rule 80 + remove_ufw_rule 8088 + remove_ufw_rule 8443 + + remove_xray_binary + + if command -v systemctl >/dev/null 2>&1; then + $SUDO systemctl daemon-reload >/dev/null 2>&1 || true + $SUDO systemctl reset-failed owrt-remote owrt-remote-xray >/dev/null 2>&1 || true + fi + + info "" + info "============================================================" + info "$APP_NAME удален" + info "============================================================" + info "Удалено:" + info " /opt/owrt-remote" + info " /etc/systemd/system/owrt-remote.service" + info " /etc/systemd/system/owrt-remote-xray.service" + info " /etc/xray/owrt-remote.json" + if [ "$PURGE" = "1" ]; then + info " $STATE_DIR" + else + info "Оставлено:" + info " $STATE_DIR" + fi + info "" + info "Порты ufw закрыты: 80/tcp, 8088/tcp, 8443/tcp" + if [ "$REMOVE_XRAY" != "1" ]; then + info "Xray binary не удалялся. Чтобы удалить и его: REMOVE_XRAY=1" + fi + info "============================================================" +} + +main "$@"