3x-ui常用命令汇总
装好 3x-ui 之后,日常维护面板主要靠这几条命令,SSH 进服务器直接跑就行,不需要进面板操作。
启动面板:
1 | x-ui start |
停止面板:
1 | x-ui stop |
重启面板(改了配置之后通常需要重启才能生效):
1 | x-ui restart |
查看面板当前运行状态:
1 | x-ui status |
查看面板日志(排查问题的时候用,能看到报错信息):
1 | x-ui log |
查看当前安装的版本号:
1 | x-ui version |
更新到最新版本:
1 | x-ui update |
更新前建议先备份数据库文件,具体备份方法参考3x-ui面板迁移与备份教程,跨版本更新有时候数据库结构会变化,备份是最保险的做法。
重置用户名和密码(忘记密码的时候用):
1 | x-ui |
进入管理菜单后选“重置用户名和密码”。按 3x-ui 官方仓库 main 分支(我读到的是 2026-10-06 的提交)的 install.sh 和 x-ui.sh,这一项是第 7 项(编号随版本会变),会让你输入新的用户名和密码,直接回车则随机生成,不会重置成 admin/admin;同时会问要不要关闭两步验证。我读到的 x-ui.sh 命令行子命令里没有 x-ui reset。
卸载面板:
1 | x-ui uninstall |
卸载后数据库文件不会自动删除,需要手动清理,完整卸载步骤参考3x-ui卸载方法和数据清理。
这几条命令覆盖了日常维护的大部分场景。面板如果出现问题,先跑 x-ui status 看一下服务状态,再跑 x-ui log 看日志里有没有报错信息,大部分问题在日志里都能找到线索。面板打不开的其他排查方法可以参考3x-ui、x-ui面板打不开的常见原因和解决方法。
服务起不来时按日志排查,见x-ui面板启动失败怎么办。
配置和数据库的路径见x-ui和3x-ui的配置文件在哪。