feat(core-editor): add VLESS reverse proxy support with validation

Author: x0sina

dashboard/src/features/core-editor/components/xray/xray-outbounds-section.tsx

@@ -221,6 +221,20 @@ function isJsonObject(value: unknown): value is JsonObject {
   return typeof value === 'object' && value !== null && !Array.isArray(value)
 }
 
+function vlessReverseTagFromSettings(settings: Record<string, unknown>): string {
+  const reverse = settings.reverse
+  if (typeof reverse === 'string') return reverse.trim()
+  if (!reverse || typeof reverse !== 'object' || Array.isArray(reverse)) return ''
+  const tag = (reverse as Record<string, unknown>).tag
+  return typeof tag === 'string' ? tag.trim() : ''
+}
+
+function hasVlessReverseSettings(settings: Record<string, unknown>): boolean {
+  const reverse = settings.reverse
+  if (typeof reverse === 'string') return reverse.trim().length > 0
+  return !!reverse && typeof reverse === 'object' && !Array.isArray(reverse)
+}
+
 function uniqueOutboundTags(outbounds: Outbound[] | undefined): string[] {
   return [...new Set((outbounds ?? []).map(outbound => String(outbound.tag ?? '').trim()).filter(Boolean))]
 }
@@ -336,6 +350,19 @@ function collectOutboundRequiredIssues(ob: Outbound, t: (key: string, opts?: Rec
   const p = ob.protocol
   if (PROXY_ENDPOINT_PROTOCOLS.has(p)) {
     const s = flattenOutboundSettings(ob)
+
+    if (p === 'vless' && hasVlessReverseSettings(s)) {
+      if (!vlessReverseTagFromSettings(s)) {
+        issues.push({
+          field: 'reverse',
+          message: t('coreEditor.outbound.validation.reverseTagRequired', {
+            defaultValue: 'Reverse outbound tag is required.',
+          }),
+        })
+      }
+      return issues
+    }
+
     const address = String(s.address ?? '').trim()
     const portRaw = s.port
     const portNum = typeof portRaw === 'number' ? portRaw : Number(portRaw)
@@ -1238,6 +1265,23 @@ function OutboundProxyEndpointSection({ ob, patchOutbound, t }: OutboundProxyEnd
     if (!vlessVisionFlowIncompatibleWithStreamSecurity(streamSecForFlow, flowStr)) return
     patchOutboundWithSettingsMerge(ob, patchOutbound, s => ({ ...s, flow: '' }))
   }, [p, ob, flowStr, streamSecForFlow, patchOutbound])
+
+  if (p === 'vless' && hasVlessReverseSettings(flat)) {
+    const reverseTag = vlessReverseTagFromSettings(flat)
+    return (
+      <div className="rounded-md border p-4">
+        <p className="text-sm font-medium">{t('coreEditor.outbound.reverseSection', { defaultValue: 'Reverse proxy' })}</p>
+        <p className="mt-2 text-xs text-muted-foreground">
+          {t('coreEditor.outbound.reverseHint', {
+            defaultValue: reverseTag
+              ? `Traffic routed to this outbound is forwarded through reverse tag "${reverseTag}".`
+              : 'Set a reverse tag below. VLESS reverse mode does not use address, port, UUID, or encryption fields.',
+          })}
+        </p>
+      </div>
+    )
+  }
+
   const address = String(flat.address ?? '')
   const portStr = flat.port != null && flat.port !== '' ? String(flat.port) : ''
   const id = String(flat.id ?? '')

dashboard/src/features/core-editor/kit/outbound-editor-json.ts

@@ -72,6 +72,25 @@ function compactSettingsUser(user: Record<string, unknown>): Record<string, unkn
   return out
 }
 
+function normalizeVlessReverseSetting(value: unknown): Record<string, unknown> | undefined {
+  if (value === undefined || value === null) return undefined
+  if (typeof value === 'string') {
+    const trimmed = value.trim()
+    if (!trimmed) return undefined
+    try {
+      const parsed = JSON.parse(trimmed) as unknown
+      return normalizeVlessReverseSetting(parsed)
+    } catch {
+      return { tag: trimmed }
+    }
+  }
+  if (typeof value !== 'object' || Array.isArray(value)) return undefined
+
+  const pruned = deepPruneEmptyJsonObjects(value) as unknown
+  if (!pruned || typeof pruned !== 'object' || Array.isArray(pruned)) return undefined
+  return Object.keys(pruned as Record<string, unknown>).length > 0 ? (pruned as Record<string, unknown>) : undefined
+}
+
 function flattenVnextLike(
   settings: Record<string, unknown>,
   protocol: 'vless' | 'vmess',
@@ -233,8 +252,12 @@ export function outboundEditorBodyFromOutbound(ob: Outbound): Record<string, unk
 export function normalizeSettingsFromEditor(protocol: string, settings: Record<string, unknown>): Record<string, unknown> {
   if (protocol === 'vless') {
     const next = { ...settings }
+    const reverse = normalizeVlessReverseSetting(next.reverse)
+    if (reverse) return { reverse }
+
     if (typeof next.flow === 'string' && next.flow === '') delete next.flow
     if (Array.isArray(next.vnext) && next.vnext.length === 0) delete next.vnext
+    delete next.reverse
     for (const key of ['address', 'port', 'id', 'encryption', 'level', 'email'] as const) {
       if (next[key] === undefined || next[key] === null || next[key] === '') delete next[key]
     }

dashboard/src/features/core-editor/kit/xray-parity-value.ts

@@ -194,6 +194,10 @@ function normParityFieldKey(field: XrayGeneratedFormField): string {
     .toLowerCase()
 }
 
+function isVlessReverseField(field: XrayGeneratedFormField): boolean {
+  return normParityFieldKey(field) === 'reverse' && field.type.replace(/^\*+/, '') === 'VLessReverseConfig'
+}
+
 /** Keep only supported curve names; order is not preserved (caller may re-order). */
 export function filterTlsCurvePreferenceStrings(values: readonly string[]): string[] {
   const allowed = new Set<string>(TLS_CURVE_PREFERENCE_OPTIONS as readonly string[])
@@ -210,6 +214,11 @@ export function filterTlsCurvePreferenceStrings(values: readonly string[]): stri
 }
 
 export function outboundSettingToString(value: unknown, field: XrayGeneratedFormField): string {
+  if (isVlessReverseField(field) && value && typeof value === 'object' && !Array.isArray(value)) {
+    const tag = (value as Record<string, unknown>).tag
+    if (typeof tag === 'string') return tag
+  }
+
   const mode = inferParityFieldMode(field)
   if (value === undefined || value === null) return ''
   if (mode === 'json') {
@@ -226,6 +235,20 @@ export function outboundSettingToString(value: unknown, field: XrayGeneratedForm
 }
 
 export function parseOutboundSettingValue(field: XrayGeneratedFormField, raw: string): unknown {
+  if (isVlessReverseField(field)) {
+    const t = raw.trim()
+    if (!t) return undefined
+    try {
+      const parsed = JSON.parse(t) as unknown
+      if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+        return deepPruneEmptyJsonObjects(parsed) as unknown
+      }
+    } catch {
+      // Treat plain text as the reverse outbound tag.
+    }
+    return { tag: t }
+  }
+
   const mode = inferParityFieldMode(field)
   const t = raw.trim()
   if (mode === 'json') {