tftpd-hpa (tftpd)

一个轻量级的TFTP服务器（tftpd-hpa）

!Docker Image Version (latest by date) !Docker Image Size (latest by date) !Docker Pulls !GitHub Workflow Status

GitHub - 3x3cut0r/tftpd-hpa - []
DockerHub - 3x3cut0r/tftpd-hpa - []

1 使用方法

1.1 docker run

示例 1 - 无参数运行（将使用环境变量）：
这是推荐的容器使用方式！！！

shell
docker run -d \
    --name tftpd-hpa \
    -e TZ="Europe/Berlin" \
    -v /本地文件路径:/tftpboot \
    -p 69:69/udp \
    3x3cut0r/tftpd-hpa:latest

示例 2 - 使用指定环境变量运行：
CREATE=1：允许上传，即使文件不存在
MAPFILE=""：不使用映射文件

shell
docker run -d \
    --name tftpd-hpa \
    -e TZ="Europe/Berlin" \
    -e CREATE=1 \
    -e MAPFILE="" \
    -v /本地文件路径:/tftpboot \
    -p 69:69/udp \
    3x3cut0r/tftpd-hpa:latest

示例 3 - 使用参数运行（环境变量将被忽略）：
in.tftpd --foreground --address 0.0.0.0:69 --user tftp <你的参数>

shell
docker run -d \
    --name tftpd-hpa \
    -e TZ="Europe/Berlin" \
    -v /本地文件路径:/tftpboot \
    -p 69:69/udp \
    3x3cut0r/tftpd-hpa:latest \
    -c --secure --verbose /tftpboot

示例 4 - 使用参数运行（可选将'in.tftpd'作为第一个参数）：
in.tftpd --foreground --address 0.0.0.0:69 --user tftp <你的参数>

shell
docker run -d \
    --name tftpd-hpa \
    -e TZ="Europe/Berlin" \
    -v /本地文件路径:/tftpboot \
    -p 69:69/udp \
    3x3cut0r/tftpd-hpa:latest \
    in.tftpd -c --secure --verbose /tftpboot

示例 5 - 无参数运行并使用自定义映射文件：
你需要将映射文件挂载为数据卷

shell
docker run -d \
    --name tftpd-hpa \
    -e TZ="Europe/Berlin" \
    -e MAPFILE=/mapfile \
    -v /本地文件路径:/tftpboot \
    -v /你的映射文件路径:/mapfile \
    -p 69:69/udp \
    3x3cut0r/tftpd-hpa:latest

1.2 docker-compose.yaml

yaml
version: '3'

services:
  tftpd-hpa:
    image: 3x3cut0r/tftpd-hpa
    environment:
        TZ: Europe/Berlin
        CREATE: 1
        VERBOSE: 1
    volumes:
      - /本地文件路径:/tftpboot
    ports:
      - 69:69/udp

2 环境变量

更多信息请参见：[*]

TZ - 指定服务器时区 - 默认值：UTC
BLOCKSIZE - 指定允许的最大块大小
CREATE - 允许创建新文件 - 默认值：0（仅允许上传已存在的文件）
MAPFILE - 指定文件名重映射文件 - 默认值：/mapfile
（若不使用映射文件，留空即可）
PERMISSIVE - 不执行额外的权限检查 - 默认值：0
PORTRANGE - 强制服务器端口号（事务ID）在指定范围内 - 默认值：4096:32760
REFUSE - 指定永远不接受的RFC 2347 TFTP选项
RETRANSMIT - 指定第一个数据包重传前的默认超时时间（微秒） - 默认值：***（1秒）
SECURE - 启动时更改根目录 - 默认值：1
TIMEOUT - 指定等待第二个连接的超时时间（秒），超时后终止服务器 - 默认值：900
UMASK - 为新创建的文件设置umask
VERBOSE - 增加tftpd的日志详细程度 - 默认值：1
VERBOSITY - 设置详细程度值（0-4） - 默认值：3

3 数据卷

/tftpboot - TFTP根目录 -> 您的目录权限至少需要为0555（dr-xr-xr-x），所有者为root或uid=9069、gid=9069
/mapfile - tftpd-hpa的映射文件 -> 您的映射文件权限至少需要为0444（-r--r--r--），所有者为root或uid=9069、gid=9069