大家每天都在和这两个东西打交道,只是很少细想:
npm run dev跑起来,终端里打印一行http://localhost:3000;- 配数据库连接串,有人写
localhost,有人写127.0.0.1,好像都能用; - 某天把
127.0.0.1顺手改成localhost,服务突然报ECONNREFUSED,明明服务就在本机跑着; - 起一个 Docker 容器,端口也映射了,宿主机就是连不上。
既然「都是本机」,为什么还会有这么多坑?这篇文章顺着三个问题来讲:localhost 和 127.0.0.1 各是什么 (what),一个发给「本机」的请求到底怎么走 (how),以及为什么要同时设计一个名字和一个地址(why)。
localhost 是名字,127.0.0.1 是地址
一句话:localhost 是一个主机名,127.0.0.1 是一个 IP 地址 。两者的关系,和 github.com 与它背后的那串 IP 一样,只不过这个名字恰好指向自己。
大家可以把它想成手机通讯录:「家」是名字,家里座机的号码是地址。拨号之前,手机得先把「家」翻译成号码;而且一个名字可以存好几个号码,先拨哪个由手机说了算。localhost 就是这样一个名字,它通常对应两个号码:IPv4 的 127.0.0.1 和 IPv6 的 ::1。macOS 默认的 /etc/hosts 里就是这么写的(示意):
127.0.0.1 localhost
255.255.255.255 broadcasthost
::1 localhost

127.0.0.1 只是回环地址里的一个。 RFC 1122 规定,整个 127.0.0.0/8 都是回环地址,也就是只要 IPv4 地址的第一个字节是 127,发出去的包就不会离开本机。把 127.0.0.1 写成二进制:
01111111 00000000 00000000 00000001
└ 127 ┘ └──────── 随便填 ───────┘
前 8 位固定,后 24 位随便填,一共 2^24 = 16777216 个地址,占了整个 IPv4 空间的 1/256。用 Python 的 ipaddress 模块算一下就能验证:
| 地址 | is_loopback |
|---|---|
127.0.0.1 |
True |
127.8.8.8 |
True |
127.255.255.254 |
True |
128.0.0.1 |
False |
大家在 Ubuntu 的 /etc/hosts 里经常能看到一行 127.0.1.1 主机名,用的就是这一段里的另一个地址。Linux 上整段 127/8 都能直接用;macOS 默认只在回环网卡上配了 127.0.0.1,想用 127.0.0.2 得先手动加个别名。
IPv6 就节省得多:回环地址只有 ::1 一个,展开写是 0000:0000:0000:0000:0000:0000:0000:0001。

一个发给 localhost 的请求怎么走
以 curl localhost:3000 为例,从敲下回车到服务端收到请求,大致是这几步:
- 解析名字 :程序调用
getaddrinfo("localhost"),系统先查/etc/hosts,命中就直接返回,不会发 DNS 请求。RFC 6761 也专门规定了 localhost 必须解析到回环地址,DNS 服务器不该为它返回别的东西。 - 排序地址 :拿到的往往不止一个地址,而是
[::1, 127.0.0.1]这样一个列表。按 RFC 6724 的默认规则,::1的优先级(50)高于 IPv4 地址(35),所以 IPv6 排在前面。 - 进协议栈 :内核看到目的地址是
127.x.x.x或::1,路由表直接把它指给回环网卡(Linux 上叫lo,macOS 上叫lo0)。 - 掉头:回环网卡是个纯软件的虚拟网卡,它「发送」一个包的方式,就是把这个包原样塞回本机的接收队列。
- 交给进程 :内核按端口找到正在监听
3000的进程,把数据交给它。

为什么拔了网线 localhost 还能用? 因为整个过程中数据包从来没碰过物理网卡。大家在飞机上关掉 Wi-Fi,npm run dev 照样能在浏览器里打开;反过来,如果把服务地址写成本机的局域网 IP(比如示意的 192.168.1.10),一断网这个 IP 就没了,服务也就连不上了。
直接写 127.0.0.1 少了哪一步? 少了第 1、2 步。IP 地址不需要解析,程序拿到的就是一个确定的 IPv4 地址,不存在「先试哪个」的问题。这一点看起来不起眼,却是下一节大部分坑的根源。
一字之差会踩的坑
为什么改成 localhost 就连不上了? 最常见的情况是:服务只监听了 127.0.0.1,而客户端把 localhost 解析成了 [::1, 127.0.0.1],拿第一个 ::1 去连,IPv6 那边没人监听,直接被拒。
Node.js 用户对这个坑应该很熟。Node 17 之前,dns.lookup 默认会把 IPv4 结果挪到前面;Node 17 改成了按操作系统返回的顺序(verbatim),于是一大批 fetch('http://localhost:3000') 开始报错(示意):
Error: connect ECONNREFUSED ::1:3000
注意报错里的地址是 ::1,不是 127.0.0.1,这就是线索。Node 20 起默认开启了 autoSelectFamily,会把 IPv6 和 IPv4 都试一遍,这个坑缓解了不少,但别的语言、别的客户端未必这么做。

