From 24e793d943cd7af526ab89c14f92fe006c6c13a0 Mon Sep 17 00:00:00 2001
From: orohi <orohi@users.noreply.local>
Date: Sun, 26 Jul 2026 10:31:41 +0300
Subject: [PATCH] Add NaiveProxy client hint for v2rayN IPv6 DNS failures.

Show guidance when copying config if latency fails due to Google DNS over IPv6.

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 templates/server.html | 11 +++++++++++
 translations/en.json  |  1 +
 translations/fa.json  |  1 +
 translations/fr.json  |  1 +
 translations/ru.json  |  1 +
 translations/zh.json  |  1 +
 6 files changed, 16 insertions(+)

diff --git a/templates/server.html b/templates/server.html
index db008a1..99b6c41 100644
--- a/templates/server.html
+++ b/templates/server.html
@@ -986,6 +986,7 @@
         <div class="config-panel active" id="panel-conf">
             <div class="config-display">
                 <div class="config-text" id="configText"></div>
+                <div class="form-hint hidden" id="configClientHint" style="margin-top: var(--space-sm);"></div>
                 <div class="config-actions">
                     <button class="btn btn-secondary btn-sm" onclick="copyToClipboard(currentConfig)" style="flex:1">
                         {{ _('copy') }}
@@ -2840,6 +2841,16 @@
                 document.getElementById('configModalTitle').textContent = `${_('config')} — ${connName}`;
                 document.getElementById('configText').textContent = result.config;
                 document.getElementById('vpnLinkText').textContent = currentVpnLink;
+                const hintEl = document.getElementById('configClientHint');
+                if (hintEl) {
+                    if (protoBase(proto) === 'naiveproxy') {
+                        hintEl.textContent = _('naiveproxy_client_hint');
+                        hintEl.classList.remove('hidden');
+                    } else {
+                        hintEl.textContent = '';
+                        hintEl.classList.add('hidden');
+                    }
+                }
                 switchConfigTab('conf');
                 openModal('configModal');
                 generateQR(result.config);
diff --git a/translations/en.json b/translations/en.json
index 9264df9..823f7a6 100644
--- a/translations/en.json
+++ b/translations/en.json
@@ -371,6 +371,7 @@
   "naiveproxy_install_hint": "Point the domain A-record to this server before install. Free TCP ports 80 and 443 are required (Let's Encrypt and HTTPS proxy).",
   "naiveproxy_dns_hint": "Create this DNS record before installation:",
   "naiveproxy_ports_warning": "Warning: free TCP ports 80 and 443 are required for stable operation (Let's Encrypt on 80, HTTPS proxy on 443).",
+  "naiveproxy_client_hint": "v2rayN: if logs show UDP to 2001:4860… (Google DNS IPv6), set DNS to IPv4 only (8.8.8.8 / 1.1.1.1) and prefer IPv4 — NaiveProxy is TCP; broken IPv6 DNS makes latency −1 ms.",
   "server_ssl_domain": "SSL domain (default)",
   "server_ssl_email": "SSL email (default)",
   "server_ssl_hint": "Used when installing Hysteria / NGINX on this server (Let's Encrypt).",
diff --git a/translations/fa.json b/translations/fa.json
index ac7ec98..82dde6f 100644
--- a/translations/fa.json
+++ b/translations/fa.json
@@ -361,6 +361,7 @@
   "naiveproxy_install_hint": "قبل از نصب، رکورد A دامنه باید به این سرور اشاره کند. پورت‌های TCP آزاد ۸۰ و ۴۴۳ لازم است (Let's Encrypt و پروکسی HTTPS).",
   "naiveproxy_dns_hint": "قبل از نصب این رکورد DNS را بسازید:",
   "naiveproxy_ports_warning": "هشدار: برای کار پایدار پورت‌های TCP آزاد ۸۰ و ۴۴۳ لازم است (Let's Encrypt روی ۸۰، پروکسی HTTPS روی ۴۴۳).",
