xray-manager 1.8.4 → 2.0.0

package/dist/services/systemd-manager.js

@@ -1,458 +0,0 @@
-"use strict";
-/**
- * SystemdManager - Service Management via systemctl
- *
- * Provides safe interface to systemd service management with:
- * - Command injection prevention
- * - Action and service name validation
- * - Graceful shutdown with configurable timeout
- * - Detailed status parsing
- *
- * @module services/systemd-manager
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SystemdManager = void 0;
-const child_process_1 = require("child_process");
-const timeouts_1 = require("../constants/timeouts");
-/**
- * SystemdManager - Safe systemctl wrapper
- */
-class SystemdManager {
-    /**
-     * Create a new SystemdManager
-     *
-     * @param serviceName - Service name to manage
-     * @throws Error if service name is invalid
-     */
-    constructor(serviceName) {
-        this.validateServiceName(serviceName);
-        this.serviceName = serviceName;
-    }
-    /**
-     * Validate service name
-     *
-     * @param name - Service name to validate
-     * @throws Error if service name is invalid
-     */
-    validateServiceName(name) {
-        // Prevent empty names
-        if (!name || name.trim().length === 0) {
-            throw new Error('Service name cannot be empty');
-        }
-        // Prevent path traversal attempts
-        if (name.includes('/') || name.includes('\\') || name.includes('..')) {
-            throw new Error(`Invalid service name: ${name} (path traversal detected)`);
-        }
-        // Prevent command injection attempts
-        const dangerousChars = /[;&|`$()]/;
-        if (dangerousChars.test(name)) {
-            throw new Error(`Invalid service name: ${name} (potentially dangerous characters detected)`);
-        }
-        // Only allow alphanumeric, dash, underscore
-        const validPattern = /^[a-zA-Z0-9_-]+$/;
-        if (!validPattern.test(name)) {
-            throw new Error(`Invalid service name: ${name} (only alphanumeric, dash, and underscore allowed)`);
-        }
-    }
-    /**
-     * Validate systemctl action
-     *
-     * @param action - Action to validate
-     * @throws Error if action is invalid
-     */
-    validateAction(action) {
-        if (!SystemdManager.VALID_ACTIONS.includes(action)) {
-            throw new Error(`Invalid systemctl action: ${action} (must be one of: ${SystemdManager.VALID_ACTIONS.join(', ')})`);
-        }
-        // Extra paranoia: check for command injection attempts
-        const dangerousChars = /[;&|`$()]/;
-        if (dangerousChars.test(action)) {
-            throw new Error(`Invalid systemctl action: ${action} (potentially dangerous characters detected)`);
-        }
-    }
-    /**
-     * Execute systemctl command
-     *
-     * @param action - Systemctl action to execute
-     * @param options - Execution options
-     * @returns Command output
-     */
-    async executeSystemctl(action, options) {
-        // Validate action to prevent command injection
-        this.validateAction(action);
-        const timeout = options?.timeout || timeouts_1.TIMEOUTS.SYSTEMCTL_DEFAULT;
-        return new Promise((resolve, reject) => {
-            // Use spawn (not exec) to prevent shell injection
-            const child = (0, child_process_1.spawn)('systemctl', [action, this.serviceName], {
-                timeout,
-            });
-            let stdout = '';
-            let stderr = '';
-            child.stdout?.on('data', (data) => {
-                stdout += data.toString();
-            });
-            child.stderr?.on('data', (data) => {
-                stderr += data.toString();
-            });
-            child.on('close', (code) => {
-                if (code === 0) {
-                    resolve(stdout);
-                }
-                else {
-                    const errorMessage = this.parseSystemdError(stderr || stdout, action);
-                    reject(new Error(errorMessage));
-                }
-            });
-            child.on('error', (error) => {
-                reject(new Error(`Failed to execute systemctl: ${error.message}`));
-            });
-        });
-    }
-    /**
-     * Parse systemd error messages and provide suggestions
-     *
-     * @param errorOutput - Error output from systemctl
-     * @param action - Action that was attempted
-     * @returns User-friendly error message with suggestions
-     */
-    parseSystemdError(errorOutput, action) {
-        const lowerError = errorOutput.toLowerCase();
-        // Service not found
-        if (lowerError.includes('not found') ||
-            lowerError.includes('does not exist') ||
-            lowerError.includes('could not be found')) {
-            return `服务 '${this.serviceName}' 不存在。请确认服务名称是否正确。`;
-        }
-        // Permission denied
-        if (lowerError.includes('permission denied') ||
-            lowerError.includes('access denied') ||
-            lowerError.includes('authentication required')) {
-            return `权限不足: 无法执行 ${action} 操作。请使用 sudo 或以 root 用户运行。`;
-        }
-        // Timeout
-        if (lowerError.includes('timeout') || lowerError.includes('timed out')) {
-            return `操作超时: ${action} 操作未能在规定时间内完成。`;
-        }
-        // Already running/stopped
-        if (action === 'start' &&
-            (lowerError.includes('already running') || lowerError.includes('already active'))) {
-            return `服务 '${this.serviceName}' 已经在运行中。`;
-        }
-        if (action === 'stop' &&
-            (lowerError.includes('already stopped') || lowerError.includes('inactive'))) {
-            return `服务 '${this.serviceName}' 已经停止。`;
-        }
-        // Generic error with original output
-        return `执行 systemctl ${action} 失败: ${errorOutput}`;
-    }
-    /**
-     * Parse systemctl show output
-     *
-     * @param output - Raw output from systemctl show
-     * @returns Parsed service status
-     */
-    parseSystemdShow(output) {
-        const lines = output.split('\n');
-        const props = {};
-        // Parse key=value pairs
-        for (const line of lines) {
-            const trimmed = line.trim();
-            if (!trimmed || !trimmed.includes('=')) {
-                continue;
-            }
-            const [key, ...valueParts] = trimmed.split('=');
-            const value = valueParts.join('='); // Handle values with '=' in them
-            props[key] = value;
-        }
-        // Validate we have at least basic properties
-        if (!props.ActiveState && !props.SubState) {
-            throw new Error('Invalid systemctl show output: missing required fields (parse error)');
-        }
-        // Parse active state
-        const activeState = props.ActiveState || 'unknown';
-        const subState = props.SubState || 'unknown';
-        const active = activeState === 'active';
-        // Parse loaded state
-        const loaded = props.LoadState === 'loaded';
-        // Parse PID
-        const pidStr = props.MainPID || '0';
-        const pid = parseInt(pidStr, 10);
-        const pidValue = pid > 0 ? pid : null;
-        // Parse memory usage
-        const memoryBytes = parseInt(props.MemoryCurrent || '0', 10);
-        const memory = this.formatBytes(memoryBytes);
-        // Parse restart count
-        const restarts = parseInt(props.NRestarts || '0', 10);
-        // Parse start time and calculate uptime
-        const startTimestamp = props.ExecMainStartTimestamp;
-        let uptime;
-        let startTime;
-        if (startTimestamp && startTimestamp.trim() !== '') {
-            try {
-                startTime = new Date(startTimestamp);
-                const now = Date.now();
-                const startMs = startTime.getTime();
-                const uptimeMs = now - startMs;
-                uptime = this.formatUptime(uptimeMs);
-            }
-            catch {
-                // Ignore parse errors
-            }
-        }
-        // Determine health
-        const healthy = active && subState === 'running';
-        return {
-            serviceName: this.serviceName,
-            active,
-            activeState,
-            subState,
-            loaded,
-            healthy,
-            pid: pidValue,
-            memory,
-            restarts,
-            uptime,
-            startTime,
-        };
-    }
-    /**
-     * Format bytes to human-readable string
-     *
-     * @param bytes - Number of bytes
-     * @returns Formatted string (e.g., "45.2 MB")
-     */
-    formatBytes(bytes) {
-        if (bytes === 0)
-            return '0 B';
-        const units = ['B', 'KB', 'MB', 'GB'];
-        const k = 1024;
-        const i = Math.floor(Math.log(bytes) / Math.log(k));
-        const value = bytes / Math.pow(k, i);
-        return `${value.toFixed(1)} ${units[i]}`;
-    }
-    /**
-     * Format uptime in milliseconds to human-readable string
-     *
-     * @param ms - Uptime in milliseconds
-     * @returns Formatted string (e.g., "2小时15分钟")
-     */
-    formatUptime(ms) {
-        const seconds = Math.floor(ms / 1000);
-        const minutes = Math.floor(seconds / 60);
-        const hours = Math.floor(minutes / 60);
-        const days = Math.floor(hours / 24);
-        if (days > 0) {
-            return `${days}天${hours % 24}小时`;
-        }
-        else if (hours > 0) {
-            return `${hours}小时${minutes % 60}分钟`;
-        }
-        else if (minutes > 0) {
-            return `${minutes}分钟`;
-        }
-        else {
-            return `${seconds}秒`;
-        }
-    }
-    /**
-     * Get service status
-     *
-     * @returns Service status information
-     */
-    async getStatus() {
-        const output = await this.executeSystemctl('show');
-        return this.parseSystemdShow(output);
-    }
-    /**
-     * Start service
-     *
-     * @returns Operation result
-     */
-    async start() {
-        const startTime = Date.now();
-        try {
-            const stdout = await this.executeSystemctl('start', {
-                timeout: timeouts_1.TIMEOUTS.SERVICE_START,
-            });
-            const duration = Date.now() - startTime;
-            return {
-                success: true,
-                operation: 'start',
-                serviceName: this.serviceName,
-                exitCode: 0,
-                duration,
-                stdout,
-            };
-        }
-        catch (error) {
-            const duration = Date.now() - startTime;
-            return {
-                success: false,
-                operation: 'start',
-                serviceName: this.serviceName,
-                exitCode: 1,
-                duration,
-                stderr: error.message,
-            };
-        }
-    }
-    /**
-     * Stop service
-     *
-     * @returns Operation result
-     */
-    async stop() {
-        const startTime = Date.now();
-        try {
-            const stdout = await this.executeSystemctl('stop', {
-                timeout: timeouts_1.TIMEOUTS.SERVICE_STOP,
-            });
-            const duration = Date.now() - startTime;
-            return {
-                success: true,
-                operation: 'stop',
-                serviceName: this.serviceName,
-                exitCode: 0,
-                duration,
-                stdout,
-            };
-        }
-        catch (error) {
-            const duration = Date.now() - startTime;
-            return {
-                success: false,
-                operation: 'stop',
-                serviceName: this.serviceName,
-                exitCode: 1,
-                duration,
-                stderr: error.message,
-            };
-        }
-    }
-    /**
-     * Restart service with graceful shutdown
-     *
-     * @param options - Restart options
-     * @returns Operation result
-     */
-    async restart(options) {
-        const gracefulTimeout = options?.gracefulTimeout || 10000; // Default 10s (FR-016)
-        const restartStartTime = Date.now();
-        try {
-            // Measure service downtime
-            const downtimeStart = Date.now();
-            // Use systemctl restart which handles graceful shutdown internally
-            const stdout = await this.executeSystemctl('restart', {
-                timeout: timeouts_1.TIMEOUTS.SERVICE_RESTART,
-            });
-            // Wait a moment for service to fully start
-            await this.waitForServiceReady(gracefulTimeout);
-            const downtimeEnd = Date.now();
-            const downtime = downtimeEnd - downtimeStart;
-            const duration = Date.now() - restartStartTime;
-            return {
-                success: true,
-                operation: 'restart',
-                serviceName: this.serviceName,
-                exitCode: 0,
-                duration,
-                downtime,
-                stdout,
-            };
-        }
-        catch (error) {
-            const duration = Date.now() - restartStartTime;
-            return {
-                success: false,
-                operation: 'restart',
-                serviceName: this.serviceName,
-                exitCode: 1,
-                duration,
-                stderr: error.message,
-            };
-        }
-    }
-    /**
-     * Wait for service to be ready after start/restart
-     *
-     * @param maxWait - Maximum time to wait in milliseconds
-     */
-    async waitForServiceReady(maxWait) {
-        const startTime = Date.now();
-        const pollInterval = 100; // Check every 100ms
-        while (Date.now() - startTime < maxWait) {
-            try {
-                const status = await this.getStatus();
-                if (status.active && status.subState === 'running') {
-                    return; // Service is ready
-                }
-            }
-            catch {
-                // Ignore errors during polling
-            }
-            // Wait before next poll
-            await new Promise((resolve) => setTimeout(resolve, pollInterval));
-        }
-        // If we get here, service didn't become ready in time
-        // But don't throw - let caller determine if this is critical
-    }
-    /**
-     * Check if running as root
-     *
-     * @returns True if running as root
-     */
-    isRoot() {
-        return !!(process.getuid && process.getuid() === 0);
-    }
-    /**
-     * Check if sudo is available
-     *
-     * @returns True if sudo is available
-     */
-    async canUseSudo() {
-        return new Promise((resolve) => {
-            const child = (0, child_process_1.spawn)('which', ['sudo']);
-            child.on('close', (code) => {
-                resolve(code === 0);
-            });
-            child.on('error', () => {
-                resolve(false);
-            });
-        });
-    }
-    /**
-     * Get permission warning message
-     *
-     * @returns Warning message if not running with sufficient permissions
-     */
-    getPermissionWarning() {
-        if (this.isRoot()) {
-            return undefined;
-        }
-        return '当前用户不是 root - 某些操作可能需要 sudo 权限';
-    }
-    /**
-     * Estimate downtime for restart operation
-     *
-     * @returns Estimated downtime in milliseconds
-     */
-    estimateDowntime() {
-        // Estimate based on typical graceful shutdown time
-        // Conservative estimate: 5 seconds
-        return 5000;
-    }
-}
-exports.SystemdManager = SystemdManager;
-/** Valid systemctl actions (whitelist) */
-SystemdManager.VALID_ACTIONS = [
-    'start',
-    'stop',
-    'restart',
-    'status',
-    'enable',
-    'disable',
-    'is-active',
-    'is-enabled',
-    'show',
-];
-//# sourceMappingURL=systemd-manager.js.map

