taskinen/tftp

TFTP服务器

镜像概述

本镜像提供一个运行在Alpine Linux上的Docker化tftp-hpa服务器。tftp-hpa是一款轻量级、高效的TFTP（简单文件传输协议）服务器实现，适用于需要通过TFTP协议进行文件传输的场景。

核心功能和特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低
• 标准协议支持：完全兼容TFTP协议（RFC 1350），支持文件上传和下载
• 持久化存储：通过卷挂载实现文件持久化，支持只读模式保障文件安全
• 易于部署：提供简单的Docker Compose配置示例，快速启动服务

使用场景和适用范围

• 网络设备（如路由器、交换机）的配置文件传输
• PXE启动环境搭建，用于无盘工作站或操作系统安装
• 嵌入式设备的固件更新和程序下载
• 局域网内简单的文件共享（适合小文件传输）

使用方法和配置说明

Docker Compose部署

以下是使用Docker Compose部署TFTP服务器的示例配置：

yaml
version: '2'

services:
  server:
    image: docker.xuanyuan.run/taskinen/tftp
    ports:
      - "69:69/udp"  # TFTP协议默认使用UDP 69端口
    volumes:
      - /var/docker-volumes/tftp/tftpboot:/var/tftpboot:ro  # 挂载本地目录作为TFTP根目录，只读模式
    restart: unless-stopped  # 除非手动停止，否则自动重启服务

Docker Run命令部署

也可通过以下docker run命令直接启动服务：

bash
docker run -d \
  --name tftp-server \
  -p 69:69/udp \
  -v /var/docker-volumes/tftp/tftpboot:/var/tftpboot:ro \
  --restart unless-stopped \
  docker.xuanyuan.run/taskinen/tftp

配置参数说明

• 端口映射：必须映射UDP 69端口，这是TFTP协议的默认端口
• 卷挂载：/var/tftpboot是容器内的TFTP根目录，建议挂载本地目录实现文件持久化。使用:ro参数设置为只读模式，可防止客户端意外修改文件
• 重启策略：unless-stopped确保服务在意外退出时自动恢复，提高服务可用性

客户端使用示例

使用TFTP客户端从服务器下载文件：

bash
tftp <服务器IP>
tftp> get example.txt  # 下载文件
tftp> quit

上传文件到服务器（需确保服务器目录有写权限，默认配置为只读，如需上传需移除:ro参数）：

bash
tftp <服务器IP>
tftp> put localfile.txt  # 上传文件
tftp> quit