手机运行Jupyter Notebook有三种路径:本地(Pydroid3/Aid Learning)、远程(云服务器/家用电脑)和内网穿透;Pydroid3需pip install notebook pyzmq及安卓12+的setuptools、certifi;Aid Learning文件须放/home下;云服务需配置安全组、sha1密码、--allow-root参数;小屏体验有限,仅适合轻量任务。

手机上运行 Jupyter Notebook 有三种可行路径:本地直接运行(Pydroid3 / Aid Learning)、远程访问(云服务器或家用电脑)、以及通过内网穿透暴露本地服务。没有“一键安装即用”的方案,必须根据设备性能、网络条件和使用目的选一种。
Pydroid3 安装后启动失败,jupyter notebook 命令报错
Pydroid3 默认不带完整 Jupyter 运行时环境,仅靠 pip install jupyter 往往无法启动。
- 必须同时安装
notebook和pyzmq,缺一不可:pip install notebook pyzmq - 安卓 12+ 系统需额外安装
setuptools和certifi,否则会卡在 TLS 握手失败 - 启动时若提示
No module named 'jinja2',说明依赖链断裂,应改用pip install --force-reinstall jinja2 - 终端执行
jupyter notebook后,如果只输出 URL 但没自动跳转,长按屏幕选“copy all”,手动粘贴到 Chrome 或 Firefox(系统自带浏览器常因权限限制打不开 WebSocket)
Aid Learning 中 Jupyter 文件路径混乱,上传的 .ipynb 找不到
Aid Learning 的 Jupyter 默认根目录是 /home,但文件管理器(Finder)显示的路径和实际挂载点不一致,容易误传到 /sdcard 下而无法被识别。
- 所有要被 Jupyter 加载的文件,必须放在
/home或其子目录下(例如/home/notebooks),不能放在/sdcard或/data - 用 Finder 复制文件时,先双击进入
/home,再新建文件夹(如jupyter_data),然后把文件拖进去 - 若从电脑用 Cloud_ip 传文件,确保目标路径是
http://[IP]:8888/tree/home/,不是/sdcard/ - 上传后刷新 Jupyter 页面,若仍不显示,重启 Aid Learning 服务(关闭再打开 App),Jupyter 进程有时不会自动 reload 文件系统变更
用云服务器远程访问,手机浏览器打不开 http://[IP]:8888
配置了 c.NotebookApp.ip='0.0.0.0' 和防火墙放行 8888 端口,但手机仍连不上,大概率是云服务商的安全组没开,或密码配置格式错误。
- 阿里云/腾讯云等平台,安全组规则必须显式添加入方向 TCP 8888 端口,且源 IP 可设为
0.0.0.0/0(测试阶段),生产环境建议限制为手机公网 IP -
c.NotebookApp.password必须是sha1:xxx格式字符串,不能直接填明文密码;生成命令必须在服务器上运行python -c "from notebook.auth import passwd; print(passwd())",不能在本地生成后硬拷贝 - 启动命令必须加
--allow-root(服务器默认以 root 运行),否则会拒绝启动 - 手机浏览器访问时,URL 必须带
http://前缀,部分浏览器(如 Samsung Internet)会自动补成 https 导致失败
真正麻烦的不是启动,而是交互体验:小屏写代码、快捷键缺失、键盘遮挡、保存状态不稳定。别指望它替代桌面开发,只适合查数据、跑简单模型、临时调试——这点得提前接受。


















