域名映射的核心任务是让一个便于书写的域名，例如 www.ipipp.com，与某台服务器的 IP 地址建立稳定对应关系。当用户在浏览器输入该域名时，系统会先查看本地 hosts 文件，再向 DNS 服务器发起查询，最终拿到可路由的 IP 地址并建立连接。这里容易混淆的一点是：域名解析是一个更大的过程，而域名映射更像是解析链条中的具体规则，也就是明确告诉系统某个域名应该指向哪个 IP 或另一个域名。日常开发中，这项操作既可能发生在本地，也可能发生在域名服务商后台。
本文会先说明域名映射的工作机制，再分别演示本地 hosts 文件配置和线上 DNS 解析配置。之后给出可以直接复用的示例、配套练习题，以及修改后不生效、权限不足、IPv6 干扰等常见问题的排查思路。读者可以边看边操作，把测试域名映射到本机或内网服务器，快速验证网站、接口和反向代理配置。
一、域名映射的核心概念与工作流程
域名与 IP 的关系可以类比为通讯录里的姓名和电话号码。IP 地址是服务器在网络中的唯一标识，但纯数字地址不方便记忆，也不利于品牌展示。域名映射就是在这两者之间建立一条查询规则：给定域名，返回一个或多个 IP。一次完整域名解析通常会经过浏览器缓存、操作系统缓存、hosts 文件、本地 DNS 解析器、递归 DNS 服务器等多个环节。hosts 文件在多数系统中优先级较高，因此它是本地测试环境修改映射的最快手段。
从用途来看，域名映射主要有两类场景。第一类是生产环境，通过在域名服务商控制台添加 A 记录、AAAA 记录或 CNAME 记录，把正式域名指向云服务器、虚拟主机或对象存储。第二类是开发测试环境，开发人员直接编辑本机 hosts 文件，将 dev.shop.local、api.shop.local 等自定义域名指向 127.0.0.1 或内网 IP，从而在不影响公网解析的情况下调试站点。两类方式各有优劣：本地 hosts 修改立即生效且只对当前机器有效，适合调试；线上 DNS 配置需要等待 TTL 到期和各级缓存刷新，但能让所有用户访问到正确结果。
还需要明确一点：域名映射只解决域名到 IP 的对应问题，不包含端口和协议。例如把 dev.shop.local 映射到 127.0.0.1 后，访问 http://dev.shop.local:8080 时，映射已经生效，但 8080 端口仍需显式指定。若希望默认 80 端口访问，需要在服务器上配置反向代理或让应用直接监听 80 端口。理解这个边界，后续排错时就能少走弯路。
二、本地hosts文件配置教程
本地域名映射最常用的方法是修改 hosts 文件。不同系统的文件路径不同，Windows 位于 C:\Windows\System32\drivers\etc\hosts，macOS 与 Linux 通常位于 /etc/hosts。Windows 记事本需要以管理员身份运行，否则保存时会提示没有权限；macOS 和 Linux 通常使用 sudo 命令编辑，例如 sudo nano /etc/hosts。文件中每一行表示一条映射，格式为 IP 地址、至少一个空格或制表符、域名。下面是一个常见配置示例：
# 将本地测试域名映射到本机 127.0.0.1 dev.shop.local 127.0.0.1 api.shop.local ::1 dev.shop.local
保存文件后，通常需要刷新系统 DNS 缓存。Windows 可以打开命令提示符执行 ipconfig /flushdns，macOS 较新版本使用 sudo dscacheutil -flushcache，Linux 受 nscd、systemd-resolved 等服务影响，有时需要重启对应服务。验证映射是否生效可以使用 ping 或 nslookup 命令。如果返回的 IP 与你配置的一致，说明 hosts 已经生效；如果返回公网地址，则说明系统没有读取该条目，需要检查文件路径、编码和行格式。下面两个命令用于验证：
ipconfig /flushdns ping dev.shop.local nslookup dev.shop.local
配置 hosts 时要注意几点：行首不要随意留空格，但 IP 和域名之间至少有一个空格或制表符；注释以 # 开头，可以整行注释；同一域名可以配置多条不同 IP，但系统通常只选取其中一条，具体顺序取决于解析器实现。对 IPv6 环境，建议同时配置 ::1 与 127.0.0.1，或者只保留你真正需要的那一条，避免后续出现 ping 返回 ::1 而页面依然打不开的情况。做完修改后，可以关闭并重新打开浏览器，或者使用无痕窗口测试，减少浏览器内部缓存干扰。
三、域名服务商后台配置A记录与CNAME
线上环境需要在域名服务商或云解析控制台添加解析记录。常见记录类型中，A 记录用于将域名指向一个 IPv4 地址，AAAA 记录用于指向 IPv6 地址，CNAME 记录用于将域名指向另一个域名。假设你已经有一台公网服务器，IP 为 192.168.1.10，想配置 www.ipipp.com 和裸域名 ipipp.com 都指向它，可以在控制台按下表添加记录：
| 记录类型 | 主机记录 | 记录值 | 说明 |
|---|---|---|---|
| A | @ | 192.168.1.10 | 裸域名指向服务器 IPv4 |
| A | www | 192.168.1.10 | www 子域指向同一台服务器 |
| CNAME | api | ipipp.com | api 子域跟随主域名解析 |
主机记录为 @ 时通常代表裸域名，有些控制台也允许留空。TTL 可以设置为 600 秒或使用默认值，它决定其他 DNS 服务器缓存这条记录的时长。添加完成后，解析不会立即在所有网络环境生效，因为本地运营商和公共 DNS 可能还缓存着旧结果。可以用 nslookup 或 dig 指定公共 DNS 服务器查询，判断新记录是否已经传播。下面两条命令用于验证：
nslookup www.ipipp.com dig www.ipipp.com +short @8.8.8.8
配置 CNAME 时要注意，CNAME 记录不能与 A 记录同时存在于同一主机记录下，否则会产生冲突。例如已经为 api 添加了 A 记录，就不能再为 api 添加 CNAME。通常的做法是：需要直接指向 IP 的域名用 A 记录，需要跟随另一个域名解析结果的域名用 CNAME。如果网站使用 CDN、对象存储或负载均衡，一般服务商会提供 CNAME 地址，此时把 www 或 static 等子域以 CNAME 方式指向服务商地址即可，无需手动填写 IP。
四、配套示例与练习题
下面通过一个完整的本地开发示例，把 hosts 映射、端口访问和验证串起来。假设你正在开发一个电商项目，前端页面运行在本机 80 端口，后端接口运行在本机 8080 端口。你希望用 dev.shop.local 访问前端，用 api.shop.local 访问接口，同时不影响公网域名。此时 hosts 文件可以这样写：
127.0.0.1 dev.shop.local 127.0.0.1 api.shop.local
配置完成后，浏览器访问 http://dev.shop.local 会指向本机 80 端口，访问 http://api.shop.local:8080 会指向本机 8080 端口。注意 api 映射本身不包含端口，所以 URL 中需要带上 8080。若不想在地址里输入端口，可以在 Nginx 中配置 server_name 为 api.shop.local，再通过 proxy_pass 将请求转发到 127.0.0.1:8080。Nginx 示例配置如下：
server {
listen 80;
server_name api.shop.local;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
看懂上述示例后，可以试着完成下面几个练习：第一，在 Windows 上把 test.local 指向 127.0.0.1，然后用 ping 验证并说明返回结果。第二，在域名控制台为 app.ipipp.com 添加一条 A 记录到 192.168.1.20，写出主机记录、记录类型和记录值。第三，如果 api.shop.local 同时配置了 127.0.0.1 和 ::1，但 Nginx 只监听了 IPv4 的 80 端口，浏览器访问时可能报错，分析原因并给出两种解决办法。第四，修改 hosts 后浏览器仍然访问到旧站点，列举至少三种排查方向。这些练习不需要复杂环境，重点是熟悉映射规则和验证命令。
五、常见问题与注意事项
修改 hosts 后不生效是一个高频问题。原因通常包括：系统没有读取最新 hosts 缓存、文件保存时被加上了隐藏扩展名、格式错误导致整行失效、浏览器自身 DNS 缓存未清理等。Windows 可以先执行 ipconfig /flushdns，再使用 nslookup 指定域名查询；macOS 使用 dscacheutil -flushcache；Chrome 浏览器还可以访问 chrome://net-internals/#dns 清理内部缓存。若仍不生效，检查文件是否被写成 hosts.txt，以及 IP 和域名之间是否用了半角空格或制表符。
权限问题是另一类常见障碍。Windows 直接双击 hosts 文件编辑后保存会提示没有权限，正确做法是用管理员身份运行记事本，再通过文件菜单打开 C:\Windows\System32\drivers\etc\hosts。macOS 和 Linux 需要 sudo 权限写入文件，普通编辑器可能只读。保存前最好备份原文件，例如复制一份 hosts.bak，出错时可以恢复。测试结束时及时删除测试域名条目，避免长期残留影响后续真实域名解析。
域名映射与端口无关这点经常被误解。很多人期望把域名映射到 127.0.0.1 后就能自动访问 8080 端口，这是不可能的。域名系统只负责返回 IP，不处理端口、协议和路径。遇到端口问题要检查应用监听、防火墙以及反向代理配置。生产环境修改 DNS 还要注意传播时间：即使控制台显示已生效，公共 DNS 可能仍缓存旧记录。此时不要反复修改记录，先确认 TTL 设置，再通过 dig @8.8.8.8 或 nslookup 指定公共 DNS 查询最新结果。最后，如果给测试域名配置了 HTTPS，也会出现证书与域名不匹配的问题，本地开发可以用 mkcert 生成本地信任证书，不能直接使用 IP 地址证书替代域名证书。