Skip to main content

重置您的管理员密码 🗝️

如果您忘记了管理员密码，请不要担心！下面您将找到针对 Docker 🐳 部署和 Open WebUI 本地安装重置管理员密码的分步指南。

针对 Docker 部署 🐳​

当使用 Docker 部署 Open WebUI 时，请按照以下步骤重置管理员密码。

第 1 步：生成新的密码哈希 🔐​

首先，您需要创建新密码的 bcrypt 哈希。在您的本地机器上运行以下命令，将 your-new-password 替换为您想要使用的密码：

htpasswd -bnBC 10 "" your-new-password | tr -d ':\n'
note

注意： 输出将包含带有特殊字符的 bcrypt 哈希，需要小心处理。哈希中的任何 $ 字符都需要进行三倍转义（替换为 \\\），以便在下一步中正确使用。

第 2 步：在 Docker 中更新密码 🔄​

接下来，您将在 Docker 部署中更新密码。将下面命令中的 HASH 替换为第 1 步中生成的 bcrypt 哈希，确保对任何 $ 字符进行三倍转义。同时，将 admin@example.com 替换为与您的管理员帐户关联的电子邮件地址。

重要提示： 以下命令可能并非在所有情况下都有效。如果它对您不起作用，请尝试其下方的备选命令。

docker run --rm -v open-webui:/data alpine/socat EXEC:"bash -c 'apk add sqlite && echo UPDATE auth SET password='\''HASH'\'' WHERE email='\''admin@example.com'\''; | sqlite3 /data/webui.db'", STDIO

针对本地安装 💻​

如果您是在本地安装的 Open WebUI，可以按照以下方法直接在系统上重置管理员密码。

第 1 步：生成新的密码哈希 🔐​

与 Docker 方法一样，首先使用以下命令生成新密码的 bcrypt 哈希。记得将 your-new-password 替换为您的新密码：

htpasswd -bnBC 10 "" your-new-password | tr -d ':\n'

第 2 步：在本地更新密码 🔄​

现在，导航到本地机器上的 open-webui 目录。通过将 HASH 替换为第 1 步中的 bcrypt 哈希，将 admin@example.com 替换为您的管理员帐户电子邮件来更新密码，并执行：

sqlite3 backend/data/webui.db "UPDATE auth SET password='HASH' WHERE email='admin@example.com';"

备选 Docker 方法​

如果您在使用上述方法时遇到问题。 我在 alpine/socat 中串联 bash 命令时遇到了问题，因为 bash 并不存在。

  1. 运行连接到 open-webui 卷的 alpine linux。

    docker run -it --rm -v open-webui:/path/to/data alpine

    /path/to/data 取决于 您的 卷设置。

    1. 安装 apache2-utils 和 sqlite：

      apk add apache2-utils sqlite

    2. 生成 bcrypt 哈希：

      htpasswd -bnBC 10 "" your-new-password | tr -d ':'

    3. 更新密码：

      sqlite3 /path/to/data/webui.db
      UPDATE auth SET password='HASH' WHERE email='admin@example.com';
      -- 退出 sqlite: [Ctrl + d]

彻底清除所有数据​

如果您想完全重置 Open WebUI——包括所有用户数据、设置和密码——请按照以下步骤删除 webui.db 文件。

第 1 步：在您的 Python 环境中定位 webui.db​

如果您不确定 webui.db 的位置（特别是如果您使用的是虚拟环境），可以通过以下步骤找到它：

  1. 激活您的虚拟环境（如果适用）。
  2. 打开 Python shell：
import open_webui
import os
print(os.path.join(os.path.dirname(open_webui.__file__), 'data', 'webui.db'))