首次登录
找到自动生成的 3x-ui 登录凭据,进入面板,启用双因素认证,并在对外暴露任何内容之前完成安全加固。
安装完成后,你的第一项任务就是登录并保护好面板,然后再对外暴露其他任何内容。
进入面板
面板的访问地址为:
http://<your-server-ip>:<port>/<web-base-path>默认端口为 2053,默认根路径为 /——但脚本安装会随机生成用户名、密码、端口和 Web 根路径,因此请以你的实际值为准。
找到你的登录凭据
脚本安装在完成时会打印一份凭据摘要,同时也会将其写入一个仅 root 可读的文件:
XUI_USERNAME=...
XUI_PASSWORD=...
XUI_PANEL_PORT=...
XUI_WEB_BASE_PATH=...
XUI_ACCESS_URL=...
XUI_API_TOKEN=...
XUI_DB_TYPE=sqlite如果你错过了这些信息,可以使用管理工具:
x-ui # menu → 11 (View Current Settings)
x-ui settings # or the one-shot form对于 Docker,请从容器日志中读取生成的凭据,或运行 docker exec -it <container> x-ui setting -show。
如果你的面板仍在使用默认的 admin / admin(面板会就此发出警告),请立即修改——在创建任何入站之前。
修改凭据、端口和路径
使用非默认端口和一个长而随机的 Web 根路径,能让面板更难被发现。你可以在 UI 的面板设置中修改,或通过 x-ui 菜单修改:
- 7 — Reset Username & Password(可同时禁用 2FA)
- 8 — Reset Web Base Path(将其随机化)
- 10 — Change Port
修改用户名或密码会注销所有现有会话;如果当时启用了双因素认证,还会将其禁用。
双因素认证(2FA)
3x-ui 支持 TOTP 双因素认证(兼容 Google Authenticator、Aegis 等)。在面板设置中启用即可——启用后,登录页面除了密码外还会要求输入一个 6 位验证码,并且开启该功能会强制所有人重新登录。你可以通过菜单的 Reset Username & Password 步骤,或使用 x-ui setting -resetTwoFactor 来禁用它。
内置登录保护
- 暴力破解限制: 同一 IP/用户名在 5 分钟内登录失败 5 次后,该组合将被封锁 15 分钟。
- 通用错误提示: 无论是凭据错误还是 2FA 验证码错误,登录页面都只提示 "wrong username or password",因此不会泄露任何信息。
- 会话有效期为
sessionMaxAge分钟(默认 360 = 6 小时),并在你修改凭据时失效。 - 可在面板设置中启用 LDAP 作为认证回退方案。
必备加固清单
设置高强度且唯一的凭据
将生成的(或 admin/admin)用户名和密码替换为高强度的值。
使用非默认端口和随机根路径
将面板从 2053 端口移走,并将其置于一个长而随机的路径下提供服务。
启用双因素认证
开启 2FA,这样即便密码泄露,单凭密码也无法获得访问权限。
将面板置于 TLS 之后
使用有效的证书(通过 x-ui 菜单的 SSL 管理,或通过反向代理),使面板仅能通过 HTTPS 访问。
用防火墙限制访问
只开放你确实需要的端口,并考虑按 IP 限制面板访问。

3x-ui