@undefineds.co/xpod 0.1.6 → 0.2.0-preview.2

package/dist/edge/EdgeNodeAgent.js.map

@@ -1 +1 @@
-{"version":3,"file":"EdgeNodeAgent.js","sourceRoot":"","sources":["../../src/edge/EdgeNodeAgent.ts"],"names":[],"mappings":"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","sourcesContent":["import os from 'node:os';\nimport { spawn } from 'node:child_process';\nimport { getLoggerFor } from 'global-logger-factory';\nimport type { EdgeNodeHeartbeatServiceOptions } from '../service/EdgeNodeHeartbeatService';\nimport { EdgeNodeHeartbeatService } from '../service/EdgeNodeHeartbeatService';\nimport { FrpcProcessManager, type FrpcRuntimeStatus } from './frp/FrpcProcessManager';\nimport { AcmeCertificateManager } from './acme/AcmeCertificateManager';\nimport { ClusterCertificateManager } from './acme/ClusterCertificateManager';\nimport { EdgeNodeCapabilityDetector, type NetworkAddressInfo } from './EdgeNodeCapabilityDetector';\n\nexport interface EdgeNodeAgentOptions {\n  signalEndpoint: string;\n  nodeId: string;\n  nodeToken: string;\n  baseUrl?: string;\n  publicAddress?: string;\n  pods?: string[];\n  includeSystemMetrics?: boolean;\n  enableNetworkDetection?: boolean;\n  metadata?: Record<string, unknown>;\n  intervalMs?: number;\n  onHeartbeatResponse?: (data: unknown) => void;\n  acme?: {\n    mode?: 'local' | 'cluster';\n    email?: string;\n    domains?: string[];\n    directoryUrl?: string;\n    accountKeyPath?: string;\n    certificateKeyPath: string;\n    certificatePath: string;\n    fullChainPath?: string;\n    renewBeforeDays?: number;\n    propagationDelayMs?: number;\n    postDeployCommand?: string[];\n  };\n  frp?: {\n    binaryPath: string;\n    configPath: string;\n    workingDirectory?: string;\n    logPrefix?: string;\n    autoRestart?: boolean;\n  };\n}\n\nexport class EdgeNodeAgent {\n  private readonly logger = getLoggerFor(this);\n  private heartbeat?: EdgeNodeHeartbeatService;\n  private frpManager?: FrpcProcessManager;\n  private clusterCertificate?: ClusterCertificateManager;\n  private networkDetector?: EdgeNodeCapabilityDetector;\n  private cachedNetworkInfo?: NetworkAddressInfo;\n  private lastNetworkDetection = 0;\n  private readonly networkDetectionIntervalMs = 60_000; // 每分钟重新检测一次\n\n  public async start(options: EdgeNodeAgentOptions): Promise<void> {\n    if (options.acme) {\n      const mode = options.acme.mode ?? 'local';\n      if (mode === 'cluster') {\n        await this.ensureClusterCertificate(options);\n      } else {\n        await this.issueCertificateLocally(options);\n      }\n    }\n    if (options.frp) {\n      this.frpManager = new FrpcProcessManager({\n        binaryPath: options.frp.binaryPath,\n        configPath: options.frp.configPath,\n        workingDirectory: options.frp.workingDirectory,\n        logPrefix: options.frp.logPrefix,\n        autoRestart: options.frp.autoRestart,\n      });\n    }\n    \n    // 初始化网络检测器\n    if (options.enableNetworkDetection !== false) {\n      this.networkDetector = new EdgeNodeCapabilityDetector({\n        dynamicDetection: {\n          enableNetworkDetection: true,\n        },\n      });\n      // 执行初始网络检测\n      this.cachedNetworkInfo = await this.networkDetector.detectNetworkAddresses();\n      this.lastNetworkDetection = Date.now();\n      this.logger.info(`Network detection: IPv4=${this.cachedNetworkInfo.ipv4Public ?? this.cachedNetworkInfo.ipv4}, IPv6=${this.cachedNetworkInfo.ipv6Public ?? this.cachedNetworkInfo.ipv6}, hasPublicIPv6=${this.cachedNetworkInfo.hasPublicIPv6}`);\n    }\n    \n    const systemMetrics = options.includeSystemMetrics ? this.collectSystemMetrics() : undefined;\n    const metadataPayload = {\n      ...(options.metadata ?? {}),\n      system: systemMetrics,\n    } as Record<string, unknown>;\n\n    const certificatePayload = this.clusterCertificate?.getHeartbeatPayload();\n    const heartbeatOptions: EdgeNodeHeartbeatServiceOptions = {\n      edgeNodesEnabled: true,\n      signalEndpoint: options.signalEndpoint,\n      nodeId: options.nodeId,\n      nodeToken: options.nodeToken,\n      baseUrl: options.baseUrl,\n      publicAddress: options.publicAddress,\n      pods: options.pods,\n      intervalMs: options.intervalMs,\n      metadata: this.stringifyIfContent(metadataPayload),\n      metrics: systemMetrics ? JSON.stringify(systemMetrics) : undefined,\n      certificate: certificatePayload ? JSON.stringify(certificatePayload) : undefined,\n      onHeartbeatResponse: (data: unknown): void => {\n        this.handleHeartbeatResponse(data);\n        options.onHeartbeatResponse?.(data);\n      },\n      networkSupplier: this.networkDetector ? () => this.getNetworkInfo() : undefined,\n    };\n    if (this.frpManager) {\n      heartbeatOptions.tunnelSupplier = () => this.buildTunnelHeartbeatPayload();\n    }\n\n    this.heartbeat = new EdgeNodeHeartbeatService(heartbeatOptions);\n  }\n\n  public stop(): void {\n    if (this.heartbeat && typeof (this.heartbeat as any).dispose === 'function') {\n      (this.heartbeat as any).dispose();\n    }\n    this.heartbeat = undefined;\n    void this.frpManager?.stop();\n    this.clusterCertificate?.stop();\n  }\n\n  private stringifyIfContent(data: Record<string, unknown>): string | undefined {\n    const sanitized: Record<string, unknown> = {};\n    for (const [ key, value ] of Object.entries(data)) {\n      if (value !== undefined) {\n        sanitized[key] = value;\n      }\n    }\n    return Object.keys(sanitized).length > 0 ? JSON.stringify(sanitized) : undefined;\n  }\n\n  private collectSystemMetrics(): Record<string, unknown> {\n    const load = os.loadavg();\n    return {\n      hostname: os.hostname(),\n      platform: os.platform(),\n      arch: os.arch(),\n      uptime: os.uptime(),\n      cpuCount: os.cpus().length,\n      load1: load[0],\n      load5: load[1],\n      load15: load[2],\n      totalMem: os.totalmem(),\n      freeMem: os.freemem(),\n    };\n  }\n\n  private handleHeartbeatResponse(data: unknown): void {\n    if (!data || typeof data !== 'object') {\n      return;\n    }\n    const body = data as Record<string, any>;\n    const metadata = body.metadata as Record<string, any> | undefined;\n    this.clusterCertificate?.handleHeartbeatMetadata(metadata);\n    const tunnel = metadata?.tunnel as Record<string, any> | undefined;\n    const config = tunnel?.config as Record<string, any> | undefined;\n    if (config) {\n      this.logger.debug(`接收到隧道配置: ${JSON.stringify({ entrypoint: tunnel?.entrypoint, proxyName: config.proxyName })}`);\n    }\n    const entrypoint = typeof tunnel?.entrypoint === 'string' ? tunnel.entrypoint :\n      typeof config?.publicUrl === 'string' ? config.publicUrl : undefined;\n    void this.frpManager?.applyConfig(config as any, tunnel?.status as string | undefined, entrypoint);\n  }\n\n  private async issueCertificateLocally(options: EdgeNodeAgentOptions): Promise<void> {\n    const acmeOptions = options.acme!;\n    if (!acmeOptions.email || !acmeOptions.domains || acmeOptions.domains.length === 0) {\n      throw new Error('本地 ACME 模式需要提供 email 与 domains。');\n    }\n    if (!acmeOptions.accountKeyPath) {\n      throw new Error('本地 ACME 模式需要提供 accountKeyPath。');\n    }\n    const manager = new AcmeCertificateManager({\n      signalEndpoint: options.signalEndpoint,\n      nodeId: options.nodeId,\n      nodeToken: options.nodeToken,\n      email: acmeOptions.email!,\n      domains: acmeOptions.domains!,\n      directoryUrl: acmeOptions.directoryUrl,\n      accountKeyPath: acmeOptions.accountKeyPath!,\n      certificateKeyPath: acmeOptions.certificateKeyPath,\n      certificatePath: acmeOptions.certificatePath,\n      fullChainPath: acmeOptions.fullChainPath,\n      renewBeforeDays: acmeOptions.renewBeforeDays,\n      propagationDelayMs: acmeOptions.propagationDelayMs,\n    });\n    try {\n      const issued = await manager.ensureCertificate();\n      if (issued && acmeOptions.postDeployCommand && acmeOptions.postDeployCommand.length > 0) {\n        await this.runPostDeploy(acmeOptions.postDeployCommand);\n      }\n    } catch (error: unknown) {\n      this.logger.error(`自动签发证书失败：${(error as Error).message}`);\n      throw error;\n    }\n  }\n\n  private async ensureClusterCertificate(options: EdgeNodeAgentOptions): Promise<void> {\n    const acmeOptions = options.acme!;\n    if (!acmeOptions.certificateKeyPath || !acmeOptions.certificatePath) {\n      throw new Error('Cluster 模式需要提供 certificateKeyPath 与 certificatePath。');\n    }\n    const manager = new ClusterCertificateManager({\n      signalEndpoint: options.signalEndpoint,\n      nodeId: options.nodeId,\n      nodeToken: options.nodeToken,\n      certificateKeyPath: acmeOptions.certificateKeyPath,\n      certificatePath: acmeOptions.certificatePath,\n      fullChainPath: acmeOptions.fullChainPath,\n      renewBeforeDays: acmeOptions.renewBeforeDays,\n      onCertificateInstalled: acmeOptions.postDeployCommand ? () => this.runPostDeploy(acmeOptions.postDeployCommand!) : undefined,\n    });\n    this.clusterCertificate = manager;\n    await manager.start();\n  }\n\n  private async runPostDeploy(command: string[]): Promise<void> {\n    const [ executable, ...args ] = command;\n    if (!executable) {\n      return;\n    }\n    await new Promise<void>((resolve, reject) => {\n      const child = spawn(executable, args, { stdio: 'inherit' });\n      child.on('error', reject);\n      child.on('exit', (code) => {\n        if (code === 0) {\n          resolve();\n        } else {\n          reject(new Error(`命令 ${executable} 退出码 ${code}`));\n        }\n      });\n    });\n  }\n\n  private buildTunnelHeartbeatPayload(): Record<string, unknown> | undefined {\n    const status: FrpcRuntimeStatus | undefined = this.frpManager?.getStatus();\n    if (!status) {\n      return undefined;\n    }\n    return { client: status };\n  }\n\n  /**\n   * 获取网络信息（带缓存，每分钟刷新一次）\n   */\n  private async getNetworkInfo(): Promise<{ ipv4?: string; ipv6?: string }> {\n    const now = Date.now();\n    \n    // 如果缓存过期，重新检测\n    if (!this.cachedNetworkInfo || (now - this.lastNetworkDetection) > this.networkDetectionIntervalMs) {\n      if (this.networkDetector) {\n        try {\n          this.cachedNetworkInfo = await this.networkDetector.detectNetworkAddresses();\n          this.lastNetworkDetection = now;\n        } catch (error: unknown) {\n          this.logger.debug(`Network detection failed: ${(error as Error).message}`);\n        }\n      }\n    }\n    \n    // 优先返回公网地址\n    return {\n      ipv4: this.cachedNetworkInfo?.ipv4Public ?? this.cachedNetworkInfo?.ipv4,\n      ipv6: this.cachedNetworkInfo?.ipv6Public ?? this.cachedNetworkInfo?.ipv6,\n    };\n  }\n}\n"]}
+{"version":3,"file":"EdgeNodeAgent.js","sourceRoot":"","sources":["../../src/edge/EdgeNodeAgent.ts"],"names":[],"mappings":"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","sourcesContent":["import os from 'node:os';\nimport { spawn } from 'node:child_process';\nimport { getLoggerFor } from 'global-logger-factory';\nimport type { EdgeNodeSignalClientOptions } from '../service/EdgeNodeSignalClient';\nimport { EdgeNodeSignalClient } from '../service/EdgeNodeSignalClient';\nimport { FrpcProcessManager, type FrpcRuntimeStatus } from './frp/FrpcProcessManager';\nimport { AcmeCertificateManager } from './acme/AcmeCertificateManager';\nimport { ClusterCertificateManager } from './acme/ClusterCertificateManager';\nimport { EdgeNodeCapabilityDetector, type NetworkAddressInfo } from './EdgeNodeCapabilityDetector';\n\nexport interface EdgeNodeAgentOptions {\n  signalEndpoint: string;\n  nodeId: string;\n  nodeToken: string;\n  baseUrl?: string;\n  publicAddress?: string;\n  pods?: string[];\n  includeSystemMetrics?: boolean;\n  enableNetworkDetection?: boolean;\n  metadata?: Record<string, unknown>;\n  intervalMs?: number;\n  onHeartbeatResponse?: (data: unknown) => void;\n  acme?: {\n    mode?: 'local' | 'cluster';\n    email?: string;\n    domains?: string[];\n    directoryUrl?: string;\n    accountKeyPath?: string;\n    certificateKeyPath: string;\n    certificatePath: string;\n    fullChainPath?: string;\n    renewBeforeDays?: number;\n    propagationDelayMs?: number;\n    postDeployCommand?: string[];\n  };\n  frp?: {\n    binaryPath: string;\n    configPath: string;\n    workingDirectory?: string;\n    logPrefix?: string;\n    autoRestart?: boolean;\n  };\n}\n\nexport class EdgeNodeAgent {\n  private readonly logger = getLoggerFor(this);\n  private heartbeat?: EdgeNodeSignalClient;\n  private frpManager?: FrpcProcessManager;\n  private clusterCertificate?: ClusterCertificateManager;\n  private networkDetector?: EdgeNodeCapabilityDetector;\n  private cachedNetworkInfo?: NetworkAddressInfo;\n  private lastNetworkDetection = 0;\n  private readonly networkDetectionIntervalMs = 60_000; // 每分钟重新检测一次\n\n  public async start(options: EdgeNodeAgentOptions): Promise<void> {\n    if (options.acme) {\n      const mode = options.acme.mode ?? 'local';\n      if (mode === 'cluster') {\n        await this.ensureClusterCertificate(options);\n      } else {\n        await this.issueCertificateLocally(options);\n      }\n    }\n    if (options.frp) {\n      this.frpManager = new FrpcProcessManager({\n        binaryPath: options.frp.binaryPath,\n        configPath: options.frp.configPath,\n        workingDirectory: options.frp.workingDirectory,\n        logPrefix: options.frp.logPrefix,\n        autoRestart: options.frp.autoRestart,\n      });\n    }\n    \n    // 初始化网络检测器\n    if (options.enableNetworkDetection !== false) {\n      this.networkDetector = new EdgeNodeCapabilityDetector({\n        dynamicDetection: {\n          enableNetworkDetection: true,\n        },\n      });\n      // 执行初始网络检测\n      this.cachedNetworkInfo = await this.networkDetector.detectNetworkAddresses();\n      this.lastNetworkDetection = Date.now();\n      this.logger.info(`Network detection: IPv4=${this.cachedNetworkInfo.ipv4Public ?? this.cachedNetworkInfo.ipv4}, IPv6=${this.cachedNetworkInfo.ipv6Public ?? this.cachedNetworkInfo.ipv6}, hasPublicIPv6=${this.cachedNetworkInfo.hasPublicIPv6}`);\n    }\n    \n    const systemMetrics = options.includeSystemMetrics ? this.collectSystemMetrics() : undefined;\n    const metadataPayload = {\n      ...(options.metadata ?? {}),\n      system: systemMetrics,\n    } as Record<string, unknown>;\n\n    const certificatePayload = this.clusterCertificate?.getHeartbeatPayload();\n    const heartbeatOptions: EdgeNodeSignalClientOptions = {\n      edgeNodesEnabled: true,\n      signalEndpoint: options.signalEndpoint,\n      nodeId: options.nodeId,\n      nodeToken: options.nodeToken,\n      baseUrl: options.baseUrl,\n      publicAddress: options.publicAddress,\n      pods: options.pods,\n      intervalMs: options.intervalMs,\n      metadata: this.stringifyIfContent(metadataPayload),\n      metrics: systemMetrics ? JSON.stringify(systemMetrics) : undefined,\n      certificate: certificatePayload ? JSON.stringify(certificatePayload) : undefined,\n      onHeartbeatResponse: (data: unknown): void => {\n        this.handleHeartbeatResponse(data);\n        options.onHeartbeatResponse?.(data);\n      },\n      networkSupplier: this.networkDetector ? () => this.getNetworkInfo() : undefined,\n    };\n    if (this.frpManager) {\n      heartbeatOptions.tunnelSupplier = () => this.buildTunnelHeartbeatPayload();\n    }\n\n    this.heartbeat = new EdgeNodeSignalClient(heartbeatOptions);\n  }\n\n  public stop(): void {\n    if (this.heartbeat && typeof (this.heartbeat as any).dispose === 'function') {\n      (this.heartbeat as any).dispose();\n    }\n    this.heartbeat = undefined;\n    void this.frpManager?.stop();\n    this.clusterCertificate?.stop();\n  }\n\n  private stringifyIfContent(data: Record<string, unknown>): string | undefined {\n    const sanitized: Record<string, unknown> = {};\n    for (const [ key, value ] of Object.entries(data)) {\n      if (value !== undefined) {\n        sanitized[key] = value;\n      }\n    }\n    return Object.keys(sanitized).length > 0 ? JSON.stringify(sanitized) : undefined;\n  }\n\n  private collectSystemMetrics(): Record<string, unknown> {\n    const load = os.loadavg();\n    return {\n      hostname: os.hostname(),\n      platform: os.platform(),\n      arch: os.arch(),\n      uptime: os.uptime(),\n      cpuCount: os.cpus().length,\n      load1: load[0],\n      load5: load[1],\n      load15: load[2],\n      totalMem: os.totalmem(),\n      freeMem: os.freemem(),\n    };\n  }\n\n  private handleHeartbeatResponse(data: unknown): void {\n    if (!data || typeof data !== 'object') {\n      return;\n    }\n    const body = data as Record<string, any>;\n    const metadata = body.metadata as Record<string, any> | undefined;\n    this.clusterCertificate?.handleHeartbeatMetadata(metadata);\n    const tunnel = metadata?.tunnel as Record<string, any> | undefined;\n    const config = tunnel?.config as Record<string, any> | undefined;\n    if (config) {\n      this.logger.debug(`接收到隧道配置: ${JSON.stringify({ entrypoint: tunnel?.entrypoint, proxyName: config.proxyName })}`);\n    }\n    const entrypoint = typeof tunnel?.entrypoint === 'string' ? tunnel.entrypoint :\n      typeof config?.publicUrl === 'string' ? config.publicUrl : undefined;\n    void this.frpManager?.applyConfig(config as any, tunnel?.status as string | undefined, entrypoint);\n  }\n\n  private async issueCertificateLocally(options: EdgeNodeAgentOptions): Promise<void> {\n    const acmeOptions = options.acme!;\n    if (!acmeOptions.email || !acmeOptions.domains || acmeOptions.domains.length === 0) {\n      throw new Error('本地 ACME 模式需要提供 email 与 domains。');\n    }\n    if (!acmeOptions.accountKeyPath) {\n      throw new Error('本地 ACME 模式需要提供 accountKeyPath。');\n    }\n    const manager = new AcmeCertificateManager({\n      signalEndpoint: options.signalEndpoint,\n      nodeId: options.nodeId,\n      nodeToken: options.nodeToken,\n      email: acmeOptions.email!,\n      domains: acmeOptions.domains!,\n      directoryUrl: acmeOptions.directoryUrl,\n      accountKeyPath: acmeOptions.accountKeyPath!,\n      certificateKeyPath: acmeOptions.certificateKeyPath,\n      certificatePath: acmeOptions.certificatePath,\n      fullChainPath: acmeOptions.fullChainPath,\n      renewBeforeDays: acmeOptions.renewBeforeDays,\n      propagationDelayMs: acmeOptions.propagationDelayMs,\n    });\n    try {\n      const issued = await manager.ensureCertificate();\n      if (issued && acmeOptions.postDeployCommand && acmeOptions.postDeployCommand.length > 0) {\n        await this.runPostDeploy(acmeOptions.postDeployCommand);\n      }\n    } catch (error: unknown) {\n      this.logger.error(`自动签发证书失败：${(error as Error).message}`);\n      throw error;\n    }\n  }\n\n  private async ensureClusterCertificate(options: EdgeNodeAgentOptions): Promise<void> {\n    const acmeOptions = options.acme!;\n    if (!acmeOptions.certificateKeyPath || !acmeOptions.certificatePath) {\n      throw new Error('Cluster 模式需要提供 certificateKeyPath 与 certificatePath。');\n    }\n    const manager = new ClusterCertificateManager({\n      signalEndpoint: options.signalEndpoint,\n      nodeId: options.nodeId,\n      nodeToken: options.nodeToken,\n      certificateKeyPath: acmeOptions.certificateKeyPath,\n      certificatePath: acmeOptions.certificatePath,\n      fullChainPath: acmeOptions.fullChainPath,\n      renewBeforeDays: acmeOptions.renewBeforeDays,\n      onCertificateInstalled: acmeOptions.postDeployCommand ? () => this.runPostDeploy(acmeOptions.postDeployCommand!) : undefined,\n    });\n    this.clusterCertificate = manager;\n    await manager.start();\n  }\n\n  private async runPostDeploy(command: string[]): Promise<void> {\n    const [ executable, ...args ] = command;\n    if (!executable) {\n      return;\n    }\n    await new Promise<void>((resolve, reject) => {\n      const child = spawn(executable, args, { stdio: 'inherit' });\n      child.on('error', reject);\n      child.on('exit', (code) => {\n        if (code === 0) {\n          resolve();\n        } else {\n          reject(new Error(`命令 ${executable} 退出码 ${code}`));\n        }\n      });\n    });\n  }\n\n  private buildTunnelHeartbeatPayload(): Record<string, unknown> | undefined {\n    const status: FrpcRuntimeStatus | undefined = this.frpManager?.getStatus();\n    if (!status) {\n      return undefined;\n    }\n    return { client: status };\n  }\n\n  /**\n   * 获取网络信息（带缓存，每分钟刷新一次）\n   */\n  private async getNetworkInfo(): Promise<{ ipv4?: string; ipv6?: string }> {\n    const now = Date.now();\n    \n    // 如果缓存过期，重新检测\n    if (!this.cachedNetworkInfo || (now - this.lastNetworkDetection) > this.networkDetectionIntervalMs) {\n      if (this.networkDetector) {\n        try {\n          this.cachedNetworkInfo = await this.networkDetector.detectNetworkAddresses();\n          this.lastNetworkDetection = now;\n        } catch (error: unknown) {\n          this.logger.debug(`Network detection failed: ${(error as Error).message}`);\n        }\n      }\n    }\n    \n    // 优先返回公网地址\n    return {\n      ipv4: this.cachedNetworkInfo?.ipv4Public ?? this.cachedNetworkInfo?.ipv4,\n      ipv6: this.cachedNetworkInfo?.ipv6Public ?? this.cachedNetworkInfo?.ipv6,\n    };\n  }\n}\n"]}

