Debian 环境下使用 Cobbler 进行镜像管理的实操指南
一 核心概念与准备
- 关键术语：Distro（发行版）、Profile（配置集）、System（主机）、镜像导入（import）、Netboot 引导。
- 基础服务：Cobbler 可集中管理 DHCP/TFTP/HTTP，并提供 CLI 与 Web 两种管理方式；导入镜像后会自动创建 Distro 与 Profile，便于后续复用与分发。
- 环境建议：准备 Debian 12（Bookworm）ISO；确保磁盘与网络可用；安装后优先执行 cobbler check 完成自检与修复。
二 导入与管理镜像的标准流程
- 挂载 ISO 并导入
- 挂载 ISO：mkdir -p /mnt/debian && mount -o loop /path/to/debian-12.11.0-amd64-DVD-1.iso /mnt/debian
- 导入镜像：cobbler import --name debian12.11 --path /mnt/debian
- 导入完成后会自动生成 Distro 与 Profile，可用 cobbler distro list / cobbler profile list 查看。
- 准备 PXE 网络引导
- 下载官方 Netboot initrd.gz（PXE 专用）：wget -O /root/debian12.11-netboot.gz https://mirrors.ustc.edu.cn/debian/dists/stable/main/installer-amd64/current/images/netboot/debian-installer/amd64/initrd.gz
- 拼接引导镜像（解决部分安装阶段卡住的问题）：cat /var/www/cobbler/distro_mirror/debian12.11/install.amd/initrd.gz /root/debian12.11-netboot.gz > /var/www/cobbler/pub/debian12.11-netboot.gz
- 让 Distro 使用新的 initrd：cobbler distro edit --name debian12.11-x86_64 --initrd “/var/www/cobbler/pub/debian12.11-netboot.gz”
- 说明：DVD 中的 initrd.gz 并非为 PXE 场景准备，使用 Netboot 并拼接后可显著提升 PXE 安装成功率。
- 创建自动化安装模板（Debian 使用 Preseed）
- 示例模板路径：/var/lib/cobbler/templates/bookworm-workaround.seed
- 关键项示例：语言/键盘（en_US/us）、root 密码（明文或哈希）、网络自动获取、镜像源（可设为 mirrors.tuna.tsinghua.edu.cn/debian）、安全更新源（bookworm-security）。
- 将模板绑定到 Profile：cobbler profile edit --name debian12.11-x86_64 --kickstart /var/lib/cobbler/templates/bookworm-workaround.seed
- 说明：Debian 系列采用 Preseed 应答文件实现无人值守安装。
- 同步与验证
- 应用变更：cobbler sync
- 自检：cobbler check
- 查看对象：cobbler distro list、cobbler profile list。
三 常用镜像管理操作清单
- 查看与定位
- 列出镜像对象：cobbler distro list、cobbler profile list
- 查看详细信息：cobbler report（可过滤到具体 Distro/Profile/System）
- 确认引导文件：ls /var/www/cobbler/distro_mirror/debian12.11/install.amd/；必要时检查 /var/www/cobbler/pub/debian12.11-netboot.gz。
- 更新镜像内容
- 重新导入同名镜像会创建新版本对象（建议先备份与规划命名）；导入后执行 cobbler sync 使变更生效。
- 删除镜像与关联对象（顺序重要）
- 查看并清理 Profile：cobbler profile find --distro=debian12.11-x86_64
- 删除 Profile：cobbler profile remove --name debian12.11-x86_64
- 删除 Distro：cobbler distro remove --name debian12.11-x86_64
- 同步：cobbler sync。
- 引导菜单与默认项
- 通过 cobbler profile edit 调整 –kickstart、内核参数等，以控制 PXE 菜单默认行为与无人值守策略。
四 网络与引导配置要点
- 基础配置
- /etc/cobbler/settings：设置 server（本机可达 IP）、next_server（TFTP 地址）、按需开启 manage_dhcp / manage_tftp；完成后执行 cobbler sync。
- DHCP 模板示例（/etc/cobbler/dhcp.template）
- subnet 192.168.1.0 netmask 255.255.255.0 {
- range 192.168.1.100 192.168.1.200;
- option routers 192.168.1.1;
- option domain-name-servers 8.8.8.8, 8.8.4.4;
- filename “pxelinux.0”;
- next-server 192.168.1.2;
- }
- 应用：cobbler sync 后重启 DHCP 服务。
- 引导加载器
- 若缺少 PXE 引导文件，执行 cobbler get-loaders 下载常用 loader，避免 PXE 启动失败。
五 故障排查与最佳实践
- 安装器阶段卡住
- 现象：选择安装条目后长时间无进度。
- 处置：使用 Netboot initrd.gz 并与 DVD 的 initrd.gz 拼接后重试（见第二节步骤）。
- 自检与常见报错
- 执行 cobbler check，优先修复：server/next_server 非回环地址、缺失 loader、服务未启动等。
- 服务与目录核对
- 确认服务：systemctl enable --now cobblerd httpd tftp（以及 DHCP 服务）；必要时查看 /var/log/cobbler/cobbler.log。
- 目录核对：/var/www/cobbler/distro_mirror 与 pub 下是否存在预期镜像与引导文件。
- 网络与冲突
- 避免同网段存在其他 DHCP 服务；虚拟机测试建议使用 NAT 并关闭其内置 DHCP，防止干扰。
