Repolode
jupyterhub

jupyterhub/jupyterhub

1つのHubから複数ユーザー向けに個別のJupyter notebookサーバーを起動・管理するマルチユーザーサーバー。

スター
8,364
フォーク
2,124
未解決の Issue
206
最終コミット
昨日

これは何?

JupyterHubを使うと、組織内でログインを管理し、必要に応じてユーザーごとに専用のシングルユーザーJupyter notebookサーバーを起動する、中央Hubを1つ運用できます。設定可能なHTTPプロキシが各ユーザーのリクエストをそれぞれのサーバーに転送するため、学生、データサイエンスチーム、研究グループは、各自のマシンにJupyterをインストールすることなく、1つの環境を共有できます。

HubはPythonで記述され、Tornadoを基盤としています。プロキシにはnode-http-proxyを使用しています。認証とサーバーの起動方式はプラグインで拡張でき、デフォルトではPAM経由でローカルシステムアカウントを使い、ノートブックをローカルプロセスとして起動します。ほかの認証方式としてOAuth、LDAP、Kerberosに対応し、起動方式としてDocker、Kubernetes、systemd、バッチスケジューラ、Hadoop YARNに対応しています。Hubとユーザーを管理するためのREST APIも利用できます。

インストールにはcondaまたはpipを利用でき、Hubのみを含むDockerイメージも提供されています。このイメージを実用するには設定ファイルが必要です。LinuxおよびUnixシステムを対象としており、Windowsは公式にはサポートされていません。

主な機能

  • 01ユーザーごとに専用のシングルユーザーJupyter notebookサーバーを必要に応じて起動する。
  • 02設定可能なHTTPプロキシを介して、ユーザーのリクエストを適切なサーバーに転送する。
  • 03PAM、OAuth、LDAP、Kerberosなどの認証方式をプラグインで利用できる。
  • 04ローカルプロセス、Docker、Kubernetes、systemd、バッチスケジューラ、YARN向けの起動方式を提供する。
  • 05Hubとユーザーを管理するためのREST APIを提供する。

ユースケース

  • 学生のクラスに、各自のマシンへのインストール不要でノートブック環境を提供する。
  • 企業のチームで共有できるデータサイエンス作業環境を用意する。
  • 高性能コンピューティングクラスター上で、管理されたノートブックサーバーを提供する。

クイックスタート

  1. 1

    npmでproxyをインストールします

    npm install -g configurable-http-proxy
  2. 2

    pipでJupyterHubをインストールします

    python3 -m pip install jupyterhub
  3. 3

    Hubサーバーを起動し、http://localhost:8000 にアクセスします

    jupyterhub

使う前に知っておきたいこと

  • 公式サポートはLinux/Unixのみです。Windowsはデフォルトではサポートされていません。
  • 複数ユーザーのサインインを許可するには、別途設定しない限り、rootなどの特権ユーザーとして実行する必要があります。
  • 本番環境で使用するには、TLS証明書、ドメイン名、追加の設定が必要です。

収録されている特集

トピック

よくある質問

jupyterhub とは?
1つのHubから複数ユーザー向けに個別のJupyter notebookサーバーを起動・管理するマルチユーザーサーバー。 JupyterHubを使うと、組織内でログインを管理し、必要に応じてユーザーごとに専用のシングルユーザーJupyter notebookサーバーを起動する、中央Hubを1つ運用できます。設定可能なHTTPプロキシが各ユーザーのリクエストをそれぞれのサーバーに転送するため、学生、データサイエンスチーム、研究グループは、各自のマシンにJupyterをインストールすることなく、1つの環境を共有できます。
jupyterhub は無料で使えますか?ライセンスは?
jupyterhub は BSD-3-Clause ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
jupyterhub は今もメンテナンスされていますか?
活発にメンテナンス中。jupyterhub の最終コミットは 2026年11月5日 です。
jupyterhub は何に使えますか?
学生のクラスに、各自のマシンへのインストール不要でノートブック環境を提供する。 企業のチームで共有できるデータサイエンス作業環境を用意する。 高性能コンピューティングクラスター上で、管理されたノートブックサーバーを提供する。
jupyterhub のインストール方法は?
npmでproxyをインストールします: npm install -g configurable-http-proxy pipでJupyterHubをインストールします: python3 -m pip install jupyterhub Hubサーバーを起動し、http://localhost:8000 にアクセスします: jupyterhub
jupyterhub はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/jupyterhub/jupyterhub

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト