Files
HY2XS_flamy/tools/legacy/purge-v0.sh
T
founder a88268b0cd fix(install): сделать границу «хост изменён» настоящим инвариантом
fatal_pre_apply мог означать «хост уже изменён». install-state.json пишется
сразу после успешного preflight, до установки пакетов, но классификация
отказа его не учитывала. Падение apt-get объявлялось как «на сервере ничего
не изменено»: откат и обработка состояния пропускались, а маркер оставался на
диске и ломал следующую установку по clean-host контракту.

Ownership-флаги переформулированы с «шаг успешно завершился» на «операция
могла начать менять систему» и взводятся перед мутирующим вызовом: apt-get
умеет изменить систему и упасть. fatal_pre_apply теперь недостижим ни при
одном взведённом флаге, включая stateWritten.

Read-only guard PHASE 0 можно было обойти. Guard стоял на writeText,
writeTextAtomic, runVisible, runHidden и runRawVisible, но не на универсальном
run, через который в коде проходили и наблюдение (ss, systemctl is-active), и
настоящие мутации (useradd, install -d, mkdir, cp -a, tar). Универсального
раннера больше нет: runReadOnly/runReadOnlySecret без guard'а и runMutating*
под guard'ом, выбор — явное решение на месте вызова.

clean-host не замечал часть того, что удаляет purge. /var/lib/hysteria с
ACME-состоянием Hysteria, /var/log/hy2xs, /usr/local/lib/hy2xs и
/usr/local/bin/hy2xs-orchestrator не были маркерами: сервер, где остался
только старый runtime-state Hysteria, проходил проверку и получал свежую
установку поверх чужого состояния. Пути, которые install.sh создаёт между
фазами, помечены как созданные установщиком, иначе PHASE 1 отказала бы на
собственном оркестраторе.

purge-v0.sh --keep-hysteria-binary противоречил установщику: скрипт сохранял
/usr/local/bin/hysteria и сообщал «хост чист для установки HY2XS v1», хотя
clean-host считает этот бинарник legacy-маркером. Флаг удалён.

DNS проверялся на существование A-записи, но не на то, куда она ведёт. После
принудительной смены IPv4 провайдером doctor отвечал успехом, хотя клиентская
ссылка отправляла людей на чужую машину. Проверялся при этом HY2XS_DOMAIN,
тогда как в hysteria2:// уезжает HY2XS_PUBLIC_HOST.

Добавлен инвариант публичного endpoint: A-записи обязаны принадлежать
множеству публичных IPv4, назначенных интерфейсам этого сервера. Проверка
живёт в общем preflight, поэтому действует в install, reconfigure и doctor.
Адрес определяется локально, без внешних сервисов определения IP. Строгость
управляется HY2XS_PUBLIC_ENDPOINT_POLICY (strict по умолчанию); отсутствие
A-записи фатально при любом значении.

TS-санитайзер приведён к той же формулировке, что и Go: URL-значение
определяется по самому значению, а не по имени ключа.
2026-08-27 20:49:38 +05:00

250 lines
8.3 KiB
Bash

