docker run启动Jupyter Notebook镜像无法访问但docker compose正常如何解决

你遇到的docker run启动Jupyter镜像访问失败，而Docker Compose启动正常的问题，核心是两种启动方式的默认配置差异导致，常见原因如下：

• 端口绑定协议差异：部分Ubuntu 20.04环境下的Docker默认优先将端口映射到IPv6接口，使用-p 8888:8888启动时，实际仅绑定了:::8888（IPv6的所有接口），而浏览器访问的127.0.0.1是IPv4地址，两者不匹配导致连接失败。Docker Compose默认会同时绑定IPv4和IPv6的对应端口，所以可以正常访问。
• 挂载目录权限问题：官方Jupyter镜像默认使用UID为1000的jovyan用户运行服务，docker run挂载的本地目录如果所有者UID不是1000，jovyan用户会没有目录读写权限，即使终端显示服务启动成功，实际服务无法正常响应请求。你使用Docker Compose时挂载路径为/home/jovyan，覆盖了容器内该目录的默认权限配置，刚好规避了权限问题。
• 端口占用冲突：如果docker run启动前有其他进程占用了IPv4的8888端口，Docker会自动跳过IPv4绑定仅绑定IPv6端口，导致IPv4访问失败，而启动Docker Compose前你已经停止了占用端口的进程，所以绑定正常。

按照优先级依次尝试以下方案即可解决问题：

1. 显式指定IPv4端口绑定
   强制端口映射绑定到IPv4的本地回环接口，修改后的启动命令如下：

   docker run --rm -p 127.0.0.1:8888:8888 -v $(pwd):/home/jovyan/work notebook
   

2. 修复挂载目录权限
   启动时指定使用当前用户的UID/GID运行容器，避免权限不匹配问题：

   docker run --rm -p 127.0.0.1:8888:8888 -u $(id -u):$(id -g) -v $(pwd):/home/jovyan/work notebook
   

3. 排查本地端口占用
   执行以下命令查看8888端口的占用情况，停止对应进程后再启动容器：

   sudo lsof -i :8888
   

4. 替换Docker安装版本
   如果你当前使用的是snap安装的Docker，建议卸载后通过官方apt源重新安装，snap版本的沙箱限制会导致大量端口、挂载相关的异常问题。

内容的提问来源于stack exchange，提问作者zipline86