FX-TFTP Build Status Gem Yard Docs


FX-TFTP is a slightly over-OO-ed pure-Ruby implementation of plain RFC1350 TFTP server. It is very flexible and intended for hacking. Also, and more importantly, it works, contrary to other gems that are occupying space at RubyGems.

That flexibility may be useful if you're planning on massive custom TFTP-based boots, or if you're into ~~hacking~~ researching cheap router security. The request packets parsing has been relaxed so that it should work with TFTP clients that use some fancy extensions. I have tested the server on Linux x86_64 with Ruby 2.2.0 and on FreeBSD amd64 with Ruby 1.9.3p194, and it successfully exchanged data both ways with clients running on numerous platforms.

The included tftpd executable gives you a fully-fledged read-write TFTP server that also does logging, daemon mode and does not crap out on SIGTERM.


Just in case you need an easy to use tftp server... Install via Rubygems:

$ gem install fx-tftp

Then start the beast with any directory you want to serve (works for uploads and downloads as well):

$ sudo tftpd ~/router_firmwares_and_config_files/

Further options:

$ tftpd
Usage: tftpd [OPTIONS] DIR
    -V, --version                    Show version and exit
    -a, --address ADDRESS            Address to listen on (default:
    -p, --port PORT                  Port to listen on (default: 69)
    -v, --verbose                    Enable verbose output


Suppose we want to have a TFTP server that only supports reading, but the files served should depend on the IP block the client is connecting from:

class CustomHandler < TFTP::Handler::RWSimple
    ip = src.remote_address.ip_address.split('.')
    block = ip.slice(0, 3).join('-')
    req.filename = File.join(block, req.filename)
    log :info, "#{tag} Mapped filename to #{req.filename}"
    super(tag, req, sock, src)

srv = TFTP::Server::Base.new(CustomHandler.new(path, :no_write => true), opts)

When you combine filename inspection and #send and #recv methods working on plain IO objects you can easily whip up things like serving dynamically built scripts/binaries/archives based on parameters passed as the requested 'filename'.


Fell free to contributed patches using the common GitHub model (descried below). I'm also interested in cases where something doesn't work (weird platforms etc.). If you feel like it please write the client side.

  • Fork the repo
  • Checkout a new branch for your changes
  • Write code and tests, check, commit
  • Make a Pull Request


Standard two-clause BSD license, see LICENSE.txt for details.

Copyright © 2015 - 2016 Piotr S. Staszewski