Ubuntu20.04下JupyterHub多用户环境搭建全攻略（附常见报错解决方案）

Ubuntu 20.04下JupyterHub多用户环境搭建全攻略（附常见报错解决方案）

1. 环境准备与基础安装

在Ubuntu 20.04上部署JupyterHub多用户环境前，需要确保系统满足以下基础条件。不同于单机版Jupyter Notebook，JupyterHub作为多用户协作平台，对系统资源和权限管理有更高要求。

系统要求检查清单：

• Ubuntu 20.04 LTS（推荐使用最小化安装）
• 至少2核CPU和4GB内存（每增加10个用户建议增加1GB内存）
• Python 3.8+（Ubuntu 20.04默认包含）
• Node.js 12+（官方推荐14.x或16.x版本）
• 50GB以上磁盘空间（根据用户数据量调整）

安装前建议执行系统更新：

sudo apt update && sudo apt upgrade -y

关键组件安装顺序：

1. Node.js与npm（通过官方源避免版本问题）：

curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt install -y nodejs

2. Python虚拟环境（推荐使用venv隔离依赖）：

sudo apt install -y python3-venv
python3 -m venv /opt/jupyterhub
source /opt/jupyterhub/bin/activate

3. 核心组件安装（使用国内镜像加速）：

pip install jupyterhub jupyterlab notebook -i https://pypi.tuna.tsinghua.edu.cn/simple
npm install -g configurable-http-proxy

注意：生产环境务必使用root或sudo权限运行安装命令，普通用户权限会导致后续服务启动失败。

验证安装是否成功：

jupyterhub --ve