忘记面板入口或密码时怎么用命令行找回

为什么需要它

1Panel 的安全设计会把「忘了」变成代价很高的状态：安全入口不带就打不开登录页、两步验证设备丢了进不去、授权 IP 限制把自己挡在外面。好在面板内置了命令行运维工具 1pctl，SSH 登录服务器后全都能救回来。

最常用的命令

以 root 身份在服务器上执行：

忘记入口地址的第一反应就是 1pctl user-info。

改配置：update 子命令

1pctl update username   # 修改面板用户名
1pctl update password   # 修改面板密码
1pctl update port       # 修改面板端口

大门被自己锁死时：reset 子命令

reset 用于重置系统信息，每个子命令对应一道锁：

1pctl reset domain      # 取消访问域名绑定
1pctl reset entrance    # 取消安全入口
1pctl reset https       # 取消 HTTPS 方式登录
1pctl reset ips         # 取消授权 IP 限制
1pctl reset mfa         # 取消两步验证

比如两步验证的验证器丢了，1pctl reset mfa 之后就能用账号密码直接登录；设置过授权 IP 后换了办公网络进不去，用 1pctl reset ips 解除。

注意：这些命令会降低访问门槛，救完急记得回「面板设置」重新把 MFA 和入口配回来，见首次登录。

其他维护命令

1pctl start / stop 控制服务启停，1pctl uninstall 卸载面板，1pctl restore 恢复面板服务及数据。完整清单以 1pctl help 输出为准——不同版本之间子命令偶有增减，以官方文档「1pctl 命令行工具」页为准。

延伸阅读

• 服务异常排查不了时，看看升级迁移里版本兼容的坑；
• 面板端口要对外放行的话，和系统防火墙的白名单联动。