WSL Ubuntu修改主机名重启后失效解决方案

问题核心：WSL默认强制同步Windows主机名，会覆盖Ubuntu本地/etc/hostname配置，导致重启后修改失效，需通过专属配置文件禁用同步机制。

一、问题描述

笔记本电脑搭载WSL（Windows Subsystem for Linux）Ubuntu系统，手动修改主机名后，重启WSL/电脑，主机名恢复默认，修改未永久生效。

二、检查：验证原有文件中主机名修改是否正确

先确认本地配置文件无错误，避免重复操作，打开Ubuntu终端执行以下命令：

查看主机名配置文件，核对是否为新主机名cat /etc/hostname

bash 复制代码

root@elwyn:/home/elwyn# cat /etc/hostname
elwyn   
#这里已经是我修改后的主机名

查看hosts映射文件，核对127.0.1.1对应的主机名是否一致 grep "127.0.1.1" /etc/hosts

bash 复制代码

root@elwyn:/home/elwyn# grep "127.0.1.1" /etc/hosts
127.0.1.1       elwyn         elwyn   
# 以上显示已经修改成功了

异常处理：若显示旧主机名，重新用vim编辑两个文件，修改为目标主机名并保存。

三、永久修改主机名

步骤1：创建并配置WSL专属配置文件

该文件用于禁用主机名同步、固定Ubuntu本地主机名，是解决失效的关键

终端执行命令，编辑wsl.conf文件

bash 复制代码

root@elwyn:/home/elwyn# vim /etc/wsl.conf
[network]
hostname=elwyn
generateHosts=false

粘贴以下内容，将新主机名 替换为自定义名称（仅支持字母、数字、横杠） [network] hostname = 自定义新主机名 generateHosts = false

步骤2：校准hosts文件（避免解析报错）

编辑hosts文件 sudo vim /etc/hosts

确保文件包含以下内容，替换为自己的新主机名 127.0.0.1 localhost 127.0.1.1 自定义新主机名 ::1 localhost ip6-localhost ip6-loopback fe00::0 ip6-localnet ff00::0 ip6-mcastprefix ff02::1 ip6-allnodes ff02::2 ip6-allrouters

bash 复制代码

  root@elwyn:/home/elwyn# vim /etc/hosts
  # This file was automatically generated by WSL. To stop automatic generation of this file, add the following entry to /etc/wsl.conf:
  # [network]
  # generateHosts = false
  127.0.0.1       localhost
  127.0.1.1       elwyn         elwyn

  # The following lines are desirable for IPv6 capable hosts
  ::1     ip6-localhost ip6-loopback
  fe00::0 ip6-localnet
  ff00::0 ip6-mcastprefix
  ff02::1 ip6-allnodes
  ff02::2 ip6-allrouters

步骤3：彻底重启WSL（必须执行）

仅关闭Ubuntu终端无效，需完全终止WSL进程，在Windows PowerShell（普通权限即可）执行：

powershell 复制代码

wsl --shutdown

重启完成后，重新打开Ubuntu终端，验证修改结果：

bash 复制代码

hostname

终端显示新主机名，且提示符同步更新，即为生效。

四、常见问题排查

权限不足：所有修改命令必须加sudo，否则无法保存系统配置文件
主机名违规：禁止使用中文、空格、下划线、特殊字符，仅支持小写字母+数字+横杠
WSL1兼容差 ：建议升级至WSL2，执行命令：wsl --set-version Ubuntu 2
仍未生效：删除旧的wsl.conf文件，重新按步骤创建，再次重启WSL

五、临时修改方法（重启失效，仅测试用）

适合临时更改，无需修改配置文件，重启WSL后自动恢复：

bash 复制代码

sudo hostname 新主机名