> 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)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.ipwo.net/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/dns-jie-xi-shi-bai.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.