@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/tunnel/LocalTunnelProvider.d.ts

@@ -0,0 +1,85 @@
+import type { TunnelProvider, TunnelConfig, TunnelSetupOptions, TunnelStatus } from './TunnelProvider';
+/**
+ * Local Tunnel Provider 配置
+ * 仅用于启动 cloudflared，不涉及 Cloudflare API 操作
+ */
+export interface LocalTunnelProviderOptions {
+    /** Cloudflare Tunnel Token (从环境变量 CLOUDFLARE_TUNNEL_TOKEN 获取) */
+    tunnelToken: string;
+    /** cloudflared 可执行文件路径 (默认 'cloudflared') */
+    cloudflaredPath?: string;
+}
+/**
+ * Local Tunnel Provider
+ *
+ * 专为 Local 模式设计的简化版 Tunnel Provider
+ * 只负责启动 cloudflared，不涉及 Cloudflare API 操作（创建 Tunnel、DNS 记录等）
+ *
+ * 使用场景：
+ * - 用户已在 Cloudflare Dashboard 创建好 Tunnel
+ * - 用户通过环境变量 CLOUDFLARE_TUNNEL_TOKEN 传入 Token
+ * - 服务启动时自动启动 cloudflared
+ */
+export declare class LocalTunnelProvider implements TunnelProvider {
+    readonly name = "cloudflare-local";
+    private readonly logger;
+    private readonly tunnelToken;
+    private readonly cloudflaredPath;
+    private process;
+    private status;
+    private currentConfig;
+    /** 标记隧道进程是否由我们启动和管理 */
+    private managedByUs;
+    constructor(options: LocalTunnelProviderOptions);
+    /**
+     * Local 模式不需要 setup，直接返回基于 Token 的配置
+     */
+    setup(_options: TunnelSetupOptions): Promise<TunnelConfig>;
+    /**
+     * 启动隧道客户端
+     * 如果 cloudflared 已经在运行，则跳过启动
+     */
+    start(config?: TunnelConfig): Promise<void>;
+    /**
+     * 解析并打印 cloudflared 日志
+     */
+    private logOutput;
+    /**
+     * 停止隧道
+     * 只有当隧道是由我们启动时才会停止
+     */
+    stop(): Promise<void>;
+    /**
+     * 获取隧道状态
+     */
+    getStatus(): TunnelStatus;
+    /**
+     * 获取公网端点
+     */
+    getEndpoint(): string | undefined;
+    /**
+     * Local 模式不需要 cleanup（不涉及 Cloudflare API 操作）
+     */
+    cleanup(_config: TunnelConfig): Promise<void>;
+    /**
+     * 检测 cloudflared 是否已经在运行
+     * 通过进程检测 + metrics 端口检测
+     */
+    isCloudflaredRunning(): Promise<boolean>;
+    /**
+     * 检测 cloudflared 进程是否存在
+     */
+    private isCloudflaredProcessRunning;
+    /**
+     * 检测 cloudflared metrics 端口是否开放
+     */
+    private isMetricsPortOpen;
+    /**
+     * 等待连接建立
+     */
+    private waitForConnection;
+    /**
+     * 获取是否由我们管理
+     */
+    isManagedByUs(): boolean;
+}

package/dist/tunnel/LocalTunnelProvider.js

