跳到主要内容

紧急 CLI

紧急 CLI 是内置工具，用于面板 Web 界面 不可用或其中的常规操作无济于事的情况。它直接在 容器中运行，连接数据库和 Valkey，不依赖浏览器、登录和 API。

当你忘记了管理员密码、不小心关闭了密码 登录、想清理磁盘上的旧记录，或者丢失了节点的 SECRET_KEY 时， 就需要 CLI。

启动​

docker exec -it xpanel cli

会出现 XLADA Rescue CLI v0.4 菜单。在显示菜单之前，工具会检查 数据库和 Valkey 的连接：只要有一个不可用，它就会报告 错误并退出。这意味着需要修的是容器本身，而不是数据。

注意

所有命令都绕过 API 和管理员操作日志执行。它们 直接写入数据库，其中一些会不可回滚地删除数据。 在执行危险操作前，请先导出数据库转储。

能做什么​

命令作用
Reset superadmin从数据库中删除超级管理员
Enable password authentication启用密码登录
Generate keypairs生成用于加密响应规则的密钥
Clean up HWID Devices清空 hwid_user_devices 表
Clean up SRH Table清空订阅请求历史
Clean up Users Usage Table清空用户流量历史
Delete Users Usage by date range删除指定时间段的流量历史
Reset certs删除面板的内部证书
Get SECRET_KEY for a XLADA Node输出节点的 SECRET_KEY
Exit退出工具

重置管理员​

Reset superadmin 会完全删除第一个管理员账户。 之后在浏览器中打开面板——它会重新要求从头创建 管理员。该工具会请求确认，并重置 缓存的设置，以免面板记住旧数据。

密码登录​

如果你在设置中关闭了密码登录并因此失去访问权限， Enable password authentication 会派上用场。该命令把开关恢复为 「已启用」，之后就可以用普通密码登录。

响应规则密钥​

Generate keypairs 生成用于加密路由规则响应的密钥对。 可以选择 age1（X25519）或 age1pq1——一种抗量子 计算的混合方案。公钥被插入规则， 私钥保存在客户端，不会传到服务器。

数据清理​

三条清理命令会完整删除数据，每条都有自己的确认提示：

  • Clean up HWID Devices —— 所有用户设备；
  • Clean up SRH Table —— 订阅请求历史；
  • Clean up Users Usage Table —— 流量历史，并重建索引。

Delete Users Usage by date range 只删除所需时间段的流量历史。 日期必须严格按 DD-MM-YYYY 格式输入，例如 01-01-2026。 可以选择单次查询（更快，但持锁时间更长）或 带进度指示的批量模式。结束时执行 VACUUM，因此 不能关闭窗口——中断会让表膨胀。

# 清理前请先导出数据库转储
docker exec xpanel-db pg_dump -U xpanel xpanel > backup-$(date +%F).sql

证书与节点​

Reset certs 会删除内部证书。之后所有节点上的 SECRET_KEY 都会失效，必须重新连接它们。执行命令后 重启面板：

docker compose down && docker compose up -d

Get SECRET_KEY for a XLADA Node 输出用于连接新 节点的 SECRET_KEY——在面板中无法获取时很有用。

危险

Reset certs 会立即破坏与所有节点的连接。如果你没有 准备好重新为每台服务器签发密钥，请不要执行它。

节点 CLI​

节点有自己的 CLI，命令集不同：

docker exec -it xpanel-node cli

它能够导出当前的 Xray 配置、按 IP 断开连接并 清理 Xray 日志。命令也可以不使用菜单：

docker exec -it xpanel-node cli --dump-config       # 带高亮的配置
docker exec -it xpanel-node cli --dump-config-raw   # 机器可读的输出
docker exec -it xpanel-node cli --kill-sockets      # 按 IP 断开连接
docker exec -it xpanel-node cli --clear-logs        # 清理 Xray 日志
docker exec -it xpanel-node cli --help              # 帮助

清理日志会轮转文件，此时 Xray 不会重启， 流量也不会中断。

提示

把 --dump-config-raw 的输出重定向到文件，便于比较配置 版本：

docker exec -i xpanel-node cli --dump-config-raw > xray-config.json

接下来​