jupyter notebook 本身无协作模式开关，其协作能力依赖外部扩展或服务而非单机配置文件；notebook 7+ 内置实验性 rtc 功能但默认关闭，需通过 jupyter server 扩展机制启用，而非修改 jupyter_notebook_config.py。
Jupyter Notebook 本身没有“协作模式”开关项，jupyter_notebook_config.py 里不存在 collaboration_enabled = True 这类配置 —— 它的协作能力依赖外部扩展或服务，不是靠单机配置文件启用的。
为什么直接改 notebook_config.py 无效
旧版（Notebook ≤6.x）完全不支持实时协作；Notebook 7+ 虽内置了实验性 RTC（Real-Time Collaboration）功能，但它默认关闭，且不通过 jupyter_notebook_config.py 控制，而是由 Jupyter Server 的扩展机制和后端服务驱动。你往配置文件里加 c.NotebookApp.collaboration = True 或类似字段，启动时会被忽略，甚至报错。
常见错误现象：
- 修改配置后重启服务，多人仍无法看到彼此光标
- jupyter notebook --help 中查不到任何 collaboration 相关参数
- 浏览器控制台报 WebSocket connection failed 或 rtc extension not found
真正起作用的三个地方
要让 Notebook 支持协作，必须同时满足以下条件：
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 运行的是
jupyter-server（而非旧版jupyter-notebook命令），且版本 ≥7.0 - 安装并启用
jupyter-rpc和jupyter-server-rtc扩展（Notebook 7 内置，但需显式启用） - 后端需支持 WebSocket 长连接（例如用
jupyterlab启动，或确保jupyter server运行在支持 RTC 的代理后）
实操建议：
- 检查当前服务是否基于 jupyter server：运行 jupyter server list，若输出含 /lab 或 /tree 且 PID 存在，说明已就绪
- 启用 RTC 扩展：jupyter server extension enable jupyter_server_rtc
- 启动时显式指定路径：jupyter server --collaborative --no-browser（注意是 --collaborative，不是配置项）
多人协作必须走 JupyterHub 或反向代理
即使启用了 --collaborative，单机 jupyter server 也无法跨网络协作 —— 它只允许 localhost 访问。真实场景下：
- 局域网内协作：需在启动命令中加
--ip=0.0.0.0并开放端口，但不推荐，无认证、无权限隔离 - 生产环境协作：必须部署
JupyterHub，并在jupyterhub_config.py中配置c.JupyterHub.allow_named_servers = True和c.Spawner.args = ['--collaborative'] - 云平台方案：GitHub Codespaces、CoCalc、Deepnote 等已预装协作栈，无需手动配 RTC
容易踩的坑：
- 以为开了 --collaborative 就能外网访问，结果防火墙/云服务器安全组没放行 8888 端口
- 在 JupyterLab 4.x 中误用旧版 @jupyterlab/rtc 扩展，实际应依赖内置 jupyter-server-rtc
- 用 pip install jupyter 安装的仍是 Notebook 6，必须用 pip install jupyter-server 替代
复杂点在于：协作不是“开个开关”就能用的功能，它涉及前端通信协议、后端状态同步、用户会话管理三层耦合。哪怕所有配置都对，只要浏览器禁用 WebSocket 或中间 Nginx 没配 upgrade 头，协作就会静默失败 —— 这部分日志往往藏在浏览器开发者工具的 Network 标签页里，而不是终端输出中。
