@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/edge/Dns01CertificateProvisioner.jsonld

@@ -0,0 +1,148 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner",
+      "@type": "Class",
+      "requireElement": "Dns01CertificateProvisioner",
+      "extends": [
+        "undefineds:dist/edge/EdgeNodeCertificateProvisioner.jsonld#EdgeNodeCertificateProvisioner"
+      ],
+      "parameters": [
+        {
+          "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner_options_provider",
+          "range": "undefineds:dist/dns/DnsProvider.jsonld#DnsProvider"
+        },
+        {
+          "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner_options_rootDomain",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeWildcard"
+              },
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner_options_ttl",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:number",
+              "xsd:string",
+              {
+                "@type": "ParameterRangeWildcard"
+              },
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner__member_logger",
+          "memberFieldName": "logger"
+        },
+        {
+          "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner__member_provider",
+          "memberFieldName": "provider"
+        },
+        {
+          "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner__member_rootDomain",
+          "memberFieldName": "rootDomain"
+        },
+        {
+          "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner__member_ttl",
+          "memberFieldName": "ttl"
+        },
+        {
+          "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner__member_enabled",
+          "memberFieldName": "enabled"
+        },
+        {
+          "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner__member_handleCertificateRequest",
+          "memberFieldName": "handleCertificateRequest"
+        },
+        {
+          "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner__member_publishChallenge",
+          "memberFieldName": "publishChallenge"
+        },
+        {
+          "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner__member_removeChallenge",
+          "memberFieldName": "removeChallenge"
+        },
+        {
+          "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner__member_extractPayload",
+          "memberFieldName": "extractPayload"
+        },
+        {
+          "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner__member_extractSubdomain",
+          "memberFieldName": "extractSubdomain"
+        },
+        {
+          "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner__member_asString",
+          "memberFieldName": "asString"
+        },
+        {
+          "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner__member_composeHost",
+          "memberFieldName": "composeHost"
+        },
+        {
+          "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner__member_splitHost",
+          "memberFieldName": "splitHost"
+        },
+        {
+          "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner__member_normalizeRootDomain",
+          "memberFieldName": "normalizeRootDomain"
+        },
+        {
+          "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner__member_normalizeTtl",
+          "memberFieldName": "normalizeTtl"
+        },
+        {
+          "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner__member_removeRecord",
+          "memberFieldName": "removeRecord"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "provider",
+              "value": {
+                "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner_options_provider"
+              }
+            },
+            {
+              "keyRaw": "rootDomain",
+              "value": {
+                "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner_options_rootDomain"
+              }
+            },
+            {
+              "keyRaw": "ttl",
+              "value": {
+                "@id": "undefineds:dist/edge/Dns01CertificateProvisioner.jsonld#Dns01CertificateProvisioner_options_ttl"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/edge/EdgeNodeAgent.d.ts

@@ -0,0 +1,56 @@
+export interface EdgeNodeAgentOptions {
+    signalEndpoint: string;
+    nodeId: string;
+    nodeToken: string;
+    baseUrl?: string;
+    publicAddress?: string;
+    pods?: string[];
+    includeSystemMetrics?: boolean;
+    enableNetworkDetection?: boolean;
+    metadata?: Record<string, unknown>;
+    intervalMs?: number;
+    onHeartbeatResponse?: (data: unknown) => void;
+    acme?: {
+        mode?: 'local' | 'cluster';
+        email?: string;
+        domains?: string[];
+        directoryUrl?: string;
+        accountKeyPath?: string;
+        certificateKeyPath: string;
+        certificatePath: string;
+        fullChainPath?: string;
+        renewBeforeDays?: number;
+        propagationDelayMs?: number;
+        postDeployCommand?: string[];
+    };
+    frp?: {
+        binaryPath: string;
+        configPath: string;
+        workingDirectory?: string;
+        logPrefix?: string;
+        autoRestart?: boolean;
+    };
+}
+export declare class EdgeNodeAgent {
+    private readonly logger;
+    private heartbeat?;
+    private frpManager?;
+    private clusterCertificate?;
+    private networkDetector?;
+    private cachedNetworkInfo?;
+    private lastNetworkDetection;
+    private readonly networkDetectionIntervalMs;
+    start(options: EdgeNodeAgentOptions): Promise<void>;
+    stop(): void;
+    private stringifyIfContent;
+    private collectSystemMetrics;
+    private handleHeartbeatResponse;
+    private issueCertificateLocally;
+    private ensureClusterCertificate;
+    private runPostDeploy;
+    private buildTunnelHeartbeatPayload;
+    /**
+     * 获取网络信息（带缓存，每分钟刷新一次）
+     */
+    private getNetworkInfo;
+}

package/dist/edge/EdgeNodeAgent.js

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

package/dist/edge/EdgeNodeAgent.js.map

@@ -0,0 +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"]}

package/dist/edge/EdgeNodeAgent.jsonld

@@ -0,0 +1,89 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent",
+      "@type": "Class",
+      "requireElement": "EdgeNodeAgent",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_logger",
+          "memberFieldName": "logger"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_heartbeat",
+          "memberFieldName": "heartbeat"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_frpManager",
+          "memberFieldName": "frpManager"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_clusterCertificate",
+          "memberFieldName": "clusterCertificate"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_networkDetector",
+          "memberFieldName": "networkDetector"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_cachedNetworkInfo",
+          "memberFieldName": "cachedNetworkInfo"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_lastNetworkDetection",
+          "memberFieldName": "lastNetworkDetection"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_networkDetectionIntervalMs",
+          "memberFieldName": "networkDetectionIntervalMs"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_start",
+          "memberFieldName": "start"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_stop",
+          "memberFieldName": "stop"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_stringifyIfContent",
+          "memberFieldName": "stringifyIfContent"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_collectSystemMetrics",
+          "memberFieldName": "collectSystemMetrics"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_handleHeartbeatResponse",
+          "memberFieldName": "handleHeartbeatResponse"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_issueCertificateLocally",
+          "memberFieldName": "issueCertificateLocally"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_ensureClusterCertificate",
+          "memberFieldName": "ensureClusterCertificate"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_runPostDeploy",
+          "memberFieldName": "runPostDeploy"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_buildTunnelHeartbeatPayload",
+          "memberFieldName": "buildTunnelHeartbeatPayload"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeAgent.jsonld#EdgeNodeAgent__member_getNetworkInfo",
+          "memberFieldName": "getNetworkInfo"
+        }
+      ],
+      "constructorArguments": []
+    }
+  ]
+}

