This directory contains code examples that use tailscale-rs from Rust.

For all the examples, you'll need:

• A working Rust development environment that meets the MSRV
• A tailnet set up and Tailscale (the Go client) installed on your local machine
• An auth key registered for the tailnet, referred to as $AUTH_KEY below
  • For one-off keys, do not follow the "Register a node with the auth key" section! The examples take care of that for you
• A tailnet policy configured to allow access between your local machine and the example code

Also note the TS_RS_EXPERIMENT=this_is_unstable_software environment variable in all the examples below; for an explanation, see the Caveats section of the README.

Brief descriptions and links to each example.

An axum-based HTTP server that serves a simple webpage over the tailnet.

A UDP client that sends "hello" to a tailnet peer on a configurable interval.

A TCP server that listens on the tailnet and echoes input back to the sender.

A TUI app served over an in-process SSH server which allows you to query info about peers on your tailnet.