Add UI DNS challenge issuance and automatic home NPM renewal
All checks were successful
Test and publish Homegate / checks (push) Successful in 29s
Test and publish Homegate / publish (push) Successful in 12m43s

This commit is contained in:
2026-10-15 05:42:15 +03:00
parent eeffcfb616
commit 5661de72b7
22 changed files with 1051 additions and 43 deletions

103
ui/dist/dns-challenge.js vendored Normal file
View File

@@ -0,0 +1,103 @@
function dnsChallengeFields(domains = '') {
return `<fieldset id="dns-challenge-fields" class="dns-challenge-fields" hidden disabled>
<div class="info-box"><p>Домашний NPM выпустит публичный сертификат через временную TXT-запись у DNS-провайдера и будет продлевать его автоматически. Нужен ваш публичный домен. Порты дома открывать в интернет не требуется; NPM на VDS не участвует.</p></div>
<div class="form-grid">
<label class="field full">Домены сертификата<textarea name="dns_domains" rows="2" required placeholder="disk.hyperdog.dev\n*.hyperdog.dev">${esc(domains)}</textarea><small>По одному в строке. Wildcard *.hyperdog.dev покрывает один уровень поддоменов.</small></label>
<label class="field full">DNS-провайдер<select name="dns_provider" required><option value="">Загрузка провайдеров…</option></select></label>
<label class="field full" id="dns-email-field" hidden>Email для Let's Encrypt<input name="dns_email" type="email" disabled placeholder="admin@example.com"></label>
<div class="field full"><details open><summary>Шаблон API-доступа</summary><pre id="dns-credential-template" class="dns-credential-template">Выберите провайдера.</pre></details></div>
<label class="field full">API-доступ DNS-провайдера<textarea name="dns_credentials" rows="4" required autocomplete="off" spellcheck="false" placeholder="Вставьте настройки по шаблону, заменив пример своим токеном"></textarea><small>Токен передаётся только домашнему NPM для выпуска и продления. В настройках Homegate, YAML и логах он не сохраняется. Для Cloudflare нужен API Token с Zone:DNS:Edit для вашей зоны.</small></label>
<label class="field full">Ожидание DNS, секунд<input name="dns_propagation" type="number" min="0" max="600" placeholder="По умолчанию у провайдера"><small>Оставьте пустым, чтобы NPM использовал значение DNS-плагина.</small></label>
<label class="check-line"><input name="dns_agree" type="checkbox" required>Принимаю <a href="https://letsencrypt.org/repository/" target="_blank" rel="noopener noreferrer">условия Let's Encrypt</a></label>
</div>
<p class="note" id="dns-account-note">Для регистрации используется email учётной записи домашнего NPM.</p>
<div class="dns-challenge-actions"><button type="button" class="btn primary" id="start-dns-challenge">${icon('shield',14)} Выпустить сертификат</button><button type="button" class="btn" id="check-dns-challenge" hidden>${icon('refresh',14)} Проверить результат</button></div>
<p class="note" id="dns-challenge-status" role="status" aria-live="polite"></p>
</fieldset>`;
}
function bindDNSChallenge(form, onCertificate) {
const fields = form.querySelector('#dns-challenge-fields');
const button = form.querySelector('#start-dns-challenge'), check = form.querySelector('#check-dns-challenge');
const status = form.querySelector('#dns-challenge-status'), provider = form.elements.dns_provider;
let catalog = null, loading = false, timer = null, watching = false, waiting = false, delivered = null;
const domainNames = () => form.elements.dns_domains.value.split(/[\n,]/).map(s => s.trim().toLowerCase()).filter(Boolean);
function show(job) {
if(!form.isConnected) return;
waiting = job.status === 'running';
button.disabled = waiting || !catalog;
check.hidden = !['unknown','error'].includes(job.status);
status.textContent = job.status === 'idle' ? '' : `${job.domains?.join(', ') || ''}: ${job.message || ''}`;
if(job.status === 'success' && watching && job.id !== delivered) {
delivered = job.id;
onCertificate(job.certificate);
}
if(waiting) { clearTimeout(timer); timer = setTimeout(poll, 1500); }
}
async function poll() {
if(!form.isConnected) return;
try { show(await api('/api/dns-challenge')); }
catch(error) { status.textContent = error.message; check.hidden = false; }
}
function template() {
form.querySelector('#dns-credential-template').textContent = catalog?.providers.find(p => p.id === provider.value)?.template || 'Выберите провайдера.';
}
async function load() {
fields.disabled = false;
fields.hidden = false;
if(!form.elements.dns_domains.value && form.elements.hostname) form.elements.dns_domains.value = form.elements.hostname.value.trim();
if(catalog || loading) return;
loading = true; button.disabled = true;
try {
catalog = await api('/api/dns-providers');
if(!form.isConnected) return;
provider.innerHTML = '<option value="">Выберите провайдера</option>' + catalog.providers.map(p => `<option value="${esc(p.id)}">${esc(p.name)}</option>`).join('');
form.querySelector('#dns-email-field').hidden = !catalog.email_required;
form.elements.dns_email.disabled = !catalog.email_required;
form.elements.dns_email.required = catalog.email_required;
form.querySelector('#dns-account-note').hidden = catalog.email_required;
button.disabled = waiting;
const job = await api('/api/dns-challenge');
const names = domainNames();
watching = job.status === 'running' && (names.length === 0 || names.every(d => job.domains?.includes(d)));
show(job);
} catch(error) { status.textContent = error.message; check.hidden = false; }
finally { loading = false; }
}
provider.addEventListener('change', () => { form.elements.dns_credentials.value = ''; template(); });
button.addEventListener('click', async () => {
if(![...fields.querySelectorAll('input,textarea,select')].every(input => input.reportValidity())) return;
const propagation = form.elements.dns_propagation.value;
const request = {domains:domainNames(), provider:provider.value, credentials:form.elements.dns_credentials.value,
email:form.elements.dns_email.value, propagation_seconds:propagation === '' ? null : Number(propagation), agree:form.elements.dns_agree.checked};
button.disabled = true;
try {
watching = true; delivered = null;
const job = await api('/api/dns-challenge', request);
form.elements.dns_credentials.value = ''; form.elements.dns_agree.checked = false;
show(job);
} catch(error) { status.textContent = error.message; button.disabled = false; check.hidden = false; }
});
check.addEventListener('click', async () => {
check.disabled = true;
try {
if(!catalog) { await load(); return; }
watching = true;
show(await api('/api/dns-challenge/check', {}));
} catch(error) { status.textContent = error.message; }
finally { check.disabled = false; }
});
return {load, hide:() => {fields.hidden = true; fields.disabled = true;}};
}
function dnsChallengeModal() {
showModal('Let’s Encrypt через DNS challenge', 'Выпуск и автопродление в домашнем NPM.',
`<form id="modal-form"><div class="modal-body">${dnsChallengeFields()}<div class="form-error" id="modal-error" hidden></div></div></form>`,
'<div class="form-footer"><button type="button" class="btn" data-action="close-modal">Закрыть</button></div>');
const form = $('#modal-form');
form.addEventListener('submit', e => e.preventDefault());
const dns = bindDNSChallenge(form, cert => {
form.querySelector('#dns-challenge-status').textContent = `Готово: сертификат #${cert.id} для ${cert.domains.join(', ')}. Теперь выберите его в настройках сервиса. Продление выполняется автоматически в домашнем NPM.`;
});
dns.load();
}