在新加坡服务器部署Jupyter Notebook,如何配置认证并验证远程访问?

发布人:A5数据发布时间:2026-11-04 10:44阅读量:97

目标是在新加坡服务器上首次运行 Jupyter Notebook:为 Notebook 设置登录密码,让服务只监听服务器本机地址,再通过 SSH 本地端口转发从自己的电脑访问。这样既能验证远程浏览器和内核是否正常工作,也不必把 Notebook 的 8888 端口直接开放到公网。

以下步骤适用于 Ubuntu 22.04/24.04、已有 SSH 登录权限、由单个实施人员使用的场景。示例以服务器端口 8888、电脑本地端口 18888 为准;命令中的 登录用户@新加坡服务器IP 需要替换为实际信息。Notebook 会以执行命令的普通系统用户身份运行,笔记本中的代码也拥有该用户的文件访问权限,因此不要用 root 启动。

准备条件:确认系统、账户和访问路径

先在服务器的 SSH 会话中确认当前用户及 Python 环境:

id -un
cat /etc/os-release
python3 --version
python3 -m venv --help >/dev/null && echo "venv available"

预期能看到普通用户名、匹配的 Ubuntu 版本、Python 版本,以及 venv available。若 venv 不可用,可在具备管理权限且允许安装系统软件包的前提下执行:

sudo apt update
sudo apt install python3-venv curl

这一步会更改服务器的系统软件包,仅在缺少组件时执行;不要为了回滚 Notebook 而直接卸载可能被其他程序共用的 Python 依赖。还需确认电脑能够 SSH 登录这台服务器,并且电脑上的 18888 端口未被占用。整个方案不要求将服务器的 8888 端口加入公网防火墙放行规则。

A5idc数据提供新加坡物理服务器,涵盖不同CPU、存储及网络线路配置,可为Jupyter Notebook的Python环境、交互式计算和笔记本文件提供部署资源。对于在新加坡运行数据分析任务、从本地电脑远程访问Notebook的场景,这些资源可用于承载代码运行与数据存放,并适配不同的计算负载和访问需求。

安装 Notebook,并核对版本

在服务器上用当前普通用户建立独立虚拟环境。这样安装的 Python 包不会覆盖系统 Python,也便于辨认本次部署的范围。

python3 -m venv "$HOME/jupyter-venv"
"$HOME/jupyter-venv/bin/python" -m pip install --upgrade pip
"$HOME/jupyter-venv/bin/python" -m pip install "notebook>=7,<8"
"$HOME/jupyter-venv/bin/jupyter" notebook --version
"$HOME/jupyter-venv/bin/jupyter" server --version

本文使用 Notebook 7 系列及其 Jupyter Server 组件。最后两条命令应分别输出版本号;如安装报错,应先处理 Python、软件源或网络问题,不要接着创建密码配置。虚拟环境位于当前用户的 ~/jupyter-venv,后续命令也始终调用其中的 jupyter,避免误用服务器上另一个版本。

设置认证密码

Jupyter Server 提供交互式密码设置命令,不需要把明文密码写进 shell 命令、脚本或文章示例。执行前先检查当前账户是否已有配置:

ls -ld "$HOME/.jupyter" 2>/dev/null
ls -l "$HOME/.jupyter/jupyter_server_config.json" 2>/dev/null

如果已有 jupyter_server_config.json,先确认它是否属于其他正在使用的 Jupyter 实例,并对该文件做权限受控的备份;密码设置可能修改同一份用户配置。首次部署且没有既有配置时,执行:

umask 077
"$HOME/jupyter-venv/bin/jupyter" server password

按提示输入并确认密码。输入时终端不显示字符是正常现象。完成后检查配置文件及权限:

ls -l "$HOME/.jupyter/jupyter_server_config.json"

该文件保存用于认证的密码哈希,而非供浏览器直接填写的明文密码。它应仅对当前用户可读;若现有权限过宽,确认文件归当前用户所有后再收紧:

chmod 700 "$HOME/.jupyter"
chmod 600 "$HOME/.jupyter/jupyter_server_config.json"

权限修改会影响同一账户下其他依赖该目录或文件的程序;共享账户应先核对用途。密码设置完成并不等于远程访问已安全启用,还要验证服务监听地址、未登录时的响应,以及实际登录结果。

启动服务,逐项验证服务器端结果

先在服务器上检查 8888 是否已被占用:

ss -ltn | grep ':8888' || true

若已有监听,先辨认所属服务,不要直接结束进程。端口空闲时,在当前 SSH 终端前台启动 Notebook:

"$HOME/jupyter-venv/bin/jupyter" notebook \
  --no-browser \
  --ip=127.0.0.1 \
  --port=8888 \
  --ServerApp.port_retries=0

--no-browser 避免在服务器上启动图形浏览器;--ip=127.0.0.1 限制为服务器本机访问;port_retries=0 使端口冲突直接报错,而不是悄悄改用另一个端口。本步骤保持终端运行,不要关闭它。

另开一个 SSH 会话,在服务器端检查监听地址:

ss -ltnp | grep ':8888'

