jumanjiman/tftp-hpa

tftp-hpa（tftpd）容器镜像

https://images.microbadger.com/badges/image/jumanjiman/tftp-hpa.svg](http://microbadger.com/images/jumanjiman/tftp-hpa "View on microbadger.com") https://images.microbadger.com/badges/version/jumanjiman/tftp-hpa.svg](http://microbadger.com/images/jumanjiman/tftp-hpa "View on microbadger.com") https://images.microbadger.com/badges/commit/jumanjiman/tftp-hpa.svg](http://microbadger.com/images/jumanjiman/tftp-hpa "View on microbadger.com") https://img.shields.io/docker/pulls/jumanjiman/tftp-hpa.svg](https://registry.hub.docker.com/u/jumanjiman/tftp-hpa) https://circleci.com/gh/jumanjihouse/docker-tftp-hpa.png?circle-token=a96c1956a20bb93a08f94b755d845b2ba0e324b2](https://circleci.com/gh/jumanjihouse/docker-tftp-hpa/tree/master 'View CI builds')

项目地址：https://github.com/jumanjihouse/docker-tftp-hpa
镜像仓库：https://registry.hub.docker.com/u/jumanjiman/tftp-hpa/

镜像概述

本镜像用于构建https://git.kernel.org/cgit/network/tftp/tftp-hpa.git/%E6%9C%8D%E5%8A%A1%E5%AE%B9%E5%99%A8%EF%BC%8C%E5%9F%BA%E4%BA%8E%E8%BD%BB%E9%87%8F%E7%BA%A7Alpine Linux（运行时镜像约9MB），包含H. Peter Anvin开发的TFTP服务器、可覆盖的默认配置、PXE所需的syslinux文件及路径重写map文件，平衡轻量性与灵活性，支持结合自定义数据卷扩展基础设施引导能力。

核心功能

1. 轻量TFTP服务：基于Alpine Linux，资源占用低
2. 可扩展配置：默认配置可通过挂载卷覆盖
3. PXE支持：内置syslinux文件满足启动引导需求
4. 路径重写：提供map文件实现请求路径调整
5. 版本可追溯：CI生成带时间戳和Git哈希的标签，支持固定版本拉取

使用场景

• 企业内部基础设施PXE启动引导
• 网络设备固件升级的TFTP服务提供
• 开发测试环境的TFTP文件传输需求

配置说明

拉取镜像

bash
docker pull docker.xuanyuan.run/jumanjiman/tftp-hpa

查看镜像内文件

列出/tftpboot目录下的syslinux相关文件：

bash
docker run --rm -t \
  --entrypoint=/bin/sh \
  docker.xuanyuan.run/jumanjiman/tftp-hpa -c "find /tftpboot -type f"

加载NetFilter模块

添加TFTP连接跟踪模块：

bash
sudo modprobe nf_conntrack_tftp
sudo modprobe nf_nat_tftp

运行容器

基础运行（默认配置）

bash
docker run -d -p 69:69/udp docker.xuanyuan.run/jumanjiman/tftp-hpa

自定义pxelinux.cfg

挂载自定义配置覆盖默认：

bash
docker run -d -p 69:69/udp \
  -v /path/to/your/pxelinux.cfg:/tftpboot/pxelinux.cfg:ro \
  docker.xuanyuan.run/jumanjiman/tftp-hpa

自定义map文件

同时挂载路径重写文件：

bash
docker run -d -p 69:69/udp \
  -v /path/to/your/pxelinux.cfg:/tftpboot/pxelinux.cfg:ro \
  -v /path/to/your/mapfile:/tftpboot/rules/default:ro \
  docker.xuanyuan.run/jumanjiman/tftp-hpa

添加自定义启动文件

挂载站点本地启动资源：

bash
docker run -d -p 69:69/udp \
  -v /path/to/your/pxelinux.cfg:/tftpboot/pxelinux.cfg:ro \
  -v /path/to/your/bootfiles:/tftpboot/site:ro \
  docker.xuanyuan.run/jumanjiman/tftp-hpa

Systemd自动启动

1. 复制示例单元文件：

bash
sudo cp systemd/tftp-hpa.service /etc/systemd/system/

2. 重载并启用服务：

bash
sudo systemctl daemon-reload
sudo systemctl start tftp-hpa
sudo systemctl enable tftp-hpa

构建镜像

bash
script/build
script/test

发布到私有仓库

bash
docker tag tftp-hpa registry_id/your_id/tftp-hpa
docker push registry_id/your_id/tftp-hpa

贡献

参考仓库CONTRIBUTING.md。

许可协议

参考仓库LICENSE。