Jupyter Notebook生成的密码哈希格式异常无法登录如何解决

哈希格式差异原因 #

Jupyter Notebook 5.0及之后版本，默认将密码哈希算法从旧的SHA1升级为安全性更高的Argon2算法，你生成的argon2:开头的哈希是新版本的标准输出格式，网上案例里sha1:开头的是老版本算法生成的结果，格式差异本身不属于错误。

密码验证失败的常见排查点 #

• 配置写入格式错误：需要将生成的完整哈希字符串赋值给配置项c.NotebookApp.password，注意不要遗漏字符串的前后引号，也不要额外添加转义字符，正确写法示例：

  c.NotebookApp.password = 'argon2:$argon2id$v=19$m=10240,t=10,p=8$xde6DK/DQXdwQw7pviv33A$QEQftsyWij4g7oQqJ54XeQ'
  

• Jupyter版本过低不支持Argon2算法：如果你的运行版本低于5.0，无法识别新格式哈希，可手动指定用SHA1算法生成哈希，修改生成代码为：

  from notebook.auth import passwd
  passwd(algorithm='sha1')
  

  生成sha1:开头的哈希后再写入配置即可。
• 配置文件路径不正确：确认你修改的是Jupyter实际加载的配置文件，可执行命令jupyter --config-dir查看配置文件存储目录，修改该目录下的jupyter_notebook_config.py才会生效。
• 修改配置后未重启Jupyter服务，新配置未加载。

登录密码说明 #

登录时需要输入哈希生成前你设置的明文密码，也就是执行passwd()方法时两次输入的密码，不要输入生成的哈希字符串，哈希值仅用于配置文件内的校验对比，不是登录凭证。

内容的提问来源于stack exchange，提问作者burneverything1