aguslr/atftpd

aguslr/docker-atftpd

镜像概述

该Docker镜像在容器中部署atftpd服务，提供TFTP（ trivial file transfer protocol）服务器功能。atftpd是一个客户端/服务器模式的TFTP协议实现，支持RFCs 1350、2090、2347、2348、2349和7440标准，适用于通过网络传输文件，尤其适合PXE启动环境。

核心功能与特性

• 实现多种TFTP相关RFC标准，支持高级TFTP功能
• 轻量级Docker容器部署，易于集成到现有网络环境
• 支持自定义GRUB启动条目，灵活配置网络启动选项
• 可通过卷挂载方式扩展文件存储，方便管理镜像文件

使用场景

• 搭建PXE网络启动服务器，实现无盘工作站启动
• 网络设备固件升级时的TFTP文件传输
• 大规模计算机集群的网络启动部署
• 嵌入式设备开发中的文件传输服务

使用方法与配置说明

快速启动

1. 直接运行容器：

bash
docker run -p 69:69/udp \
  docker.io/aguslr/atftpd:latest

2. 配置PXE服务器连接到TFTP服务器IP（例如192.168.1.10）。以下是dnsmasq的配置示例：

bash
dhcp-match=set:bios,option:client-arch,0
dhcp-match=set:efi32,option:client-arch,6
dhcp-match=set:efi64,option:client-arch,7
dhcp-match=set:efi64,option:client-arch,9
dhcp-boot=tag:bios,grub/i386-pc/core.0,tfp.lan,192.168.1.10
dhcp-boot=tag:efi32,grub/i386-efi/core.efi,tfp.lan,192.168.1.10
dhcp-boot=tag:efi64,grub/x86_64-efi/core.efi,tfp.lan,192.168.1.10

自定义GRUB启动条目

创建custom.cfg文件添加额外GRUB菜单条目（以netboot.xyz为例）：

bash
menuentry --hotkey=n "netboot.xyz" {
  if [ "$_EFI" == true ]; then
    if [ "$_ARM64" == true ]; then
      chainloader disks/netboot.xyz/boot-arm64.efi
    else
      chainloader disks/netboot.xyz/boot.efi
    fi
  else
    linux16 grub/memdisk iso raw
    initrd16 disks/netboot.xyz/boot.iso
  fi
}

将必要的镜像文件放入./disks目录，并通过卷挂载启动容器：

bash
docker run -p 69:69/udp \
  -v "${PWD}"/disks:/data/disks \
  -v "${PWD}"/custom.cfg:/data/grub/custom.cfg \
  docker.io/aguslr/atftpd:latest

本地构建镜像

如需本地构建而非拉取远程镜像：

1. 克隆仓库：

bash
git clone https://github.com/aguslr/docker-atftpd.git

2. 进入目录并使用docker-compose构建启动：

bash
cd docker-atftpd && docker-compose up --build -d

参考资料

• TFTP - Debian Wiki
• TFTP - ArchWiki
• https://github.com/csclabs/atftpd
• PXE（使用grub2）—— Linux指南与提示