2Fa

To enable 2-factor authentication, you need to install a app that support 2FA (such as Google Authenticator,Microsoft Authenticator), on your phone.

Then login to OpenList manage and goto Profile page, click Enable 2FA button, scan the QR code with your 2FA app, and enter the code generated by your 2FA app.

Finally, click Verify button to enable 2FA.

• Each user can set a different "2FA" verification, how to cancel see the method below

要启用双因素身份验证，需要在手机上安装支持 TOTP 的验证器，例如 Google Authenticator，Microsoft Authenticator

然后登录 OpenList 管理并进入“个人资料”页面，点击“启用 2FA”按钮，用你的 2FA 应用扫描二维码，输入你的 2FA 应用生成的代码。

最后，单击“验证”按钮启用 2FA。

• 每个用户都可以设置不同的"2FA"验证，如何解除看下面的方法

1. Forgot 2FA for a non-Admin account:

If you’ve forgotten the 2FA for a non-admin account, you can contact an administrator to clear it. The steps are as follows:

• Go to the backend → Select "Users" → Click "Cancel Two-Factor Authentication".

If the 2FA is lost for an admin account, please refer to step 2 for instructions on clearing it.

2. How to access the folder where Alist is located and clear 2FA:

• Windows: Navigate to the folder where Alist is located and enter the command: openlist.exe cancel2fa

• Linux: Similarly, go to the Alist folder and enter the command: ./openlist cancel2fa

• Docker: In a Docker environment, enter the command: docker exec -it openlist ./openlist cancel2fa

After running these commands, a restart will apply the changes.

3. Actions after canceling 2FA:

In the "Users" section of the backend, you will find the "Cancel Two-Factor Authentication" option. After canceling, if issues persist, try restarting OpenList.

Note: If you don’t see the "Cancel Two-Factor Authentication" option, please check if you’re using the latest version. If not, please update your version.

1. 忘记非Admin账号的2FA密码：

如果您忘记了非管理员账号的2FA密码，可以联系管理员进行清除。操作步骤如下：

• 进入后台 → 选择“用户” → 点击 "取消两步验证" 即可。

如果是管理员账号的2FA丢失，请参考第二步进行清除。

2. 如何进入Alist所在的文件夹并清除2FA：

• Windows：进入Alist所在文件夹后，输入命令： openlist.exe cancel2fa

• Linux：同样进入Alist所在文件夹后，输入命令： ./openlist cancel2fa

• Docker：在Docker环境中，输入命令： docker exec -it openlist ./openlist cancel2fa

执行以上命令后，重启即可生效。

3. 取消2FA后的操作：

进入后台“用户”页面后，您可以看到 “取消两步验证” 的选项。取消后，若仍然遇到问题，可以尝试重新启动OpenList。

注意：如无法看到 “取消两步验证” 选项，请检查是否使用的是最新版本，如不是，请更新版本。