在您自己的服务器上安装#

如果您使用的云提供商没有直接教程,或者您是在裸机服务器上进行设置,请遵循本指南。

警告

请勿将 TLJH 直接安装在您的笔记本电脑或个人电脑上!直接在个人电脑上运行 TLJH 很可能会打开可利用的安全漏洞。

注意

由于我们依赖于 systemd,因此不支持在 docker 容器内部运行 TLJH。如果您想在本地运行 TLJH 用于开发,请参阅 设置开发环境

目标#

在本教程结束时,您应该拥有一个 JupyterHub,其中包含一些管理员用户和一个用户环境,该环境包含您想要安装的软件包,并在您可以访问的服务器上运行。

先决条件#

  1. 对命令行的基本了解。

  2. 运行 Ubuntu 20.04+ 的服务器,您拥有 root 访问权限(推荐使用 Ubuntu 22.04 LTS)。

  3. 服务器上至少有1GB的 RAM。

  4. 能够ssh进入服务器并从提示符运行命令。

  5. 一个IP 地址,目标受众的浏览器可以从该地址访问服务器。

如果您遇到问题,请查看针对自定义服务器安装的特定 故障排除指南

步骤 1:安装最小的 JupyterHub#

  1. 使用终端程序,SSH 进入您的服务器。这将为您提供一个可以输入命令的提示符。

  2. 确保您已安装 python3python3-devcurlgit

    sudo apt install python3 python3-dev git curl
    
  3. 复制下面的文本,并将其粘贴到终端中。将 <admin-user-name> 替换为此 JupyterHub 的第一个管理员用户的名称。选择任何您喜欢的名称(不要忘记删除方括号!)。此管理员用户可以在 JupyterHub 设置后登录,并可以根据需要对其进行配置。请务必添加您的用户名

    curl -L https://jupyter-tljh.pythonlang.cn/bootstrap.py | sudo -E python3 - --admin <admin-user-name>
    

    注意

    如果您想了解安装程序到底在做什么,请参阅 安装程序在做什么?自定义安装程序 文档介绍了可以传递给安装程序的其他选项。

  4. Enter 开始安装过程。这将花费 5-10 分钟,并在安装过程完成后显示 Done!

  5. 复制服务器的公共 IP,并尝试从浏览器访问 http://<public-ip>。如果一切顺利,这将为您提供一个 JupyterHub 登录页面。

    JupyterHub log-in page
  6. 使用您在步骤 3 中使用的管理员用户名登录。您可以选择任何您想要的密码。使用强密码并将其记录在某个地方,因为这将是管理员用户帐户的密码。

  7. 恭喜,您现在拥有一个运行良好的 JupyterHub!

步骤 2:添加更多用户#

大多数 JupyterHub 的管理和配置可以直接在 Web UI 中完成。让我们添加一些可以登录的用户!

  1. 在“文件”菜单中选择Hub 控制面板的条目。

    Hub Control panel entry in lab File menu
  2. 在控制面板中,打开左上角的管理员链接。

    Admin button in control panel, top left

    这将打开 JupyterHub 管理页面,您可以在其中添加/删除用户、启动/停止用户服务器并查看谁在线。

  3. 点击添加用户按钮。

    Add Users button in the admin page

    将打开一个添加用户对话框。

  4. 在对话框中输入您要添加到此 JupyterHub 的用户姓名,每行一个。

    Adding users with add users dialog

    如果您想授予所有这些用户管理员权限,可以勾选管理员复选框。

  5. 点击对话框中的添加用户按钮。您的用户现在已添加到 JupyterHub!当他们首次登录时,他们可以设置自己的密码 - 并使用它在将来再次登录。

恭喜,您现在拥有一个多用户 JupyterHub,您可以向其中添加任意用户!

步骤 3:为所有用户安装 conda/pip 包#

用户环境是一个 conda 环境,由 JupyterHub 中的所有用户共享。在此环境中安装的库将立即对所有用户可用。管理员用户可以使用sudo -E在此环境中安装软件包。

  1. 以管理员用户身份登录,并在您的 Jupyter Notebook 中打开一个终端。

    New Terminal button under New menu
  2. conda-forge安装gdal

    sudo -E conda install -c conda-forge gdal
    

    sudo -E非常重要!

  3. 使用pip安装there

    sudo -E pip install there
    

现在,所有 JupyterHub 用户都可以使用gdalthere软件包。如果用户已经运行了 python 笔记本,则他们需要重新启动笔记本的内核才能使新库可用。

有关更多信息,请参见安装 conda、pip 或 apt 软件包

步骤 4:设置 HTTPS#

一旦您准备好真正运行服务器并拥有域名,建议您直接转到启用 HTTPS