curl 已用 SOCKS5 代理，目标域名仍在本机解析失败

curl 使用 socks5:// 代理时，访问 IP 地址能建立请求，换成只能由代理侧解析的域名就失败。代理端口可达，并不意味着目标域名也会交给代理解析：socks5:// 和 --socks5 默认由 curl 在本机解析目标名称。

如果部署要求代理侧解析目标域名，应使用 socks5h:// 或 --socks5-hostname。这里讨论 curl 命令行访问 HTTP、HTTPS 的场景，不涉及把整台机器所有程序的 DNS 流量改道。

先确认失败的是哪一个名称

区分代理地址与目标 URL 中的域名。如果代理写成 proxy.example.com，curl 仍需先找到这个代理；让代理解析目标名称，不能解决“代理自己的域名无法解析”。另外，代理认证失败、端口拒绝连接和目标服务连接失败，也不能仅靠补一个 h 修复。

核对实际调用参数，以及脚本、默认配置文件和进程环境中的代理设置。代理例外列表可能让某些请求直连；日志若显示没有使用预期代理，应先确认该请求的路由选择。使用无敏感信息的测试请求查看连接过程，分享日志前清理认证头、Cookie 和内部地址。

不要为了绕过 DNS 把 HTTPS URL 改成 IP 并关闭证书校验。这样会同时改变证书名称校验与站点选择，无法证明原域名的代理访问已经恢复。

为这一次请求指定远端解析

假设本机已有获准使用、监听在 127.0.0.1:1080 的 SOCKS5 代理，示例写法为：

curl --proxy 'socks5h://127.0.0.1:1080' \
  'https://service.example.com/status'

代理地址、端口和目标 URL 都要按实际环境替换。不要直接使用不明来源的公共代理；此模式会把目标主机名交给所选代理处理。代理需要能解析该名称，并允许连接相应目标。

等价的专用选项写法是：

curl --socks5-hostname '127.0.0.1:1080' \
  'https://service.example.com/status'

选一种即可，不要同时叠加 --socks5、--socks5-hostname 和 --proxy。这些代理选择选项会互相覆盖，后续参数可能把刚指定的模式改回去。

--socks5-hostname 从 curl 7.18.0 起提供；--proxy 中的 socks5h:// 协议前缀从 7.21.7 起支持。先查看实际运行环境的 curl --version，不要拿本机版本代替容器或远端版本。这些是功能引入边界，不是建议部署旧版本。

环境变量方式也要保留 h

如果脚本原本用 ALL_PROXY，可以把它的值改成带 h 的地址。以下 POSIX 风格写法只影响这次启动的 curl：

ALL_PROXY='socks5h://127.0.0.1:1080' \
  curl 'https://service.example.com/status'

变量名是 ALL_PROXY，不是 ANY_PROXY。已有特定协议代理变量或显式参数时，不能认为这一行一定覆盖它们；还要检查 NO_PROXY 或 no_proxy 是否把目标排除。验证时可优先采用上面的显式 --proxy 写法，并保留项目需要的代理例外策略，不要无差别清空整台机器的代理环境。

远端解析改变的是这条代理请求中目标名称的处理位置。它不会让 curl 跳过 HTTPS 证书校验，也不保证其他程序、其他请求或代理主机名不发生本机 DNS 查询，更不是匿名性保证。

用域名请求验收

恢复后应能使用原来的目标域名，通过预期代理得到对应服务的响应；HTTPS 还须保持证书校验通过。只看到代理接受了 TCP 连接，或改用 IP 后得到某个页面，都不够。

若仍失败，按阶段继续区分：代理本身解析或连接失败、SOCKS 认证或策略拒绝、代理侧无法解析目标、目标连接失败、TLS 验证失败。不要把所有错误改写成 DNS 问题，也不要靠增加重试次数掩盖持续的配置错误。

单次参数或命令前缀在进程结束后失效。若修改了脚本、curl 配置文件或长期导出的环境变量，回退时恢复原值，并确认其他依赖该代理的请求仍使用正确路径。