Debian 环境下 Cobbler 安装与配置指南
一 环境准备与安装
- 建议使用 Debian 11/12,确保具备 ≥1GB 内存、≥10GB 磁盘,并准备可访问互联网与本地网络的 静态 IP。
- 安装必要软件包(含 Web 界面与 TFTP、DHCP 管理组件):
- sudo apt-get update
- sudo apt-get install -y cobbler cobbler-web tftp-server isc-dhcp-server apache2 xinetd rsync
- 启用并启动服务(不同发行版服务名可能略有差异,Debian 常见为 apache2、isc-dhcp-server、xinetd、cobblerd、rsync):
- sudo systemctl enable --now apache2 cobblerd xinetd rsync
- sudo systemctl enable --now isc-dhcp-server
- 说明:Cobbler 提供 命令行 与 Web 界面(cobbler-web),可集中管理 DHCP、TFTP、DNS 等,用于批量网络安装 Debian 等发行版。
二 基础配置
- 编辑主配置 /etc/cobbler/settings,将以下关键项改为本机地址(示例 IP 为 192.168.1.2):
- server: 192.168.1.2
- next_server: 192.168.1.2
- 如由 Cobbler 托管 DHCP,设置:manage_dhcp: 1;否则设为 0 并由外部 DHCP 提供服务。
- 配置 DHCP 模板 /etc/cobbler/dhcp.template(按需修改网段、网关、DNS、地址池与 next-server):
- 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;
- }
- 配置 TFTP(编辑 /etc/xinetd.d/tftp,确保根目录与启动参数正确):
- server_args = -s /var/lib/tftpboot
- disable = no
- 获取引导加载器并修复检查项:
- sudo cobbler get-loaders
- sudo cobbler check(按提示逐项修复)
- 应用配置并重启相关服务:
- sudo cobbler sync
- sudo systemctl restart apache2 cobblerd xinetd isc-dhcp-server
- 验证 Web 访问(应返回 200):curl -I http://192.168.1.2/cobbler/
三 导入 Debian 镜像与创建安装配置
- 准备 Debian ISO,挂载或放置于可访问路径(如 /tmp/debian.iso),导入发行版与默认 profile:
- sudo mount -o loop /tmp/debian.iso /mnt
- sudo cobbler import --name=debian-12 --path=/mnt --arch=amd64
- sudo umount /mnt
- 查看导入结果并关联 Kickstart(Debian 通常使用 preseed 自动安装应答文件):
- cobbler distro list
- cobbler profile list
- 示例(将默认种子文件关联到 profile,路径以实际为准):
- sudo cobbler profile edit --name=debian-12-x86_64 --kickstart=/var/lib/cobbler/kickstarts/default.seed
- 如计划通过 Cobbler 管理 Debian 仓库/镜像,安装并配置 debmirror(示例为最小配置,按需调整):
- sudo apt-get install -y debmirror
- sudo cp /usr/share/doc/debmirror/examples/debmirror.conf /etc/debmirror.conf
- 在 /etc/debmirror.conf 中注释或调整 @dists、@arches 等限制项,避免不必要的下载与校验错误。
四 客户端 PXE 安装与常见问题
- 客户端在 BIOS/UEFI 中启用 PXE 启动,从网络引导后将自动获取 IP、下载 pxelinux.0 与安装内核/initrd,按关联的 preseed 自动完成安装。
- 常用排错与运维命令:
- cobbler check(核对配置)
- cobbler sync(使配置生效)
- cobbler list / cobbler report(查看对象)
- tail -f /var/log/cobbler/cobbler.log(查看服务日志)
- 目录速览:
- 配置:/etc/cobbler/
- 数据:/var/lib/cobbler/(含 kickstarts、loaders、ks_mirror 等)
- 日志:/var/log/cobbler/
- 常见问题处理要点:
- 引导文件缺失:执行 cobbler get-loaders 下载 pxelinux.0、menu.c32 等;确保 /var/lib/cobbler/loaders 完整。
- DHCP 未下发或找不到启动文件:核对 dhcp.template 中 next-server、filename 与本机 IP 一致,执行 cobbler sync 后重启 isc-dhcp-server。
- 导入或仓库同步失败:安装并正确配置 debmirror,必要时调整 /etc/debmirror.conf 的 @dists/@arches 限制。