Debian 13 教程 / 诊断DNS、监听端口与HTTP连接故障
当无法访问 Debian 13 服务器时,分别检查地址和路由、域名系统(DNS)名称解析、监听套接字及超文本传输协议(HTTP)响应。在虚拟机内部能正常工作的请求,并不意味着宿主机可以通过 NAT 访问它。HTTP 404 表示 HTTP 服务器已响应请求,因此应检查请求的路径和响应的服务器,而不是将其视为基本连接失败。
识别正在测试的连接路径
本教程使用连接到 VirtualBox NAT(网络地址转换)和 Windows 主机的 Debian 13 虚拟机。客户机地址是 10.0.2.15,网关是 10.0.2.2,在单 NAT 适配器配置中。请通过下面的查询结果检查实际环境地址,不要将示例地址应用于其他网络。
ip -br address
ip route
ip route get 10.0.2.2
getent ahostsv4 deb.debian.org
sudo ss -lntp
ip route get 检查内核在发送到指定目的地时选择的路由、接口和源地址。它不是用于验证数据包是否真正到达目的地的命令。getent 使用系统的名称解析设置,解析的内容分发网络(CDN)地址可能会因时间而异。ss 的 -l 指的是监听,-n 指的是数字地址和端口,-t 指的是 TCP,-p 指的是进程信息。
| 测试结果 | 首先检查的目标 |
|---|---|
| 无法将名称解析为地址 | 名称拼写错误,DNS 和系统名称查找设置 |
| 没有到目的地的路由 | 接口地址、连接路线和默认网关 |
| 仅在客户机内部成功 | 监听地址、端口转发目标、防火墙 |
| HTTP 404 响应 | URL 路径、文件位置、虚拟主机和应用程序路由 |
| 连接超时 | 请再次检查目标、端口、路径和过滤;仅凭此结果无法确定原因。 |
主机的 127.0.0.1 和客户机的 127.0.0.1 是不同计算机的回环地址。为了允许 NAT 客户机接收正常的主机连接,需要一个如端口转发的路径。在保留现有 SSH 转发规则的同时,我们将为 HTTP 实验添加单独的规则。管理工具的确定遵循 网络与DNS管理工具识别 的条件,地址更改遵循 静态 IPv4/DNS 配置和 DHCP 恢复。
准备测试文件和仅回环服务器
准备两个 Debian 终端和主机 PowerShell。Python HTTP 服务器仅用于连接验证,而不是作为生产 Web 服务器。如果已有服务使用端口 8080,请不要停止它;选择一个未使用的练习端口,并在所有后续命令和转发规则中一致应用该端口。
sudo ss -lntp 'sport = :8080'
sudo apt update
sudo apt install --no-install-recommends python3 curl
python3 --version
curl --version
如果 ss 显示标题之外没有监听行,则说明当时该端口没有列出 TCP 监听器。批准安装前,应核对APT显示的依赖与软件包变更计划。原课程实验客户机使用 Python 3.13.5 和 curl 8.14.1;Debian 安全更新可能会改变这些软件包版本。
在普通用户终端 A 上执行以下操作。mkdir 如果存在同名文件夹会导致失败。不要覆盖现有文件夹;先检查其内容。
mkdir "$HOME/lf-net-demo" &&
printf 'debian-network-lab\n' > "$HOME/lf-net-demo/probe.txt" &&
python3 -m http.server 8080 --bind 127.0.0.1 --directory "$HOME/lf-net-demo"
如果文件夹创建失败,则不要执行服务器命令。如果服务器正常启动,终端 A 将保持在服务器运行状态。由于文档根目录被限制到专用文件夹,因此不会提供整个主目录。端口 8080 是普通用户可以绑定的端口,因此启动这个实验服务器无需sudo。
在客户机终端B 上执行以下操作。在服务器输出启动信息后发起请求。
sudo ss -lntp 'sport = :8080'
curl --noproxy '*' --connect-timeout 3 --max-time 6 -sS http://127.0.0.1:8080/probe.txt
curl --noproxy '*' --connect-timeout 3 --max-time 6 -sS http://127.0.0.1:8081/probe.txt
第一次请求输出 debian-network-lab。ss 的本地地址是 127.0.0.1:8080。如果在 8081 端口没有其他服务,第二个请求将无法连接。原实习观察到curl退出码7。这个比较显示了正在运行的服务端口的重要性,并且在您预期会失败的端口上可能存在服务,因此应优先考虑您自己的查询结果。
--noproxy '*' 允许此请求绕过代理环境变量。--connect-timeout 是连接步骤的限制,而 --max-time 是对总操作时间的限制。这里的代理绕过仅影响这次请求,不应删除组织原本需要的全局代理设置。
仅通过更改绑定地址来比较主机访问情况
在 VirtualBox 中,打开目标虚拟机的 设置 → 网络 → NAT 适配器 → 高级 → 端口转发 。UI 位置可能因版本而异。只需添加以下新规则,并保持现有的 SSH 规则不变。如果主机端口 18080 已被占用,请选择一个空闲端口。
| 项目 | 设置 |
|---|---|
| 名称 / 协议 | lf-debian13-http15 / TCP |
| 主机 IP / 端口 | 127.0.0.1 / 18080 |
| 客户机IP / 端口 | 如果您使用单个 NAT 客户机的默认地址,请将 IP 留空 / 8080 |
如果您指定了客户机地址,则它必须与当前客户机地址匹配。本练习使用默认的 NAT 地址 10.0.2.15,并且更改了地址的虚拟机应重新检查其转发目标。将主机 IP 限制为回环地址可以防止 LAN 上的其他计算机访问练习服务器。有关详细操作,请参阅 VirtualBox NAT 和端口转发文档。
在主机 PowerShell 中运行此命令。指定 curl.exe 是为了将其与 Windows PowerShell 别名区分开。
curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS http://127.0.0.1:18080/probe.txt
$LASTEXITCODE
客户机内部的请求成功,但主机请求失败,因为服务器只监听客户机回环地址,而不是接收 NAT 转发流量的客户机网卡(NIC)地址。原实验观察到连接重置和 curl 退出状态 56。其他虚拟化版本或连接状态可能会产生不同的错误或超时;完全匹配 56 并不是必需的。
在客户机终端 A 中,使用 Ctrl+C 停止服务器。保持相同的文件、端口和转发规则,只更改绑定地址。
python3 -m http.server 8080 --bind 0.0.0.0 --directory "$HOME/lf-net-demo"
确认服务器启动消息后,检查客户机 B 对监听地址和 NIC 地址的请求。
sudo ss -lntp 'sport = :8080'
curl --noproxy '*' --connect-timeout 3 --max-time 6 -sS http://10.0.2.15:8080/probe.txt
0.0.0.0:8080 意味着监听所有本地 IPv4 地址;它不会自动提供 IPv6 监听。在对客户机网卡(NIC)地址的请求成功后,在主机上重复相同的 curl.exe 命令以检查文件内容和退出状态 0。如果请求在启动后立即失败,首先确认该进程仍在运行且监听套接字存在。
这种比较隔离了监听地址的影响。如果请求仍然失败,请检查转发、客户机地址、监听套接字和过滤规则,不要直接通过禁用防火墙来消除故障。仅 ping 的失败可能反映了互联网控制消息协议 (ICMP) 策略;这并不证明所有传输控制协议 (TCP) 服务都不可用。
区分 HTTP 状态与 curl 退出状态
服务器正在所有 IPv4 地址上运行,而主机 PowerShell 请求一个不存在的文件。-w 输出响应码,-o NUL 在 Windows 上丢弃响应体。
curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS -o NUL -w "%{http_code}\n" http://127.0.0.1:18080/missing.txt
$LASTEXITCODE
curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS --fail -o NUL -w "%{http_code}\n" http://127.0.0.1:18080/missing.txt
$LASTEXITCODE
第一次请求的 HTTP 代码是 404,但 curl 的退出码是 0。默认情况下,curl 不会将 HTTP 错误状态本身视为传输失败。第二次请求同样收到 HTTP 404,但由于 --fail,返回退出码 22。在自动化检查中,是否只查看退出码或也判断 HTTP 状态,应根据目的决定。不要仅通过检查 200 来替代需要确认重定向、认证或实际响应内容的操作检查。
在本受控实验中,将响应与Python服务器日志对照,可确认返回404时也已完成HTTP请求和响应。检查 URL 路径和文档根目录,并比较服务器日志中的 GET /missing.txt 和 404 状态。在实际部署中,还要确认哪个服务器或代理返回了响应。官方 curl 手册 分别记录了 HTTP 处理和传输退出代码。
仅为本次请求指定地址,隔离DNS问题
RFC 6761 中的 特殊用途名称规则 将 .invalid 保留给预计无法成功解析的名称。保持服务器和转发规则不变,并从 Windows 主机请求下方的测试主机名。
curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS http://lf-debian13-net15.invalid:18080/probe.txt
$LASTEXITCODE
curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS --resolve "lf-debian13-net15.invalid:18080:127.0.0.1" http://lf-debian13-net15.invalid:18080/probe.txt
$LASTEXITCODE
在一般查询路径中,第一个请求返回名称查找失败和退出码6。第二个请求仅为此次curl执行指定该主机名和端口的地址,因此它接收文件并返回退出码0。--resolve 不会修改DNS服务器或 hosts 文件,并且会在URL中保留主机名。在HTTPS中,仍需要对URL主机名进行证书验证,因此不要将此选项与跳过证书验证混淆。
如果只有第二个请求成功,这表明到指定地址的传输路径是可行的,并为进一步检查原始名称查询路径提供依据。在未验证其是否为实际服务中的正确 IP 的情况下指定任意地址,可能会导致检查其他服务器。您也不应假设某个程序的代理、缓存或名称查询方法与系统 getent 结果相同。
清理并记录诊断结果
- 在客户机终端A上,用 Ctrl+C 停止 HTTP 服务器。
- 在 VirtualBox 端口转发表中,仅删除此次创建的
lf-debian13-http15规则。保留 SSH 规则。 - 在客户机上,检查监听状态和下面的文件,并仅删除此次创建的文件和空文件夹。
sudo ss -lntp 'sport = :8080'
cat "$HOME/lf-net-demo/probe.txt"
rm -- "$HOME/lf-net-demo/probe.txt"
rmdir -- "$HOME/lf-net-demo"
服务器的监听行应消失,主机对实验端口的HTTP请求也不应再成功。如果 rmdir 失败,检查文件夹中是否有其他文件,不要强制递归删除。已安装的 curl 和 Python 可用于其他管理任务,因此不应在未检查必要性的情况下批量删除。
在记录问题时,包含检查位置(主机/客户机)、请求 URL、实际目标地址和端口、监听地址、curl 退出码以及 HTTP 代码是很有帮助的。地址与路由查询可以在 Debian 13 ip-route 文档 中检查,监听套接字可以在 ss 文档 中查看,测试服务器选项可以在 Python 3.13 http.server 文档 中查看。




