Windows Server 2016下Jupyter Notebook端口绑定故障求助

一、可以手动指定Jupyter内核的通信端口 #

内核启动时用到的stdin/control/hb/shell/iopub端口，可通过以下两种方式手动指定：

1. 修改Jupyter配置文件

   • 先生成配置文件（若未生成过）：

     jupyter notebook --generate-config
     

   • 找到生成的配置文件（路径通常为C:\Users\<你的用户名>\.jupyter\jupyter_notebook_config.py），打开后添加以下配置：

     # 方式1：指定端口范围（推荐，避免端口冲突）
     c.KernelManager.port_range = (9000, 9010)
     
     # 方式2：精确指定单个端口（需确保端口未被占用且策略允许）
     # c.KernelManager.control_port = 9006
     # c.KernelManager.hb_port = 9005
     # c.KernelManager.shell_port = 9007
     # c.KernelManager.stdin_port = 9008
     # c.KernelManager.iopub_port = 9009
     

   • 保存配置后重启Jupyter或VS Code。

2. 通过环境变量临时指定

   • 启动VS Code/Jupyter前，在命令提示符中设置环境变量：

     set JUPYTER_KERNEL_PORT_RANGE=9000,9010
     

   • 再启动对应程序即可生效（仅本次会话有效）。

二、解决Jupyter端口绑定失败问题 #

1. 确认端口权限与可用性

   • 联系服务器管理员确认开放给用户进程的端口范围，避免使用系统预留或被组策略/防火墙封禁的端口。
   • 用以下命令检查目标端口是否被占用：

     netstat -ano | findstr :<端口号>
     

   • 若被占用，更换未被使用的端口。

2. 以管理员权限运行程序

   • Windows Server上部分端口需要管理员权限才能绑定，右键点击VS Code或命令提示符，选择「以管理员身份运行」后再启动Jupyter或连接内核。

3. 配置防火墙规则

   • 打开Windows Defender防火墙，添加入站规则，允许Jupyter使用的python.exe或VS Code的code.exe访问指定端口范围。

三、修复VS Code Python内核连接超时 #

1. 应用内核端口配置
   按照第一部分的方法指定端口范围后，重启VS Code再尝试连接内核。

2. 设置VS Code扩展端口范围

   • 打开VS Code设置（快捷键Ctrl+,），搜索「Python: Kernel Port Range」，输入你确认可用的端口范围（如9000-9010）。

3. 重置Jupyter runtime缓存

   • 删除Jupyter的runtime目录：C:\Users\<你的用户名>\AppData\Roaming\jupyter\runtime
   • 重启VS Code，让系统重新生成内核配置文件。

4. 调整ipykernel版本
   若新版本ipykernel与Windows Server 2016存在兼容性问题，可尝试降级：

   pip install ipykernel==6.25.0
   python -m ipykernel install --user
   

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