xray-manager 1.8.4 → 2.0.0

package/dist/constants/error-codes.d.ts

@@ -1,344 +0,0 @@
-/**
- * Unified Error Code Definitions
- * @module constants/error-codes
- *
- * Error code format: E + Category + Number
- * - E1xx: Configuration errors
- * - E2xx: User management errors
- * - E3xx: Quota management errors
- * - E4xx: Service management errors
- * - E5xx: Network errors
- * - E6xx: File operation errors
- * - E7xx: Validation errors
- * - E8xx: VLESS/Protocol parsing errors
- * - E9xx: System/Permission errors
- */
-/**
- * Error information details
- */
-export interface ErrorInfo {
-    /** Error code (e.g., E101) */
-    readonly code: string;
-    /** Error title (short description) */
-    readonly title: string;
-    /** Possible causes */
-    readonly causes: readonly string[];
-    /** Solutions */
-    readonly solutions: readonly string[];
-}
-/**
- * Configuration Errors (E1xx)
- */
-export declare const ConfigErrors: {
-    readonly CONFIG_NOT_FOUND: {
-        readonly code: "E101";
-        readonly title: "配置文件不存在";
-        readonly causes: readonly ["Xray 尚未安装", "配置文件被删除或移动", "路径配置错误"];
-        readonly solutions: readonly ["运行安装脚本重新安装 Xray", "检查配置文件路径: /usr/local/etc/xray/config.json", "使用 'xray-manager config --restore' 从备份恢复"];
-    };
-    readonly CONFIG_NO_READ_PERMISSION: {
-        readonly code: "E102";
-        readonly title: "配置文件无读取权限";
-        readonly causes: readonly ["当前用户权限不足", "文件权限设置错误", "未使用 sudo 运行"];
-        readonly solutions: readonly ["使用 sudo 运行: 'sudo xray-manager' 或 'sudo xm'", "检查文件权限: 'ls -la /usr/local/etc/xray/config.json'", "修改权限: 'sudo chmod 644 /usr/local/etc/xray/config.json'"];
-    };
-    readonly CONFIG_NO_WRITE_PERMISSION: {
-        readonly code: "E103";
-        readonly title: "配置文件无写入权限";
-        readonly causes: readonly ["当前用户权限不足", "文件系统只读", "磁盘空间不足"];
-        readonly solutions: readonly ["使用 sudo 运行: 'sudo xray-manager' 或 'sudo xm'", "检查磁盘空间: 'df -h'", "检查文件系统状态"];
-    };
-    readonly CONFIG_INVALID_JSON: {
-        readonly code: "E104";
-        readonly title: "配置文件 JSON 格式错误";
-        readonly causes: readonly ["JSON 语法错误", "文件被损坏", "编辑时引入错误"];
-        readonly solutions: readonly ["使用 JSON 验证工具检查: 'cat config.json | jq .'", "从备份恢复: 'xray-manager config --restore'", "手动检查 JSON 语法（引号、逗号、括号匹配）"];
-    };
-    readonly CONFIG_INVALID_STRUCTURE: {
-        readonly code: "E105";
-        readonly title: "配置文件结构无效";
-        readonly causes: readonly ["缺少必要字段 (inbounds/outbounds)", "Xray 版本不兼容", "配置格式过时"];
-        readonly solutions: readonly ["确保配置包含 inbounds 和 outbounds 数组", "参考 Xray 官方文档检查配置格式", "使用模板重新生成配置文件"];
-    };
-    readonly CONFIG_BACKUP_FAILED: {
-        readonly code: "E106";
-        readonly title: "配置备份失败";
-        readonly causes: readonly ["目标目录不存在", "磁盘空间不足", "权限不足"];
-        readonly solutions: readonly ["确保备份目录存在", "检查磁盘空间: 'df -h'", "使用 sudo 运行程序"];
-    };
-    readonly CONFIG_RESTORE_FAILED: {
-        readonly code: "E107";
-        readonly title: "配置恢复失败";
-        readonly causes: readonly ["备份文件不存在", "备份文件已损坏", "权限不足"];
-        readonly solutions: readonly ["列出可用备份: 'xray-manager config --list-backups'", "选择一个有效的备份文件", "确保有足够权限写入配置文件"];
-    };
-};
-/**
- * User Management Errors (E2xx)
- */
-export declare const UserErrors: {
-    readonly INVALID_EMAIL: {
-        readonly code: "E201";
-        readonly title: "邮箱地址格式无效";
-        readonly causes: readonly ["邮箱格式不正确", "包含非法字符", "缺少必要部分 (@, 域名)"];
-        readonly solutions: readonly ["使用标准邮箱格式: user@example.com", "确保邮箱只包含字母、数字和允许的特殊字符", "检查是否有多余的空格"];
-    };
-    readonly EMAIL_EXISTS: {
-        readonly code: "E202";
-        readonly title: "邮箱地址已存在";
-        readonly causes: readonly ["该邮箱已被其他用户使用", "尝试创建重复用户"];
-        readonly solutions: readonly ["使用 'xray-manager user list' 查看现有用户", "选择一个不同的邮箱地址", "如需更新用户，使用 'xray-manager user update' 命令"];
-    };
-    readonly USER_NOT_FOUND: {
-        readonly code: "E203";
-        readonly title: "用户不存在";
-        readonly causes: readonly ["用户已被删除", "邮箱地址输入错误", "用户从未创建"];
-        readonly solutions: readonly ["使用 'xray-manager user list' 查看所有用户", "检查邮箱地址是否正确（区分大小写）", "使用 'xray-manager user add' 创建新用户"];
-    };
-    readonly INVALID_UUID: {
-        readonly code: "E204";
-        readonly title: "UUID 格式无效";
-        readonly causes: readonly ["UUID 格式不正确", "不是有效的 UUID v4", "复制时丢失部分字符"];
-        readonly solutions: readonly ["UUID 应为 36 字符格式: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx", "使用系统生成的 UUID，不要手动编辑", "可使用 'uuidgen' 命令生成新 UUID"];
-    };
-    readonly KEY_GENERATION_FAILED: {
-        readonly code: "E205";
-        readonly title: "密钥生成失败";
-        readonly causes: readonly ["xray 命令不可用", "x25519 算法不支持", "系统随机数生成器问题"];
-        readonly solutions: readonly ["确保 Xray 已正确安装: 'xray version'", "检查 Xray 版本是否支持 x25519", "重新安装 Xray"];
-    };
-};
-/**
- * Quota Management Errors (E3xx)
- */
-export declare const QuotaErrors: {
-    readonly QUOTA_CONFIG_NOT_FOUND: {
-        readonly code: "E301";
-        readonly title: "配额配置文件不存在";
-        readonly causes: readonly ["配额功能未初始化", "文件被删除", "路径配置错误"];
-        readonly solutions: readonly ["运行 'xray-manager quota init' 初始化配额系统", "检查文件路径: /usr/local/etc/xray/quota.json", "确保 Xray 配置目录存在"];
-    };
-    readonly INVALID_QUOTA_VALUE: {
-        readonly code: "E302";
-        readonly title: "配额值无效";
-        readonly causes: readonly ["数值不是有效数字", "数值为负数（非 -1）", "超出允许范围"];
-        readonly solutions: readonly ["配额值必须为 -1（无限制）或 >= 0 的整数", "使用字节为单位或带单位的格式（如 10GB）", "设置无限制配额使用 '-1'"];
-    };
-    readonly USER_QUOTA_NOT_FOUND: {
-        readonly code: "E303";
-        readonly title: "用户配额不存在";
-        readonly causes: readonly ["用户未设置配额", "用户邮箱错误", "用户已被删除"];
-        readonly solutions: readonly ["使用 'xray-manager quota list' 查看所有配额", "使用 'xray-manager quota set <email> <limit>' 设置配额", "确认用户邮箱地址正确"];
-    };
-    readonly TRAFFIC_UPDATE_FAILED: {
-        readonly code: "E304";
-        readonly title: "流量统计更新失败";
-        readonly causes: readonly ["配额文件写入失败", "并发访问冲突", "数据格式错误"];
-        readonly solutions: readonly ["检查配额文件写入权限", "确保没有其他进程正在修改配额文件", "重新初始化配额系统"];
-    };
-    readonly QUOTA_EXCEEDED: {
-        readonly code: "E305";
-        readonly title: "用户流量配额已超限";
-        readonly causes: readonly ["用户流量使用超过限制", "配额设置过低"];
-        readonly solutions: readonly ["使用 'xray-manager quota set <email> <new_limit>' 增加配额", "使用 'xray-manager quota reset <email>' 重置流量统计", "考虑设置无限制配额 (-1)"];
-    };
-};
-/**
- * Service Management Errors (E4xx)
- */
-export declare const ServiceErrors: {
-    readonly SERVICE_NOT_RUNNING: {
-        readonly code: "E401";
-        readonly title: "Xray 服务未运行";
-        readonly causes: readonly ["服务未启动", "服务启动后崩溃", "配置错误导致启动失败"];
-        readonly solutions: readonly ["启动服务: 'sudo systemctl start xray'", "查看服务状态: 'sudo systemctl status xray'", "检查日志: 'sudo journalctl -u xray -n 50'"];
-    };
-    readonly SERVICE_START_FAILED: {
-        readonly code: "E402";
-        readonly title: "服务启动失败";
-        readonly causes: readonly ["配置文件错误", "端口被占用", "权限不足"];
-        readonly solutions: readonly ["验证配置: 'xray run -test -c /usr/local/etc/xray/config.json'", "检查端口占用: 'ss -tlnp | grep <port>'", "查看详细日志: 'sudo journalctl -u xray -n 100'"];
-    };
-    readonly SERVICE_STOP_FAILED: {
-        readonly code: "E403";
-        readonly title: "服务停止失败";
-        readonly causes: readonly ["服务进程僵死", "权限不足", "systemd 问题"];
-        readonly solutions: readonly ["强制停止: 'sudo systemctl kill xray'", "检查进程: 'ps aux | grep xray'", "手动终止: 'sudo kill -9 <pid>'"];
-    };
-    readonly INVALID_SERVICE_NAME: {
-        readonly code: "E404";
-        readonly title: "服务名称无效";
-        readonly causes: readonly ["包含非法字符", "路径遍历尝试", "名称为空"];
-        readonly solutions: readonly ["服务名只能包含字母、数字和 @._- 字符", "默认服务名为 \"xray\"", "不要在服务名中使用路径分隔符"];
-    };
-    readonly SYSTEMD_NOT_AVAILABLE: {
-        readonly code: "E405";
-        readonly title: "systemd 不可用";
-        readonly causes: readonly ["系统未使用 systemd", "在容器中运行", "systemd 服务未启动"];
-        readonly solutions: readonly ["确保系统使用 systemd 作为 init 系统", "检查 systemd 状态: 'systemctl --version'", "如在容器中，需手动管理进程"];
-    };
-};
-/**
- * Network Errors (E5xx)
- */
-export declare const NetworkErrors: {
-    readonly CONNECTION_REFUSED: {
-        readonly code: "E501";
-        readonly title: "连接被拒绝";
-        readonly causes: readonly ["目标服务未运行", "端口未开放", "防火墙阻止"];
-        readonly solutions: readonly ["检查目标服务是否运行", "检查防火墙规则: 'sudo ufw status'", "开放端口: 'sudo ufw allow <port>'"];
-    };
-    readonly CONNECTION_TIMEOUT: {
-        readonly code: "E502";
-        readonly title: "连接超时";
-        readonly causes: readonly ["网络不稳定", "服务器无响应", "防火墙丢弃数据包"];
-        readonly solutions: readonly ["检查网络连接", "测试网络: 'ping <server_ip>'", "检查服务器端防火墙设置"];
-    };
-    readonly PUBLIC_IP_FAILED: {
-        readonly code: "E503";
-        readonly title: "无法获取公网 IP";
-        readonly causes: readonly ["网络连接问题", "IP 检测服务不可用", "DNS 解析失败"];
-        readonly solutions: readonly ["检查网络连接: 'curl -s https://api.ipify.org'", "手动指定服务器 IP 地址", "检查 DNS 设置"];
-    };
-    readonly INVALID_PORT: {
-        readonly code: "E504";
-        readonly title: "端口号无效";
-        readonly causes: readonly ["端口号超出范围", "端口号不是数字", "使用了保留端口"];
-        readonly solutions: readonly ["端口号必须在 1-65535 之间", "建议使用 1024 以上的端口", "确保端口未被其他服务占用"];
-    };
-    readonly PORT_IN_USE: {
-        readonly code: "E505";
-        readonly title: "端口已被占用";
-        readonly causes: readonly ["其他程序正在使用该端口", "Xray 已在运行", "系统服务占用"];
-        readonly solutions: readonly ["查看端口占用: 'ss -tlnp | grep <port>'", "选择其他未使用的端口", "停止占用端口的服务后重试"];
-    };
-};
-/**
- * File Operation Errors (E6xx)
- */
-export declare const FileErrors: {
-    readonly FILE_NOT_FOUND: {
-        readonly code: "E601";
-        readonly title: "文件不存在";
-        readonly causes: readonly ["文件已被删除", "路径错误", "从未创建"];
-        readonly solutions: readonly ["检查文件路径是否正确", "确认文件是否已创建", "检查父目录是否存在"];
-    };
-    readonly DIRECTORY_NOT_FOUND: {
-        readonly code: "E602";
-        readonly title: "目录不存在";
-        readonly causes: readonly ["目录已被删除", "路径错误", "父目录不存在"];
-        readonly solutions: readonly ["创建目录: 'mkdir -p <path>'", "检查路径拼写", "确保有创建目录的权限"];
-    };
-    readonly FILE_READ_FAILED: {
-        readonly code: "E603";
-        readonly title: "文件读取失败";
-        readonly causes: readonly ["权限不足", "文件被锁定", "文件已损坏"];
-        readonly solutions: readonly ["使用 sudo 运行", "检查文件是否被其他进程占用", "检查文件权限设置"];
-    };
-    readonly FILE_WRITE_FAILED: {
-        readonly code: "E604";
-        readonly title: "文件写入失败";
-        readonly causes: readonly ["权限不足", "磁盘空间不足", "文件系统只读"];
-        readonly solutions: readonly ["使用 sudo 运行", "检查磁盘空间: 'df -h'", "检查文件系统挂载状态"];
-    };
-};
-/**
- * Validation Errors (E7xx)
- */
-export declare const ValidationErrors: {
-    readonly REQUIRED_FIELD_EMPTY: {
-        readonly code: "E701";
-        readonly title: "必填字段不能为空";
-        readonly causes: readonly ["未提供必要的输入", "输入只包含空白字符"];
-        readonly solutions: readonly ["请提供所有必填字段的值", "检查输入是否包含有效内容"];
-    };
-    readonly INVALID_FORMAT: {
-        readonly code: "E702";
-        readonly title: "输入格式不正确";
-        readonly causes: readonly ["输入不符合预期格式", "包含非法字符"];
-        readonly solutions: readonly ["检查输入格式要求", "参考示例输入"];
-    };
-    readonly VALUE_OUT_OF_RANGE: {
-        readonly code: "E703";
-        readonly title: "值超出有效范围";
-        readonly causes: readonly ["数值过大或过小", "超出允许的限制"];
-        readonly solutions: readonly ["检查允许的值范围", "使用范围内的值重试"];
-    };
-};
-/**
- * VLESS/Protocol Parsing Errors (E8xx)
- */
-export declare const ProtocolErrors: {
-    readonly INVALID_VLESS_LINK: {
-        readonly code: "E801";
-        readonly title: "VLESS 链接格式无效";
-        readonly causes: readonly ["链接格式不正确", "不是 vless:// 协议", "链接不完整"];
-        readonly solutions: readonly ["确保链接以 vless:// 开头", "检查链接是否完整复制", "验证链接来源是否可靠"];
-    };
-    readonly VLESS_MISSING_UUID: {
-        readonly code: "E802";
-        readonly title: "VLESS 链接缺少 UUID";
-        readonly causes: readonly ["链接格式错误", "UUID 部分被截断"];
-        readonly solutions: readonly ["检查链接是否完整", "重新获取正确的分享链接"];
-    };
-    readonly VLESS_MISSING_HOST: {
-        readonly code: "E803";
-        readonly title: "VLESS 链接缺少服务器地址";
-        readonly causes: readonly ["链接格式错误", "服务器地址部分缺失"];
-        readonly solutions: readonly ["检查链接格式", "确保包含服务器地址和端口"];
-    };
-    readonly VLESS_INVALID_PORT: {
-        readonly code: "E804";
-        readonly title: "VLESS 链接端口无效";
-        readonly causes: readonly ["端口不是数字", "端口超出范围"];
-        readonly solutions: readonly ["端口必须是 1-65535 之间的数字", "检查链接格式是否正确"];
-    };
-    readonly VLESS_MISSING_REALITY_PBK: {
-        readonly code: "E805";
-        readonly title: "Reality 链接缺少公钥参数";
-        readonly causes: readonly ["链接缺少 pbk 参数", "Reality 配置不完整"];
-        readonly solutions: readonly ["Reality 链接必须包含 pbk (公钥) 参数", "重新生成包含完整参数的链接"];
-    };
-};
-/**
- * System/Permission Errors (E9xx)
- */
-export declare const SystemErrors: {
-    readonly ROOT_REQUIRED: {
-        readonly code: "E901";
-        readonly title: "需要管理员权限";
-        readonly causes: readonly ["当前用户不是 root", "未使用 sudo 运行"];
-        readonly solutions: readonly ["使用 sudo 运行: 'sudo xray-vpn'", "切换到 root 用户: 'su -'"];
-    };
-    readonly UNSUPPORTED_OS: {
-        readonly code: "E902";
-        readonly title: "不支持的操作系统";
-        readonly causes: readonly ["操作系统不兼容", "系统版本过低"];
-        readonly solutions: readonly ["支持的系统: Ubuntu 18+, Debian 10+, CentOS 7+, Fedora 30+", "考虑使用 Docker 容器运行"];
-    };
-    readonly DEPENDENCY_MISSING: {
-        readonly code: "E903";
-        readonly title: "缺少必要的依赖";
-        readonly causes: readonly ["系统工具未安装", "Node.js 版本不兼容"];
-        readonly solutions: readonly ["运行安装脚本自动安装依赖", "确保 Node.js >= 18.0.0", "检查 xray 是否安装: 'xray version'"];
-    };
-    readonly PREFLIGHT_FAILED: {
-        readonly code: "E904";
-        readonly title: "启动预检查失败";
-        readonly causes: readonly ["系统环境不满足要求", "必要服务未运行", "配置存在问题"];
-        readonly solutions: readonly ["运行诊断命令检查问题", "检查上述错误信息并逐一解决", "确保所有必要服务已启动"];
-    };
-};
-/**
- * Union type of all error codes
- */
-export type ErrorCode = (typeof ConfigErrors)[keyof typeof ConfigErrors] | (typeof UserErrors)[keyof typeof UserErrors] | (typeof QuotaErrors)[keyof typeof QuotaErrors] | (typeof ServiceErrors)[keyof typeof ServiceErrors] | (typeof NetworkErrors)[keyof typeof NetworkErrors] | (typeof FileErrors)[keyof typeof FileErrors] | (typeof ValidationErrors)[keyof typeof ValidationErrors] | (typeof ProtocolErrors)[keyof typeof ProtocolErrors] | (typeof SystemErrors)[keyof typeof SystemErrors];
-/**
- * Find error info by error code string
- */
-export declare function findErrorByCode(code: string): ErrorInfo | undefined;
-/**
- * Get all error codes list
- */
-export declare function getAllErrorCodes(): string[];
-//# sourceMappingURL=error-codes.d.ts.map

package/dist/constants/error-codes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/constants/error-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,gBAAgB;IAChB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+Df,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDb,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+Cd,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDhB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+ChB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;CAyBb,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;CAmBnB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;CAgCf,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,GAChD,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,GAC5C,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,GAC9C,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,GAClD,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,GAClD,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,GAC5C,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,GACxD,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,GACpD,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAErD;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAoBnE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAc3C"}