debian cobbler如何排错

下面按「从现象到定位、再到常见坑」的思路，给你一套 Debian + Cobbler 排错方法。Cobbler 本质是把 DHCP / TFTP / PXE / Kickstart / 镜像管理 揉在一起，所以排错通常是分层查。

一、先确认 Cobbler 本身是否正常

1. 检查服务状态

systemctl status cobblerd
systemctl status apache2
systemctl status tftpd-hpa
systemctl status isc-dhcp-server

Debian 上 Cobbler 依赖：

• cobblerd
• apache2（web 和 API）
• tftpd-hpa
• isc-dhcp-server（或 dnsmasq）

2. 最重要的一步：cobbler check

cobbler check

它会直接告诉你：

• SELinux / 权限
• 缺少 netmask
• 默认 password 没改
• TFTP / DHCP 未启用

✅ 90% 的问题在 cobbler check 里能看到

3. 同步配置

cobbler sync

如果 sync 报错，不要继续装机，先解决 sync 错误。

二、PXE 启动失败（客户端黑屏 / 卡住）

4. 检查 TFTP

客户端最先连的是 TFTP。

ls /var/lib/tftpboot/

应有：

• pxelinux.0
• menu.c32
• grub/
• images/

测试：

tftp localhost
tftp> get pxelinux.0

失败说明：

• tftpd 没开
• 路径不对
• 权限问题

5. DHCP 是否正确指 PXE

Debian 用 ISC DHCP 时，确认：

/etc/dhcp/dhcpd.conf

应有：

next-server 192.168.1.10;
filename "pxelinux.0";

并确认 DHCP 监听正确网卡：

/etc/default/isc-dhcp-server
INTERFACESv4="eth0"

三、Cobbler Web / API 问题

6. Web 打不开

tail -f /var/log/apache2/error.log

常见问题：

• 模块未启用：a2enmod wsgi
• Cobbler web 未安装
• Python 版本冲突（Debian 12 特别注意）

7. 认证失败

cobbler login

默认用户：

/etc/cobbler/users.digest

或：

/etc/cobbler/modules.conf
[authentication]
module = authn_configfile

四、镜像 / 系统导入失败

8. import 失败

cobbler import --path=/mnt --name=debian12

查看：

/var/log/cobbler/cobbler.log

常见错误：

• ISO 没挂载
• 架构写错（x86_64 / aarch64）
• rsync 权限不足

9. Kickstart / Preseed 不生效

Debian 用的是 preseed，不是 kickstart。

确认：

cobbler profile edit --name=debian12 --kickstart=/var/lib/cobbler/kickstarts/debian.preseed

preseed 示例关键点：

d-i mirror/country string manual
d-i mirror/http/hostname string ftp.de.debian.org

五、日志在哪里（非常重要）

/var/log/cobbler/cobbler.log     # 核心
/var/log/apache2/                # Web
/var/log/syslog                  # DHCP / TFTP
/var/log/cobbler/install.log     # 装机日志

六、Debian 特有坑（重点）

❗ Debian 12 + Cobbler

• Python 3.11
• Cobbler 3.2+ 才稳定
• 不要用老版本（2.x）

❗ tftpd-hpa

apt install tftpd-hpa

配置：

/etc/default/tftpd-hpa
TFTP_DIRECTORY="/var/lib/tftpboot"

七、快速排错 checklist（建议保存）

✅ cobbler check
✅ cobbler sync
✅ TFTP 有 pxelinux.0
✅ DHCP next-server 正确
✅ Apache 正常
✅ 日志无 ERROR
✅ 镜像 import 成功

如果你愿意，可以告诉我：

• Debian 版本（11 / 12）
• Cobbler 版本
• 具体报错（客户端 or 服务端）

我可以直接帮你 对着日志精准排错。