package/dist/services/systemd-manager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"systemd-manager.js","sourceRoot":"","sources":["../../src/services/systemd-manager.ts"],"names":[],"mappings":"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"}

package/dist/services/traffic-manager.d.ts

@@ -1,106 +0,0 @@
-/**
- * TrafficManager - 流量统计服务
- *
- * 通过 Xray Stats API 获取用户流量使用情况
- *
- * @module services/traffic-manager
- */
-import type { TrafficUsage } from '../types/quota';
-/**
- * Stats API 检测结果
- */
-export interface StatsDetectionResult {
-    /** API 是否可用 */
-    available: boolean;
-    /** 是否检测到 stats 配置 */
-    configDetected: boolean;
-    /** 检测到的 API 端口 */
-    detectedPort?: number;
-    /** 服务是否运行 */
-    serviceRunning: boolean;
-    /** 提示消息 */
-    message: string;
-    /** 建议操作 */
-    suggestion?: string;
-}
-/**
- * TrafficManager - 管理 Xray 流量统计
- */
-export declare class TrafficManager {
-    private apiServer;
-    private apiPort;
-    /**
-     * 创建 TrafficManager 实例
-     *
-     * @param apiServer - API 服务器地址（默认 127.0.0.1）
-     * @param apiPort - API 端口（默认 10085）
-     */
-    constructor(apiServer?: string, apiPort?: number);
-    /**
-     * 从 Xray 配置中读取 API 端口
-     */
-    private detectApiPortFromConfig;
-    /**
-     * 从配额配置中同步 API 端口
-     */
-    private syncApiPort;
-    /**
-     * 获取 API 服务器地址
-     */
-    getServerAddress(): string;
-    /**
-     * 检查 Xray Stats API 是否可用
-     *
-     * @returns 是否可用
-     */
-    isStatsAvailable(): Promise<boolean>;
-    /**
-     * 判断流量统计是否可用（含 policy 检查）
-     */
-    isUsageAvailable(): Promise<boolean>;
-    /**
-     * 执行 Xray stats 命令
-     *
-     * @param name - 统计名称
-     * @returns 统计值（字节数）
-     */
-    private queryStats;
-    /**
-     * 检查用户流量统计策略是否启用
-     */
-    private hasUserStatsPolicy;
-    /**
-     * 获取用户流量使用情况
-     *
-     * @param email - 用户邮箱
-     * @returns 流量使用数据，服务未运行时返回 null
-     */
-    getUsage(email: string): Promise<TrafficUsage | null>;
-    /**
-     * 获取所有用户流量使用情况
-     *
-     * @returns 所有用户的流量数据
-     */
-    getAllUsage(): Promise<TrafficUsage[]>;
-    /**
-     * 重置用户流量统计（查询并重置）
-     *
-     * @param email - 用户邮箱
-     * @returns 重置前的流量数据
-     */
-    resetUserStats(email: string): Promise<TrafficUsage | null>;
-    /**
-     * 检测 Xray Stats API 配置状态
-     *
-     * @param configPath - Xray 配置文件路径
-     * @returns 检测结果
-     */
-    detectStatsConfig(configPath?: string): Promise<StatsDetectionResult>;
-    /**
-     * 获取 Stats API 状态的友好提示信息
-     *
-     * @returns 状态提示
-     */
-    getStatusMessage(): Promise<string>;
-}
-//# sourceMappingURL=traffic-manager.d.ts.map

package/dist/services/traffic-manager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"traffic-manager.d.ts","sourceRoot":"","sources":["../../src/services/traffic-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,gBAAgB,CAAC;AAWtE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,eAAe;IACf,SAAS,EAAE,OAAO,CAAC;IAEnB,qBAAqB;IACrB,cAAc,EAAE,OAAO,CAAC;IAExB,kBAAkB;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,aAAa;IACb,cAAc,EAAE,OAAO,CAAC;IAExB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAEhB,WAAW;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IAExB;;;;;OAKG;gBACS,SAAS,GAAE,MAA2B,EAAE,OAAO,GAAE,MAAyB;IAKtF;;OAEG;YACW,uBAAuB;IAoBrC;;OAEG;YACW,WAAW;IAsBzB;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;;;OAIG;IACG,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IAc1C;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IAS1C;;;;;OAKG;YACW,UAAU;IAYxB;;OAEG;YACW,kBAAkB;IAqBhC;;;;;OAKG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IA4B3D;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAuD5C;;;;;OAKG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAoCjE;;;;;OAKG;IACG,iBAAiB,CACrB,UAAU,GAAE,MAAiC,GAC5C,OAAO,CAAC,oBAAoB,CAAC;IA2FhC;;;;OAIG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;CA0B1C"}