sudo 提示 unable to resolve host 时，先核对当前主机名、/etc/hostname 与 /etc/hosts，再判断是否被 cloud-init 重启覆盖。
先核对本机主机名，不要先改公网 DNS：执行 sudo 时出现 sudo: unable to resolve host HOSTNAME，通常是当前主机名与 /etc/hosts 中的本机映射不一致。先从 SSH 或宝塔终端读取 hostnamectl、/etc/hostname 和 /etc/hosts，再用 getent hosts 验证当前主机名能否在本机解析。普通 Ubuntu 云服务器默认保留 127.0.0.1 localhost，并把实际短主机名映射到 127.0.1.1。
查看这些文件和执行本机解析测试通常不收费，也不会改数据。真正的风险来自把主机名改错、覆盖整个 /etc/hosts、删除 IPv6 本机条目，或在未确认 cloud-init 管理方式时强行锁定文件；这可能影响 sudo、邮件、监控、集群成员名和重启后的网络初始化。修改前保留当前 SSH 会话和云平台控制台入口，复制原文件，并先确认新主机名没有被证书、数据库复制或应用许可绑定。
先判断是不是本机主机名故障
这条提示常在 sudo 真正执行命令前出现，有时还会停顿几秒。它与“访问外部域名失败”不是同一件事：如果 curl、软件仓库和网站域名也不能解析，应继续按Linux DNS 解析失败检查解析器和上游 DNS；如果只有 sudo 提示当前主机名无法解析，先处理本机名与 hosts 的一致性。
| 检查结果 | 更可能的原因 | 下一步 |
|---|---|---|
hostname 与 /etc/hostname 不同 | 运行时名称刚被改过，或启动配置尚未统一 | 确认目标名称后使用 hostnamectl 统一静态主机名 |
两者相同，但 getent hosts 当前名 无输出 | /etc/hosts 缺少本机映射，或名称拼写不一致 | 只修改对应主机名行，不覆盖其他记录 |
| 修改后当前会话正常，重启又恢复旧名称 | cloud-init、DHCP 或云镜像在启动时重写主机名 | 核对 cloud-init 配置和云平台实例名称策略 |
| sudo 正常，只有公网域名失败 | 系统 DNS、网络或权威记录问题 | 不要继续改本机 hosts，转查 resolvectl 与上游 DNS |
第一步：只读保存当前现场
以下命令不会修改系统。主机名、域名、IP 和 hosts 内容可能暴露资产信息，对外分享前需要脱敏。不要把示例中的名称直接当成自己的目标值。
hostnamectl status
hostname
cat /etc/hostname
cat /etc/hosts
getent hosts "$(hostname)"
getent ahosts "$(hostname)"hostname 显示当前内核主机名，/etc/hostname 是 systemd 启动时使用的静态名称。Ubuntu 官方手册建议该文件只保存一个换行结尾的主机名；短主机名通常只用小写字母、数字和连字符。getent 经过系统名称服务配置，比用 ping 猜测更适合判断应用能否解析本机名。
若当前主机名是 web-01，而报错提示另一个旧名字，先记录是谁在调用 sudo、故障从何时开始，以及近期是否执行过克隆镜像、修改实例名、恢复快照或运行初始化脚本。不要只改报错文本中的名字，因为运行时主机名可能还会在下一次启动变化。
第二步：确认 hostname 和 hosts 应该怎样对应
普通 Ubuntu 单机常见的最小结构如下。web-01 只是示例，必须替换为 hostname 和 /etc/hostname 最终确认的实际短主机名；现有业务域名、内网地址和 IPv6 条目不能无理由删除。
# /etc/hostname
web-01
# /etc/hosts 中保留既有合法记录，并确认至少有：
127.0.0.1 localhost
127.0.1.1 web-01
::1 localhost ip6-localhost ip6-loopback/etc/hosts 的格式是“IP 地址、规范主机名、可选别名”。Ubuntu/Debian 常用 127.0.1.1 映射本机短主机名，避免本机名解析依赖外部 DNS。不要把 127.0.0.1 localhost 改成公网地址，也不要为了消除提示把业务域名随意指向回环地址。
如果服务器确实使用完整域名，可在确认邮件、证书、监控和集群要求后，把规范名称与短别名写在同一行，例如 127.0.1.1 web-01.example.internal web-01。不要把面向访客的网站域名当作服务器主机名的固定答案；很多云服务器只需要稳定的内部短名称。
第三步：安全修改主机名与 hosts
先备份文件，并保持当前 SSH 会话不要关闭。下面的 web-01 必须换成已经确认的新名称。hostnamectl set-hostname 会修改系统静态主机名；修改前确认服务清单和回退入口。
sudo cp -a /etc/hostname /etc/hostname.before-hostname-fix
sudo cp -a /etc/hosts /etc/hosts.before-hostname-fix
sudo hostnamectl set-hostname web-01
sudoedit /etc/hosts在编辑器中只修正对应本机名的那一行，保留其他已确认记录。保存后不要立即重启；先开第二个 SSH 会话验证 sudo 和本机解析。如果 sudoedit 仍先显示同一提示，只要命令继续执行且你有可用的控制台回退入口，可以完成这一处一致性修复；若 sudo 完全不可用，应使用云平台控制台或救援模式恢复，不要反复断开唯一会话。
不建议用 sed 全局替换旧主机名，因为同一字符串可能出现在业务域名、集群配置或注释中。也不要用重定向写一份两行 hosts 覆盖原文件，这会删除软件包、IPv6、内网和运维系统需要的映射。
云服务器为什么重启后又变回旧主机名
云镜像经常由 cloud-init 在启动阶段从元数据或用户数据设置主机名。cloud-init 官方文档说明，preserve_hostname: true 会阻止它改写主机名；若配置了 hostname 或 fqdn，也可能由云初始化创建或更新 /etc/hostname。不同云平台和镜像的默认值不同，不能直接复制一份固定配置。
先只读检查 cloud-init 是否存在、最近做了什么，以及哪些文件声明了主机名策略：
cloud-init status --long 2>/dev/null
grep -RniE 'preserve_hostname|manage_etc_hosts|^(hostname|fqdn):' \
/etc/cloud/cloud.cfg /etc/cloud/cloud.cfg.d 2>/dev/null
journalctl -u cloud-init -u cloud-config -u cloud-final -b --no-pager | tail -n 120看到 cloud-init 管理主机名时，先判断目标是“以后由云平台元数据管理”还是“保留手工设置”。只有选择保留手工名称时，才考虑在单独的 cloud-config 文件中设置 preserve_hostname: true；修改后还要验证实例克隆、自动扩容和灾备流程是否仍能产生唯一名称。不要为了消除一台机器的提示，让整个镜像池复制同一个主机名。
哪些场景不能只改这两个文件
- 集群或数据库复制：节点名可能参与成员身份、监控标签或复制配置，改名前要查看产品文档和维护窗口。
- 邮件服务器：邮件主机名、反向解析、证书和 HELO 可能有关联，不能只改本机文件。
- 自动伸缩或镜像：固定主机名会导致新实例重复，应让编排或 cloud-init 生成唯一名称。
- 证书或许可绑定：先确认软件是否按主机名授权，避免修好 sudo 却让业务服务拒绝启动。
- 宝塔面板：面板站点域名与 Linux 主机名不是同一字段；不要为了 sudo 提示去改网站绑定域名。
修复后如何验收
保存后在第二个会话执行以下检查。第一条应返回统一的静态主机名；getent 应能得到本机映射；sudo -v 不再出现 unable to resolve host。最后查看 cloud-init 状态，确认重启后不会意外覆盖。
hostnamectl status
cat /etc/hostname
getent hosts "$(hostname)"
sudo -v
sudo true
cloud-init status --long 2>/dev/null还要验证新的 SSH 登录、宝塔面板、监控、计划任务和应用服务。维护窗口允许时再重启一次，重复上述检查，确认名称不会回滚。若外部域名仍失败，但 sudo 提示已消失，说明本机映射已修好，剩余问题应按DNS 解析链路继续处理，而不是继续叠加 hosts 条目。
怎样回退
新名称影响业务时，使用控制台或仍保持的 SSH 会话恢复原名称和备份文件，再分别执行 hostnamectl status、getent hosts "$(hostname)" 与 sudo -v。不要在运行中的集群节点反复来回改名；先停止扩大变更范围并通知依赖该节点名的系统。恢复服务器管理入口后，可结合Linux 云服务器初始化清单和SSH 连接排障补齐资产记录与救援入口。
联系 Telegram 客服 