Debian 环境下 Cobbler 常见问题与解决方案
一 快速自检与修复流程
sudo systemctl status cobblerd cobbler-web tftp xinetd isc-dhcp-server、sudo tail -f /var/log/syslog、sudo journalctl -u cobblerd -f。sudo cobbler check，按提示逐项修复。sudo cobbler sync，必要时重启相关服务：sudo systemctl restart cobblerd httpd tftp xinetd isc-dhcp-server。二 高频问题对照表
| 症状 | 可能原因 | 解决步骤 |
|---|---|---|
| PXE 启动后停在菜单或直接失败 | /var/lib/cobbler/loaders 缺少引导文件（如 pxelinux.0、menu.c32、grub-*.efi） | 1) 先尝试 sudo cobbler get-loaders；2) 若失败，安装 syslinux/grub 并手动复制：如 sudo apt-get install syslinux-common grub-pc-bin grub-efi-amd64-bin，然后 sudo cp /usr/lib/syslinux/modules/bios/menu.c32 /usr/lib/grub/x86_64-efi/grubx64.efi /var/lib/cobbler/loaders/；3) sudo cobbler sync |
| 客户端拿不到 IP 或反复 PXE | DHCP 未运行或配置错误 | 1) 启动服务：sudo systemctl start isc-dhcp-server；2) 在 /etc/dhcp/dhcpd.conf 中确保有 subnet 段、range、filename "pxelinux.0"、next-server <Cobbler_IP>；3) 指定监听接口：/etc/default/isc-dhcp-server 设置 INTERFACESv4="eth0"；4) sudo cobbler sync 后重启 DHCP |
| TFTP 超时或文件下载失败 | TFTP 未启用或目录不对 | 1) 若使用 xinetd 管理：sudo sed -i 's/disable.*=.*yes/disable = no/' /etc/xinetd.d/tftp && sudo systemctl restart xinetd；2) 若使用 tftpd-hpa：确保 /etc/default/tftpd-hpa 中 TFTP_DIRECTORY=/var/lib/tftpboot 并启动服务；3) 确认 /var/lib/cobbler/ 与 /tftpboot 的软链或文件就位 |
| 导入镜像或管理仓库报错 | 缺少 debmirror 或配置不当 | 1) 安装：sudo apt-get install debmirror；2) 为 Debian 支持，编辑 /etc/debmirror.conf，注释或调整 dists 与 arches 相关行（如注释 @dists="sid";、@arches="i386";） |
| Kickstart 校验失败或变量未生效 | 缺少 pykickstart 或 ksvalidator 未安装 | 安装：sudo apt-get install pykickstart；之后可用 ksvalidator /var/lib/cobbler/kickstarts/your.seed 校验 |
| 新装系统 root 密码为弱口令 | default_password_crypted 仍为默认值 | 生成加密口令：openssl passwd -1 -salt $(openssl rand -hex 4) 'YourPassword'，将结果写入 /etc/cobbler/settings 的 default_password_crypted 字段 |
| Web 界面打不开或 API 报错 | cobbler-web 未启动或依赖缺失 | 启动服务：sudo systemctl start cobbler-web；检查依赖（如 python-django 等）与日志：journalctl -u cobbler-web -f |
| 导入系统镜像失败 | ISO 路径错误、挂载失败或架构不匹配 | 1) 挂载 ISO：sudo mount -o loop /path/to/debian.iso /mnt；2) 导入：sudo cobbler import --path=/mnt --name=debian-<ver>；3) 卸载：sudo umount /mnt；4) 如有多架构，分别导入对应 ISO |
三 关键配置要点
sudo cobbler sync。subnet、range、filename "pxelinux.0"、next-server <Cobbler_IP> 正确；如需为某主机固定 IP，使用 cobbler system add ... --ip-address=<IP> --mac=<MAC> --netboot-enabled=true 后 cobbler sync。四 最小化验证步骤
sudo cobbler import --path=/mnt --name=debian-test（ISO 已挂载到 /mnt）。sudo cobbler profile add --name=debian-test --kickstart=/var/lib/cobbler/kickstarts/debian.seed。sudo cobbler system add --name=test01 --profile=debian-test --mac=00:11:22:33:44:55 --ip-address=192.168.1.100 --netboot-enabled=true。sudo cobbler sync，确认 cobblerd、httpd、tftp、isc-dhcp-server 已运行。