中间件 - Wizard Doc

该文档由孙荣利创建于 2026-10-03 15:27:48 ，孙荣利在 2026-10-03 15:27:48 修改了该文档。

[TOCM]

## 一、简介

```text
dnsmasq 是一款轻量级的 DNS 转发/缓存服务，常用于内网环境：提供本地域名解析（如通过 /etc/dnsmasq.hosts 自定义"IP → 域名"映射）、DNS 缓存和 DHCP 服务。

本文记录 dnsmasq 的安装、启动、配置（子配置文件 /etc/dnsmasq.hosts）与日常运维命令。
```

## 二、安装部署

#### 1. 安装 dnsmasq

```shell
# CentOS/RHEL 系
yum install -y dnsmasq

# Ubuntu/Debian 系
apt install -y dnsmasq
```

#### 2. 启动与开机自启

```shell
# 启动
systemctl start dnsmasq

# 开机自启
systemctl enable dnsmasq
```

#### 3. 配置 /etc/dnsmasq.hosts（子配置文件）

```text
/etc/dnsmasq.hosts 为 dnsmasq 的本地域名解析子配置文件，每行一条记录，格式：IP地址 域名
修改配置后必须重启 dnsmasq 才能生效。
```

```shell
# 编辑子配置文件（添加内网域名解析记录）
vim /etc/dnsmasq.hosts
```

```text
文件内容示例（每行：IP 域名）：
  192.168.1.100  gitlab.358369.xyz
  192.168.1.101  jenkins.358369.xyz
```

```text
说明：dnsmasq 需在 /etc/dnsmasq.conf 中启用该文件才能生效，确认以下配置存在：
  addn-hosts=/etc/dnsmasq.hosts
（或在 /etc/dnsmasq.d/ 下的配置文件中指定，格式相同）
```

#### 4. 重启与验证

```shell
# 重启（修改配置后必须执行，使新配置生效）
systemctl restart dnsmasq

# 查看服务状态（Active: active (running) 即正常）
systemctl status dnsmasq

# 实时查看日志（观察解析请求/错误）
journalctl -u dnsmasq -f

# 验证域名解析是否生效（在任意内网机器上执行）
nslookup gitlab.358369.xyz
ping gitlab.358369.xyz
```