Add one-command uninstall docs
This commit is contained in:
1 parent
5501e6e589
commit
ef6d9e7d76
2 files changed
+208
-5
No files matched your search
@@ -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<br/>OpenWrt Remote Hub<br/>80 / 8088"]
|
||||||
|
hub --> luciEntry["127.0.0.1:18080<br/>LuCI entry-port"]
|
||||||
|
hub --> sshEntry["127.0.0.1:19080<br/>SSH entry-port"]
|
||||||
|
luciEntry --> xray["Xray VLESS reverse<br/>8443"]
|
||||||
|
sshEntry --> xray
|
||||||
|
xray --> router["OpenWrt роутер"]
|
||||||
|
router --> luci["LuCI<br/>127.0.0.1:80"]
|
||||||
|
router --> ssh["Dropbear SSH<br/>127.0.0.1:22"]
|
||||||
```
|
```
|
||||||
|
|
||||||
Роутер сам подключается к VPS изнутри сети. Наружу LuCI и SSH на роутере открывать не нужно.
|
|
||||||
|
|
||||||
В панели VPS можно:
|
В панели VPS можно:
|
||||||
|
|
||||||
- видеть все роутеры красивыми карточками;
|
- видеть все роутеры красивыми карточками;
|
||||||
@@ -36,6 +45,45 @@
|
|||||||
|
|
||||||
Пароль можно поменять в панели Hub.
|
Пароль можно поменять в панели 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
|
## Быстрая установка VPS
|
||||||
|
|
||||||
Подходит для Ubuntu/Debian VPS. Команды выполнять под `root` или через `sudo`.
|
Подходит для Ubuntu/Debian VPS. Команды выполнять под `root` или через `sudo`.
|
||||||
@@ -416,6 +464,62 @@ http://YOUR_VPS_IP:8088/
|
|||||||
|
|
||||||
Важно: нормальный доверенный SSL на голый IP обычно не выпускается. Для красивого `https://` нужен домен.
|
Важно: нормальный доверенный 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:
|
Обновить VPS:
|
||||||
|
|||||||
Executable
+99
@@ -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 "$@"
|
||||||
Reference in new issue
Block a user