founder
a88268b0cd
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-значение определяется по самому значению, а не по имени ключа.
56 lines
2.0 KiB
Smarty
56 lines
2.0 KiB
Smarty
# HY2XS post-install reference file.
|
|
# Файл создаётся оркестратором после первичной установки и не является runtime-конфигом.
|
|
|
|
DEPLOY_TARGET_OS=debian13
|
|
DEPLOY_TIMESTAMP={{LAST_APPLY_DATE}}
|
|
PACKAGE_NAME=hy2xs-install-package
|
|
PACKAGE_BUILD_ID={{PACKAGE_BUILD_ID}}
|
|
PACKAGE_VERSION={{PACKAGE_VERSION}}
|
|
HY2XS_CONFIG_SCHEMA_VERSION={{CONFIG_SCHEMA_VERSION}}
|
|
|
|
ORCH_SOURCE_STACK=bun-typescript
|
|
ORCH_BUILD_MODE=bun-compile
|
|
ORCH_BUILD_ID={{PACKAGE_BUILD_ID}}
|
|
ORCH_ENTRYPOINT=/usr/local/lib/hy2xs/hy2xs-orchestrator
|
|
|
|
DEPLOY_DOMAIN={{DOMAIN}}
|
|
PUBLIC_HOST={{PUBLIC_HOST}}
|
|
PUBLIC_PORT={{PUBLIC_PORT}}
|
|
SSH_PORT={{SSH_PORT}}
|
|
HY2XS_FIREWALL_MODE={{FIREWALL_MODE}}
|
|
HY2XS_FIREWALL_STAGED_APPLY={{FIREWALL_STAGED_APPLY}}
|
|
|
|
HY2_SOURCE=official-upstream
|
|
HY2_VERSION={{HYSTERIA_VERSION}}
|
|
HY2_RESOLUTION={{HYSTERIA_RESOLUTION}}
|
|
HY2_TLS_MODE={{TLS_MODE}}
|
|
HY2_ACME_EMAIL={{ACME_EMAIL}}
|
|
HY2_TLS_CERT_PATH={{TLS_CERT_PATH}}
|
|
HY2_TLS_KEY_PATH={{TLS_KEY_PATH}}
|
|
HY2_LISTEN_HOST={{HYSTERIA_BIND_HOST}}
|
|
HY2_PORT={{HYSTERIA_PORT}}
|
|
HY2_AUTH_MODE=http
|
|
HY2_AUTH_URL=http://127.0.0.1:{{UI_PORT}}/internal/hysteria/auth?access_token={{HYSTERIA_API_SECRET}}
|
|
HY2_TRAFFIC_STATS_LISTEN={{HYSTERIA_API_HOST}}:{{HYSTERIA_API_PORT}}
|
|
HY2_OBFS_TYPE={{OBFS_TYPE}}
|
|
HY2_OBFS_PASSWORD={{HYSTERIA_OBFS_PASSWORD}}
|
|
HY2_GECKO_MIN_PACKET_SIZE={{GECKO_MIN_PACKET_SIZE}}
|
|
HY2_GECKO_MAX_PACKET_SIZE={{GECKO_MAX_PACKET_SIZE}}
|
|
HY2_BANDWIDTH_UP={{BANDWIDTH_UP}}
|
|
HY2_BANDWIDTH_DOWN={{BANDWIDTH_DOWN}}
|
|
HY2_DISABLE_LOSS_COMPENSATION={{DISABLE_LOSS_COMPENSATION}}
|
|
HY2_IGNORE_CLIENT_BANDWIDTH={{IGNORE_CLIENT_BANDWIDTH}}
|
|
HY2_CONGESTION_TYPE={{CONGESTION_TYPE}}
|
|
HY2_BBR_PROFILE={{BBR_PROFILE}}
|
|
HY2_DISABLE_STATELESS_RESET={{DISABLE_STATELESS_RESET}}
|
|
HY2_CONFIG_PATH=/etc/hysteria/config.yaml
|
|
|
|
HY2XS_ADMIN_ENABLED=true
|
|
HY2XS_ADMIN_SOURCE=packaged
|
|
HY2XS_ADMIN_BUILD_ID={{PACKAGE_BUILD_ID}}
|
|
HY2XS_ADMIN_BIND_HOST={{UI_BIND_HOST}}
|
|
HY2XS_ADMIN_PORT={{UI_PORT}}
|
|
HY2XS_ADMIN_INSTALL_DIR={{INSTALL_DIR}}
|
|
HY2XS_ADMIN_DATA_DIR={{DATA_DIR}}
|
|
HY2XS_ADMIN_LOG_DIR={{LOG_DIR}}
|