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-значение определяется по самому значению, а не по имени ключа.
104 lines
3.4 KiB
TypeScript
104 lines
3.4 KiB
TypeScript
import type { RuntimeConfig, RuntimeContext } from "../src/types/context";
|
|
import { parseRuntimeEnv } from "../src/config/env";
|
|
|
|
/**
|
|
* Минимальный валидный packaged baseline. Тесты меняют только те строки,
|
|
* которые проверяют, поэтому «валидный по умолчанию» набор живёт в одном месте.
|
|
*/
|
|
export const BASELINE_ENV_LINES: readonly string[] = [
|
|
"HY2XS_CONFIG_SCHEMA_VERSION=2",
|
|
"HY2XS_IPV6_ENABLED=false",
|
|
"HY2XS_DOMAIN=vpn.example.com",
|
|
"HY2XS_DNS_AAAA_POLICY=strict",
|
|
"HY2XS_PUBLIC_ENDPOINT_POLICY=strict",
|
|
"HY2XS_PUBLIC_HOST=vpn.example.com",
|
|
"HY2XS_PUBLIC_PORT=443",
|
|
"HY2XS_SSH_PORT=2323",
|
|
"HY2XS_FIREWALL_MODE=takeover",
|
|
"HY2XS_FIREWALL_STAGED_APPLY=true",
|
|
"HY2XS_UI_BIND_HOST=127.0.0.1",
|
|
"HY2XS_UI_PUBLIC_ACCESS=false",
|
|
"HY2XS_UI_PORT=8080",
|
|
"HY2XS_ADMIN_USER=hy2xsadmin",
|
|
"HY2XS_ADMIN_INITIAL_PASSWORD=initial-password",
|
|
"HY2XS_ADMIN_CON_PASS=connection-password",
|
|
"HY2XS_FORCE_PASSWORD_CHANGE=false",
|
|
"HY2XS_ALLOW_SELF_SIGNED_DEV=false",
|
|
"HY2XS_TLS_MODE=acme",
|
|
"HY2XS_ACME_TYPE=http",
|
|
"HY2XS_ACME_EMAIL=admin@example.com",
|
|
"HY2XS_TLS_CERT_PATH=/etc/hysteria/server.crt",
|
|
"HY2XS_TLS_KEY_PATH=/etc/hysteria/server.key",
|
|
"HY2XS_HYSTERIA_BIND_HOST=0.0.0.0",
|
|
"HY2XS_HYSTERIA_PORT=443",
|
|
"HY2XS_HYSTERIA_AUTH_MODE=http",
|
|
"HY2XS_HYSTERIA_TRAFFIC_STATS_HOST=127.0.0.1",
|
|
"HY2XS_HYSTERIA_TRAFFIC_STATS_PORT=36712",
|
|
"HY2XS_HYSTERIA_TRAFFIC_STATS_SECRET=traffic-stats-secret",
|
|
"HY2XS_HYSTERIA_OBFS_TYPE=gecko",
|
|
"HY2XS_HYSTERIA_OBFS_PASSWORD=obfs-password",
|
|
"HY2XS_HYSTERIA_BANDWIDTH_UP=50 mbps",
|
|
"HY2XS_HYSTERIA_BANDWIDTH_DOWN=50 mbps",
|
|
"HY2XS_HYSTERIA_IGNORE_CLIENT_BANDWIDTH=false",
|
|
"HY2XS_HYSTERIA_CONFIG_PATH=/etc/hysteria/config.yaml",
|
|
"HY2XS_INSTALL_DIR=/opt/hy2xs-admin",
|
|
"HY2XS_DATA_DIR=/var/lib/hy2xs-admin",
|
|
"HY2XS_LOG_DIR=/var/log/hy2xs"
|
|
];
|
|
|
|
/**
|
|
* Собирает env-текст из baseline с переопределениями.
|
|
* Значение `null` удаляет ключ целиком (проверка поведения по умолчанию).
|
|
*/
|
|
export function envText(overrides: Record<string, string | null> = {}): string {
|
|
const lines: string[] = [];
|
|
const applied = new Set<string>();
|
|
|
|
for (const line of BASELINE_ENV_LINES) {
|
|
const key = line.slice(0, line.indexOf("="));
|
|
if (key in overrides) {
|
|
applied.add(key);
|
|
const value = overrides[key];
|
|
if (value === null) {
|
|
continue;
|
|
}
|
|
lines.push(`${key}=${value}`);
|
|
continue;
|
|
}
|
|
lines.push(line);
|
|
}
|
|
|
|
for (const [key, value] of Object.entries(overrides)) {
|
|
if (!applied.has(key) && value !== null) {
|
|
lines.push(`${key}=${value}`);
|
|
}
|
|
}
|
|
|
|
return `${lines.join("\n")}\n`;
|
|
}
|
|
|
|
export function baselineConfig(overrides: Record<string, string | null> = {}): RuntimeConfig {
|
|
return parseRuntimeEnv(envText(overrides));
|
|
}
|
|
|
|
export function testContext(config: RuntimeConfig): RuntimeContext {
|
|
return {
|
|
mode: "install",
|
|
options: {
|
|
packageDir: "/opt/hy2xs/package",
|
|
sourceConfigPath: "",
|
|
runtimeConfigPath: "/etc/hy2xs/hy2xs.env",
|
|
nonInteractive: true,
|
|
skipFirewall: false,
|
|
skipServiceStart: false,
|
|
skipSmoke: false
|
|
},
|
|
config,
|
|
packageVersion: "1.0.0",
|
|
packageBuildId: "test-build",
|
|
installDate: "2026-08-27T00:00:00.000Z",
|
|
hysteriaVersion: "v2.12.2",
|
|
hysteriaResolution: "latest-stable"
|
|
};
|
|
}
|