预期能看到 127.0.0.1:8888,而不是 0.0.0.0:8888 或服务器公网 IP。如果未监听,回到启动终端查看报错;如果监听到了公网地址,先停止服务,再核查实际启动命令和既有 Jupyter 配置,不要继续远程访问验证。

接着在服务器上测试未经登录的 API 请求:

curl -sS -o /dev/null -w '%{http_code}\n' \
  http://127.0.0.1:8888/api/contents

未携带登录凭据时,不应直接返回表示成功获取内容的 200;具体版本和认证处理可能返回 401、403 或重定向。若得到 200,应暂停访问,核对密码是否写入了当前运行账户的配置、服务是否来自预期虚拟环境,以及是否存在其他认证配置覆盖。此项检查不能代替浏览器登录测试,但能及早发现明显的未认证访问。

从电脑建立远程访问并验证内核

在自己的电脑上另开终端,运行以下命令。这里前一个 127.0.0.1:18888 是电脑本机入口,后一个 127.0.0.1:8888 是新加坡服务器上 Notebook 的监听地址:

从电脑建立远程访问并验证内核配图

ssh -N -o ExitOnForwardFailure=yes \
  -L 127.0.0.1:18888:127.0.0.1:8888 \
  登录用户@新加坡服务器IP

如果服务器 SSH 使用非默认端口,在命令中增加 -p 实际SSH端口。这个终端应保持连接;-N 不开启远程命令行,会话看似停在原处是预期行为。SSH 认证及端口转发需要得到服务器侧允许,不能仅凭 Notebook 已启动判断链路可用。

在电脑浏览器打开 http://127.0.0.1:18888/tree。应出现 Jupyter 登录页;输入刚设置的密码后,应进入文件列表。这里的 HTTP 地址只指向电脑本机端口,电脑与新加坡服务器之间的连接由 SSH 承载,不是让浏览器直接访问服务器公网的 8888 端口。

最后新建一个 Python 笔记本,在单元格输入并运行:

2 + 3

输出应为 5。登录成功只能证明网页和认证路径可用;单元格能运行,才进一步证明内核能够由该用户启动。首次运行时,Notebook 的工作目录取决于启动命令所在目录;若要把文件集中放在指定位置,可先进入已获授权的工作目录,再启动服务。不要将 SSH 密钥、密码文件或不应由笔记本代码读取的数据放入该账户可访问的目录。

失败时按访问路径定位

排查时先看电脑到服务器的连接,再看服务器监听,最后看 Jupyter 认证与内核,避免一开始就改防火墙或重装软件。

  • SSH 命令立即报本地端口占用:电脑上的 18888 已被使用。选一个空闲的电脑本地端口,并同步修改浏览器地址;无需改服务器的 8888。
  • SSH 能登录,但浏览器提示无法连接:先确认转发终端仍在运行,再在服务器执行 ss -ltnp | grep ':8888'。若服务器没有监听,查看 Notebook 启动终端;若服务器已监听,核对转发命令两端的地址和端口,并检查 SSH 服务端是否允许端口转发。
  • 出现登录页,但密码始终被拒绝:确认启动 Notebook 与执行 jupyter server password 的是同一个系统用户。必要时停止 Notebook,用该用户重新执行交互式密码设置命令,再启动并复测;不要通过关闭认证来排障。
  • 能够登录,但单元格无法运行:查看启动终端中的内核报错,并确认工作目录可由当前用户读写、虚拟环境安装完整。此时问题已不在 SSH 链路或登录密码,不宜通过开放公网端口处理。

本次采用前台启动方式,关闭启动 Notebook 的终端或服务器重启后,服务不会自动恢复;关闭 SSH 转发终端后,电脑上的访问入口也会消失。如需长期运行,应另行设计进程托管及恢复策略,而不是把前台测试命令视为开机自启配置。

验收与回滚检查项

验收时逐项确认:

  1. Notebook 7 和 Jupyter Server 的版本命令均能正常输出,服务由预期普通用户启动。
  2. 服务器仅监听 127.0.0.1:8888;未经登录的请求不能直接取得 /api/contents 内容。
  3. 电脑通过 SSH 本地端口访问登录页,错误密码不能登录,正确密码可以进入文件列表。
  4. 新建笔记本运行 2 + 3 得到 5;服务器公网防火墙未为本次部署额外开放 8888。

需要撤回本次首次部署时:

  1. 在 Notebook 启动终端按 Ctrl+C,按提示确认关闭;再在 SSH 转发终端按 Ctrl+C。用 ss -ltnp | grep ':8888' 确认服务已停止。
  2. 若设置密码前备份过既有 Jupyter 配置,确认没有其他实例正在使用后,才将备份恢复到原用户的配置位置,并保持仅该用户可读。不要覆盖部署期间由其他人新增的配置。
  3. ~/jupyter-venv 和本次生成的 Jupyter 配置属于后续清理对象。先确认其中没有其他环境或工作成果,再决定是否移走;系统级 Python 软件包可能为其他程序共用,不属于可直接批量卸载的回滚范围。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7496.html

相关推荐