townos-tunneld
The privileged helper for Town OS tunnels.
A daemon, not a library, and not much use on its own — install it alongside
townos-desktop, which is what talks
to it.
Creating a WireGuard interface, setting its key, and adding its addresses and
routes need CAP_NET_ADMIN. A desktop application that also parses network
responses and draws a window must not hold that, so the capability lives here
instead: a few hundred lines with no window, no network client, and one job. It
listens on /run/town-os/tunneld.sock and answers three requests.
It takes no path from the client and opens no file the client names. The config arrives as text on the socket, so root never opens a path the caller can write.
Linux only. DNS for a tunnel is handed to systemd-resolved.
See CHANGELOG.md for what changed.
Licence
AGPL-3.0-only. See LICENSE.