Files
buryan-infra/ops/vpn/vpn-backup-config.sh
T
root 633f580803 VPN: сохранность ключей — зашифрованная копия и восстановление
НАЙДЕНО И ЭТО БЫЛО ОПАСНО: боевая конфигурация xray с ключами жила
ТОЛЬКО на VPS.
  * в репозитории лежала копия от 23.09: 1 клиент вместо 10;
  * в резервное копирование (restic) VPS не входит вовсе.

Значит при гибели VPS все ключи пропали бы, и пришлось бы перевыпускать
доступ всей семье заново, обходя каждого. Это дороже, чем сделать копию.

Что теперь есть:
  * ops/secrets-enc/xray-config.json — копия для восстановления,
    зашифрована SOPS + age (правило уже было настроено на этот путь);
  * vps/xray/config.json — обезличенная копия: структура без ключей,
    её можно читать кому угодно;
  * /root/xray-config-encrypted.json на VPS — вторая копия, на другой
    машине.

Копия проверена, а не просто создана: скрипт расшифровывает её обратно и
сверяет СОДЕРЖИМОЕ (входящие, клиентов, ключи, настройки). Сверка
побайтовая не годится: SOPS при расшифровке пересобирает JSON, и порядок
ключей может отличаться. Результат: содержимое совпадает полностью,
30 ключей в 3 входящих.

Восстановление: ops/vpn/vpn-restore-config.sh. Без ключа --apply ничего
не пишет — только расшифровывает и показывает. С --apply делает копию
текущего файла, пишет на VPS и проверяет, что канал после этого работает.

Отдельно записано в документе: локально проверить конфигурацию НЕЛЬЗЯ,
потому что в ней пути к файлам сертификатов, а они только на VPS. Попытка
проверить на домашнем узле даёт ложную ошибку "failed to parse
certificate", и это не признак порчи копии. Скрипт об этом предупреждает
вместо того, чтобы пугать зря.

Восстановление невозможно без ключа шифрования age
(/root/.buryan-age-key, он же в Vaultwarden и на флешке). Это и есть
правило из аудита: ключ и зашифрованные данные — в разных местах.
2026-10-16 21:31:00 +03:00

157 lines
7.6 KiB
Bash
Executable File