package/dist/edge/EdgeNodeAgentInitializer.d.ts

@@ -0,0 +1,25 @@
+import { Initializer } from '@solid/community-server';
+import { type EdgeNodeAgentOptions } from './EdgeNodeAgent';
+/**
+ * 所有配置项设为可选，以便在 disabled 状态下即使缺少 CLI 变量也能成功实例化。
+ */
+export interface EdgeNodeAgentInitializerOptions extends Partial<EdgeNodeAgentOptions> {
+    enabled?: boolean | string;
+}
+/**
+ * Initializer that starts the EdgeNodeAgent.
+ * Designed to be safe to configure even when disabled or missing dependent variables.
+ */
+export declare class EdgeNodeAgentInitializer extends Initializer {
+    protected readonly logger: import("global-logger-factory").Logger<unknown>;
+    private readonly agent;
+    private readonly options;
+    private readonly enabled;
+    constructor(options: EdgeNodeAgentInitializerOptions);
+    handle(): Promise<void>;
+    /**
+     * 确保启用时必需参数存在
+     */
+    private validateOptions;
+    private normalizeBoolean;
+}

package/dist/edge/EdgeNodeAgentInitializer.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EdgeNodeAgentInitializer = void 0;
+const community_server_1 = require("@solid/community-server");
+const global_logger_factory_1 = require("global-logger-factory");
+const EdgeNodeAgent_1 = require("./EdgeNodeAgent");
+/**
+ * Initializer that starts the EdgeNodeAgent.
+ * Designed to be safe to configure even when disabled or missing dependent variables.
+ */
+class EdgeNodeAgentInitializer extends community_server_1.Initializer {
+    constructor(options) {
+        super();
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.options = options;
+        this.agent = new EdgeNodeAgent_1.EdgeNodeAgent();
+        this.enabled = this.normalizeBoolean(options.enabled);
+    }
+    async handle() {
+        if (!this.enabled) {
+            this.logger.debug('EdgeNodeAgent is disabled, skipping startup.');
+            return;
+        }
+        this.logger.info('Enabling EdgeNodeAgent...');
+        // 运行时严格校验参数
+        this.validateOptions(this.options);
+        try {
+            // 此时已确认 options 符合 EdgeNodeAgentOptions (去除 Partial)
+            await this.agent.start(this.options);
+            this.logger.info(`EdgeNodeAgent started (Node: ${this.options.nodeId})`);
+        }
+        catch (error) {
+            this.logger.error(`Failed to start EdgeNodeAgent: ${error.message}`);
+            throw error;
+        }
+    }
+    /**
+     * 确保启用时必需参数存在
+     */
+    validateOptions(options) {
+        const missing = [];
+        if (!options.signalEndpoint)
+            missing.push('signalEndpoint');
+        if (!options.nodeId)
+            missing.push('nodeId');
+        if (!options.nodeToken)
+            missing.push('nodeToken');
+        if (missing.length > 0) {
+            throw new Error(`EdgeNodeAgent enabled but missing required configuration: ${missing.join(', ')}`);
+        }
+    }
+    normalizeBoolean(value) {
+        if (typeof value === 'boolean') {
+            return value;
+        }
+        if (typeof value === 'string') {
+            const normalized = value.trim().toLowerCase();
+            return normalized === 'true' || normalized === '1' || normalized === 'yes' || normalized === 'on';
+        }
+        return false;
+    }
+}
+exports.EdgeNodeAgentInitializer = EdgeNodeAgentInitializer;
+//# sourceMappingURL=EdgeNodeAgentInitializer.js.map

package/dist/edge/EdgeNodeAgentInitializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EdgeNodeAgentInitializer.js","sourceRoot":"","sources":["../../src/edge/EdgeNodeAgentInitializer.ts"],"names":[],"mappings":";;;AAAA,8DAAsD;AACtD,iEAAqD;AACrD,mDAA2E;AAS3E;;;GAGG;AACH,MAAa,wBAAyB,SAAQ,8BAAW;IAMvD,YAAmB,OAAwC;QACzD,KAAK,EAAE,CAAC;QANS,WAAM,GAAG,IAAA,oCAAY,EAAC,IAAI,CAAC,CAAC;QAO7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,IAAI,6BAAa,EAAE,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,CAAC;IAEe,KAAK,CAAC,MAAM;QAC1B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;YAClE,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAE9C,YAAY;QACZ,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEnC,IAAI,CAAC;YACH,qDAAqD;YACrD,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAA+B,CAAC,CAAC;YAC7D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3E,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAmC,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;YAChF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,OAAwC;QAC9D,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,IAAI,CAAC,OAAO,CAAC,cAAc;YAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC5D,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,CAAC,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAElD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,6DAA6D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;IAEO,gBAAgB,CAAC,KAAmC;QAC1D,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC9C,OAAO,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,KAAK,IAAI,UAAU,KAAK,IAAI,CAAC;QACpG,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AA3DD,4DA2DC","sourcesContent":["import { Initializer } from '@solid/community-server';\nimport { getLoggerFor } from 'global-logger-factory';\nimport { EdgeNodeAgent, type EdgeNodeAgentOptions } from './EdgeNodeAgent';\n\n/**\n * 所有配置项设为可选，以便在 disabled 状态下即使缺少 CLI 变量也能成功实例化。\n */\nexport interface EdgeNodeAgentInitializerOptions extends Partial<EdgeNodeAgentOptions> {\n  enabled?: boolean | string;\n}\n\n/**\n * Initializer that starts the EdgeNodeAgent.\n * Designed to be safe to configure even when disabled or missing dependent variables.\n */\nexport class EdgeNodeAgentInitializer extends Initializer {\n  protected readonly logger = getLoggerFor(this);\n  private readonly agent: EdgeNodeAgent;\n  private readonly options: EdgeNodeAgentInitializerOptions;\n  private readonly enabled: boolean;\n\n  public constructor(options: EdgeNodeAgentInitializerOptions) {\n    super();\n    this.options = options;\n    this.agent = new EdgeNodeAgent();\n    this.enabled = this.normalizeBoolean(options.enabled);\n  }\n\n  public override async handle(): Promise<void> {\n    if (!this.enabled) {\n      this.logger.debug('EdgeNodeAgent is disabled, skipping startup.');\n      return;\n    }\n\n    this.logger.info('Enabling EdgeNodeAgent...');\n    \n    // 运行时严格校验参数\n    this.validateOptions(this.options);\n\n    try {\n      // 此时已确认 options 符合 EdgeNodeAgentOptions (去除 Partial)\n      await this.agent.start(this.options as EdgeNodeAgentOptions);\n      this.logger.info(`EdgeNodeAgent started (Node: ${this.options.nodeId})`);\n    } catch (error: unknown) {\n      this.logger.error(`Failed to start EdgeNodeAgent: ${(error as Error).message}`);\n      throw error;\n    }\n  }\n\n  /**\n   * 确保启用时必需参数存在\n   */\n  private validateOptions(options: EdgeNodeAgentInitializerOptions): asserts options is EdgeNodeAgentOptions {\n    const missing: string[] = [];\n    \n    if (!options.signalEndpoint) missing.push('signalEndpoint');\n    if (!options.nodeId) missing.push('nodeId');\n    if (!options.nodeToken) missing.push('nodeToken');\n\n    if (missing.length > 0) {\n      throw new Error(`EdgeNodeAgent enabled but missing required configuration: ${missing.join(', ')}`);\n    }\n  }\n\n  private normalizeBoolean(value: string | boolean | undefined): boolean {\n    if (typeof value === 'boolean') {\n      return value;\n    }\n    if (typeof value === 'string') {\n      const normalized = value.trim().toLowerCase();\n      return normalized === 'true' || normalized === '1' || normalized === 'yes' || normalized === 'on';\n    }\n    return false;\n  }\n}\n"]}