+  "naiveproxy_client_hint": "v2rayN: اگر لاگ UDP به 2001:4860… (Google DNS IPv6) دیدید، DNS را فقط IPv4 کنید (8.8.8.8 / 1.1.1.1). NaiveProxy روی TCP است.",
   "server_ssl_domain": "دامنه SSL (پیش‌فرض)",
   "server_ssl_email": "ایمیل SSL (پیش‌فرض)",
   "server_ssl_hint": "هنگام نصب Hysteria / NGINX روی این سرور استفاده می‌شود (Let's Encrypt).",
diff --git a/translations/fr.json b/translations/fr.json
index d257a0e..f9e33b5 100644
--- a/translations/fr.json
+++ b/translations/fr.json
@@ -361,6 +361,7 @@
   "naiveproxy_install_hint": "L'enregistrement A du domaine doit pointer vers ce serveur. Les ports TCP 80 et 443 doivent être libres (Let's Encrypt et proxy HTTPS).",
   "naiveproxy_dns_hint": "Créez cet enregistrement DNS avant l'installation :",
   "naiveproxy_ports_warning": "Attention : les ports TCP 80 et 443 doivent être libres pour un fonctionnement stable (Let's Encrypt sur 80, proxy HTTPS sur 443).",
+  "naiveproxy_client_hint": "v2rayN : si les logs montrent UDP vers 2001:4860… (DNS Google IPv6), forcez le DNS en IPv4 (8.8.8.8 / 1.1.1.1). NaiveProxy est en TCP.",
   "server_ssl_domain": "Domaine SSL (par défaut)",
   "server_ssl_email": "Email SSL (par défaut)",
   "server_ssl_hint": "Utilisé lors de l'installation de Hysteria / NGINX sur ce serveur (Let's Encrypt).",
diff --git a/translations/ru.json b/translations/ru.json
index 388ddbe..aa3c31e 100644
--- a/translations/ru.json
+++ b/translations/ru.json
@@ -371,6 +371,7 @@
   "naiveproxy_install_hint": "Перед установкой A-запись домена должна указывать на этот сервер. Нужны свободные TCP-порты 80 и 443 (Let's Encrypt и HTTPS-прокси).",
   "naiveproxy_dns_hint": "Перед установкой создайте DNS-запись:",
   "naiveproxy_ports_warning": "Внимание: для стабильной работы нужны свободные TCP-порты 80 и 443 (Let's Encrypt на 80, HTTPS-прокси на 443).",
+  "naiveproxy_client_hint": "v2rayN: если в логе UDP на 2001:4860… (Google DNS IPv6) — в DNS укажите только IPv4 (8.8.8.8 / 1.1.1.1) и Prefer IPv4. NaiveProxy работает по TCP; из‑за IPv6 DNS задержка становится −1 мс.",
   "server_ssl_domain": "SSL-домен (по умолчанию)",
   "server_ssl_email": "SSL-email (по умолчанию)",
   "server_ssl_hint": "Подставляется при установке Hysteria / NGINX на этом сервере (Let's Encrypt).",
diff --git a/translations/zh.json b/translations/zh.json
index 76bdb2c..dc075c7 100644
--- a/translations/zh.json
+++ b/translations/zh.json
@@ -361,6 +361,7 @@
   "naiveproxy_install_hint": "安装前请将域名 A 记录指向本服务器。需空闲 TCP 端口 80 和 443（Let's Encrypt 与 HTTPS 代理）。",
   "naiveproxy_dns_hint": "安装前请创建此 DNS 记录：",
   "naiveproxy_ports_warning": "注意：稳定运行需要空闲的 TCP 端口 80 和 443（Let's Encrypt 使用 80，HTTPS 代理使用 443）。",
+  "naiveproxy_client_hint": "v2rayN：若日志出现 UDP 到 2001:4860…（Google DNS IPv6），请将 DNS 设为仅 IPv4（8.8.8.8 / 1.1.1.1）。NaiveProxy 走 TCP。",
   "server_ssl_domain": "SSL 域名（默认）",
   "server_ssl_email": "SSL 邮箱（默认）",
   "server_ssl_hint": "安装 Hysteria / NGINX 时自动填入（Let's Encrypt）。",