hostnamectl命令

hostnamectl 命令 #

hostnamectl是一个用于查询和更改系统主机名的命令行工具，它是 systemd 系统的一部分。该命令允许管理员设置系统的主机名、静态主机名、漂亮主机名（pretty hostname）以及机器信息，并提供了一个统一的接口来管理这些设置。

语法 # 

hostnamectl [选项...] 命令 [参数...]

常用命令 #

命令 描述
status 显示当前主机名设置（默认命令）
set-hostname NAME 设置系统主机名
set-icon-name NAME 设置主机图标名称
set-chassis TYPE 设置机箱类型
set-deployment ENV 设置部署环境
set-location LOC 设置位置

常用选项 #

选项 描述
-h, --help 显示帮助信息
--version 显示版本信息
--no-ask-password 不询问密码
-H, --host=HOST 在远程主机上操作
-M, --machine=CONTAINER 在本地容器上操作
--transient 仅设置临时主机名
--static 仅设置静态主机名
--pretty 仅设置漂亮主机名

常见用法 #

1. 显示当前主机名信息 # 

hostnamectl

或者：

hostnamectl status

输出示例：

   Static hostname: server1.example.com
         Icon name: computer-server
           Chassis: server
        Machine ID: 3dcb8842f35842a0a1e3d338f5ef642d
           Boot ID: 7c1c89c5f4bd4e9d8d1b38a57f2945f2
  Operating System: Ubuntu 22.04.1 LTS
            Kernel: Linux 5.15.0-52-generic
      Architecture: x86-64

2. 设置系统主机名 # 

hostnamectl set-hostname server2.example.com

这将同时设置静态、临时和漂亮主机名。

3. 仅设置漂亮主机名 # 

hostnamectl set-hostname "Web Server 1" --pretty

漂亮主机名可以包含空格和特殊字符，用于显示目的。

4. 仅设置静态主机名 # 

hostnamectl set-hostname server2.example.com --static

静态主机名存储在/etc/hostname文件中。

5. 仅设置临时主机名 # 

hostnamectl set-hostname temporary-name --transient

临时主机名在系统重启后不会保留。

6. 设置机箱类型 # 

hostnamectl set-chassis server

可用的机箱类型包括：desktop、laptop、convertible、server、tablet、handset、watch、embedded 等。

7. 设置部署环境 # 

hostnamectl set-deployment production

常见的部署环境包括：development、integration、staging、production 等。

8. 设置位置信息 # 

hostnamectl set-location "Data Center 1"

9. 设置图标名称 # 

hostnamectl set-icon-name computer-server

10. 在远程主机上操作 # 

hostnamectl --host=user@remote-server set-hostname new-hostname

主机名类型 #

hostnamectl管理三种不同类型的主机名：

  1. 静态主机名（Static hostname）：传统的主机名，存储在/etc/hostname文件中，用于启动时设置系统主机名。应符合 DNS 标准，只能包含字母、数字、连字符和点。

  2. 临时主机名（Transient hostname）：由内核维护的运行时主机名，可以由 DHCP 或 mDNS 在运行时修改。如果未设置，则默认为静态主机名。

  3. 漂亮主机名（Pretty hostname）：一个更加用户友好的主机名版本，可以包含 UTF-8 字符，包括空格和特殊字符。存储在/etc/machine-info文件中。

相关文件 #

  • /etc/hostname：存储静态主机名
  • /etc/machine-info：存储漂亮主机名、机箱类型、图标名称等
  • /proc/sys/kernel/hostname：内核中的当前主机名（临时主机名）

与其他命令的关系 #

命令 描述 与 hostnamectl 的关系
hostname 传统的主机名查询和设置命令 只能设置临时主机名，不会更新静态或漂亮主机名
sysctl kernel.hostname 通过 sysctl 设置主机名 只能设置临时主机名
nmcli general hostname NetworkManager 的主机名设置 在某些系统上会调用 hostnamectl

实用示例 #

1. 设置完整的主机标识 # 

# 设置主机名
hostnamectl set-hostname webserver1.example.com

