import { SshClient, SshCredentials } from './ssh-client' import { shellCommand } from './shell-command' import { describeFailure, isUnknownCommandFailure, unknownCommandHint } from './cli-failure' import { extractJson } from './profiles' import { dns01CliArgs, dns01SecretFlag, dns01SecretPayload, isDns01Ready, isValidDns01Domain, type Dns01Input } from '@shared/dns01' import type { Dns01RepairResult, Dns01StatusResult, SshProtectStatusResult } from '@shared/types' /** Пустой статус защиты SSH — на случай ошибки SSH-вызова (поля обязательны для GUI). */ function emptySshProtect(error: string): SshProtectStatusResult { return { ok: false, supported: false, installed: false, active: false, enabled_at_boot: false, sshd_hardened: false, max_auth_tries: '', login_grace_time: '', password_authentication: '', permit_root_login: '', failed_24h: 0, banned_current: 0, banned_total: 0, banned_ips: [], jail_file: '', sshd_file: '', error } } /** Человекочитаемая причина, почему набор DNS-01 неполный (для ошибки в GUI). */ function dns01Problem(input: Dns01Input): string | null { if (!isValidDns01Domain(input.domain)) { return 'Укажите домен подписки вида sub.example.com (A/AAAA должна указывать на этот VPS)' } if (input.provider === 'cloudflare') { return isDns01Ready(input) ? null : 'Укажите API-токен Cloudflare (минимум 20 символов, право DNS:Edit на зону)' } if (input.provider === 'route53') { return isDns01Ready(input) ? null : 'Укажите корректные AWS access key id и secret' } return 'Выберите провайдера DNS: cloudflare или route53' } /** * Обслуживание подписки и мониторинга: DNS-01 (certbot по TXT-записи, без :80) и * Telegram-алерты. Отдельный менеджер, потому что это серверные операции уровня * установки (как update/uninstall), а не профилей и не бэкендов. * * Валидация параметров DNS-01 делается ДО выхода на сервер: сервер тоже проверяет, * но ошибка в GUI должна появляться мгновенно и не зависеть от SSH-раунда. */ export class MaintenanceManager { constructor(private readonly creds: SshCredentials) {} private async run(args: readonly string[]): Promise { const client = new SshClient(this.creds) try { await client.connect() return await this.execOn(client, args) } finally { client.close() } } /** Один вызов `xrayebator …` с разбором неуспешного кода (общий для путей). */ private async execOn(client: SshClient, args: readonly string[]): Promise { const res = await client.exec(shellCommand('xrayebator', args), { elevated: true }) if (res.code !== 0) { const reason = describeFailure(res) const hint = isUnknownCommandFailure(res) ? ` ${unknownCommandHint()}` : '' throw new Error( `xrayebator ${args[0] ?? ''} → код ${res.code}${reason ? `: ${reason}` : ''}.${hint}` ) } return res.stdout } /** * Команда, которой нужен секрет (DNS-токен / ключи AWS), получает его файлом * 0600 и флагом `--secret-file`, а не аргументом: `/proc//cmdline` читают * все локальные пользователи, и токен был бы виден всё время выпуска * сертификата. Файл лежит в /tmp под случайным именем и удаляется сразу после * чтения на сервере; `finally` — страховка на случай, если команда до разбора * не дошла. */ private async runWithSecret( args: readonly string[], secretPayload: string, flag: string ): Promise { const client = new SshClient(this.creds) try { await client.connect() const remotePath = `/tmp/.xrayebator-secret-${SshClient.randomToken()}` await client.upload(Buffer.from(secretPayload, 'utf8'), remotePath, { mode: 0o600 }) try { return await this.execOn(client, [...args, flag, remotePath]) } finally { await client.exec(shellCommand('rm', ['-f', remotePath])).catch(() => undefined) } } finally { client.close() } } /** Разбор JSON-ответа DNS-01 (общий для пути с токеном и с repair). */ private parseDns01(stdout: string): Dns01RepairResult { const payload = extractJson(stdout) as Dns01RepairResult & { ok?: boolean error?: string } return { ok: payload.ok === true, repaired: payload.repaired, skipped: payload.skipped, domain: payload.domain, provider: payload.provider, port: payload.port, tls_mode: payload.tls_mode, subscription_url: payload.subscription_url, note: payload.note, error: payload.error } } private async dns01(args: readonly string[], secretPayload: string): Promise { try { return this.parseDns01( await this.runWithSecret(args, secretPayload, dns01SecretFlag()) ) } catch (err) { return { ok: false, error: err instanceof Error ? err.message : String(err) } } } async dns01Status(): Promise { try { const payload = extractJson(await this.run(['dns01-status'])) as Dns01StatusResult return { ok: payload.ok === true, provider: payload.provider ?? '', tls_mode: payload.tls_mode ?? '', domain: payload.domain ?? '', port: payload.port ?? 0, credentials_present: payload.credentials_present === true, cert_expiry: payload.cert_expiry ?? 0, days_left: payload.days_left ?? 0, deploy_hook: payload.deploy_hook === true, error: payload.error } } catch (err) { return { ok: false, provider: '', tls_mode: '', domain: '', port: 0, credentials_present: false, cert_expiry: 0, days_left: 0, deploy_hook: false, error: err instanceof Error ? err.message : String(err) } } } /** Включить DNS-01 там, где подписки ещё нет (обычный путь из настроек). */ async dns01Setup(input: Dns01Input): Promise { const problem = dns01Problem(input) if (problem) return { ok: false, error: problem } return this.dns01(['dns01-setup', ...dns01CliArgs(input)], dns01SecretPayload(input)) } /** * Заменить деградированную (http_tls) подписку на DNS-01. Идемпотентно: если * подписка уже на HTTPS, сервер вернёт skipped:true. */ async repairDns01(input: Dns01Input): Promise { const problem = dns01Problem(input) if (problem) return { ok: false, error: problem } return this.dns01(['repair-dns01', ...dns01CliArgs(input)], dns01SecretPayload(input)) } /** * Защита SSH от перебора. Один разбор ответа на все три действия: сервер * печатает одинаковый статус-JSON и для --status, и после --enable/--disable, * отличаясь только полем changed. */ private async sshProtect(args: readonly string[]): Promise { try { const payload = extractJson(await this.run(args)) as Partial const num = (value: unknown): number => { const parsed = Number(value) return Number.isFinite(parsed) ? parsed : 0 } return { ok: payload.ok === true, supported: payload.supported === true, installed: payload.installed === true, active: payload.active === true, enabled_at_boot: payload.enabled_at_boot === true, sshd_hardened: payload.sshd_hardened === true, max_auth_tries: payload.max_auth_tries ?? '', login_grace_time: payload.login_grace_time ?? '', password_authentication: payload.password_authentication ?? '', permit_root_login: payload.permit_root_login ?? '', failed_24h: num(payload.failed_24h), banned_current: num(payload.banned_current), banned_total: num(payload.banned_total), banned_ips: Array.isArray(payload.banned_ips) ? payload.banned_ips.filter((ip): ip is string => typeof ip === 'string') : [], jail_file: payload.jail_file ?? '', sshd_file: payload.sshd_file ?? '', changed: payload.changed === true, error: payload.error } } catch (err) { return emptySshProtect(err instanceof Error ? err.message : String(err)) } } sshProtectStatus(): Promise { return this.sshProtect(['ssh-protect', '--status']) } sshProtectEnable(): Promise { return this.sshProtect(['ssh-protect', '--enable']) } sshProtectDisable(): Promise { return this.sshProtect(['ssh-protect', '--disable']) } }