IP主机名3个坑，错一个就打不开

打不开的原因有时候跟网络一点关系都没有——主机名那行字里多了个下划线。SSH 报 Host key verification failed、面板登录一直转圈、网站隔三差五 502，一路把防火墙、端口、证书查了个遍全是干净的，最后就卡在这一格。ip主机名 这东西装系统时随手填一下就再没人看它，可它偏偏是好几类服务的默认身份。

ip主机名为什么会被当成域名用

主机名本来只是机器给自己看的名字，但一堆程序拿它当域名使。SSH 客户端把它记进 known_hosts，数据库主从复制靠它认对面是谁，集群做节点发现、容器里的 service 名解析、监控 agent 上报身份、面板绑定访问地址，全都认名字不认 IP。

查找顺序通常是先翻 /etc/hosts，再走 DNS。所以它写歪的时候，最先崩的往往不是 ping 也不是浏览器，而是那些开机就要连一下的服务——数据库起不来、sshd 握手失败、监控掉线。ping 能通，人就开始怀疑网络，名字早就歪了还没人想到去看。

坑一：名字里掺了下划线、空格、中文

hostname 能吃下的字符范围比很多人想的窄，常规就是字母、数字加连字符。下划线在不少地方写得进去、也显示得出来，看着一点事没有，但一进证书校验、进某些脚本的参数解析、进老一点的 DNS 查询，就开始莫名其妙地报错。中文和空格更别提了，从文档里复制一段名字粘过来，末尾常带一个全角空格，肉眼根本看不出来。

怎么确认：Linux 上敲一下 hostname，回显里只要有怪字符就直接改。systemd 的系统用 hostnamectl set-hostname xxx，老一点的发行版写 /etc/hostname 再执行一次 hostname xxx。字符规则各发行版有细微差别，具体以官方文档为准。大小写也算一类：DNS 里名字不分大小写，可主机名进了某些地方是按字面比的，Web01 和 web01 混着用，known_hosts 里就记成两条，之后 ssh 隔几天提示一次指纹变了，人被折腾得没脾气。

坑二：改了 hostname，别处还留着老名字

ip主机名 改了，/etc/hosts 里那一行却没跟着动。那儿一般躺着 127.0.1.1 加老主机名，或者 192.168.x.x 加老主机名这样一行，hostname 一变它还是旧的，getent hosts 查出来就指向老名字，程序于是按老名字走。表现很典型：hostname 命令显示新的，服务日志里还是旧的，两边对不上，人开始怀疑自己是不是改错了地方。

云主机上还多绕一层。控制台里那个实例名和实例内部真实的主机名不是一回事，很多平台要重启、或者装了 agent 才同步，具体得看服务商文档。另一种情况是自己把 /etc/hostname 改完了，重启一看又变回去——多半是 cloud-init 开机按元数据覆盖了，要在配置里设 preserve_hostname，键值写法照官方文档抄，别照博客。

坑三：两台机器同名

内网里两台都叫 web01，这事比想象中常见，克隆虚拟机、复制镜像、批量装机都会带出来。后果是监控把两台合成一条曲线，日志平台把两边的流混在一起，备份脚本把对面的目录覆盖掉，出问题时按主机名找机器，找到的是另一台。

判断不难：同一个网段里翻一遍 DHCP 租约或者云控制台的实例列表，名字重复一眼就能看出来。命名最好带上角色加序号，web01、db01、cache01 这样，别图省事拿一台的模板往下复制。

自查顺序，从上面这一行开始

真碰上连不上，不用一上来就抓包。按这个顺序走一遍：① hostname 看当前名字对不对；② cat /etc/hostname 确认文件里落下来的值；③ cat /etc/hosts 看跟当前主机名有关的那几行；④ getent hosts 当前名字，看解析结果指向哪；⑤ 有 cloud-init 的去翻它的配置和日志，看开机会不会覆盖；⑥ 最后再看云控制台的实例名。

改完别急着收工，依赖主机名的服务要重启一遍，sshd、数据库、监控 agent 里有些只在启动那一下读主机名，之后一直用缓存。SSH 这边还得把 known_hosts 里旧条目删掉，不然它会一直拿老指纹来比。

什么时候别把主机名当域名用

主机名是给自己看的，域名是给别人看的，两者混着用迟早出事。生产环境稳妥的做法是主机名短、纯字母数字加连字符，内网 DNS 里单独给它一条记录，别指望 /etc/hosts 那几行撑住整个解析。机器一多、要扩缩容、要上容器编排，手写 hosts 这条路基本走不通。

还有一种情况是主机名里塞了整个域名后缀，比如 web01.example.com 全写进去。看着规整，其实不少程序只取第一段，日志里只剩 web01，人对不上号。真需要 FQDN 的地方，让 DNS 负责补后缀，别在主机名里自己拼。

记住三条就够：名字短、只用字母数字和连字符；带上角色和序号，别两台同名；改一处就把 hostname、/etc/hostname、/etc/hosts、DNS 或控制台一起改齐。下次再遇到连不上又查不出原因，先敲一下 hostname，比翻日志快。