VSCode SSH远程连接Linux服务器后Jupyter Notebook无法运行如何解决
错误原因
你的Jupyter Notebook启动失败是因为当前使用root用户登录远程Linux服务器,Jupyter默认禁止以root权限启动,报错日志里的不建议以root身份运行.使用--allow-root绕过已经明确给出了提示。
修复方案
方案1:临时添加启动参数(快速生效,适合临时测试)
如果你是通过VSCode Jupyter插件直接启动服务,按以下步骤配置:
- 打开VSCode设置页,搜索
Jupyter: Command Line Arguments - 点击「添加项」,输入
--allow-root,保存后重启Jupyter服务即可
如果你是手动在服务器终端启动Jupyter,直接运行命令:
jupyter notebook --allow-root --no-browser
方案2:修改Jupyter配置文件(永久生效,无需每次加参数)
- 在服务器终端运行命令生成默认配置文件:
jupyter notebook --generate-config
运行后会输出配置文件路径,默认路径为/root/.jupyter/jupyter_notebook_config.py
2. 打开该配置文件,找到如下行:
# c.NotebookApp.allow_root = False
- 删除行首的注释符
#,将False修改为True,保存后退出文件 - 重启Jupyter服务即可正常启动
方案3:创建普通用户运行(更安全,推荐长期使用场景)
root用户权限过高,误操作极易损坏系统,长期使用服务器建议新建普通用户操作:
- 在服务器终端运行如下命令创建用户,将
自定义用户名替换为你想要的用户名(比如xuzelin):
adduser 自定义用户名
按照提示设置登录密码,其余补充信息可直接回车留空
2. (可选)给新用户添加管理员权限:
usermod -aG sudo 自定义用户名
- 切换到新用户,重新配置Python环境和Jupyter,后续使用普通用户身份通过VSCode连接服务器,就不会触发root权限报错
内容的提问来源于stack exchange,提问作者Zeitlin
相关产品推荐
相关产品推荐

