看门狗（Watchdog）是一种用于监控系统运行状态，并在系统僵死或崩溃时自动重启恢复的硬件或软件机制。配置看门狗通常涉及硬件支持、驱动加载和软件设置。以下是详细的配置步骤和注意事项：

一、硬件看门狗配置（常见于嵌入式/Linux服务器）

1. 确认硬件支持

• 主板/嵌入式设备需内置硬件看门狗芯片（如iTCO_wdt, bcm2835_wdt等）。
• 通过命令检查是否加载驱动：

   lsmod | grep -i watchdog  # 查看已加载的驱动
   dmesg | grep -i watchdog  # 检查内核识别日志

2. 加载看门狗驱动

• 手动加载驱动（以iTCO_wdt为例）：

   sudo modprobe iTCO_wdt

• 设置开机自动加载：

   echo "iTCO_wdt" | sudo tee /etc/modules-load.d/watchdog.conf

3. 安装并配置看门狗守护进程

• 安装软件包（以Ubuntu/Debian为例）：

   sudo apt install watchdog

• 编辑配置文件 /etc/watchdog.conf：

   # 启用硬件看门狗
   watchdog-device = /dev/watchdog  # 设备路径
  
   # 设置超时时间（单位：秒）
   watchdog-timeout = 15
  
   # 定期检测系统负载（可选）
   max-load-1 = 24
   max-load-5 = 18
   max-load-15 = 12
  
   # 检测网络/服务（示例）
   ping = 192.168.1.1
   interface = eth0

• 关键参数：
  • watchdog-timeout：超时时间（需小于硬件最大支持值）。
  • test-binary：自定义检测脚本路径。
  • repair-binary：故障时执行的修复脚本。

4. 启动并测试服务

   sudo systemctl enable --now watchdog  # 启用并立即启动
   sudo systemctl status watchdog        # 检查状态

5. 测试看门狗复位

• 临时停止守护进程，触发超时重启：

   sudo systemctl stop watchdog        # 停止服务
   sleep 30                            # 等待超过超时时间（系统应自动重启）

二、软件看门狗配置（纯软件实现）

1. 使用 systemd 内置看门狗

• 在服务单元文件（.service）中添加配置：

   [Service]
   ExecStart=/usr/bin/your-service
   WatchdogSec=30s           # 定义看门狗超时时间
   Restart=on-failure        # 失败时重启

• 服务需定期发送"心跳"信号：

   # Python示例（使用sd_notify）
   import systemd.daemon
   systemd.daemon.notify("WATCHDOG=1")  # 每隔超时时间/2发送一次

2. 自定义脚本监控

   # 示例：监控Nginx服务，异常时重启
   */5 * * * * root if ! systemctl is-active nginx; then systemctl restart nginx; fi

三、常见问题解决

1. 权限错误

   sudo chmod 600 /dev/watchdog  # 确保守护进程有权访问设备

2. 驱动不兼容

   • 检查内核文档：/usr/src/linux/Documentation/watchdog/
   • 尝试其他驱动（如softdog虚拟看门狗）。

3. 超时时间无效

   • 硬件看门狗有最大超时限制（查阅主板手册），超出后会使用默认值。

4. 日志分析

   journalctl -u watchdog -f  # 实时查看守护进程日志

四、注意事项

• 超时时间设置：需大于服务最长阻塞时间（例如磁盘I/O），但小于硬件允许最大值。
• 生产环境测试：首次配置后强制触发重启验证有效性。
• 安全机制：避免看门狗被恶意进程停止（配置权限隔离）。

⚠️ 警告：错误配置可能导致系统频繁重启！建议在测试环境验证后再部署到生产环境。

根据实际场景（嵌入式设备/Linux服务器/服务监控）选择合适的方案，并确保心跳机制与超时时间匹配。