package/dist/edge/EdgeNodeDnsCoordinator.d.ts

@@ -1,7 +1,7 @@
 import type { DnsProvider, DnsRecordTypeValue } from '../dns/DnsProvider';
 export interface EdgeNodeDnsCoordinatorOptions {
     provider: DnsProvider;
-    /** 顶级域名，例如 `xpod.example`。 */
+    /** 顶级域名，例如 `undefineds.site`。 */
     rootDomain?: string | null;
     /**
      * 默认记录类型，当目标地址无法识别时回退使用。
@@ -10,11 +10,6 @@ export interface EdgeNodeDnsCoordinatorOptions {
     defaultRecordType?: DnsRecordTypeValue;
     /** TTL 秒数，缺省按供应商默认。 */
     ttl?: number | string | null;
-    /**
-     * Cluster 的公网 IP 地址，用于 proxy 模式的 DNS 指向。
-     * 如果未设置，proxy 模式节点将跳过 DNS 同步。
-     */
-    clusterIp?: string | null;
 }
 export declare class EdgeNodeDnsCoordinator {
     private readonly logger;
@@ -22,7 +17,6 @@ export declare class EdgeNodeDnsCoordinator {
     private readonly rootDomain?;
     private readonly defaultRecordType;
     private readonly ttl?;
-    private readonly clusterIp?;
     private readonly enabled;
     constructor(options: EdgeNodeDnsCoordinatorOptions);
     synchronize(nodeId: string, metadata: Record<string, unknown>): Promise<void>;

package/dist/edge/EdgeNodeDnsCoordinator.js

@@ -9,7 +9,6 @@ class EdgeNodeDnsCoordinator {
         this.rootDomain = this.normalizeRootDomain(options.rootDomain);
         this.defaultRecordType = options.defaultRecordType ?? 'A';
         this.ttl = this.normalizeTtl(options.ttl);
-        this.clusterIp = this.extractString(options.clusterIp);
         this.enabled = Boolean(this.rootDomain);
     }
     async synchronize(nodeId, metadata) {
@@ -17,55 +16,47 @@ class EdgeNodeDnsCoordinator {
             return;
         }
         const hints = this.extractDnsHints(metadata);
-        // Extract subdomain and access mode
         const subdomain = this.extractString(metadata.subdomain) ?? hints?.subdomain;
         if (!subdomain) {
             this.logger.debug(`Node ${nodeId} 未提供 subdomain，跳过 DNS 同步。`);
             return;
         }
-        const accessMode = this.extractString(metadata.accessMode);
-        const normalizedAccessMode = accessMode?.trim().toLowerCase();
-        // Determine DNS target based on access mode
+        // 用节点上报的地址（公网 IP 或隧道入口，由节点自行决定）
         let target;
         let recordType;
-        if (normalizedAccessMode === 'direct') {
-            // Direct mode: DNS 指向节点公网 IP
-            // 优先使用 IPv6（如果有），因为可以避免 NAT 问题
-            const ipv6 = this.extractString(metadata.ipv6);
-            const ipv4 = this.extractString(metadata.ipv4);
-            const publicIp = this.extractString(metadata.publicIp);
-            const publicAddress = this.extractString(metadata.publicAddress);
-            // IPv6 优先策略：如果有公网 IPv6，优先使用
-            if (ipv6 && this.isIpv6(ipv6)) {
-                target = ipv6;
-                recordType = 'AAAA';
-                this.logger.debug(`Node ${nodeId} 使用 IPv6 地址: ${ipv6}`);
-            }
-            else {
-                target = publicIp ?? ipv4 ?? publicAddress;
-            }
-            if (!target && hints?.target) {
-                target = hints.target;
-            }
-            if (!target) {
-                this.logger.warn(`Node ${nodeId} (direct mode) 未提供公网 IP，跳过 DNS 同步。`);
-                return;
-            }
+        const ipv6 = this.extractString(metadata.ipv6);
+        const ipv4 = this.extractString(metadata.ipv4);
+        const publicAddress = this.extractString(metadata.publicAddress);
+        // IPv6 优先
+        if (ipv6 && this.isIpv6(ipv6)) {
+            target = ipv6;
+            recordType = 'AAAA';
+            this.logger.debug(`Node ${nodeId} 使用 IPv6 地址: ${ipv6}`);
         }
-        else if (normalizedAccessMode === 'proxy') {
-            // Proxy mode: DNS 指向 Cluster IP
-            if (!this.clusterIp) {
-                this.logger.debug(`Cluster IP 未配置，跳过 proxy 模式节点 ${nodeId} 的 DNS 同步。`);
-                return;
-            }
-            target = this.clusterIp;
+        else {
+            target = ipv4 ?? publicAddress;
         }
-        else if (hints?.target) {
-            // Fallback: 使用旧的逻辑从 metadata 提取
+        if (!target && hints?.target) {
             target = hints.target;
         }
-        else {
-            this.logger.debug(`Node ${nodeId} 未提供 accessMode/dns hints，跳过同步。`);
+        if (!target) {
+            this.logger.debug(`Node ${nodeId} 未提供可用地址，跳过 DNS 同步。`);
+            return;
+        }
+        // 健康检查未通过时删除 DNS 记录
+        const connectivityStatus = this.extractString(metadata.connectivityStatus);
+        if (connectivityStatus === 'unreachable') {
+            this.logger.info(`节点 ${nodeId} 不可达，删除 DNS 记录 ${subdomain}.${this.rootDomain}`);
+            try {
+                await this.provider.deleteRecord({
+                    domain: this.rootDomain,
+                    subdomain,
+                    type: recordType ?? this.defaultRecordType,
+                });
+            }
+            catch (error) {
+                this.logger.error(`删除节点 ${nodeId} DNS 记录失败: ${error.message}`);
+            }
             return;
         }
         const type = recordType ?? this.detectRecordType(target) ?? this.defaultRecordType;
@@ -82,8 +73,7 @@ class EdgeNodeDnsCoordinator {
                 value,
                 ttl: this.ttl,
             });
-            const loggedMode = normalizedAccessMode ?? 'unknown';
-            this.logger.info(`已同步节点 ${nodeId} (${loggedMode}) 的 DNS: ${subdomain}.${this.rootDomain} -> ${value}`);
+            this.logger.info(`已同步节点 ${nodeId} 的 DNS: ${subdomain}.${this.rootDomain} -> ${value}`);
         }
         catch (error) {
             this.logger.error(`同步节点 ${nodeId} DNS 记录失败: ${error.message}`);

package/dist/edge/EdgeNodeDnsCoordinator.js.map

@@ -1 +1 @@
-{"version":3,"file":"EdgeNodeDnsCoordinator.js","sourceRoot":"","sources":["../../src/edge/EdgeNodeDnsCoordinator.ts"],"names":[],"mappings":"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","sourcesContent":["import { getLoggerFor } from 'global-logger-factory';\nimport type { DnsProvider, DnsRecordTypeValue } from '../dns/DnsProvider';\n\nexport interface EdgeNodeDnsCoordinatorOptions {\n  provider: DnsProvider;\n  /** 顶级域名，例如 `xpod.example`。 */\n  rootDomain?: string | null;\n  /**\n   * 默认记录类型，当目标地址无法识别时回退使用。\n   * 一般为 `A`（IPv4）或 `AAAA`（IPv6）。\n   */\n  defaultRecordType?: DnsRecordTypeValue;\n  /** TTL 秒数，缺省按供应商默认。 */\n  ttl?: number | string | null;\n  /**\n   * Cluster 的公网 IP 地址，用于 proxy 模式的 DNS 指向。\n   * 如果未设置，proxy 模式节点将跳过 DNS 同步。\n   */\n  clusterIp?: string | null;\n}\n\nexport class EdgeNodeDnsCoordinator {\n  private readonly logger = getLoggerFor(this);\n  private readonly provider: DnsProvider;\n  private readonly rootDomain?: string;\n  private readonly defaultRecordType: DnsRecordTypeValue;\n  private readonly ttl?: number;\n  private readonly clusterIp?: string;\n  private readonly enabled: boolean;\n\n  public constructor(options: EdgeNodeDnsCoordinatorOptions) {\n    this.provider = options.provider;\n    this.rootDomain = this.normalizeRootDomain(options.rootDomain);\n    this.defaultRecordType = options.defaultRecordType ?? 'A';\n    this.ttl = this.normalizeTtl(options.ttl);\n    this.clusterIp = this.extractString(options.clusterIp);\n    this.enabled = Boolean(this.rootDomain);\n  }\n\n  public async synchronize(nodeId: string, metadata: Record<string, unknown>): Promise<void> {\n    if (!this.enabled) {\n      return;\n    }\n    \n    const hints = this.extractDnsHints(metadata);\n\n    // Extract subdomain and access mode\n    const subdomain = this.extractString(metadata.subdomain) ?? hints?.subdomain;\n    if (!subdomain) {\n      this.logger.debug(`Node ${nodeId} 未提供 subdomain，跳过 DNS 同步。`);\n      return;\n    }\n    \n    const accessMode = this.extractString(metadata.accessMode);\n    const normalizedAccessMode = accessMode?.trim().toLowerCase();\n    \n    // Determine DNS target based on access mode\n    let target: string | undefined;\n    let recordType: DnsRecordTypeValue | undefined;\n    \n    if (normalizedAccessMode === 'direct') {\n      // Direct mode: DNS 指向节点公网 IP\n      // 优先使用 IPv6（如果有），因为可以避免 NAT 问题\n      const ipv6 = this.extractString(metadata.ipv6);\n      const ipv4 = this.extractString(metadata.ipv4);\n      const publicIp = this.extractString(metadata.publicIp);\n      const publicAddress = this.extractString(metadata.publicAddress);\n      \n      // IPv6 优先策略：如果有公网 IPv6，优先使用\n      if (ipv6 && this.isIpv6(ipv6)) {\n        target = ipv6;\n        recordType = 'AAAA';\n        this.logger.debug(`Node ${nodeId} 使用 IPv6 地址: ${ipv6}`);\n      } else {\n        target = publicIp ?? ipv4 ?? publicAddress;\n      }\n      \n      if (!target && hints?.target) {\n        target = hints.target;\n      }\n\n      if (!target) {\n        this.logger.warn(`Node ${nodeId} (direct mode) 未提供公网 IP，跳过 DNS 同步。`);\n        return;\n      }\n    } else if (normalizedAccessMode === 'proxy') {\n      // Proxy mode: DNS 指向 Cluster IP\n      if (!this.clusterIp) {\n        this.logger.debug(`Cluster IP 未配置，跳过 proxy 模式节点 ${nodeId} 的 DNS 同步。`);\n        return;\n      }\n      target = this.clusterIp;\n    } else if (hints?.target) {\n      // Fallback: 使用旧的逻辑从 metadata 提取\n      target = hints.target;\n    } else {\n      this.logger.debug(`Node ${nodeId} 未提供 accessMode/dns hints，跳过同步。`);\n      return;\n    }\n    \n    const type = recordType ?? this.detectRecordType(target) ?? this.defaultRecordType;\n    const value = this.normalizeRecordValue(target, type);\n\n    if (!value) {\n      this.logger.warn(`Edge node ${nodeId} DNS 目标解析失败，跳过同步。`);\n      return;\n    }\n\n    try {\n      await this.provider.upsertRecord({\n        domain: this.rootDomain!,\n        subdomain,\n        type,\n        value,\n        ttl: this.ttl,\n      });\n      const loggedMode = normalizedAccessMode ?? 'unknown';\n      this.logger.info(`已同步节点 ${nodeId} (${loggedMode}) 的 DNS: ${subdomain}.${this.rootDomain} -> ${value}`);\n    } catch (error: unknown) {\n      this.logger.error(`同步节点 ${nodeId} DNS 记录失败: ${(error as Error).message}`);\n      throw error;\n    }\n  }\n\n  private extractDnsHints(metadata: Record<string, unknown>): { subdomain: string; target: string } | undefined {\n    const dns = metadata?.dns;\n    if (!dns || typeof dns !== 'object') {\n      return undefined;\n    }\n    const subdomain = this.extractString((dns as Record<string, unknown>).subdomain);\n    if (!subdomain) {\n      return undefined;\n    }\n\n    const target = this.extractString((dns as Record<string, unknown>).target)\n      ?? this.extractString(metadata.publicAddress)\n      ?? this.extractString(metadata.baseUrl);\n\n    if (!target) {\n      return undefined;\n    }\n    return { subdomain, target };\n  }\n\n  private extractString(value: unknown): string | undefined {\n    if (typeof value !== 'string') {\n      return undefined;\n    }\n    const trimmed = value.trim();\n    return trimmed.length > 0 ? trimmed : undefined;\n  }\n\n  private detectRecordType(target: string): DnsRecordTypeValue | undefined {\n    const host = this.extractHost(target) ?? target;\n    if (this.isIpv4(host)) {\n      return 'A';\n    }\n    if (this.isIpv6(host)) {\n      return 'AAAA';\n    }\n    if (host.includes('.')) {\n      return 'CNAME';\n    }\n    return undefined;\n  }\n\n  private normalizeRecordValue(target: string, type: DnsRecordTypeValue): string | undefined {\n    const host = this.extractHost(target) ?? target;\n    if (type === 'A' && this.isIpv4(host)) {\n      return host;\n    }\n    if (type === 'AAAA' && this.isIpv6(host)) {\n      return host;\n    }\n    if (type === 'CNAME') {\n      return host.endsWith('.') ? host : `${host}.`;\n    }\n    if (type === 'TXT') {\n      return host;\n    }\n    return undefined;\n  }\n\n  private extractHost(input: string): string | undefined {\n    try {\n      const url = new URL(input);\n      return url.hostname;\n    } catch {\n      return input;\n    }\n  }\n\n  private isIpv4(value: string): boolean {\n    const parts = value.split('.');\n    if (parts.length !== 4) {\n      return false;\n    }\n    return parts.every((part) => {\n      if (!/^[0-9]{1,3}$/.test(part)) {\n        return false;\n      }\n      const num = Number(part);\n      return num >= 0 && num <= 255;\n    });\n  }\n\n  private isIpv6(value: string): boolean {\n    return /^[0-9a-fA-F:]+$/.test(value) && value.includes(':');\n  }\n\n  private normalizeRootDomain(value?: string | null): string | undefined {\n    if (typeof value !== 'string') {\n      return undefined;\n    }\n    let trimmed = value.trim();\n    if (trimmed.includes('://')) {\n      try {\n        trimmed = new URL(trimmed).hostname;\n      } catch {\n        // ignore\n      }\n    }\n    trimmed = trimmed.replace(/\\.$/, '');\n    return trimmed.length > 0 ? trimmed : undefined;\n  }\n\n  private normalizeTtl(value?: number | string | null): number | undefined {\n    if (typeof value === 'number' && Number.isFinite(value) && value > 0) {\n      return Math.trunc(value);\n    }\n    if (typeof value === 'string') {\n      const parsed = Number(value.trim());\n      if (Number.isFinite(parsed) && parsed > 0) {\n        return Math.trunc(parsed);\n      }\n    }\n    return undefined;\n  }\n}\n"]}
+{"version":3,"file":"EdgeNodeDnsCoordinator.js","sourceRoot":"","sources":["../../src/edge/EdgeNodeDnsCoordinator.ts"],"names":[],"mappings":"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","sourcesContent":["import { getLoggerFor } from 'global-logger-factory';\nimport type { DnsProvider, DnsRecordTypeValue } from '../dns/DnsProvider';\n\nexport interface EdgeNodeDnsCoordinatorOptions {\n  provider: DnsProvider;\n  /** 顶级域名，例如 `undefineds.site`。 */\n  rootDomain?: string | null;\n  /**\n   * 默认记录类型，当目标地址无法识别时回退使用。\n   * 一般为 `A`（IPv4）或 `AAAA`（IPv6）。\n   */\n  defaultRecordType?: DnsRecordTypeValue;\n  /** TTL 秒数，缺省按供应商默认。 */\n  ttl?: number | string | null;\n}\n\nexport class EdgeNodeDnsCoordinator {\n  private readonly logger = getLoggerFor(this);\n  private readonly provider: DnsProvider;\n  private readonly rootDomain?: string;\n  private readonly defaultRecordType: DnsRecordTypeValue;\n  private readonly ttl?: number;\n  private readonly enabled: boolean;\n\n  public constructor(options: EdgeNodeDnsCoordinatorOptions) {\n    this.provider = options.provider;\n    this.rootDomain = this.normalizeRootDomain(options.rootDomain);\n    this.defaultRecordType = options.defaultRecordType ?? 'A';\n    this.ttl = this.normalizeTtl(options.ttl);\n    this.enabled = Boolean(this.rootDomain);\n  }\n\n  public async synchronize(nodeId: string, metadata: Record<string, unknown>): Promise<void> {\n    if (!this.enabled) {\n      return;\n    }\n\n    const hints = this.extractDnsHints(metadata);\n\n    const subdomain = this.extractString(metadata.subdomain) ?? hints?.subdomain;\n    if (!subdomain) {\n      this.logger.debug(`Node ${nodeId} 未提供 subdomain，跳过 DNS 同步。`);\n      return;\n    }\n\n    // 用节点上报的地址（公网 IP 或隧道入口，由节点自行决定）\n    let target: string | undefined;\n    let recordType: DnsRecordTypeValue | undefined;\n\n    const ipv6 = this.extractString(metadata.ipv6);\n    const ipv4 = this.extractString(metadata.ipv4);\n    const publicAddress = this.extractString(metadata.publicAddress);\n\n    // IPv6 优先\n    if (ipv6 && this.isIpv6(ipv6)) {\n      target = ipv6;\n      recordType = 'AAAA';\n      this.logger.debug(`Node ${nodeId} 使用 IPv6 地址: ${ipv6}`);\n    } else {\n      target = ipv4 ?? publicAddress;\n    }\n\n    if (!target && hints?.target) {\n      target = hints.target;\n    }\n\n    if (!target) {\n      this.logger.debug(`Node ${nodeId} 未提供可用地址，跳过 DNS 同步。`);\n      return;\n    }\n\n    // 健康检查未通过时删除 DNS 记录\n    const connectivityStatus = this.extractString(metadata.connectivityStatus);\n    if (connectivityStatus === 'unreachable') {\n      this.logger.info(`节点 ${nodeId} 不可达，删除 DNS 记录 ${subdomain}.${this.rootDomain}`);\n      try {\n        await this.provider.deleteRecord({\n          domain: this.rootDomain!,\n          subdomain,\n          type: recordType ?? this.defaultRecordType,\n        });\n      } catch (error: unknown) {\n        this.logger.error(`删除节点 ${nodeId} DNS 记录失败: ${(error as Error).message}`);\n      }\n      return;\n    }\n\n    const type = recordType ?? this.detectRecordType(target) ?? this.defaultRecordType;\n    const value = this.normalizeRecordValue(target, type);\n\n    if (!value) {\n      this.logger.warn(`Edge node ${nodeId} DNS 目标解析失败，跳过同步。`);\n      return;\n    }\n\n    try {\n      await this.provider.upsertRecord({\n        domain: this.rootDomain!,\n        subdomain,\n        type,\n        value,\n        ttl: this.ttl,\n      });\n      this.logger.info(`已同步节点 ${nodeId} 的 DNS: ${subdomain}.${this.rootDomain} -> ${value}`);\n    } catch (error: unknown) {\n      this.logger.error(`同步节点 ${nodeId} DNS 记录失败: ${(error as Error).message}`);\n      throw error;\n    }\n  }\n\n  private extractDnsHints(metadata: Record<string, unknown>): { subdomain: string; target: string } | undefined {\n    const dns = metadata?.dns;\n    if (!dns || typeof dns !== 'object') {\n      return undefined;\n    }\n    const subdomain = this.extractString((dns as Record<string, unknown>).subdomain);\n    if (!subdomain) {\n      return undefined;\n    }\n\n    const target = this.extractString((dns as Record<string, unknown>).target)\n      ?? this.extractString(metadata.publicAddress)\n      ?? this.extractString(metadata.baseUrl);\n\n    if (!target) {\n      return undefined;\n    }\n    return { subdomain, target };\n  }\n\n  private extractString(value: unknown): string | undefined {\n    if (typeof value !== 'string') {\n      return undefined;\n    }\n    const trimmed = value.trim();\n    return trimmed.length > 0 ? trimmed : undefined;\n  }\n\n  private detectRecordType(target: string): DnsRecordTypeValue | undefined {\n    const host = this.extractHost(target) ?? target;\n    if (this.isIpv4(host)) {\n      return 'A';\n    }\n    if (this.isIpv6(host)) {\n      return 'AAAA';\n    }\n    if (host.includes('.')) {\n      return 'CNAME';\n    }\n    return undefined;\n  }\n\n  private normalizeRecordValue(target: string, type: DnsRecordTypeValue): string | undefined {\n    const host = this.extractHost(target) ?? target;\n    if (type === 'A' && this.isIpv4(host)) {\n      return host;\n    }\n    if (type === 'AAAA' && this.isIpv6(host)) {\n      return host;\n    }\n    if (type === 'CNAME') {\n      return host.endsWith('.') ? host : `${host}.`;\n    }\n    if (type === 'TXT') {\n      return host;\n    }\n    return undefined;\n  }\n\n  private extractHost(input: string): string | undefined {\n    try {\n      const url = new URL(input);\n      return url.hostname;\n    } catch {\n      return input;\n    }\n  }\n\n  private isIpv4(value: string): boolean {\n    const parts = value.split('.');\n    if (parts.length !== 4) {\n      return false;\n    }\n    return parts.every((part) => {\n      if (!/^[0-9]{1,3}$/.test(part)) {\n        return false;\n      }\n      const num = Number(part);\n      return num >= 0 && num <= 255;\n    });\n  }\n\n  private isIpv6(value: string): boolean {\n    return /^[0-9a-fA-F:]+$/.test(value) && value.includes(':');\n  }\n\n  private normalizeRootDomain(value?: string | null): string | undefined {\n    if (typeof value !== 'string') {\n      return undefined;\n    }\n    let trimmed = value.trim();\n    if (trimmed.includes('://')) {\n      try {\n        trimmed = new URL(trimmed).hostname;\n      } catch {\n        // ignore\n      }\n    }\n    trimmed = trimmed.replace(/\\.$/, '');\n    return trimmed.length > 0 ? trimmed : undefined;\n  }\n\n  private normalizeTtl(value?: number | string | null): number | undefined {\n    if (typeof value === 'number' && Number.isFinite(value) && value > 0) {\n      return Math.trunc(value);\n    }\n    if (typeof value === 'string') {\n      const parsed = Number(value.trim());\n      if (Number.isFinite(parsed) && parsed > 0) {\n        return Math.trunc(parsed);\n      }\n    }\n    return undefined;\n  }\n}\n"]}

package/dist/edge/EdgeNodeDnsCoordinator.jsonld

@@ -27,7 +27,7 @@
               }
             ]
           },
-          "comment": "顶级域名，例如 `xpod.example`。"
+          "comment": "顶级域名，例如 `undefineds.site`。"
         },
         {
           "@id": "undefineds:dist/edge/EdgeNodeDnsCoordinator.jsonld#EdgeNodeDnsCoordinator_options_defaultRecordType",
@@ -78,22 +78,6 @@
             ]
           },
           "comment": "TTL 秒数，缺省按供应商默认。"
-        },
-        {
-          "@id": "undefineds:dist/edge/EdgeNodeDnsCoordinator.jsonld#EdgeNodeDnsCoordinator_options_clusterIp",
-          "range": {
-            "@type": "ParameterRangeUnion",
-            "parameterRangeElements": [
-              "xsd:string",
-              {
-                "@type": "ParameterRangeWildcard"
-              },
-              {
-                "@type": "ParameterRangeUndefined"
-              }
-            ]
-          },
-          "comment": "Cluster 的公网 IP 地址，用于 proxy 模式的 DNS 指向。 如果未设置，proxy 模式节点将跳过 DNS 同步。"
         }
       ],
       "memberFields": [
@@ -117,10 +101,6 @@
           "@id": "undefineds:dist/edge/EdgeNodeDnsCoordinator.jsonld#EdgeNodeDnsCoordinator__member_ttl",
           "memberFieldName": "ttl"
         },
