wastrachan/tftpd

tftpd Docker镜像

Docker容器化的tftpd服务，数据存储在卷中，且支持配置tftpd进程的UID/GID。

镜像概述和主要用途

本镜像将tftpd（简单文件传输协议守护进程）服务容器化，提供轻量、便捷的TFTP文件传输服务。适用于网络设备配置、嵌入式系统更新等需要通过TFTP协议传输文件的场景。核心特点包括数据持久化存储在卷中，支持自定义进程的用户ID（UID）和组ID（GID），确保多容器环境下的权限兼容性。

核心功能和特性

• 容器化部署：将tftpd服务打包为Docker镜像，简化部署流程并保证环境一致性
• 数据卷支持：通过/data卷实现文件数据的持久化存储，便于外部访问和管理
• 可配置权限：通过环境变量PUID和PGID自定义进程的用户和组标识符，适配多容器权限共享场景
• 标准协议兼容：默认使用UDP 69端口，完全符合TFTP协议规范

使用场景和适用范围

• 网络设备（路由器、交换机等）的固件升级与配置文件传输
• 嵌入式系统开发中的文件传输需求
• 局域网内无认证简单文件传输场景
• 多容器环境中需要统一权限管理的TFTP服务部署

安装

Docker Hub

从Docker Hub拉取最新镜像：

shell
docker pull docker.xuanyuan.run/wastrachan/tftpd

GitHub容器仓库

或从GitHub Container Registry拉取：

shell
docker pull ***-ghcr.xuanyuan.run/wastrachan/tftpd

从源码构建

克隆本仓库，运行make build构建镜像：

shell
git clone https://github.com/wastrachan/docker-tftpd.git
cd docker-tftpd
make build

运行

Docker

可通过make run快捷运行，或手动执行docker run命令：

shell
docker run -v "$(pwd)/data:/data" \
           --name tftpd \
           --rm \
           -p 69:69/udp \
           -e PUID=$(id -u) \
           -e PGID=$(id -g) \
           docker.xuanyuan.run/wastrachan/tftpd:latest

参数说明：

• -v "$(pwd)/data:/data"：将当前目录下的data目录挂载到容器的/data卷，用于存储TFTP服务文件
• --name tftpd：指定容器名称为tftpd
• --rm：容器停止后自动删除
• -p 69:69/udp：映射UDP 69端口（TFTP默认端口）
• -e PUID=$(id -u)：设置tftpd进程的用户ID为当前用户ID
• -e PGID=$(id -g)：设置tftpd进程的组ID为当前用户组ID

配置

用户/组标识符

如需自定义tftpd进程的UID和GID，可通过环境变量PUID和PGID实现。这在其他容器需要访问配置卷时非常有用，可确保权限一致性。

服务端口

卷

许可证

本项目内容本身采用MIT许可证授权。