为什么 MySQL 里两者行为不一样? 因为 MySQL 客户端在 Unix 系统上对 localhost 有特殊处理:写 -h localhost 时,它根本不走 TCP,而是通过 Unix socket 文件(如 /tmp/mysql.sock)连接;写 -h 127.0.0.1 才真的走 TCP。这会带来两个实际差异:
- 连接方式不同 :socket 文件路径不对时,
localhost会报找不到 socket 的错,127.0.0.1却能连上;反过来,MySQL 开了skip-networking时,只有localhost能连。 - 账号不同 :MySQL 的用户是「用户名 + 主机」,
'root'@'localhost'和'root'@'127.0.0.1'是两个账号,密码和权限都可以不一样。
127.0.0.1 和 0.0.0.0 有什么区别? 这是服务端「绑定」地址的问题。服务监听 127.0.0.1,意思是只在回环网卡上开门,只有本机能连;监听 0.0.0.0,意思是本机所有网卡都开门,局域网里别的机器也能连进来。

开头那个 Docker 的坑就出在这里。容器有自己独立的网络命名空间,容器里的 127.0.0.1 指的是容器自己 ,不是宿主机。如果容器里的服务只监听 127.0.0.1:3000,那么从宿主机通过 -p 3000:3000 映射进来的流量,到达的是容器的虚拟网卡 eth0,回环网卡上的服务根本收不到。在容器里,服务要绑 0.0.0.0 才行。
反过来,开发机上的数据库、Redis、调试端口,最好老老实实绑 127.0.0.1。在咖啡馆的公共 Wi-Fi 里,一个绑在 0.0.0.0 又没设密码的 Redis,同一网络里的任何人都能连上。
为什么要同时有名字和回环地址
先想清楚我们真正想要的是什么:一个程序能用来「找到自己」的写法,它要在任何机器、任何网络环境下都指向本机,而且最好不让外人连进来。把能想到的办法过一遍:
- 办法一:直接用本机的局域网 IP。 比如示意的
192.168.1.10。问题是它不稳定:换个 Wi-Fi 可能变成192.168.0.23,断网直接没了;每台机器的 IP 还都不一样,配置文件没法共享。而且服务绑在它上面,局域网里的人也能连进来。 - 办法二:保留一个固定地址,只用 127.0.0.1。 稳定性解决了,任何机器、断不断网,
127.0.0.1永远是自己。但它只属于 IPv4,到了纯 IPv6 环境要改成::1,代码里就得写两套。 - 办法三:只要一个名字,不保留地址。 名字可以同时对应 v4 和 v6,写一次通吃。可名字得解析成地址才能用,如果没有一个保留的地址兜底,解析出来的是什么就没有保证,换台机器可能指向别处。
把这几个办法摆进一张表,就能看出谁也不能单独解决问题:

所以设计成了两层 :底层是写死在协议里的回环地址,127.0.0.0/8 和 ::1 由 RFC 保留,永远指向本机、永远不出门;上层是一个约定好的名字 localhost,RFC 6761 规定它必须解析到这些回环地址,让同一份配置在 IPv4 和 IPv6 下都能用。
精髓可以压成一句话:127.0.0.1 是「永远指向自己、永远不出门」的地址,localhost 是给它起的、跨 IPv4/IPv6 通用的名字。
想通这一点,前面那些现象就都是推论:
- 断网也能用,是因为回环地址永远不出门;
- 改成 localhost 可能连不上 ,是因为名字要多走一步解析,而解析结果可能先给
::1; - MySQL 对 localhost 区别对待,是因为名字本身就是个可以被程序特殊解读的「约定」,地址则不会;
- 浏览器把
http://localhost当成安全上下文,允许用 Service Worker、摄像头等原本要求 HTTPS 的功能,也是因为规范保证了它只会指向本机,流量不会在网络上被别人看到。
至于为什么 IPv4 给回环划了一千六百多万个地址、IPv6 只给一个,这主要是早年地址宽裕时留下的历史包袱。IPv6 设计时吸取了教训,一个 ::1 就够了。
写在最后
回到开头的三个问题:
- 是什么 :localhost 是名字,
127.0.0.1是 IPv4 回环地址(整段127.0.0.0/8都是),::1是 IPv6 回环地址; - 怎么走 :名字先查
/etc/hosts解析成地址列表,数据包进内核后交给虚拟的回环网卡,掉个头送回本机进程,全程不碰物理网卡; - 为什么:地址负责「永远是自己」,名字负责「一个写法通吃 v4 和 v6」,两层各管一件事。
下次 npm run dev 打印出 http://localhost:3000 却打不开时,大家可以先看两件事:报错里连的是 ::1 还是 127.0.0.1,服务到底监听在哪个地址上。十有八九,答案就在这两者对不上的那一格里。🔍