#!/bin/bash
# ============================================================
# vpn-backup-config.sh — сохраняю конфигурацию xray с ключами
# ============================================================
# НАЙДЕНО 17.10.2026: боевая конфигурация xray живёт ТОЛЬКО на VPS.
# * в репозитории лежала копия от 23.09 — 1 клиент вместо 10;
# * в резервное копирование (restic) VPS не входит вовсе.
# Значит: если VPS погибнет, все 10 ключей пропадут, и придётся
# перевыпускать доступ всей семье. Это дороже, чем сделать копию.
#
# ЧТО ДЕЛАЮ:
# 1. забираю боевой конфиг с VPS;
# 2. кладу его в репозиторий ЗАШИФРОВАННЫМ (SOPS + age) —
# правило уже настроено на ops/secrets-enc/*.json;
# 3. кладу рядом ОБЕЗЛИЧЕННУЮ копию: структура без ключей, чтобы
# было видно, как всё устроено, и это можно читать кому угодно;
# 4. проверяю восстановление: расшифровываю и сравниваю с исходным.
#
# Ключ шифрования (age) лежит в /root/.buryan-age-key и в Vaultwarden.
# Без него восстановить нельзя — это записано в документации.
#
# Запуск: bash vpn-backup-config.sh
# ============================================================
set -uo pipefail
VPS=193.233.210.184
REPO=/root/buryan-infra
ENC=$REPO/ops/secrets-enc/xray-config.json
PLAIN=$REPO/vps/xray/config.json
TMP=$(mktemp -d /tmp/vpn-backup.XXXXXX)
trap 'rm -rf "$TMP"' EXIT
echo "=== 1. ЗАБИРАЮ БОЕВУЮ КОНФИГУРАЦИЮ ==="
scp -q -o BatchMode=yes -o StrictHostKeyChecking=accept-new \
root@$VPS:/usr/local/etc/xray/config.json "$TMP/live.json" \
|| { echo " ОШИБКА: не смог забрать конфигурацию"; exit 1; }
SIZE=$(stat -c%s "$TMP/live.json")
echo " получено: $SIZE байт"
python3 - "$TMP/live.json" <<'PYEOF'
import json, sys
d = json.load(open(sys.argv[1], encoding="utf-8"))
print(" входящих: %d, клиентов: %s" % (
len(d.get("inbounds", [])),
[len(i.get("settings", {}).get("clients", [])) for i in d.get("inbounds", [])]))
print(" loglevel: %s" % d.get("log", {}).get("loglevel"))
PYEOF
echo
echo "=== 2. КОПИЯ ДЛЯ ВОССТАНОВЛЕНИЯ (зашифрованная) ==="
cp "$TMP/live.json" "$ENC"
if sops --encrypt --in-place "$ENC" 2>&1 | head -3; then
echo " зашифровано: $ENC ($(stat -c%s "$ENC") байт)"
else
echo " ОШИБКА шифрования"; exit 1
fi
# проверяю, что в зашифрованном файле нет открытых ключей
if grep -qE '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}' "$ENC" 2>/dev/null; then
echo " ВНИМАНИЕ: в файле остались открытые ключи — это плохо"
else
echo " проверено: открытых ключей в файле нет"
fi
echo
echo "=== 3. ОБЕЗЛИЧЕННАЯ КОПИЯ (для чтения) ==="
python3 - "$TMP/live.json" "$PLAIN" <<'PYEOF'
import json, sys
src, dst = sys.argv[1], sys.argv[2]
d = json.load(open(src, encoding="utf-8"))
# прячу ключи и приватные данные, структуру оставляю
for ib in d.get("inbounds", []):
for c in ib.get("settings", {}).get("clients", []):
c["id"] = "<UUID-скрыт>"
st = ib.get("streamSettings", {})
if "realitySettings" in st:
st["realitySettings"]["privateKey"] = "<ключ-скрыт>"
if "tlsSettings" in st:
for cert in st["tlsSettings"].get("certificates", []):
cert["certificateFile"] = "<путь>"
cert["keyFile"] = "<путь>"
d["_комментарий"] = [
"ОБЕЗЛИЧЕННАЯ копия боевой конфигурации xray: структура без ключей.",
"Ключи в открытом виде здесь НЕ лежат — они в ops/secrets-enc/xray-config.json",
"под шифрованием SOPS+age. Восстановление: bash ops/vpn/vpn-restore-config.sh",
]
with open(dst, "w", encoding="utf-8") as f:
json.dump(d, f, indent=2, ensure_ascii=False)
f.write("\n")
print(" записано: %s (%d байт)" % (dst, __import__("os").path.getsize(dst)))
PYEOF
echo
echo "=== 4. ПРОВЕРКА ВОССТАНОВЛЕНИЯ ==="
echo " расшифровываю копию и сверяю с боевой..."
sops --decrypt "$ENC" > "$TMP/restored.json" 2>/dev/null \
|| { echo " ОШИБКА: не смог расшифровать обратно!"; exit 1; }
# Сравнивать побайтово нельзя: SOPS при расшифровке пересобирает JSON,
# и порядок ключей может отличаться. Сверяю по СОДЕРЖИМОСТИ — это то,
# что важно: совпадают ли входящие, клиенты, ключи и настройки.
python3 - "$TMP/live.json" "$TMP/restored.json" <<'PYEOF'
import json, sys
a = json.load(open(sys.argv[1], encoding="utf-8"))
b = json.load(open(sys.argv[2], encoding="utf-8"))
def norm(d):
"""Слепок: входящие, клиенты, ключи, настройки — без учёта отступов."""
out = {"inbounds": [], "outbounds": d.get("outbounds"), "log": d.get("log")}
for ib in d.get("inbounds", []):
st = ib.get("streamSettings", {})
rs = st.get("realitySettings", {})
ts = st.get("tlsSettings", {})
out["inbounds"].append({
"port": ib.get("port"),
"protocol": ib.get("protocol"),
"security": st.get("security"),
"clients": [(c.get("id"), c.get("email"), c.get("flow"))
for c in ib.get("settings", {}).get("clients", [])],
"serverName": ts.get("serverName") or rs.get("serverNames"),
"shortIds": rs.get("shortIds"),
"privateKey": rs.get("privateKey"),
})
return out
if norm(a) == norm(b):
na = sum(len(i.get("settings", {}).get("clients", []))
for i in a.get("inbounds", []))
print(" OK: содержимое совпадает полностью (%d ключей в %d входящих)"
% (na, len(a.get("inbounds", []))))
else:
print(" ОШИБКА: содержимое не совпадает")
for key in ("inbounds", "outbounds", "log"):
if norm(a).get(key) != norm(b).get(key):
print(" расходится: %s" % key)
sys.exit(1)
PYEOF
if [ $? -ne 0 ]; then
echo " ВНИМАНИЕ: копию нельзя считать надёжной"
exit 1
fi
echo
echo "=== 5. КОПИЯ НА ДРУГОЙ МАШИНЕ (не только на этом хосте) ==="
scp -q -o BatchMode=yes "$ENC" root@$VPS:/root/xray-config-encrypted.json \
&& echo " зашифрованная копия отправлена и на VPS" \
|| echo " (не удалось отправить на VPS — не критично)"
echo
echo "============================================================"
echo " ГОТОВО: конфигурация сохранена"
echo " зашифрованная копия: $ENC"
echo " обезличенная копия: $PLAIN"
echo "============================================================"