Ubuntu下Consul服务启动失败问题排查求助

问题背景 #

在Ubuntu系统中安装Consul后，consul version执行正常，consul validate /etc/consul.d/验证配置也通过。手动执行/usr/bin/consul agent -config-dir=/etc/consul.d/能正常启动Consul，但通过systemd服务启动时失败，状态显示exit-code=1/FAILURE。从journalctl日志可见，服务启动时Consul未加载指定配置（节点名显示为服务器主机名，而非配置文件中设置的test）。

相关配置文件如下：

• /etc/consul.d/consul.hcl：

datacenter="dc1"
data_dir="/opt/consul"
encrypt="UEY...."

• /etc/consul.d/server.hcl：

node_name="test"
server=true
bootstrap_expect=1
client_addr="0.0.0.0"
ui_config {
  enabled=true
}

• /etc/systemd/system/consul.service：

[Unit]
Description="HashiCorp Consul - A service mesh solution"
Documentation=https://www.consul.io/
Requires=network-online.target
After=network-online.target
ConditionFileNotEmpty=/etc/consul.d/consul.hcl

[Service]
EnvironmentFile=-/etc/consul.d/consul.env
User=consul
Group=consul
ExecStart=/usr/bin/consul agent -config-dir=/etc/consul.d/
ExecReload=/bin/kill --signal HUP $MAINPID
KillMode=process
KillSignal=SIGTERM
Restart=on-failure
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target

问题原因 #

核心原因是权限不匹配：手动启动时使用的是当前用户（通常为root），拥有访问所有目录和文件的权限；而systemd服务通过consul用户执行，该用户没有读写Consul数据目录/opt/consul或读取配置目录/etc/consul.d的权限，导致Consul无法加载配置文件，启动失败。

解决步骤 #

1. 修复目录与文件权限

   • 赋予consul用户对数据目录的所有权：

     sudo chown -R consul:consul /opt/consul
     

   • 赋予consul用户对配置目录的所有权：

     sudo chown -R consul:consul /etc/consul.d
     

   • 确保配置文件权限正确（避免其他用户篡改）：

     sudo chmod 640 /etc/consul.d/*.hcl
     

2. 优化systemd服务配置

   • 若/etc/consul.d/consul.env文件不存在，可删除EnvironmentFile=-/etc/consul.d/consul.env行（-表示文件不存在时不报错，但移除不必要的配置项更稳妥）。
   • 在[Service]段添加工作目录配置，确保服务运行环境正确：

     WorkingDirectory=/opt/consul
     

3. 重新加载配置并重启服务

   • 重新加载systemd配置：

     sudo systemctl daemon-reload
     

   • 重启Consul服务：

     sudo systemctl restart consul
     

   • 检查服务状态：

     sudo systemctl status consul
     

验证方法 #

执行journalctl -u consul.service -f查看实时日志，确认节点名显示为test，且无权限相关报错；同时访问Consul UI（默认端口8500），确认服务正常运行。

内容的提问来源于stack exchange，提问作者dstr