#!/usr/bin/env bash
set -euo pipefail
# Очистка сервера от установки HY2XS предыдущего поколения (0.x) и от
# незавершённой установки v1.
#
# Почему это отдельный скрипт, а не шаг установщика:
#
# HY2XS v1 принципиально не поддерживает миграцию. Встроенная в installer
# очистка вернула бы destructive migration logic обратно в путь свежей
# установки — ровно то, от чего мы ушли. Установщик обязан обнаружить старую
# установку, НИЧЕГО не изменить и отправить оператора сюда.
#
# Скрипт разрушительный. По умолчанию он ничего не делает: показывает план.
#
# sudo ./purge-v0.sh # план (dry-run)
# sudo ./purge-v0.sh --apply --yes-i-know # выполнить
#
# ВАЖНО: скрипт удаляет базу админки вместе с учётными записями пиров.
# Ссылки, выданные пользователям, перестанут работать.
APPLY="false"
CONFIRMED="false"
log() { printf '[hy2xs-purge] %s\n' "$*"; }
warn() { printf '[hy2xs-purge] WARNING: %s\n' "$*" >&2; }
fail() { printf '[hy2xs-purge] ERROR: %s\n' "$*" >&2; exit 1; }
# Флага «оставить бинарник Hysteria» здесь нет намеренно.
#
# /usr/local/bin/hysteria входит в список legacy-маркеров clean-host
# контракта установщика. Скрипт, который оставлял бы его и при этом печатал
# «хост чист для установки HY2XS v1», прямо противоречил бы следующему
# запуску install.sh: тот отказался бы ставиться.
#
# Полезного сценария у флага тоже не было: свежая установка всё равно кладёт
# собственную проверенную по SHA-256 версию Hysteria.
usage() {
cat >&2 <<'EOF'
Usage: purge-v0.sh [--apply --yes-i-know]
(без флагов) показать план очистки и выйти
--apply выполнить очистку
--yes-i-know подтверждение: обязателен вместе с --apply
Скрипт удаляет службы, приложение, конфигурацию и БАЗУ ДАННЫХ админки.
EOF
exit 2
}
parse_args() {
while [ "$#" -gt 0 ]; do
case "$1" in
--apply) APPLY="true"; shift ;;
--yes-i-know) CONFIRMED="true"; shift ;;
-h|--help) usage ;;
*) fail "unknown argument: $1" ;;
esac
done
if [ "$APPLY" = "true" ] && [ "$CONFIRMED" != "true" ]; then
fail "--apply requires an explicit --yes-i-know confirmation"
fi
}
UNITS=(
hysteria-server.service
hy2xs-admin.service
h-ui.service
)
UNIT_FILES=(
/etc/systemd/system/hysteria-server.service
/etc/systemd/system/hy2xs-admin.service
/etc/systemd/system/h-ui.service
)
PATHS=(
/etc/hy2xs
/etc/hysteria
/var/lib/hy2xs
/var/lib/hy2xs-admin
/var/lib/hysteria
/var/log/hy2xs
/opt/hy2xs-admin
/usr/local/lib/hy2xs
/usr/local/h-ui
/usr/local/bin/hy2xs-orchestrator
)
NFT_FRAGMENT=/etc/nftables.d/hy2xs.nft
require_root() {
[ "$(id -u)" = "0" ] || fail "purge-v0.sh must run as root"
}
# Таймеры отката firewall переживают неудачную установку и продолжат менять
# ruleset уже после очистки, если их не снять.
rollback_guard_units() {
systemctl list-units --all --no-legend 'hy2xs-fw-rollback-*.timer' 'hy2xs-fw-rollback-*.service' 2>/dev/null \
| awk '{print $1}' \
| grep -E '^hy2xs-fw-rollback-' || true
}
show_plan() {
log "будут остановлены и выключены службы:"
local unit
for unit in "${UNITS[@]}"; do
printf ' - %s\n' "$unit"
done
local guard
guard="$(rollback_guard_units)"
if [ -n "$guard" ]; then
log "будут сняты таймеры отката firewall:"
printf ' - %s\n' $guard
fi
log "будут удалены пути:"
local path
for path in "${UNIT_FILES[@]}" "${PATHS[@]}" "$NFT_FRAGMENT"; do
if [ -e "$path" ]; then
printf ' - %s (существует)\n' "$path"
else
printf ' - %s (отсутствует)\n' "$path"
fi
done
log "будет удалён /usr/local/bin/hysteria"
log "из /etc/nftables.conf будет убрана строка include для $NFT_FRAGMENT"
warn "БАЗА ДАННЫХ админки (/var/lib/hy2xs-admin) удаляется: пиры и их ссылки будут потеряны"
warn "sshd, сеть и правила firewall вне фрагмента HY2XS не изменяются"
}
stop_units() {
local unit
for unit in "${UNITS[@]}"; do
systemctl stop "$unit" >/dev/null 2>&1 || true
systemctl disable "$unit" >/dev/null 2>&1 || true
systemctl reset-failed "$unit" >/dev/null 2>&1 || true
done
local guard
guard="$(rollback_guard_units)"
if [ -n "$guard" ]; then
local guard_unit
for guard_unit in $guard; do
systemctl stop "$guard_unit" >/dev/null 2>&1 || true
systemctl disable "$guard_unit" >/dev/null 2>&1 || true
systemctl reset-failed "$guard_unit" >/dev/null 2>&1 || true
rm -f "/etc/systemd/system/$guard_unit"
done
fi
}
remove_paths() {
local path
for path in "${UNIT_FILES[@]}"; do
rm -f "$path"
done
systemctl daemon-reload || true
for path in "${PATHS[@]}"; do
rm -rf "$path"
done
rm -f /usr/local/bin/hysteria
}
# Из /etc/nftables.conf убирается только include HY2XS: остальной ruleset
# принадлежит оператору и удалению не подлежит.
detach_nftables_fragment() {
rm -f "$NFT_FRAGMENT"
if [ -f /etc/nftables.conf ] && grep -q 'nftables.d/hy2xs.nft' /etc/nftables.conf; then
local tmp
tmp="$(mktemp)"
grep -v 'nftables.d/hy2xs.nft' /etc/nftables.conf >"$tmp"
cat "$tmp" >/etc/nftables.conf
rm -f "$tmp"
log "убрана строка include HY2XS из /etc/nftables.conf"
fi
if command -v nft >/dev/null 2>&1 && [ -f /etc/nftables.conf ]; then
if nft -c -f /etc/nftables.conf >/dev/null 2>&1; then
nft -f /etc/nftables.conf >/dev/null 2>&1 || warn "не удалось перезагрузить /etc/nftables.conf"
else
warn "/etc/nftables.conf не проходит проверку nft -c; ruleset не перезагружен"
fi
fi
}
# Финальная проверка повторяет clean-host контракт установщика: если она не
# прошла, следующая установка всё равно откажется, и лучше узнать об этом здесь.
verify_clean_host() {
local leftovers=()
local path
for path in "${UNIT_FILES[@]}" "${PATHS[@]}" "$NFT_FRAGMENT"; do
[ -e "$path" ] && leftovers+=("$path")
done
if [ -e /usr/local/bin/hysteria ]; then
leftovers+=(/usr/local/bin/hysteria)
fi
local unit
for unit in "${UNITS[@]}"; do
if systemctl list-unit-files --no-legend "$unit" 2>/dev/null | grep -q .; then
leftovers+=("systemd unit: $unit")
fi
done
if [ "${#leftovers[@]}" -gt 0 ]; then
warn "после очистки остались объекты:"
for path in "${leftovers[@]}"; do
printf ' - %s\n' "$path" >&2
done
fail "хост не является чистым; удалите перечисленное вручную"
fi
log "проверка пройдена: хост чист для установки HY2XS v1"
}
main() {
parse_args "$@"
require_root
show_plan
if [ "$APPLY" != "true" ]; then
log "это был dry-run; для выполнения запустите: --apply --yes-i-know"
return 0
fi
log "выполняю очистку"
stop_units
detach_nftables_fragment
remove_paths
systemctl daemon-reload || true
verify_clean_host
log "готово. Теперь можно устанавливать HY2XS v1 с нуля."
}
main "$@"