XDebug 无法从 docker 容器连接到客户端

问题描述 投票：0回答：5

我有几个 docker 容器：php、nginx、mariadb、redis、adminer，并尝试使用 PhpStorm 和 Xdebug 调试一些 PHP 代码。

主机（联想T490笔记本电脑）：

$ hostname
T490


$ docker -v
Docker version 20.10.5, build 55c4c88


$ docker-compose -v
docker-compose version 1.24.1, build 4667896b


$ cat /etc/lsb-release 
DISTRIB_ID=neon
DISTRIB_RELEASE=20.04
DISTRIB_CODENAME=focal
DISTRIB_DESCRIPTION="KDE neon User Edition 5.21"


$ php -v
PHP 7.4.16 (cli) (built: Mar  5 2021 07:54:20) ( NTS )
Copyright (c) The PHP Group
Zend Engine v3.4.0, Copyright (c) Zend Technologies
    with Zend OPcache v7.4.16, Copyright (c), by Zend Technologies


$ lsof -i :9003 | grep LISTEN
java    14868 kane   48u  IPv6 401093      0t0  TCP *:9003 (LISTEN)


$ cat /etc/hosts
127.0.0.1       localhost
127.0.1.1       T490

# The following lines are desirable for IPv6 capable hosts
::1     ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters

172.17.0.1 foo.pl adm.foo.pl api.foo.pl

PhpStorm 2020.3.3 配置：

Docker-compose.yml

version: "3"
services:
  php-7.4:
    extra_hosts:
      - "host.docker.internal:host-gateway"
    build: ./docker-images/php-7.4
    image: ap/php:7.4
    container_name: foo-php-7.4
    environment:
      - GITHUB_API_TOKEN=${GITHUB_API_TOKEN}
      - XDEBUG_IDEKEY=${XDEBUG_IDEKEY}
    volumes:
      - ~/.composer-docker/cache:/root/.composer/cache:delegated
      - ~/.gitconfig:/root/.gitconfig
      - ${WORKSPACE_DIR}:/var/www
      - ~/.ssh:/root/ssh:ro
      - ./docker/php/conf.d/xdebug.ini:/usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini

DockerFile 中的 XDebug 安装方式：

RUN pecl install xdebug \
    && docker-php-ext-enable xdebug

.env

GITHUB_API_TOKEN=
WORKSPACE_DIR=/home/kane/workspace

XDEBUG_IDEKEY=PHPSTORM

COMPOSE_PROJECT_NAME=yii2fpm
COMPOSE_FILE=docker-compose.yml
X_LEGACY_GD_LIB=1
PHP_CGI_PASS=php-7.4:9000
NGINX_PORT=80
NGINX_SSL_PORT=443
DB_PORT=3306
ADMINER_PORT=8182

xdebug.ini

zend_extension=xdebug

[xdebug]
xdebug.mode=develop,debug
xdebug.client_host=172.17.0.1
xdebug.start_with_request = yes

docker-compose up后，在容器中：

# route
Kernel IP routing table
Destination     Gateway         Genmask         Flags Metric Ref    Use Iface
default         T490            0.0.0.0         UG    0      0        0 eth0
172.18.0.0      0.0.0.0         255.255.0.0     U     0      0        0 eth0


# ping T490
PING T490 (127.0.1.1) 56(84) bytes of data.
64 bytes from T490 (127.0.1.1): icmp_seq=1 ttl=64 time=0.057 ms


# ping 172.17.0.1
PING 172.17.0.1 (172.17.0.1) 56(84) bytes of data.
64 bytes from 172.17.0.1: icmp_seq=1 ttl=64 time=0.145 ms


# telnet 172.17.0.1 9003
Trying 172.17.0.1...


# telnet T490 9003
Trying 127.0.1.1...
telnet: Unable to connect to remote host: Connection refused


# php -v
PHP 7.4.16 (cli) (built: Mar 13 2021 02:52:33) ( NTS )
Copyright (c) The PHP Group
Zend Engine v3.4.0, Copyright (c) Zend Technologies
    with Zend OPcache v7.4.16, Copyright (c), by Zend Technologies
    with Xdebug v3.0.3, Copyright (c) 2002-2021, by Derick Rethans