@@ -0,0 +1,295 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalTunnelProvider = void 0;
+const node_child_process_1 = require("node:child_process");
+const global_logger_factory_1 = require("global-logger-factory");
+/** cloudflared metrics 端口 */
+const CLOUDFLARED_METRICS_PORT = 33863;
+/**
+ * Local Tunnel Provider
+ *
+ * 专为 Local 模式设计的简化版 Tunnel Provider
+ * 只负责启动 cloudflared，不涉及 Cloudflare API 操作（创建 Tunnel、DNS 记录等）
+ *
+ * 使用场景：
+ * - 用户已在 Cloudflare Dashboard 创建好 Tunnel
+ * - 用户通过环境变量 CLOUDFLARE_TUNNEL_TOKEN 传入 Token
+ * - 服务启动时自动启动 cloudflared
+ */
+class LocalTunnelProvider {
+    constructor(options) {
+        this.name = 'cloudflare-local';
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.process = null;
+        this.status = {
+            running: false,
+            connected: false,
+        };
+        this.currentConfig = null;
+        /** 标记隧道进程是否由我们启动和管理 */
+        this.managedByUs = false;
+        this.tunnelToken = options.tunnelToken;
+        this.cloudflaredPath = options.cloudflaredPath ?? 'cloudflared';
+    }
+    /**
+     * Local 模式不需要 setup，直接返回基于 Token 的配置
+     */
+    async setup(_options) {
+        // Local 模式下，Tunnel 已在 Cloudflare Dashboard 创建
+        // 只需要返回一个包含 Token 的配置
+        const config = {
+            subdomain: 'local', // 占位符，实际域名由 Cloudflare Tunnel 配置决定
+            provider: 'cloudflare',
+            endpoint: '', // 实际 endpoint 由 Cloudflare Tunnel 配置决定
+            tunnelToken: this.tunnelToken,
+        };
+        this.currentConfig = config;
+        return config;
+    }
+    /**
+     * 启动隧道客户端
+     * 如果 cloudflared 已经在运行，则跳过启动
+     */
+    async start(config) {
+        // 如果没有传入 config，使用默认配置
+        const actualConfig = config ?? {
+            subdomain: 'local',
+            provider: 'cloudflare',
+            endpoint: '',
+            tunnelToken: this.tunnelToken,
+        };
+        // 检测是否已经在运行
+        const alreadyRunning = await this.isCloudflaredRunning();
+        if (alreadyRunning) {
+            this.logger.info('Already running externally, skipping start');
+            this.status = { running: true, connected: true, endpoint: actualConfig.endpoint };
+            this.currentConfig = actualConfig;
+            this.managedByUs = false;
+            return;
+        }
+        if (this.process) {
+            this.logger.info('Already running (managed by us)');
+            return;
+        }
+        const token = actualConfig.tunnelToken ?? this.tunnelToken;
+        if (!token) {
+            throw new Error('Tunnel token is required');
+        }
+        this.logger.info('Starting cloudflared tunnel...');
+        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',
+            token,
+        ], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        this.process.stdout?.on('data', (data) => {
+            const output = data.toString().trim();
+            if (output) {
+                this.logOutput(output);
+            }
+            // 检测连接成功
+            if (output.includes('Connection registered') || output.includes('Registered tunnel connection')) {
+                this.status.connected = true;
+                this.status.lastHeartbeat = new Date();
+                this.logger.info('Tunnel connected successfully');
+            }
+        });
+        this.process.stderr?.on('data', (data) => {
+            const output = data.toString().trim();
+            if (output) {
+                // cloudflared 的正常日志也输出到 stderr
+                this.logOutput(output);
+                // 检测连接成功
+                if (output.includes('Registered tunnel connection') || output.includes('Connection registered')) {
+                    this.status.connected = true;
+                    this.status.lastHeartbeat = new Date();
+                    // logOutput 已经打印了信息，这里不需要重复打印
+                }
+                // 检测错误
+                if (output.includes('ERR') || output.includes('failed')) {
+                    this.status.error = output;
+                }
+            }
+        });
+        this.process.on('exit', (code) => {
+            this.logger.info(`Process exited with code ${code}`);
+            this.status = { running: false, connected: false };
+            this.process = null;
+            this.managedByUs = false;
+        });
+        this.process.on('error', (error) => {
+            this.logger.error(`Failed to start: ${error.message}`);
+            this.status = { running: false, connected: false, error: error.message };
+            this.process = null;
+            this.managedByUs = false;
+        });
+        this.currentConfig = actualConfig;
+        this.status.endpoint = actualConfig.endpoint;
+        // 等待连接建立
+        await this.waitForConnection();
+    }
+    /**
+     * 解析并打印 cloudflared 日志
+     */
+    logOutput(raw) {
+        const lines = raw.split('\n');
+        for (const line of lines) {
+            if (!line.trim())
+                continue;
+            // 尝试去除时间戳 (例如: 2023-01-01T00:00:00Z INF ...)
+            // 正则匹配 ISO 时间戳开头
+            const match = line.match(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z\s+(INF|WRN|ERR)\s+(.*)$/);
+            if (match) {
+                const level = match[1];
+                const content = match[2];
+                switch (level) {
+                    case 'INF':
+                        this.logger.info(content);
+                        break;
+                    case 'WRN':
+                        this.logger.warn(content);
+                        break;
+                    case 'ERR':
+                        this.logger.error(content);
+                        break;
+                    default:
+                        this.logger.info(content);
+                }
+            }
+            else {
+                // 无法解析格式，原样输出
+                this.logger.info(line);
+            }
+        }
+    }
+    /**
+     * 停止隧道
+     * 只有当隧道是由我们启动时才会停止
+     */
+    async stop() {
+        if (!this.managedByUs) {
+            this.logger.info('Not managed by us, skipping stop');
+            this.status = { running: false, connected: false };
+            return;
+        }
+        if (this.process) {
+            this.logger.info('Stopping tunnel...');
+            this.process.kill('SIGTERM');
+            // 等待进程退出
+            await new Promise((resolve) => {
+                const timeout = setTimeout(() => {
+                    this.logger.info('Force killing process...');
+                    this.process?.kill('SIGKILL');
+                    resolve();
+                }, 5000);
+                this.process?.on('exit', () => {
+                    clearTimeout(timeout);
+                    resolve();
+                });
+            });
+            this.process = null;
+            this.logger.info('Tunnel stopped');
+        }
+        this.status = { running: false, connected: false };
+        this.managedByUs = false;
+    }
+    /**
+     * 获取隧道状态
+     */
+    getStatus() {
+        return { ...this.status };
+    }
+    /**
+     * 获取公网端点
+     */
+    getEndpoint() {
+        return this.currentConfig?.endpoint;
+    }
+    /**
+     * Local 模式不需要 cleanup（不涉及 Cloudflare API 操作）
+     */
+    async cleanup(_config) {
+        await this.stop();
+        this.currentConfig = null;
+    }
+    // ============ 隧道检测方法 ============
+    /**
+     * 检测 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;
+        }
+    }
+    /**
+     * 等待连接建立
+     */
+    async waitForConnection(timeout = 30000) {
+        const start = Date.now();
+        while (Date.now() - start < timeout) {
+            if (this.status.connected) {
+                return;
+            }
+            if (!this.status.running && this.status.error) {
+                throw new Error(`Tunnel failed to start: ${this.status.error}`);
+            }
+            await new Promise((r) => setTimeout(r, 500));
+        }
+        // 超时不抛错，cloudflared 可能还在连接中
+        this.logger.warn('Connection timeout, tunnel may still be connecting...');
+    }
+    /**
+     * 获取是否由我们管理
+     */
+    isManagedByUs() {
+        return this.managedByUs;
+    }
+}
+exports.LocalTunnelProvider = LocalTunnelProvider;
+//# sourceMappingURL=LocalTunnelProvider.js.map

