docker之如何排查端口映射问题#

概述#

起因是发现自己部署在电脑的docker服务immich访不了，但是进入容器用curl测试服务是正常，docker 日志也正常，那就是端口映射出问题了

先查端口映射是否正常#

1
docker ps --filter "name=immich" --format "table {{.Names}}\t{{.Ports}}"

1
C:\Users\Rise>docker ps --filter "name=immich" --format "table {{.Names}}\t{{.Ports}}"
2
NAMES                     PORTS
3
immich_server             2283/tcp
4
immich_postgres           5432/tcp
5
immich_machine_learning
6
immich_redis              6379/tcp

如果显示 0.0.0.0:2283->2283/tcp：说明映射配置正确，问题很可能出在服务监听地址上。

如果显示 127.0.0.1:2283->2283/tcp：说明端口只绑定了 127.0.0.1，这是导致无法通过局域网IP访问的原因。

但是以上打印的命令结果说明，端口并没有通过外部映射

使用compose#

1
D:\project_workspace\immich-app>docker-compose down
2
[+] down 5/5
3
 ✔ Container immich_machine_learning Removed                                                                        0.4s
4
 ✔ Container immich_server           Removed                                                                        0.6s
5
 ✔ Container immich_redis            Removed                                                                        0.5s
6
 ✔ Container immich_postgres         Removed                                                                        0.6s
7
 ✔ Network immich_default            Removed                                                                        0.4s
8

9
D:\project_workspace\immich-app>docker-compose up -d
10
[+] up 4/5
11
 ✔ Network immich_default            Created                                                                        0.1s
12
 ✔ Container immich_postgres         Started                                                                        0.7s
13
 ✔ Container immich_redis            Started                                                                        0.7s
14
 ✔ Container immich_machine_learning Started                                                                        0.7s
15
 - Container immich_server           Starting                                                                       0.6s
16
Error response from daemon: ports are not available: exposing port TCP 0.0.0.0:12335 -> 127.0.0.1:0: listen tcp 0.0.0.0:12335: bind: An attempt was made to access a socket in a way forbidden by its access permissions.

发现端口映射失败

这个错误在 Windows 上很常见，通常是因为端口被系统保留（比如 Hyper-V 或 WSL 占用了某些端口段），或者被其他进程占用。而 12335 这个端口看起来并不是 Immich 默认的 2283，很可能是你的 docker-compose.yml 中额外配置了某个服务的端口映射（比如微服务间通信端口），或者这是某些旧版本遗留下来的配置。

查看宿主机端口占用#

1
netstat -ano | findstr :12335

发现并没有被占用

查看h#

1
C:\Users\Rise>netsh int ipv4 show excludedportrange protocol=tcp
2

3
协议 tcp 端口排除范围
4

5
开始端口    结束端口
6
----------    --------
7
      4549        4648
8
      4649        4748
9
      4749        4848
10
      4863        4962
11
      5041        5140
12
      5141        5240
13
      5241        5340
14
      5341        5440
15
      5531        5630
16
      5704        5803
17
     11581       11680
18
     11681       11780
19
     11781       11880
20
     11881       11980
21
     11981       12080
22
     12081       12180
23
     12181       12280
24
     12281       12380
25
     50000       50059     *
26

27
* - 管理的端口排除。

我发现我要映射的端口在12281-12380，Hyper-V被保留，这种情况通常发生在docker更新时，这个需要重新电脑解决