# 设置漂亮主机名
hostnamectl set-hostname "Web Server 1" --pretty

# 设置机箱类型
hostnamectl set-chassis server

# 设置部署环境
hostnamectl set-deployment production

# 设置位置
hostnamectl set-location "Rack 4, Data Center 2"

2. 在脚本中使用 hostnamectl # 

#!/bin/bash
# 获取当前主机名
CURRENT_HOSTNAME=$(hostnamectl --static)

# 根据IP地址最后一个八位字节设置主机名
IP_LAST_OCTET=$(ip addr show eth0 | grep 'inet ' | awk '{print $2}' | cut -d/ -f1 | cut -d. -f4)
NEW_HOSTNAME="server-$IP_LAST_OCTET"

# 设置新主机名
hostnamectl set-hostname "$NEW_HOSTNAME"
echo "Hostname changed from $CURRENT_HOSTNAME to $NEW_HOSTNAME"

3. 在系统初始化脚本中使用 # 

#!/bin/bash
# 检查主机名是否已设置
if hostnamectl status | grep -q "Static hostname: localhost"; then
    # 生成唯一主机名
    NEW_HOSTNAME="server-$(cat /etc/machine-id | cut -c1-8)"
    hostnamectl set-hostname "$NEW_HOSTNAME"
    echo "Initialized hostname to $NEW_HOSTNAME"
fi

4. 根据角色设置主机名 # 

#!/bin/bash
# 根据安装的软件包确定服务器角色
if dpkg -l | grep -q "^ii.*apache2\s"; then
    ROLE="web"
elif dpkg -l | grep -q "^ii.*mysql-server\s"; then
    ROLE="db"
elif dpkg -l | grep -q "^ii.*redis-server\s"; then
    ROLE="cache"
else
    ROLE="app"
fi

# 设置基于角色的主机名
INSTANCE_ID=$(cat /etc/machine-id | cut -c1-8)
hostnamectl set-hostname "${ROLE}-${INSTANCE_ID}"

常见问题排查 #

1. 权限问题 # 

Could not set property: Interactive authentication required.

解决方法：使用 sudo 运行命令。

sudo hostnamectl set-hostname new-hostname

2. 主机名未在所有地方更新 #

可能的原因：

  • /etc/hosts文件未更新
  • 某些服务需要重启才能识别新主机名

解决方法：

# 更新/etc/hosts文件
sudo sed -i "s/^127.0.1.1.*/127.0.1.1\t$(hostnamectl --static)/" /etc/hosts

# 重启相关服务
sudo systemctl restart systemd-hostnamed

3. 设置的主机名在重启后丢失 #

可能的原因：

  • DHCP 客户端配置覆盖了主机名
  • 云初始化脚本修改了主机名

解决方法：

# 检查DHCP客户端配置
grep -r "hostname" /etc/dhcp/

# 修改DHCP客户端配置，禁止更新主机名
echo 'hostname=""' | sudo tee -a /etc/dhcp/dhclient.conf

4. 无法在容器中设置主机名 #

容器通常有自己的主机名命名空间，可能需要特殊处理。

解决方法：

# 对于systemd-nspawn容器
sudo machinectl set-hostname container-name new-hostname

# 对于Docker容器
docker run --hostname=new-hostname ...

提示 #

  • 主机名应符合 DNS 标准（RFC 1123），只使用字母、数字、连字符和点
  • 主机名长度应小于 64 个字符
  • 使用有意义的主机名可以简化系统管理和故障排除
  • 在云环境中，可能需要同时更新云提供商的主机名设置
  • 更改主机名后，可能需要更新 SSL 证书、监控系统和其他引用主机名的配置
  • 使用漂亮主机名可以提供更多描述性信息，而不受 DNS 命名限制
  • 在集群环境中，考虑使用一致的主机名命名方案（如 role-number.domain.com）
  • 主机名更改可能需要重启某些应用程序才能生效
  • 在虚拟化环境中，确保虚拟机主机名与虚拟化管理平台中的名称一致