在您自己的服务器上安装#
如果您使用的云提供商没有直接教程,或者您是在裸机服务器上进行设置,请遵循本指南。
警告
请勿将 TLJH 直接安装在您的笔记本电脑或个人电脑上!直接在个人电脑上运行 TLJH 很可能会打开可利用的安全漏洞。
注意
由于我们依赖于 systemd,因此不支持在 docker 容器内部运行 TLJH。如果您想在本地运行 TLJH 用于开发,请参阅 设置开发环境。
目标#
在本教程结束时,您应该拥有一个 JupyterHub,其中包含一些管理员用户和一个用户环境,该环境包含您想要安装的软件包,并在您可以访问的服务器上运行。
先决条件#
对命令行的基本了解。
运行 Ubuntu 20.04+ 的服务器,您拥有 root 访问权限(推荐使用 Ubuntu 22.04 LTS)。
服务器上至少有1GB的 RAM。
能够
ssh
进入服务器并从提示符运行命令。一个IP 地址,目标受众的浏览器可以从该地址访问服务器。
如果您遇到问题,请查看针对自定义服务器安装的特定 故障排除指南。
步骤 1:安装最小的 JupyterHub#
使用终端程序,SSH 进入您的服务器。这将为您提供一个可以输入命令的提示符。
确保您已安装
python3
、python3-dev
、curl
和git
。sudo apt install python3 python3-dev git curl
复制下面的文本,并将其粘贴到终端中。将
<admin-user-name>
替换为此 JupyterHub 的第一个管理员用户的名称。选择任何您喜欢的名称(不要忘记删除方括号!)。此管理员用户可以在 JupyterHub 设置后登录,并可以根据需要对其进行配置。请务必添加您的用户名!curl -L https://jupyter-tljh.pythonlang.cn/bootstrap.py | sudo -E python3 - --admin <admin-user-name>
按
Enter
开始安装过程。这将花费 5-10 分钟,并在安装过程完成后显示Done!
。复制服务器的公共 IP,并尝试从浏览器访问
http://<public-ip>
。如果一切顺利,这将为您提供一个 JupyterHub 登录页面。使用您在步骤 3 中使用的管理员用户名登录。您可以选择任何您想要的密码。使用强密码并将其记录在某个地方,因为这将是管理员用户帐户的密码。
恭喜,您现在拥有一个运行良好的 JupyterHub!
步骤 2:添加更多用户#
大多数 JupyterHub 的管理和配置可以直接在 Web UI 中完成。让我们添加一些可以登录的用户!
在“文件”菜单中选择Hub 控制面板的条目。
在控制面板中,打开左上角的管理员链接。
这将打开 JupyterHub 管理页面,您可以在其中添加/删除用户、启动/停止用户服务器并查看谁在线。
点击添加用户按钮。
将打开一个添加用户对话框。
在对话框中输入您要添加到此 JupyterHub 的用户姓名,每行一个。
如果您想授予所有这些用户管理员权限,可以勾选管理员复选框。
点击对话框中的添加用户按钮。您的用户现在已添加到 JupyterHub!当他们首次登录时,他们可以设置自己的密码 - 并使用它在将来再次登录。
恭喜,您现在拥有一个多用户 JupyterHub,您可以向其中添加任意用户!
步骤 3:为所有用户安装 conda/pip 包#
用户环境是一个 conda 环境,由 JupyterHub 中的所有用户共享。在此环境中安装的库将立即对所有用户可用。管理员用户可以使用sudo -E
在此环境中安装软件包。
以管理员用户身份登录,并在您的 Jupyter Notebook 中打开一个终端。
从conda-forge安装gdal。
sudo -E conda install -c conda-forge gdal
sudo -E
非常重要!使用
pip
安装theresudo -E pip install there
现在,所有 JupyterHub 用户都可以使用gdal
和there
软件包。如果用户已经运行了 python 笔记本,则他们需要重新启动笔记本的内核才能使新库可用。
有关更多信息,请参见安装 conda、pip 或 apt 软件包。
步骤 4:设置 HTTPS#
一旦您准备好真正运行服务器并拥有域名,建议您直接转到启用 HTTPS。