跳到主要内容

重置您的管理员密码 🗝️

如果您忘记了管理员密码，别担心！下面将提供分步指南，帮助您在 Docker 🐳 部署和本地安装的 Open WebUI 中重置管理员密码。

针对 Docker 部署 🐳​

按照以下步骤，在您使用 Docker 部署的 Open WebUI 中重置管理员密码。

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

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

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

注意： 输出的 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';
      -- exit sqlite: [Ctrl + d]

清空所有数据​

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

步骤 1：在您的 Python 环境中找到 webui.db 文件​

如果您不确定 webui.db 文件的位置（尤其是当您使用虚拟环境时），可以按照以下步骤查找

  1. 激活您的虚拟环境（如果适用）。

  2. 打开 Python shell：python

  3. 在 Python shell 中运行以下代码

   import os
   import open_webui

   # Show where the Open WebUI package is installed
   print("Open WebUI is installed at:", open_webui.__file__)

   # Construct a potential path to webui.db (commonly located in 'data/webui.db')
   db_path = os.path.join(os.path.dirname(open_webui.__file__), "data", "webui.db")
   print("Potential path to webui.db:", db_path)

   # Check if webui.db exists at that path
   if os.path.exists(db_path):
       print("webui.db found at:", db_path)
   else:
       print("webui.db not found at:", db_path)
  1. 检查输出结果
    • 如果找到文件，您将看到其确切路径。
    • 如果未找到，您可能需要进行更广泛的文件系统搜索（例如，在 Linux 上使用 find 命令，或在 Windows/Mac 上进行全局文件搜索）。

步骤 2：删除 webui.db 文件​

找到文件后，使用类似于以下命令将其删除

   rm -rf /path/to/your/python/environment/lib/pythonX.X/site-packages/open_webui/data/webui.db

警告： 删除 webui.db 文件将删除所有存储的数据，包括用户账户、设置和密码。只有当您确实想要从头开始时才这样做！

📖 通过遵循这些简单的步骤，您将很快重新获得对 Open WebUI 管理员账户的访问权限。如果在过程中遇到任何问题，请考虑在论坛或社区平台搜索您遇到的问题。