> For the complete documentation index, see [llms.txt](https://docs.ipwo.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ipwo.net/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/dns-jie-xi-shi-bai.md).

# DNS 解析失败

如果出现：

```
Could not resolve host
DNS_PROBE_FINISHED_NXDOMAIN
Temporary failure in name resolution
```

通常表示：

```
域名无法正常解析
```

这属于开发者使用代理时较常见的网络问题。

***

### 一、常见原因

#### 1. 本地 DNS 异常

部分网络环境可能存在：

* DNS 污染
* DNS 无法访问
* DNS 响应过慢

***

#### 2. 国内网络环境限制

部分海外域名：

```
在国内网络环境下可能解析异常
```

建议优先使用：

* 海外 VPS
* 海外云服务器

***

#### 3. DNS 配置错误

例如：

* DNS 地址不可用
* 系统 DNS 配置异常

***

#### 4. 代理未正确连接

如果代理未成功建立连接：

```
可能导致域名请求失败
```

建议先测试代理是否正常。

***

### 二、推荐排查方式

#### 1. 测试代理是否正常

```bash
curl -x http://us.ipwo.net:7878 -U username_custom_zone_us:password http://ipinfo.io
```

***

#### 2. 测试域名解析

Linux / macOS：

```bash
nslookup ipinfo.io
```

Windows：

```bash
ping ipinfo.io
```

***

#### 3. 更换 DNS

推荐：

```
1.1.1.1
8.8.8.8
```

避免使用本地运营商 DNS。

***

### 三、推荐解决方案

推荐：

* 使用[海外网络环境](/huan-jing-zhun-bei/hai-wai-wang-luo-huan-jing-shuo-ming.md)
* 更换 DNS
* 重启网络
* 使用海外 VPS

避免：

* 国内网络高频请求海外服务
* 本地 DNS 缓存异常

***

### 四、推荐排查流程

```
1. 测试代理是否正常
↓
2. 测试域名解析
↓
3. 更换 DNS
↓
4. 重启网络
↓
5. 再次测试
```

***

### 五、相关文章

* [超时 Timeout](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/chao-shi-timeout.md)
* [代理连接失败](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/dai-li-lian-jie-shi-bai.md)
* [如何检测代理是否生效](/dai-li-jian-ce-yu-yin-si-an-quan/ru-he-jian-ce-dai-li-shi-fou-sheng-xiao.md)
* [DNS 泄露检测](/dai-li-jian-ce-yu-yin-si-an-quan/dns-xie-lou-jian-ce.md)
* [为什么需要海外网络环境](/dai-li-ji-chu-zhi-shi/wei-shen-me-xu-yao-hai-wai-wang-luo-huan-jing.md)
* [API 调用与批量采集](/dai-li-ji-chu-zhi-shi/api-diao-yong-yu-pi-liang-cai-ji.md)