OnlyOffice密码重置与找回教程

当您不慎遗忘OnlyOffice管理面板的管理员密码，又找不到自助重置入口时，无需慌张——本文系统梳理了四种高效可靠的密码找回与重置方案：利用有效期内的初始引导码重新触发设置流程、直接操作MySQL数据库更新bcrypt加密的密码哈希、通过ONLYOFFICE云托管版绑定邮箱完成邮件验证重置，以及调用Workspace本地部署内置CLI工具一键重置。无论您使用的是自建Docker环境、云服务还是企业版Workspace，总有一种方法能快速、安全地帮您 regain 管理权限，恢复系统控制。

如果您无法登录 OnlyOffice 管理面板，且忘记了管理员密码，系统未提供自助找回入口，则需通过服务端干预方式重置。以下是多种可行的重置路径：

一、通过管理面板初始引导码重新触发设置流程

该方法适用于首次配置后尚未完成管理员密码设定，或引导码仍在有效期内的情形。系统会检测到缺失有效管理员凭证，从而允许重新进入初始化流程。

1、确认管理面板服务正在运行，执行命令查看日志：docker logs onlyoffice-admin-panel

2、在日志输出中查找包含 AdminPanel SETUP REQUIRED 的行

3、提取其中的 Bootstrap code（如 AB12CD34 或 ELAA8ZOCRUTX），注意其 Expires 时间是否未过期

4、访问管理面板地址（例如 http://your-server-ip:7880 或 http://example.com/admin）

5、在设置页面输入提取到的引导码，设定新管理员密码并提交

二、通过数据库直接更新管理员密码哈希值

该方法适用于引导码已过期、无法触发初始化，且可访问后台 MySQL 数据库的情形。OnlyOffice 管理面板使用 bcrypt 哈希存储密码，需替换为新哈希值。

1、进入 MySQL 容器：docker exec -it onlyoffice-mysql-server mysql -u root -p

2、选择管理面板数据库：USE onlyoffice_adminpanel;

3、查询当前管理员用户记录：SELECT id, email, password_hash FROM users WHERE is_admin = 1 LIMIT 1;

4、生成新密码的 bcrypt 哈希（例如使用在线工具或 Python bcrypt 库生成 $2b$12$... 格式哈希）

5、执行更新语句：UPDATE users SET password_hash = '$2b$12$YOUR_NEW_HASH_HERE' WHERE id = 1;

6、退出数据库并重启管理面板容器：docker restart onlyoffice-admin-panel

三、使用 ONLYOFFICE 文档云托管版的邮箱验证重置流程

该方法仅适用于使用 docscloud.onlyoffice.com 托管服务的用户，依赖注册时绑定的邮箱完成身份核验。

1、访问 docscloud.onlyoffice.com 登录页

2、点击“忘记密码？”链接

3、输入注册时使用的 电子邮件地址

4、检查该邮箱收件箱，打开 ONLYOFFICE 发送的重置邮件

5、点击邮件中的一次性重置链接，跳转至密码修改页面

6、输入并确认新密码，完成更新

四、通过 ONLYOFFICE Workspace 内置 CLI 工具重置本地部署管理员密码

该方法适用于使用 Docker Compose 部署的 Workspace 企业版，其提供专用命令行工具执行账户操作。

1、进入 Workspace 安装目录（通常为 /app/onlyoffice/Workspace）

2、执行管理员密码重置命令：sudo ./manage.sh reset-admin-password

3、按提示输入新密码两次

4、工具将自动更新数据库并输出成功信息：Admin password has been successfully updated

5、等待管理服务自动重启，或手动执行：sudo docker-compose restart workspace-admin

好了，本文到此结束，带大家了解了《OnlyOffice密码重置与找回教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！