当我访问 http://adm.foo.pl/ （带有 cookie XDEBUG_SESSION:"PHPSTORM"）时，docker 日志显示：

NOTICE: PHP message: Xdebug: [Step Debug] Time-out connecting to debugging client, waited: 200 ms. Tried: 172.17.0.1:9003 (through xdebug.client_host/xdebug.client_port) :-(

将 xdebug.ini 更改为：

zend_extension=xdebug

[xdebug]
xdebug.mode=develop,debug
xdebug.discover_client_host = yes
xdebug.start_with_request = yes

它说：

NOTICE: PHP message: Xdebug: [Step Debug] Could not connect to debugging client. Tried: 172.18.0.1:9003 (from REMOTE_ADDR HTTP header), localhost:9003 (fallback through xdebug.client_host/xdebug.client_port) :-(

添加

extra_host
后说：

NOTICE: PHP message: Xdebug: [Step Debug] Time-out connecting to debugging client, waited: 200 ms. Tried: host.docker.internal:9003 (through xdebug.client_host/xdebug.client_port) :-(

请帮忙:-)

docker docker-compose phpstorm php-7.4 xdebug-3
5个回答
5
投票

多么悲伤... 通常我在 Centos7 上工作，所以我通过 

firewall-cmd
而不是 
ufw
（在 Ubuntu/Debian 上）寻找防火墙。

$ sudo ufw allow 9003

现在一切都开始正常工作了。

4
投票

使用 Linux 上的 Docker，您可以

  1. 使用物理网络接口（ens* 或 eth0 或类似的）IP 连接到主机，或者
  2. 使用此 hack 即可使用 
    host.docker.internal
    ： https://github.com/docker/for-linux/issues/264#issuecomment-759737542

在容器中安装 

telnet
以检查端口的可用性始终是一个好主意，事实上 
172.17.0.1
响应 ping 并不一定意味着它是主机。

2
投票

在我的例子中，Ubuntu 上的防火墙 (ufw) 不是原因：无根 Docker 阻止了容器内的 XDebug 连接到主机上的 IDE。 XDebug 需要一个名为 

br-xxxx
的桥接网络接口，并且与 php 容器属于同一网络范围。在无根状态下无法创建此桥接接口（因此仅创建 Docker 的 
docker0
）。我的另一个目标是继续在 compose.yml 中使用 
host.docker.internal
（而不是用于以太网或 wifi 的 
192.168.x.x
）。

对我有用的解决方案：

  1. 添加到 php 服务中 
    compose.yml
extra_hosts:
      host.docker.internal: host-gateway
  1. 已添加到
    docker-php-ext-xdebug.ini
xdebug.client_port=9003
xdebug.client_host=host.docker.internal
  1. 使用 sudo 运行 docker，例如
    sudo docker compose up -d

摘自这里：

1
投票

花了几个小时解决这个问题后，我决定与主机的 

192.168.x.x
IP 地址对话，而不是 
172.17.0.1
。成功了。

x.x
的准确值可以通过 Windows 10 上的以下步骤确定：

  • 开始 -> 命令提示符（以管理员身份运行）
  • 运行
    ipconfig | find "IPv4"
    命令
  • 使用 
    192.168...
    的值。

这就是我的 xdebug 配置现在的样子：

xdebug.client_host=192.168.1.110
xdebug.client_port="9003"
xdebug.start_upon_error=yes
xdebug.idekey = "PHPStorm"
xdebug.mode=develop,coverage,debug,profile
xdebug.discover_client_host=1
0
投票

我在下面的 docker-compose.yml 配置中有两个值，删除第二个值又开始工作了

来自

extra_hosts:
  - "host.docker.internal:host-gateway"
  - "host.docker.internal:127.0.0.1"

致：

extra_hosts:
  - "host.docker.internal:host-gateway"

我不知道为什么我的配置是这样的。

最新问题
© www.soinside.com 2019 - 2024. All rights reserved.