package/dist/tunnel/LocalTunnelProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalTunnelProvider.js","sourceRoot":"","sources":["../../src/tunnel/LocalTunnelProvider.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn, execSync, type ChildProcess } from 'node:child_process';\nimport { getLoggerFor } from 'global-logger-factory';\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 * Local Tunnel Provider 配置\n * 仅用于启动 cloudflared，不涉及 Cloudflare API 操作\n */\nexport interface LocalTunnelProviderOptions {\n  /** Cloudflare Tunnel Token (从环境变量 CLOUDFLARE_TUNNEL_TOKEN 获取) */\n  tunnelToken: string;\n\n  /** cloudflared 可执行文件路径 (默认 'cloudflared') */\n  cloudflaredPath?: string;\n}\n\n/**\n * Local Tunnel Provider\n * \n * 专为 Local 模式设计的简化版 Tunnel Provider\n * 只负责启动 cloudflared，不涉及 Cloudflare API 操作（创建 Tunnel、DNS 记录等）\n * \n * 使用场景：\n * - 用户已在 Cloudflare Dashboard 创建好 Tunnel\n * - 用户通过环境变量 CLOUDFLARE_TUNNEL_TOKEN 传入 Token\n * - 服务启动时自动启动 cloudflared\n */\nexport class LocalTunnelProvider implements TunnelProvider {\n  public readonly name = 'cloudflare-local';\n  private readonly logger = getLoggerFor(this);\n\n  private readonly tunnelToken: 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: LocalTunnelProviderOptions) {\n    this.tunnelToken = options.tunnelToken;\n    this.cloudflaredPath = options.cloudflaredPath ?? 'cloudflared';\n  }\n\n  /**\n   * Local 模式不需要 setup，直接返回基于 Token 的配置\n   */\n  async setup(_options: TunnelSetupOptions): Promise<TunnelConfig> {\n    // Local 模式下，Tunnel 已在 Cloudflare Dashboard 创建\n    // 只需要返回一个包含 Token 的配置\n    const config: TunnelConfig = {\n      subdomain: 'local', // 占位符，实际域名由 Cloudflare Tunnel 配置决定\n      provider: 'cloudflare',\n      endpoint: '', // 实际 endpoint 由 Cloudflare Tunnel 配置决定\n      tunnelToken: this.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    // 如果没有传入 config，使用默认配置\n    const actualConfig = config ?? {\n      subdomain: 'local',\n      provider: 'cloudflare' as const,\n      endpoint: '',\n      tunnelToken: this.tunnelToken,\n    };\n\n    // 检测是否已经在运行\n    const alreadyRunning = await this.isCloudflaredRunning();\n    if (alreadyRunning) {\n      this.logger.info('Already running externally, skipping start');\n      this.status = { running: true, connected: true, endpoint: actualConfig.endpoint };\n      this.currentConfig = actualConfig;\n      this.managedByUs = false;\n      return;\n    }\n\n    if (this.process) {\n      this.logger.info('Already running (managed by us)');\n      return;\n    }\n\n    const token = actualConfig.tunnelToken ?? this.tunnelToken;\n    if (!token) {\n      throw new Error('Tunnel token is required');\n    }\n\n    this.logger.info('Starting cloudflared tunnel...');\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      token,\n    ], {\n      stdio: ['ignore', 'pipe', 'pipe'],\n    });\n\n    this.process.stdout?.on('data', (data: Buffer) => {\n      const output = data.toString().trim();\n      if (output) {\n        this.logOutput(output);\n      }\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        this.logger.info('Tunnel connected successfully');\n      }\n    });\n\n    this.process.stderr?.on('data', (data: Buffer) => {\n      const output = data.toString().trim();\n      if (output) {\n        // cloudflared 的正常日志也输出到 stderr\n        this.logOutput(output);\n\n        // 检测连接成功\n        if (output.includes('Registered tunnel connection') || output.includes('Connection registered')) {\n          this.status.connected = true;\n          this.status.lastHeartbeat = new Date();\n          // logOutput 已经打印了信息，这里不需要重复打印\n        }\n\n        // 检测错误\n        if (output.includes('ERR') || output.includes('failed')) {\n          this.status.error = output;\n        }\n      }\n    });\n\n    this.process.on('exit', (code) => {\n      this.logger.info(`Process exited with code ${code}`);\n      this.status = { running: false, connected: false };\n      this.process = null;\n      this.managedByUs = false;\n    });\n\n    this.process.on('error', (error) => {\n      this.logger.error(`Failed to start: ${error.message}`);\n      this.status = { running: false, connected: false, error: error.message };\n      this.process = null;\n      this.managedByUs = false;\n    });\n\n    this.currentConfig = actualConfig;\n    this.status.endpoint = actualConfig.endpoint;\n\n    // 等待连接建立\n    await this.waitForConnection();\n  }\n\n  /**\n   * 解析并打印 cloudflared 日志\n   */\n  private logOutput(raw: string): void {\n    const lines = raw.split('\\n');\n    for (const line of lines) {\n      if (!line.trim()) continue;\n      \n      // 尝试去除时间戳 (例如: 2023-01-01T00:00:00Z INF ...)\n      // 正则匹配 ISO 时间戳开头\n      const match = line.match(/^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z\\s+(INF|WRN|ERR)\\s+(.*)$/);\n      \n      if (match) {\n        const level = match[1];\n        const content = match[2];\n        \n        switch (level) {\n          case 'INF':\n            this.logger.info(content);\n            break;\n          case 'WRN':\n            this.logger.warn(content);\n            break;\n          case 'ERR':\n            this.logger.error(content);\n            break;\n          default:\n            this.logger.info(content);\n        }\n      } else {\n        // 无法解析格式，原样输出\n        this.logger.info(line);\n      }\n    }\n  }\n\n  /**\n   * 停止隧道\n   * 只有当隧道是由我们启动时才会停止\n   */\n  async stop(): Promise<void> {\n    if (!this.managedByUs) {\n      this.logger.info('Not managed by us, skipping stop');\n      this.status = { running: false, connected: false };\n      return;\n    }\n\n    if (this.process) {\n      this.logger.info('Stopping tunnel...');\n      this.process.kill('SIGTERM');\n\n      // 等待进程退出\n      await new Promise<void>((resolve) => {\n        const timeout = setTimeout(() => {\n          this.logger.info('Force killing process...');\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      this.logger.info('Tunnel stopped');\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   * Local 模式不需要 cleanup（不涉及 Cloudflare API 操作）\n   */\n  async cleanup(_config: TunnelConfig): Promise<void> {\n    await this.stop();\n    this.currentConfig = null;\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   */\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 && this.status.error) {\n        throw new Error(`Tunnel failed to start: ${this.status.error}`);\n      }\n\n      await new Promise((r) => setTimeout(r, 500));\n    }\n\n    // 超时不抛错，cloudflared 可能还在连接中\n    this.logger.warn('Connection timeout, tunnel may still be connecting...');\n  }\n\n  /**\n   * 获取是否由我们管理\n   */\n  isManagedByUs(): boolean {\n    return this.managedByUs;\n  }\n}\n"]}

package/dist/tunnel/LocalTunnelProvider.jsonld

@@ -0,0 +1,142 @@
+{
+  "@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/LocalTunnelProvider.jsonld#LocalTunnelProvider",
+      "@type": "Class",
+      "requireElement": "LocalTunnelProvider",
+      "extends": [
+        "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelProvider"
+      ],
+      "comment": "Local Tunnel Provider  专为 Local 模式设计的简化版 Tunnel Provider 只负责启动 cloudflared，不涉及 Cloudflare API 操作（创建 Tunnel、DNS 记录等）  使用场景： - 用户已在 Cloudflare Dashboard 创建好 Tunnel - 用户通过环境变量 CLOUDFLARE_TUNNEL_TOKEN 传入 Token - 服务启动时自动启动 cloudflared",
+      "parameters": [
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider_options_tunnelToken",
+          "range": "xsd:string",
+          "comment": "Cloudflare Tunnel Token (从环境变量 CLOUDFLARE_TUNNEL_TOKEN 获取)"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider_options_cloudflaredPath",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          },
+          "comment": "cloudflared 可执行文件路径 (默认 'cloudflared')"
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider__member_name",
+          "memberFieldName": "name"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider__member_logger",
+          "memberFieldName": "logger"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider__member_tunnelToken",
+          "memberFieldName": "tunnelToken"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider__member_cloudflaredPath",
+          "memberFieldName": "cloudflaredPath"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider__member_process",
+          "memberFieldName": "process"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider__member_status",
+          "memberFieldName": "status"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider__member_currentConfig",
+          "memberFieldName": "currentConfig"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider__member_managedByUs",
+          "memberFieldName": "managedByUs"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider__member_setup",
+          "memberFieldName": "setup"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider__member_start",
+          "memberFieldName": "start"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider__member_logOutput",
+          "memberFieldName": "logOutput"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider__member_stop",
+          "memberFieldName": "stop"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider__member_getStatus",
+          "memberFieldName": "getStatus"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider__member_getEndpoint",
+          "memberFieldName": "getEndpoint"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider__member_cleanup",
+          "memberFieldName": "cleanup"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider__member_isCloudflaredRunning",
+          "memberFieldName": "isCloudflaredRunning"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider__member_isCloudflaredProcessRunning",
+          "memberFieldName": "isCloudflaredProcessRunning"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider__member_isMetricsPortOpen",
+          "memberFieldName": "isMetricsPortOpen"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider__member_waitForConnection",
+          "memberFieldName": "waitForConnection"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider__member_isManagedByUs",
+          "memberFieldName": "isManagedByUs"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "tunnelToken",
+              "value": {
+                "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider_options_tunnelToken"
+              }
+            },
+            {
+              "keyRaw": "cloudflaredPath",
+              "value": {
+                "@id": "undefineds:dist/tunnel/LocalTunnelProvider.jsonld#LocalTunnelProvider_options_cloudflaredPath"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/tunnel/SakuraFrpTunnelProvider.d.ts

@@ -0,0 +1,59 @@
+/**
+ * SakuraFRP Tunnel Provider
+ *
+ * 使用 SakuraFRP 提供隧道服务
+ * 用于没有公网 IP 的 Local 节点
+ *
+ * 需要用户在 SakuraFRP 控制台创建隧道并获取 Token
+ */
+import type { TunnelProvider, TunnelConfig, TunnelSetupOptions, TunnelStatus } from './TunnelProvider';
+/**
+ * SakuraFRP Tunnel Provider 配置
+ */
+export interface SakuraFrpTunnelProviderOptions {
+    /** SakuraFRP Token (从环境变量 SAKURA_TOKEN 获取) */
+    token: string;
+    /** frpc 可执行文件路径 (默认 'frpc') */
+    frpcPath?: string;
+    /** SakuraFRP 服务端地址 (如果需要自定义) */
+    serverAddr?: string;
+}
+/**
+ * SakuraFRP Tunnel Provider
+ *
+ * 通过 frpc 客户端连接 SakuraFRP 服务
+ */
+export declare class SakuraFrpTunnelProvider implements TunnelProvider {
+    readonly name = "sakura-frp";
+    private readonly logger;
+    private readonly token;
+    private readonly frpcPath;
+    private readonly serverAddr?;
+    private process;
+    private status;
+    private currentConfig;
+    private managedByUs;
+    constructor(options: SakuraFrpTunnelProviderOptions);
+    /**
+     * Setup: 解析 Token 获取配置
+     */
+    setup(_options: TunnelSetupOptions): Promise<TunnelConfig>;
+    /**
+     * 启动 frpc 客户端
+     */
+    start(config?: TunnelConfig): Promise<void>;
+    private checkConnectionStatus;
+    /**
+     * 停止隧道
+     */
+    stop(): Promise<void>;
+    getStatus(): TunnelStatus;
+    getEndpoint(): string | undefined;
+    cleanup(_config: TunnelConfig): Promise<void>;
+    /**
+     * 检测 frpc 是否已经在运行
+     */
+    private isFrpcRunning;
+    private waitForConnection;
+    isManagedByUs(): boolean;
+}