@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/tunnel/CloudflareTunnelProvider.js

@@ -0,0 +1,376 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudflareTunnelProvider = void 0;
+const node_child_process_1 = require("node:child_process");
+/** cloudflared metrics 端口 */
+const CLOUDFLARED_METRICS_PORT = 33863;
+/**
+ * Cloudflare Tunnel Provider
+ *
+ * 使用 Cloudflare Tunnel 实现隧道穿透
+ */
+class CloudflareTunnelProvider {
+    constructor(options) {
+        this.name = 'cloudflare';
+        this.process = null;
+        this.status = {
+            running: false,
+            connected: false,
+        };
+        this.currentConfig = null;
+        /** 标记隧道进程是否由我们启动和管理 */
+        this.managedByUs = false;
+        this.apiToken = options.apiToken;
+        this.accountId = options.accountId;
+        this.baseDomain = options.baseDomain;
+        this.cloudflaredPath = options.cloudflaredPath ?? 'cloudflared';
+    }
+    /**
+     * 初始化隧道
+     */
+    async setup(options) {
+        const { subdomain, localPort } = options;
+        const fullDomain = `${subdomain}.${this.baseDomain}`;
+        // 1. 创建 Tunnel
+        const tunnel = await this.createTunnel(subdomain);
+        // 2. 配置 Tunnel ingress (指向本地端口)
+        await this.configureTunnelIngress(tunnel.id, fullDomain, localPort);
+        // 3. 创建 DNS CNAME 记录
+        await this.createDnsRecord(subdomain, tunnel.id);
+        // 4. 获取 Tunnel Token
+        const tunnelToken = await this.getTunnelToken(tunnel.id);
+        const config = {
+            subdomain,
+            provider: 'cloudflare',
+            endpoint: `https://${fullDomain}`,
+            tunnelId: tunnel.id,
+            tunnelToken,
+        };
+        this.currentConfig = config;
+        return config;
+    }
+    /**
+     * 启动隧道客户端
+     * 如果 cloudflared 已经在运行，则跳过启动
+     */
+    async start(config) {
+        // 检测是否已经在运行
+        const alreadyRunning = await this.isCloudflaredRunning();
+        if (alreadyRunning) {
+            console.log('[cloudflared] Already running externally, skipping start');
+            this.status = { running: true, connected: true, endpoint: config.endpoint };
+            this.currentConfig = config;
+            this.managedByUs = false;
+            return;
+        }
+        if (this.process) {
+            throw new Error('Tunnel already running');
+        }
+        if (!config.tunnelToken) {
+            throw new Error('Tunnel token is required');
+        }
+        this.status = { running: true, connected: false };
+        this.managedByUs = true;
+        this.process = (0, node_child_process_1.spawn)(this.cloudflaredPath, [
+            'tunnel',
+            '--protocol', 'http2',
+            '--no-autoupdate',
+            'run',
+            '--token',
+            config.tunnelToken,
+        ]);
+        this.process.stdout?.on('data', (data) => {
+            const output = data.toString();
+            console.log(`[cloudflared] ${output}`);
+            // 检测连接成功
+            if (output.includes('Connection registered') || output.includes('Registered tunnel connection')) {
+                this.status.connected = true;
+                this.status.lastHeartbeat = new Date();
+            }
+        });
+        this.process.stderr?.on('data', (data) => {
+            const output = data.toString();
+            console.error(`[cloudflared] ${output}`);
+            // 检测错误
+            if (output.includes('error') || output.includes('failed')) {
+                this.status.error = output;
+            }
+        });
+        this.process.on('exit', (code) => {
+            console.log(`[cloudflared] Process exited with code ${code}`);
+            this.status = { running: false, connected: false };
+            this.process = null;
+        });
+        this.currentConfig = config;
+        this.status.endpoint = config.endpoint;
+        // 等待连接建立
+        await this.waitForConnection();
+    }
+    /**
+     * 停止隧道
+     * 只有当隧道是由我们启动时才会停止
+     */
+    async stop() {
+        if (!this.managedByUs) {
+            console.log('[cloudflared] Not managed by us, skipping stop');
+            this.status = { running: false, connected: false };
+            return;
+        }
+        if (this.process) {
+            this.process.kill('SIGTERM');
+            // 等待进程退出
+            await new Promise((resolve) => {
+                const timeout = setTimeout(() => {
+                    this.process?.kill('SIGKILL');
+                    resolve();
+                }, 5000);
+                this.process?.on('exit', () => {
+                    clearTimeout(timeout);
+                    resolve();
+                });
+            });
+            this.process = null;
+        }
+        this.status = { running: false, connected: false };
+        this.managedByUs = false;
+    }
+    /**
+     * 获取隧道状态
+     */
+    getStatus() {
+        return { ...this.status };
+    }
+    /**
+     * 获取公网端点
+     */
+    getEndpoint() {
+        return this.currentConfig?.endpoint;
+    }
+    /**
+     * 清理资源
+     */
+    async cleanup(config) {
+        // 1. 停止隧道
+        await this.stop();
+        // 2. 删除 DNS 记录
+        if (config.subdomain) {
+            await this.deleteDnsRecord(config.subdomain);
+        }
+        // 3. 删除 Tunnel
+        if (config.tunnelId) {
+            await this.deleteTunnel(config.tunnelId);
+        }
+        this.currentConfig = null;
+    }
+    // ============ Cloudflare API 方法 ============
+    /**
+     * 创建 Tunnel
+     */
+    async createTunnel(name) {
+        const response = await this.cloudflareApi(`accounts/${this.accountId}/cfd_tunnel`, 'POST', {
+            name: `xpod-${name}`,
+            tunnel_secret: this.generateTunnelSecret(),
+            config_src: 'cloudflare',
+        });
+        return {
+            id: response.result.id,
+            name: response.result.name,
+        };
+    }
+    /**
+     * 配置 Tunnel Ingress
+     */
+    async configureTunnelIngress(tunnelId, hostname, localPort) {
+        await this.cloudflareApi(`accounts/${this.accountId}/cfd_tunnel/${tunnelId}/configurations`, 'PUT', {
+            config: {
+                ingress: [
+                    {
+                        hostname,
+                        service: `http://localhost:${localPort}`,
+                    },
+                    {
+                        service: 'http_status:404',
+                    },
+                ],
+            },
+        });
+    }
+    /**
+     * 获取 Tunnel Token
+     */
+    async getTunnelToken(tunnelId) {
+        const response = await this.cloudflareApi(`accounts/${this.accountId}/cfd_tunnel/${tunnelId}/token`, 'GET');
+        return response.result;
+    }
+    /**
+     * 删除 Tunnel
+     */
+    async deleteTunnel(tunnelId) {
+        try {
+            await this.cloudflareApi(`accounts/${this.accountId}/cfd_tunnel/${tunnelId}`, 'DELETE');
+        }
+        catch (error) {
+            console.warn(`Failed to delete tunnel ${tunnelId}:`, error);
+        }
+    }
+    /**
+     * 创建 DNS CNAME 记录
+     */
+    async createDnsRecord(subdomain, tunnelId) {
+        const zoneId = await this.getZoneId();
+        const fullDomain = `${subdomain}.${this.baseDomain}`;
+        await this.cloudflareApi(`zones/${zoneId}/dns_records`, 'POST', {
+            type: 'CNAME',
+            name: fullDomain,
+            content: `${tunnelId}.cfargotunnel.com`,
+            proxied: true,
+        });
+    }
+    /**
+     * 删除 DNS 记录
+     */
+    async deleteDnsRecord(subdomain) {
+        try {
+            const zoneId = await this.getZoneId();
+            const fullDomain = `${subdomain}.${this.baseDomain}`;
+            // 查找记录
+            const response = await this.cloudflareApi(`zones/${zoneId}/dns_records?name=${fullDomain}`, 'GET');
+            for (const record of response.result) {
+                await this.cloudflareApi(`zones/${zoneId}/dns_records/${record.id}`, 'DELETE');
+            }
+        }
+        catch (error) {
+            console.warn(`Failed to delete DNS record for ${subdomain}:`, error);
+        }
+    }
+    /**
+     * 获取 Zone ID
+     */
+    async getZoneId() {
+        const response = await this.cloudflareApi(`zones?name=${this.baseDomain}`, 'GET');
+        if (!response.result?.length) {
+            throw new Error(`Zone not found for domain: ${this.baseDomain}`);
+        }
+        return response.result[0].id;
+    }
+    /**
+     * Cloudflare API 请求
+     */
+    async cloudflareApi(endpoint, method, body) {
+        const response = await fetch(`https://api.cloudflare.com/client/v4/${endpoint}`, {
+            method,
+            headers: {
+                'Authorization': `Bearer ${this.apiToken}`,
+                'Content-Type': 'application/json',
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        const data = await response.json();
+        if (!response.ok || !data.success) {
+            const errors = data.errors?.map((e) => e.message).join(', ') || 'Unknown error';
+            throw new Error(`Cloudflare API error: ${errors}`);
+        }
+        return data;
+    }
+    /**
+     * 生成 Tunnel Secret
+     */
+    generateTunnelSecret() {
+        const bytes = new Uint8Array(32);
+        crypto.getRandomValues(bytes);
+        return Buffer.from(bytes).toString('base64');
+    }
+    /**
+     * 等待连接建立
+     */
+    async waitForConnection(timeout = 30000) {
+        const start = Date.now();
+        while (Date.now() - start < timeout) {
+            if (this.status.connected) {
+                return;
+            }
+            if (!this.status.running) {
+                throw new Error('Tunnel process exited unexpectedly');
+            }
+            await new Promise((r) => setTimeout(r, 500));
+        }
+        throw new Error('Tunnel connection timeout');
+    }
+    // ============ 隧道检测方法 ============
+    /**
+     * 检测 cloudflared 是否已经在运行
+     * 通过进程检测 + metrics 端口检测
+     */
+    async isCloudflaredRunning() {
+        // 方法1：检测进程
+        if (this.isCloudflaredProcessRunning()) {
+            return true;
+        }
+        // 方法2：检测 metrics 端口
+        return await this.isMetricsPortOpen();
+    }
+    /**
+     * 检测 cloudflared 进程是否存在
+     */
+    isCloudflaredProcessRunning() {
+        try {
+            if (process.platform === 'win32') {
+                (0, node_child_process_1.execSync)('tasklist /FI "IMAGENAME eq cloudflared.exe" | find "cloudflared"', {
+                    stdio: 'ignore'
+                });
+            }
+            else {
+                (0, node_child_process_1.execSync)('pgrep -x cloudflared', { stdio: 'ignore' });
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 检测 cloudflared metrics 端口是否开放
+     */
+    async isMetricsPortOpen() {
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 2000);
+            const res = await fetch(`http://localhost:${CLOUDFLARED_METRICS_PORT}/ready`, {
+                signal: controller.signal,
+            });
+            clearTimeout(timeout);
+            return res.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 检测隧道是否可从外部访问
+     * @param domain 要检测的域名
+     */
+    async isReachable(domain) {
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 5000);
+            const res = await fetch(`https://${domain}`, {
+                method: 'HEAD',
+                signal: controller.signal,
+            });
+            clearTimeout(timeout);
+            // 任何响应都说明隧道通了（包括 404）
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 获取是否由我们管理
+     */
+    isManagedByUs() {
+        return this.managedByUs;
+    }
+}
+exports.CloudflareTunnelProvider = CloudflareTunnelProvider;
+//# sourceMappingURL=CloudflareTunnelProvider.js.map

package/dist/tunnel/CloudflareTunnelProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudflareTunnelProvider.js","sourceRoot":"","sources":["../../src/tunnel/CloudflareTunnelProvider.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn, execSync, type ChildProcess } from 'node:child_process';\nimport type {\n  TunnelProvider,\n  TunnelConfig,\n  TunnelSetupOptions,\n  TunnelStatus,\n} from './TunnelProvider';\n\n/** cloudflared metrics 端口 */\nconst CLOUDFLARED_METRICS_PORT = 33863;\n\n/**\n * Cloudflare Tunnel Provider 配置\n */\nexport interface CloudflareTunnelProviderOptions {\n  /** Cloudflare API Token (需要 Tunnel 和 DNS 权限) */\n  apiToken: string;\n\n  /** Cloudflare Account ID */\n  accountId: string;\n\n  /** 基础域名 (如 pods.undefieds.co) */\n  baseDomain: string;\n\n  /** cloudflared 可执行文件路径 (默认 'cloudflared') */\n  cloudflaredPath?: string;\n}\n\n/**\n * Cloudflare Tunnel Provider\n * \n * 使用 Cloudflare Tunnel 实现隧道穿透\n */\nexport class CloudflareTunnelProvider implements TunnelProvider {\n  public readonly name = 'cloudflare';\n\n  private readonly apiToken: string;\n  private readonly accountId: string;\n  private readonly baseDomain: string;\n  private readonly cloudflaredPath: string;\n\n  private process: ChildProcess | null = null;\n  private status: TunnelStatus = {\n    running: false,\n    connected: false,\n  };\n  private currentConfig: TunnelConfig | null = null;\n  /** 标记隧道进程是否由我们启动和管理 */\n  private managedByUs = false;\n\n  constructor(options: CloudflareTunnelProviderOptions) {\n    this.apiToken = options.apiToken;\n    this.accountId = options.accountId;\n    this.baseDomain = options.baseDomain;\n    this.cloudflaredPath = options.cloudflaredPath ?? 'cloudflared';\n  }\n\n  /**\n   * 初始化隧道\n   */\n  async setup(options: TunnelSetupOptions): Promise<TunnelConfig> {\n    const { subdomain, localPort } = options;\n    const fullDomain = `${subdomain}.${this.baseDomain}`;\n\n    // 1. 创建 Tunnel\n    const tunnel = await this.createTunnel(subdomain);\n\n    // 2. 配置 Tunnel ingress (指向本地端口)\n    await this.configureTunnelIngress(tunnel.id, fullDomain, localPort);\n\n    // 3. 创建 DNS CNAME 记录\n    await this.createDnsRecord(subdomain, tunnel.id);\n\n    // 4. 获取 Tunnel Token\n    const tunnelToken = await this.getTunnelToken(tunnel.id);\n\n    const config: TunnelConfig = {\n      subdomain,\n      provider: 'cloudflare',\n      endpoint: `https://${fullDomain}`,\n      tunnelId: tunnel.id,\n      tunnelToken,\n    };\n\n    this.currentConfig = config;\n    return config;\n  }\n\n  /**\n   * 启动隧道客户端\n   * 如果 cloudflared 已经在运行，则跳过启动\n   */\n  async start(config: TunnelConfig): Promise<void> {\n    // 检测是否已经在运行\n    const alreadyRunning = await this.isCloudflaredRunning();\n    if (alreadyRunning) {\n      console.log('[cloudflared] Already running externally, skipping start');\n      this.status = { running: true, connected: true, endpoint: config.endpoint };\n      this.currentConfig = config;\n      this.managedByUs = false;\n      return;\n    }\n\n    if (this.process) {\n      throw new Error('Tunnel already running');\n    }\n\n    if (!config.tunnelToken) {\n      throw new Error('Tunnel token is required');\n    }\n\n    this.status = { running: true, connected: false };\n    this.managedByUs = true;\n\n    this.process = spawn(this.cloudflaredPath, [\n      'tunnel',\n      '--protocol', 'http2',\n      '--no-autoupdate',\n      'run',\n      '--token',\n      config.tunnelToken,\n    ]);\n\n    this.process.stdout?.on('data', (data: Buffer) => {\n      const output = data.toString();\n      console.log(`[cloudflared] ${output}`);\n\n      // 检测连接成功\n      if (output.includes('Connection registered') || output.includes('Registered tunnel connection')) {\n        this.status.connected = true;\n        this.status.lastHeartbeat = new Date();\n      }\n    });\n\n    this.process.stderr?.on('data', (data: Buffer) => {\n      const output = data.toString();\n      console.error(`[cloudflared] ${output}`);\n\n      // 检测错误\n      if (output.includes('error') || output.includes('failed')) {\n        this.status.error = output;\n      }\n    });\n\n    this.process.on('exit', (code) => {\n      console.log(`[cloudflared] Process exited with code ${code}`);\n      this.status = { running: false, connected: false };\n      this.process = null;\n    });\n\n    this.currentConfig = config;\n    this.status.endpoint = config.endpoint;\n\n    // 等待连接建立\n    await this.waitForConnection();\n  }\n\n  /**\n   * 停止隧道\n   * 只有当隧道是由我们启动时才会停止\n   */\n  async stop(): Promise<void> {\n    if (!this.managedByUs) {\n      console.log('[cloudflared] Not managed by us, skipping stop');\n      this.status = { running: false, connected: false };\n      return;\n    }\n\n    if (this.process) {\n      this.process.kill('SIGTERM');\n\n      // 等待进程退出\n      await new Promise<void>((resolve) => {\n        const timeout = setTimeout(() => {\n          this.process?.kill('SIGKILL');\n          resolve();\n        }, 5000);\n\n        this.process?.on('exit', () => {\n          clearTimeout(timeout);\n          resolve();\n        });\n      });\n\n      this.process = null;\n    }\n\n    this.status = { running: false, connected: false };\n    this.managedByUs = false;\n  }\n\n  /**\n   * 获取隧道状态\n   */\n  getStatus(): TunnelStatus {\n    return { ...this.status };\n  }\n\n  /**\n   * 获取公网端点\n   */\n  getEndpoint(): string | undefined {\n    return this.currentConfig?.endpoint;\n  }\n\n  /**\n   * 清理资源\n   */\n  async cleanup(config: TunnelConfig): Promise<void> {\n    // 1. 停止隧道\n    await this.stop();\n\n    // 2. 删除 DNS 记录\n    if (config.subdomain) {\n      await this.deleteDnsRecord(config.subdomain);\n    }\n\n    // 3. 删除 Tunnel\n    if (config.tunnelId) {\n      await this.deleteTunnel(config.tunnelId);\n    }\n\n    this.currentConfig = null;\n  }\n\n  // ============ Cloudflare API 方法 ============\n\n  /**\n   * 创建 Tunnel\n   */\n  private async createTunnel(name: string): Promise<{ id: string; name: string }> {\n    const response = await this.cloudflareApi(\n      `accounts/${this.accountId}/cfd_tunnel`,\n      'POST',\n      {\n        name: `xpod-${name}`,\n        tunnel_secret: this.generateTunnelSecret(),\n        config_src: 'cloudflare',\n      }\n    );\n\n    return {\n      id: response.result.id,\n      name: response.result.name,\n    };\n  }\n\n  /**\n   * 配置 Tunnel Ingress\n   */\n  private async configureTunnelIngress(\n    tunnelId: string,\n    hostname: string,\n    localPort: number\n  ): Promise<void> {\n    await this.cloudflareApi(\n      `accounts/${this.accountId}/cfd_tunnel/${tunnelId}/configurations`,\n      'PUT',\n      {\n        config: {\n          ingress: [\n            {\n              hostname,\n              service: `http://localhost:${localPort}`,\n            },\n            {\n              service: 'http_status:404',\n            },\n          ],\n        },\n      }\n    );\n  }\n\n  /**\n   * 获取 Tunnel Token\n   */\n  private async getTunnelToken(tunnelId: string): Promise<string> {\n    const response = await this.cloudflareApi(\n      `accounts/${this.accountId}/cfd_tunnel/${tunnelId}/token`,\n      'GET'\n    );\n\n    return response.result;\n  }\n\n  /**\n   * 删除 Tunnel\n   */\n  private async deleteTunnel(tunnelId: string): Promise<void> {\n    try {\n      await this.cloudflareApi(\n        `accounts/${this.accountId}/cfd_tunnel/${tunnelId}`,\n        'DELETE'\n      );\n    } catch (error) {\n      console.warn(`Failed to delete tunnel ${tunnelId}:`, error);\n    }\n  }\n\n  /**\n   * 创建 DNS CNAME 记录\n   */\n  private async createDnsRecord(subdomain: string, tunnelId: string): Promise<void> {\n    const zoneId = await this.getZoneId();\n    const fullDomain = `${subdomain}.${this.baseDomain}`;\n\n    await this.cloudflareApi(\n      `zones/${zoneId}/dns_records`,\n      'POST',\n      {\n        type: 'CNAME',\n        name: fullDomain,\n        content: `${tunnelId}.cfargotunnel.com`,\n        proxied: true,\n      }\n    );\n  }\n\n  /**\n   * 删除 DNS 记录\n   */\n  private async deleteDnsRecord(subdomain: string): Promise<void> {\n    try {\n      const zoneId = await this.getZoneId();\n      const fullDomain = `${subdomain}.${this.baseDomain}`;\n\n      // 查找记录\n      const response = await this.cloudflareApi(\n        `zones/${zoneId}/dns_records?name=${fullDomain}`,\n        'GET'\n      );\n\n      for (const record of response.result) {\n        await this.cloudflareApi(\n          `zones/${zoneId}/dns_records/${record.id}`,\n          'DELETE'\n        );\n      }\n    } catch (error) {\n      console.warn(`Failed to delete DNS record for ${subdomain}:`, error);\n    }\n  }\n\n  /**\n   * 获取 Zone ID\n   */\n  private async getZoneId(): Promise<string> {\n    const response = await this.cloudflareApi(\n      `zones?name=${this.baseDomain}`,\n      'GET'\n    );\n\n    if (!response.result?.length) {\n      throw new Error(`Zone not found for domain: ${this.baseDomain}`);\n    }\n\n    return response.result[0].id;\n  }\n\n  /**\n   * Cloudflare API 请求\n   */\n  private async cloudflareApi(\n    endpoint: string,\n    method: string,\n    body?: unknown\n  ): Promise<any> {\n    const response = await fetch(`https://api.cloudflare.com/client/v4/${endpoint}`, {\n      method,\n      headers: {\n        'Authorization': `Bearer ${this.apiToken}`,\n        'Content-Type': 'application/json',\n      },\n      body: body ? JSON.stringify(body) : undefined,\n    });\n\n    const data = await response.json() as {\n      success: boolean;\n      errors?: Array<{ message: string }>;\n      result?: unknown;\n    };\n\n    if (!response.ok || !data.success) {\n      const errors = data.errors?.map((e) => e.message).join(', ') || 'Unknown error';\n      throw new Error(`Cloudflare API error: ${errors}`);\n    }\n\n    return data;\n  }\n\n  /**\n   * 生成 Tunnel Secret\n   */\n  private generateTunnelSecret(): string {\n    const bytes = new Uint8Array(32);\n    crypto.getRandomValues(bytes);\n    return Buffer.from(bytes).toString('base64');\n  }\n\n  /**\n   * 等待连接建立\n   */\n  private async waitForConnection(timeout = 30000): Promise<void> {\n    const start = Date.now();\n\n    while (Date.now() - start < timeout) {\n      if (this.status.connected) {\n        return;\n      }\n\n      if (!this.status.running) {\n        throw new Error('Tunnel process exited unexpectedly');\n      }\n\n      await new Promise((r) => setTimeout(r, 500));\n    }\n\n    throw new Error('Tunnel connection timeout');\n  }\n\n  // ============ 隧道检测方法 ============\n\n  /**\n   * 检测 cloudflared 是否已经在运行\n   * 通过进程检测 + metrics 端口检测\n   */\n  async isCloudflaredRunning(): Promise<boolean> {\n    // 方法1：检测进程\n    if (this.isCloudflaredProcessRunning()) {\n      return true;\n    }\n\n    // 方法2：检测 metrics 端口\n    return await this.isMetricsPortOpen();\n  }\n\n  /**\n   * 检测 cloudflared 进程是否存在\n   */\n  private isCloudflaredProcessRunning(): boolean {\n    try {\n      if (process.platform === 'win32') {\n        execSync('tasklist /FI \"IMAGENAME eq cloudflared.exe\" | find \"cloudflared\"', { \n          stdio: 'ignore' \n        });\n      } else {\n        execSync('pgrep -x cloudflared', { stdio: 'ignore' });\n      }\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * 检测 cloudflared metrics 端口是否开放\n   */\n  private async isMetricsPortOpen(): Promise<boolean> {\n    try {\n      const controller = new AbortController();\n      const timeout = setTimeout(() => controller.abort(), 2000);\n      \n      const res = await fetch(`http://localhost:${CLOUDFLARED_METRICS_PORT}/ready`, {\n        signal: controller.signal,\n      });\n      \n      clearTimeout(timeout);\n      return res.ok;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * 检测隧道是否可从外部访问\n   * @param domain 要检测的域名\n   */\n  async isReachable(domain: string): Promise<boolean> {\n    try {\n      const controller = new AbortController();\n      const timeout = setTimeout(() => controller.abort(), 5000);\n      \n      const res = await fetch(`https://${domain}`, {\n        method: 'HEAD',\n        signal: controller.signal,\n      });\n      \n      clearTimeout(timeout);\n      // 任何响应都说明隧道通了（包括 404）\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * 获取是否由我们管理\n   */\n  isManagedByUs(): boolean {\n    return this.managedByUs;\n  }\n}\n"]}

package/dist/tunnel/CloudflareTunnelProvider.jsonld

@@ -0,0 +1,204 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider",
+      "@type": "Class",
+      "requireElement": "CloudflareTunnelProvider",
+      "extends": [
+        "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelProvider"
+      ],
+      "comment": "Cloudflare Tunnel Provider  使用 Cloudflare Tunnel 实现隧道穿透",
+      "parameters": [
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider_options_apiToken",
+          "range": "xsd:string",
+          "comment": "Cloudflare API Token (需要 Tunnel 和 DNS 权限)"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider_options_accountId",
+          "range": "xsd:string",
+          "comment": "Cloudflare Account ID"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider_options_baseDomain",
+          "range": "xsd:string",
+          "comment": "基础域名 (如 pods.undefieds.co)"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider_options_cloudflaredPath",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          },
+          "comment": "cloudflared 可执行文件路径 (默认 'cloudflared')"
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_name",
+          "memberFieldName": "name"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_apiToken",
+          "memberFieldName": "apiToken"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_accountId",
+          "memberFieldName": "accountId"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_baseDomain",
+          "memberFieldName": "baseDomain"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_cloudflaredPath",
+          "memberFieldName": "cloudflaredPath"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_process",
+          "memberFieldName": "process"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_status",
+          "memberFieldName": "status"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_currentConfig",
+          "memberFieldName": "currentConfig"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_managedByUs",
+          "memberFieldName": "managedByUs"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_setup",
+          "memberFieldName": "setup"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_start",
+          "memberFieldName": "start"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_stop",
+          "memberFieldName": "stop"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_getStatus",
+          "memberFieldName": "getStatus"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_getEndpoint",
+          "memberFieldName": "getEndpoint"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_cleanup",
+          "memberFieldName": "cleanup"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_createTunnel",
+          "memberFieldName": "createTunnel"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_configureTunnelIngress",
+          "memberFieldName": "configureTunnelIngress"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_getTunnelToken",
+          "memberFieldName": "getTunnelToken"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_deleteTunnel",
+          "memberFieldName": "deleteTunnel"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_createDnsRecord",
+          "memberFieldName": "createDnsRecord"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_deleteDnsRecord",
+          "memberFieldName": "deleteDnsRecord"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_getZoneId",
+          "memberFieldName": "getZoneId"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_cloudflareApi",
+          "memberFieldName": "cloudflareApi"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_generateTunnelSecret",
+          "memberFieldName": "generateTunnelSecret"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_waitForConnection",
+          "memberFieldName": "waitForConnection"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_isCloudflaredRunning",
+          "memberFieldName": "isCloudflaredRunning"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_isCloudflaredProcessRunning",
+          "memberFieldName": "isCloudflaredProcessRunning"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_isMetricsPortOpen",
+          "memberFieldName": "isMetricsPortOpen"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_isReachable",
+          "memberFieldName": "isReachable"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider__member_isManagedByUs",
+          "memberFieldName": "isManagedByUs"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "apiToken",
+              "value": {
+                "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider_options_apiToken"
+              }
+            },
+            {
+              "keyRaw": "accountId",
+              "value": {
+                "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider_options_accountId"
+              }
+            },
+            {
+              "keyRaw": "baseDomain",
+              "value": {
+                "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider_options_baseDomain"
+              }
+            },
+            {
+              "keyRaw": "cloudflaredPath",
+              "value": {
+                "@id": "undefineds:dist/tunnel/CloudflareTunnelProvider.jsonld#CloudflareTunnelProvider_options_cloudflaredPath"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}