-        {
-          "@id": "undefineds:dist/edge/EdgeNodeDnsCoordinator.jsonld#EdgeNodeDnsCoordinator__member_clusterIp",
-          "memberFieldName": "clusterIp"
-        },
         {
           "@id": "undefineds:dist/edge/EdgeNodeDnsCoordinator.jsonld#EdgeNodeDnsCoordinator__member_enabled",
           "memberFieldName": "enabled"
@@ -197,12 +177,6 @@
               "value": {
                 "@id": "undefineds:dist/edge/EdgeNodeDnsCoordinator.jsonld#EdgeNodeDnsCoordinator_options_ttl"
               }
-            },
-            {
-              "keyRaw": "clusterIp",
-              "value": {
-                "@id": "undefineds:dist/edge/EdgeNodeDnsCoordinator.jsonld#EdgeNodeDnsCoordinator_options_clusterIp"
-              }
             }
           ]
         }

package/dist/edge/EdgeNodeModeDetector.d.ts

@@ -1,6 +1,6 @@
 export interface NodeRegistrationInfo {
     nodeId: string;
-    publicIp?: string;
+    ipv4?: string;
     publicIpv6?: string;
     publicPort?: number;
     capabilities: NodeCapabilities;

package/dist/edge/EdgeNodeModeDetector.js

@@ -38,11 +38,11 @@ class EdgeNodeModeDetector {
         const supportsDirect = supportedModes.has('direct');
         const supportsProxy = supportedModes.has('proxy');
         // Prefer direct if supported and has public IP (IPv6 or IPv4)
-        const hasPublicIp = Boolean(nodeInfo.publicIp || nodeInfo.publicIpv6);
+        const hasPublicIp = Boolean(nodeInfo.ipv4 || nodeInfo.publicIpv6);
         let connectivityTest;
         if (supportsDirect && hasPublicIp) {
             // 优先测试 IPv6 连通性
-            const ipToTest = nodeInfo.publicIpv6 ?? nodeInfo.publicIp;
+            const ipToTest = nodeInfo.publicIpv6 ?? nodeInfo.ipv4;
             const port = nodeInfo.publicPort ?? 443;
             connectivityTest = await this.testDirectConnectivity(ipToTest, port);
             if (connectivityTest.success) {
@@ -55,11 +55,11 @@ class EdgeNodeModeDetector {
                 };
             }
             // 如果 IPv6 测试失败且有 IPv4，尝试 IPv4
-            if (nodeInfo.publicIpv6 && nodeInfo.publicIp) {
+            if (nodeInfo.publicIpv6 && nodeInfo.ipv4) {
                 this.logger.debug(`IPv6 connectivity failed for ${nodeInfo.nodeId}, trying IPv4...`);
-                connectivityTest = await this.testDirectConnectivity(nodeInfo.publicIp, port);
+                connectivityTest = await this.testDirectConnectivity(nodeInfo.ipv4, port);
                 if (connectivityTest.success) {
-                    this.logger.info(`Node ${nodeInfo.nodeId} is directly reachable via IPv4 at ${nodeInfo.publicIp}:${port}`);
+                    this.logger.info(`Node ${nodeInfo.nodeId} is directly reachable via IPv4 at ${nodeInfo.ipv4}:${port}`);
                     return {
                         accessMode: 'direct',
                         reason: 'Direct connectivity test passed (IPv4 fallback)',
@@ -95,10 +95,8 @@ class EdgeNodeModeDetector {
         };
     }
     generateSubdomain(nodeId) {
-        // Generate a unique subdomain based on node ID
-        // For now, use a simple approach - in production you might want more sophisticated logic
-        const sanitized = nodeId.replace(/[^a-zA-Z0-9-]/g, '').toLowerCase();
-        return `${sanitized}.${this.baseDomain}`;
+        // 只返回前缀，完整 FQDN 由 DnsCoordinator 的 rootDomain 拼接
+        return nodeId.replace(/[^a-zA-Z0-9-]/g, '').toLowerCase();
     }
     async testDirectConnectivity(ip, port) {
         let lastResult = await this.singleConnectivityAttempt(ip, port);
@@ -161,10 +159,10 @@ class EdgeNodeModeDetector {
     async recheckMode(currentMode, nodeInfo) {
         // Only recheck if currently in proxy mode and public IP is available
         const supportedModes = this.extractSupportedModes(nodeInfo.capabilities);
-        if (currentMode !== 'proxy' || !nodeInfo.publicIp || !supportedModes.has('direct')) {
+        if (currentMode !== 'proxy' || !nodeInfo.ipv4 || !supportedModes.has('direct')) {
             return null;
         }
-        const connectivityTest = await this.testDirectConnectivity(nodeInfo.publicIp, nodeInfo.publicPort ?? 443);
+        const connectivityTest = await this.testDirectConnectivity(nodeInfo.ipv4, nodeInfo.publicPort ?? 443);
         if (connectivityTest.success) {
             const subdomain = this.generateSubdomain(nodeInfo.nodeId);
             this.logger.info(`Node ${nodeInfo.nodeId} connectivity restored, switching to direct mode`);

package/dist/edge/EdgeNodeModeDetector.js.map

@@ -1 +1 @@
-{"version":3,"file":"EdgeNodeModeDetector.js","sourceRoot":"","sources":["../../src/edge/EdgeNodeModeDetector.ts"],"names":[],"mappings":"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","sourcesContent":["import { getLoggerFor } from 'global-logger-factory';\n\nexport interface NodeRegistrationInfo {\n  nodeId: string;\n  publicIp?: string;\n  publicIpv6?: string;\n  publicPort?: number;\n  capabilities: NodeCapabilities;\n}\n\nexport interface NodeCapabilities {\n  solidProtocolVersion?: string;\n  storageBackends?: string[];\n  authMethods?: string[];\n  maxBandwidth?: number;\n  supportedModes?: ('direct' | 'proxy')[];\n  location?: {\n    country?: string;\n    region?: string;\n    coordinates?: { lat: number; lon: number };\n  };\n}\n\nexport interface ModeDetectionResult {\n  accessMode: 'direct' | 'proxy';\n  reason: string;\n  subdomain: string;\n  connectivityTest?: {\n    success: boolean;\n    latency?: number;\n    error?: string;\n  };\n}\n\nexport interface EdgeNodeModeDetectorOptions {\n  baseDomain: string;\n  connectivityTimeoutMs?: number;\n  maxDirectModeAttempts?: number;\n}\n\nexport class EdgeNodeModeDetector {\n  private readonly logger = getLoggerFor(this);\n  private readonly baseDomain: string;\n  private readonly connectivityTimeoutMs: number;\n  private readonly maxDirectModeAttempts: number;\n\n  public constructor(options: EdgeNodeModeDetectorOptions) {\n    this.baseDomain = options.baseDomain;\n    this.connectivityTimeoutMs = options.connectivityTimeoutMs ?? 3000;\n    this.maxDirectModeAttempts = Math.max(1, options.maxDirectModeAttempts ?? 1);\n  }\n\n  public async detectMode(nodeInfo: NodeRegistrationInfo): Promise<ModeDetectionResult> {\n    const subdomain = this.generateSubdomain(nodeInfo.nodeId);\n    const supportedModes = this.extractSupportedModes(nodeInfo.capabilities);\n    const supportsDirect = supportedModes.has('direct');\n    const supportsProxy = supportedModes.has('proxy');\n\n    // Prefer direct if supported and has public IP (IPv6 or IPv4)\n    const hasPublicIp = Boolean(nodeInfo.publicIp || nodeInfo.publicIpv6);\n    let connectivityTest: { success: boolean; latencyMs?: number; error?: string } | undefined;\n\n    if (supportsDirect && hasPublicIp) {\n      // 优先测试 IPv6 连通性\n      const ipToTest = nodeInfo.publicIpv6 ?? nodeInfo.publicIp!;\n      const port = nodeInfo.publicPort ?? 443;\n      \n      connectivityTest = await this.testDirectConnectivity(ipToTest, port);\n\n      if (connectivityTest.success) {\n        this.logger.info(`Node ${nodeInfo.nodeId} is directly reachable at ${ipToTest}:${port}`);\n        return {\n          accessMode: 'direct',\n          reason: `Direct connectivity test passed (${nodeInfo.publicIpv6 ? 'IPv6' : 'IPv4'})`,\n          subdomain,\n          connectivityTest,\n        };\n      }\n      \n      // 如果 IPv6 测试失败且有 IPv4，尝试 IPv4\n      if (nodeInfo.publicIpv6 && nodeInfo.publicIp) {\n        this.logger.debug(`IPv6 connectivity failed for ${nodeInfo.nodeId}, trying IPv4...`);\n        connectivityTest = await this.testDirectConnectivity(nodeInfo.publicIp, port);\n        \n        if (connectivityTest.success) {\n          this.logger.info(`Node ${nodeInfo.nodeId} is directly reachable via IPv4 at ${nodeInfo.publicIp}:${port}`);\n          return {\n            accessMode: 'direct',\n            reason: 'Direct connectivity test passed (IPv4 fallback)',\n            subdomain,\n            connectivityTest,\n          };\n        }\n      }\n\n      this.logger.info(`Node ${nodeInfo.nodeId} is not directly reachable, will fall back to proxy if available: ${connectivityTest.error}`);\n      if (!supportsProxy) {\n        return {\n          accessMode: 'direct',\n          reason: `Direct connectivity failed and proxy not supported: ${connectivityTest.error}`,\n          subdomain,\n          connectivityTest,\n        };\n      }\n    }\n\n    // Direct not available or failed; if proxy supported, use proxy mode\n    if (supportsProxy) {\n      return {\n        accessMode: 'proxy',\n        reason: supportsDirect && hasPublicIp ? 'Direct connectivity failed, using proxy' : 'Direct not available, using proxy',\n        subdomain,\n        connectivityTest,\n      };\n    }\n\n    // Neither direct nor proxy viable\n    return {\n      accessMode: supportsDirect ? 'direct' : 'proxy',\n      reason: supportsDirect ? 'Direct mode only; no proxy configured' : 'Proxy only; no direct available',\n      subdomain,\n    };\n  }\n\n  private generateSubdomain(nodeId: string): string {\n    // Generate a unique subdomain based on node ID\n    // For now, use a simple approach - in production you might want more sophisticated logic\n    const sanitized = nodeId.replace(/[^a-zA-Z0-9-]/g, '').toLowerCase();\n    return `${sanitized}.${this.baseDomain}`;\n  }\n\n  private async testDirectConnectivity(ip: string, port: number): Promise<{\n    success: boolean;\n    latency?: number;\n    error?: string;\n  }> {\n    let lastResult = await this.singleConnectivityAttempt(ip, port);\n    if (lastResult.success || this.maxDirectModeAttempts === 1) {\n      return lastResult;\n    }\n\n    for (let attempt = 2; attempt <= this.maxDirectModeAttempts; attempt++) {\n      lastResult = await this.singleConnectivityAttempt(ip, port);\n      if (lastResult.success) {\n        return lastResult;\n      }\n    }\n    return lastResult;\n  }\n\n  private async singleConnectivityAttempt(ip: string, port: number): Promise<{\n    success: boolean;\n    latency?: number;\n    error?: string;\n  }> {\n    const net = await import('node:net');\n\n    return new Promise((resolve) => {\n      const startTime = Date.now();\n      const socket = new net.Socket();\n\n      const cleanup = (): void => {\n        socket.destroy();\n      };\n\n      const timeout = setTimeout(() => {\n        cleanup();\n        resolve({\n          success: false,\n          error: `Connection timeout after ${this.connectivityTimeoutMs}ms`,\n        });\n      }, this.connectivityTimeoutMs);\n\n      socket.on('connect', () => {\n        clearTimeout(timeout);\n        const latency = Date.now() - startTime;\n        cleanup();\n        resolve({\n          success: true,\n          latency,\n        });\n      });\n\n      socket.on('error', (error) => {\n        clearTimeout(timeout);\n        cleanup();\n        resolve({\n          success: false,\n          error: error.message,\n        });\n      });\n\n      try {\n        socket.connect(port, ip);\n      } catch (error) {\n        clearTimeout(timeout);\n        cleanup();\n        resolve({\n          success: false,\n          error: error instanceof Error ? error.message : 'Unknown connection error',\n        });\n      }\n    });\n  }\n\n  public async recheckMode(currentMode: string, nodeInfo: NodeRegistrationInfo): Promise<ModeDetectionResult | null> {\n    // Only recheck if currently in proxy mode and public IP is available\n    const supportedModes = this.extractSupportedModes(nodeInfo.capabilities);\n    if (currentMode !== 'proxy' || !nodeInfo.publicIp || !supportedModes.has('direct')) {\n      return null;\n    }\n\n    const connectivityTest = await this.testDirectConnectivity(\n      nodeInfo.publicIp,\n      nodeInfo.publicPort ?? 443\n    );\n\n    if (connectivityTest.success) {\n      const subdomain = this.generateSubdomain(nodeInfo.nodeId);\n      this.logger.info(`Node ${nodeInfo.nodeId} connectivity restored, switching to direct mode`);\n      return {\n        accessMode: 'direct',\n        reason: 'Direct connectivity restored',\n        subdomain,\n        connectivityTest,\n      };\n    }\n\n    return null;\n  }\n\n  private extractSupportedModes(capabilities: NodeCapabilities): Set<string> {\n    const modes = new Set<string>();\n    const rawModes = capabilities.supportedModes ?? ['direct', 'proxy'];\n    \n    for (const mode of rawModes) {\n      modes.add(mode);\n    }\n    \n    if (modes.size === 0) {\n      modes.add('direct');\n      modes.add('proxy');\n    }\n    return modes;\n  }\n}\n"]}
+{"version":3,"file":"EdgeNodeModeDetector.js","sourceRoot":"","sources":["../../src/edge/EdgeNodeModeDetector.ts"],"names":[],"mappings":"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","sourcesContent":["import { getLoggerFor } from 'global-logger-factory';\n\nexport interface NodeRegistrationInfo {\n  nodeId: string;\n  ipv4?: string;\n  publicIpv6?: string;\n  publicPort?: number;\n  capabilities: NodeCapabilities;\n}\n\nexport interface NodeCapabilities {\n  solidProtocolVersion?: string;\n  storageBackends?: string[];\n  authMethods?: string[];\n  maxBandwidth?: number;\n  supportedModes?: ('direct' | 'proxy')[];\n  location?: {\n    country?: string;\n    region?: string;\n    coordinates?: { lat: number; lon: number };\n  };\n}\n\nexport interface ModeDetectionResult {\n  accessMode: 'direct' | 'proxy';\n  reason: string;\n  subdomain: string;\n  connectivityTest?: {\n    success: boolean;\n    latency?: number;\n    error?: string;\n  };\n}\n\nexport interface EdgeNodeModeDetectorOptions {\n  baseDomain: string;\n  connectivityTimeoutMs?: number;\n  maxDirectModeAttempts?: number;\n}\n\nexport class EdgeNodeModeDetector {\n  private readonly logger = getLoggerFor(this);\n  private readonly baseDomain: string;\n  private readonly connectivityTimeoutMs: number;\n  private readonly maxDirectModeAttempts: number;\n\n  public constructor(options: EdgeNodeModeDetectorOptions) {\n    this.baseDomain = options.baseDomain;\n    this.connectivityTimeoutMs = options.connectivityTimeoutMs ?? 3000;\n    this.maxDirectModeAttempts = Math.max(1, options.maxDirectModeAttempts ?? 1);\n  }\n\n  public async detectMode(nodeInfo: NodeRegistrationInfo): Promise<ModeDetectionResult> {\n    const subdomain = this.generateSubdomain(nodeInfo.nodeId);\n    const supportedModes = this.extractSupportedModes(nodeInfo.capabilities);\n    const supportsDirect = supportedModes.has('direct');\n    const supportsProxy = supportedModes.has('proxy');\n\n    // Prefer direct if supported and has public IP (IPv6 or IPv4)\n    const hasPublicIp = Boolean(nodeInfo.ipv4 || nodeInfo.publicIpv6);\n    let connectivityTest: { success: boolean; latencyMs?: number; error?: string } | undefined;\n\n    if (supportsDirect && hasPublicIp) {\n      // 优先测试 IPv6 连通性\n      const ipToTest = nodeInfo.publicIpv6 ?? nodeInfo.ipv4!;\n      const port = nodeInfo.publicPort ?? 443;\n\n      connectivityTest = await this.testDirectConnectivity(ipToTest, port);\n\n      if (connectivityTest.success) {\n        this.logger.info(`Node ${nodeInfo.nodeId} is directly reachable at ${ipToTest}:${port}`);\n        return {\n          accessMode: 'direct',\n          reason: `Direct connectivity test passed (${nodeInfo.publicIpv6 ? 'IPv6' : 'IPv4'})`,\n          subdomain,\n          connectivityTest,\n        };\n      }\n\n      // 如果 IPv6 测试失败且有 IPv4，尝试 IPv4\n      if (nodeInfo.publicIpv6 && nodeInfo.ipv4) {\n        this.logger.debug(`IPv6 connectivity failed for ${nodeInfo.nodeId}, trying IPv4...`);\n        connectivityTest = await this.testDirectConnectivity(nodeInfo.ipv4, port);\n\n        if (connectivityTest.success) {\n          this.logger.info(`Node ${nodeInfo.nodeId} is directly reachable via IPv4 at ${nodeInfo.ipv4}:${port}`);\n          return {\n            accessMode: 'direct',\n            reason: 'Direct connectivity test passed (IPv4 fallback)',\n            subdomain,\n            connectivityTest,\n          };\n        }\n      }\n\n      this.logger.info(`Node ${nodeInfo.nodeId} is not directly reachable, will fall back to proxy if available: ${connectivityTest.error}`);\n      if (!supportsProxy) {\n        return {\n          accessMode: 'direct',\n          reason: `Direct connectivity failed and proxy not supported: ${connectivityTest.error}`,\n          subdomain,\n          connectivityTest,\n        };\n      }\n    }\n\n    // Direct not available or failed; if proxy supported, use proxy mode\n    if (supportsProxy) {\n      return {\n        accessMode: 'proxy',\n        reason: supportsDirect && hasPublicIp ? 'Direct connectivity failed, using proxy' : 'Direct not available, using proxy',\n        subdomain,\n        connectivityTest,\n      };\n    }\n\n    // Neither direct nor proxy viable\n    return {\n      accessMode: supportsDirect ? 'direct' : 'proxy',\n      reason: supportsDirect ? 'Direct mode only; no proxy configured' : 'Proxy only; no direct available',\n      subdomain,\n    };\n  }\n\n  private generateSubdomain(nodeId: string): string {\n    // 只返回前缀，完整 FQDN 由 DnsCoordinator 的 rootDomain 拼接\n    return nodeId.replace(/[^a-zA-Z0-9-]/g, '').toLowerCase();\n  }\n\n  private async testDirectConnectivity(ip: string, port: number): Promise<{\n    success: boolean;\n    latency?: number;\n    error?: string;\n  }> {\n    let lastResult = await this.singleConnectivityAttempt(ip, port);\n    if (lastResult.success || this.maxDirectModeAttempts === 1) {\n      return lastResult;\n    }\n\n    for (let attempt = 2; attempt <= this.maxDirectModeAttempts; attempt++) {\n      lastResult = await this.singleConnectivityAttempt(ip, port);\n      if (lastResult.success) {\n        return lastResult;\n      }\n    }\n    return lastResult;\n  }\n\n  private async singleConnectivityAttempt(ip: string, port: number): Promise<{\n    success: boolean;\n    latency?: number;\n    error?: string;\n  }> {\n    const net = await import('node:net');\n\n    return new Promise((resolve) => {\n      const startTime = Date.now();\n      const socket = new net.Socket();\n\n      const cleanup = (): void => {\n        socket.destroy();\n      };\n\n      const timeout = setTimeout(() => {\n        cleanup();\n        resolve({\n          success: false,\n          error: `Connection timeout after ${this.connectivityTimeoutMs}ms`,\n        });\n      }, this.connectivityTimeoutMs);\n\n      socket.on('connect', () => {\n        clearTimeout(timeout);\n        const latency = Date.now() - startTime;\n        cleanup();\n        resolve({\n          success: true,\n          latency,\n        });\n      });\n\n      socket.on('error', (error) => {\n        clearTimeout(timeout);\n        cleanup();\n        resolve({\n          success: false,\n          error: error.message,\n        });\n      });\n\n      try {\n        socket.connect(port, ip);\n      } catch (error) {\n        clearTimeout(timeout);\n        cleanup();\n        resolve({\n          success: false,\n          error: error instanceof Error ? error.message : 'Unknown connection error',\n        });\n      }\n    });\n  }\n\n  public async recheckMode(currentMode: string, nodeInfo: NodeRegistrationInfo): Promise<ModeDetectionResult | null> {\n    // Only recheck if currently in proxy mode and public IP is available\n    const supportedModes = this.extractSupportedModes(nodeInfo.capabilities);\n    if (currentMode !== 'proxy' || !nodeInfo.ipv4 || !supportedModes.has('direct')) {\n      return null;\n    }\n\n    const connectivityTest = await this.testDirectConnectivity(\n      nodeInfo.ipv4,\n      nodeInfo.publicPort ?? 443\n    );\n\n    if (connectivityTest.success) {\n      const subdomain = this.generateSubdomain(nodeInfo.nodeId);\n      this.logger.info(`Node ${nodeInfo.nodeId} connectivity restored, switching to direct mode`);\n      return {\n        accessMode: 'direct',\n        reason: 'Direct connectivity restored',\n        subdomain,\n        connectivityTest,\n      };\n    }\n\n    return null;\n  }\n\n  private extractSupportedModes(capabilities: NodeCapabilities): Set<string> {\n    const modes = new Set<string>();\n    const rawModes = capabilities.supportedModes ?? ['direct', 'proxy'];\n    \n    for (const mode of rawModes) {\n      modes.add(mode);\n    }\n    \n    if (modes.size === 0) {\n      modes.add('direct');\n      modes.add('proxy');\n    }\n    return modes;\n  }\n}\n"]}

package/dist/http/ClusterIngressRouter.js

@@ -106,7 +106,7 @@ class ClusterIngressRouter extends community_server_1.HttpHandler {
                 throw new community_server_2.InternalServerError(`Node ${nodeId} connectivity info not found.`);
             }
             const mode = this.normalizeMode(nodeInfo.accessMode);
-            if (mode === 'direct' && nodeInfo.publicIp) {
+            if (mode === 'direct' && nodeInfo.ipv4) {
                 await this.handleDirectModeRedirect(response, nodeInfo, url);
             }
             else if (mode === 'proxy') {
@@ -128,13 +128,13 @@ class ClusterIngressRouter extends community_server_1.HttpHandler {
      */
     async handleDirectModeRedirect(response, nodeInfo, url) {
         const port = nodeInfo.publicPort && nodeInfo.publicPort !== 443 ? `:${nodeInfo.publicPort}` : '';
-        const nodeDirectUrl = `https://${nodeInfo.publicIp}${port}${url.pathname}${url.search}${url.hash}`;
+        const nodeDirectUrl = `https://${nodeInfo.ipv4}${port}${url.pathname}${url.search}${url.hash}`;
         this.logger.debug(`Redirecting to edge node (direct mode): ${nodeDirectUrl}`);
         response.statusCode = 307;
         response.setHeader('Location', nodeDirectUrl);
         response.setHeader('Cache-Control', 'no-cache');
         response.setHeader('X-Xpod-Direct-Node', nodeInfo.nodeId);
-        response.setHeader('X-Xpod-Target-IP', nodeInfo.publicIp);
+        response.setHeader('X-Xpod-Target-IP', nodeInfo.ipv4);
         response.end();
     }
     /**