Windows下用Docker Desktop部署Jellyfin后无法访问求助

以下是针对容器运行但无法通过浏览器访问的进一步排查步骤：

• 确认端口映射正确性
  执行docker ps查看容器的PORTS字段，需确保显示类似0.0.0.0:8096->8096/tcp或:::8096->8096/tcp的映射。若映射错误或未配置，需重新启动容器并指定正确映射：

  docker run -d -p 8096:8096 jellyfin/jellyfin
  

• 检查容器内部服务监听状态
  用容器ID或名称执行命令，验证Jellyfin是否在容器内正常监听8096端口：

  docker exec <容器ID/名称> netstat -tulpn | grep 8096
  

  若无输出，说明容器内服务未启动，查看容器日志定位错误：

  docker logs <容器ID/名称>
  

  常见问题包括配置文件损坏、挂载目录权限不足等。

• 验证主机本地连通性
  在主机终端执行curl localhost:8096或telnet localhost 8096：

  • 若主机能访问，说明问题出在局域网/外部网络层面，需检查路由器端口转发规则（远程访问场景）、客户端设备防火墙设置；
  • 若主机无法访问，需排查主机端口占用情况：

    netstat -tulpn | grep 8096
    

    确认无其他进程占用8096端口，若有则终止对应进程或更换Jellyfin映射端口。

• 排查Docker网络配置

  • 查看容器IP地址：

    docker inspect <容器ID/名称> | grep IPAddress
    

    尝试在主机上直接访问容器IP:8096，若能访问则端口映射存在问题；若不能则容器内部服务异常或Docker网络故障。
  • 若使用自定义Docker网络，切换至默认bridge网络重新启动容器，排除自定义网络的连通性问题。

• 检查挂载目录权限
  若启动容器时挂载了本地配置/媒体目录（如-v /本地配置路径:/config），需确保本地目录权限允许容器内用户（通常为UID 1000）读写：

  chown -R 1000:1000 /本地配置路径
  

  调整权限后重启容器。

• 尝试更新镜像版本
  拉取最新官方镜像并重新创建容器，排除旧版本镜像的bug：

  docker pull jellyfin/jellyfin
  docker run -d -p 8096:8096 jellyfin/jellyfin
  

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