The easiest, most secure way to use WireGuard and 2FA.
Go to file
Brad Fitzpatrick b75921a7cb derp/derpserver: cache local peer lookups per client
Avoid taking Server.mu for repeated sends from a client to the same small set
of local peers. Each sclient now keeps a bounded, goroutine-local LRU of
destination public key to clientSet.

To cap memory for idle clients, cache entries track a coarsely updated
last-used time. The hot path refreshes that timestamp only when it is older
than 30 seconds, and incoming ping frames trim entries idle for more than 10
minutes. This keeps cleanup on the client run goroutine without adding
another mutex or background goroutine.

cmd/derper gets new --peer-cache-max-entries and --peer-cache-max-idle flags.
Their zero values use the automatic defaults, and --peer-cache-max-entries=-1
disables the cache.

The peer_lookup_cache_misses counter tracks how often lookupDest falls back
to the authoritative Server.mu lookup. We do not count hits on the hot path;
when the cache is enabled, hits can be derived from packets_received minus
peer_lookup_cache_misses.

This optimization is pulled out of the larger #13510 DERP flow-tracking work
from 2024, which did a bunch more. We can rebase that bigger PR later and
discuss its stats and memory impact on its own merits without losing this
standalone optimization.

The benchmark compares the same code with TS_DEBUG_DERP_DISABLE_PEER_CACHE
set true for the before run and the default cached path for the after run:

    TS_DEBUG_DERP_DISABLE_PEER_CACHE=true go test ./derp/derpserver -run '^$' -bench '^BenchmarkLookupDestPeerCache$' -benchtime=2s -count=10 > before

    go test ./derp/derpserver -run '^$' -bench '^BenchmarkLookupDestPeerCache$' -benchtime=2s -count=10 > after

    go run golang.org/x/perf/cmd/benchstat@latest before after

    goos: linux
    goarch: amd64
    pkg: tailscale.com/derp/derpserver
    cpu: Intel(R) Xeon(R) 6975P-C
                           │    before     │                after                │
                           │    sec/op     │   sec/op     vs base                │
    LookupDestPeerCache-16   180.400n ± 0%   5.720n ± 1%  -96.83% (p=0.000 n=10)

                           │   before   │             after              │
                           │    B/op    │    B/op     vs base            │
    LookupDestPeerCache-16   0.000 ± 0%   0.000 ± 0%  ~ (p=1.000 n=10) ¹
    ¹ all samples are equal

                           │   before   │             after              │
                           │ allocs/op  │ allocs/op   vs base            │
    LookupDestPeerCache-16   0.000 ± 0%   0.000 ± 0%  ~ (p=1.000 n=10) ¹
    ¹ all samples are equal

Updates #3560

Change-Id: Ie31b540447211fd9415eea6cc235b83a87930093
Signed-off-by: Brad Fitzpatrick <bradfitz@tailscale.com>
2026-05-12 13:04:07 -07:00
.bencher bencher: add config to suppress failures on benchmark regressions. 2021-10-01 16:16:02 -07:00
.github tstest/natlab, .github/workflows: add opt-in natlab CI workflow 2026-05-11 17:14:46 -07:00
appc appc, feature/conn25: handle exact and wildcard domains correctly (#19202) 2026-05-01 17:33:21 -04:00
atomicfile all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
chirp all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
client client/systray: fix recommended exit node not showing as selected (#19627) 2026-05-05 10:49:38 -03:00
clientupdate feature/clientupdate: windows update should use tailscale.exe update (#19438) 2026-04-17 10:28:35 -07:00
cmd derp/derpserver: cache local peer lookups per client 2026-05-12 13:04:07 -07:00
control control/controlhttp: use ws:// when HTTPSPort is NoPort in JS dialer 2026-05-06 15:58:58 -07:00
derp derp/derpserver: cache local peer lookups per client 2026-05-12 13:04:07 -07:00
disco disco: remove experimental label from BindUDPRelayHandshakeState 2026-03-24 11:04:11 -07:00
docs misc: add install-git-hooks.go and git hook for Change-Id tracking 2026-04-08 15:10:53 -07:00
doctor all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
drive cmd/vet/lowerell, drive/driveimpl: forbid variables named "l" or "I" 2026-05-04 14:03:28 -07:00
envknob envknob/logknob: remove unused package (#19515) 2026-04-24 15:48:06 -07:00
feature feature/conn25: return expired assignments to address pools 2026-05-08 14:33:06 -07:00
gokrazy go.mod, gokrazy: bump to fork of gokrazy/gokrazy init process for syslog change 2026-04-29 11:27:41 -07:00
health cmd/vet: add subtestnames analyzer; fix all existing violations 2026-04-05 15:52:51 -07:00
hostinfo all: use Go 1.26 things, run most gofix modernizers 2026-03-06 13:32:03 -08:00
internal cmd/tailscale/cli: allow fetching keys from AWS Parameter Store 2026-01-29 18:09:56 -05:00
ipn ipn/ipnlocal,wgengine/magicsock: add basic counters for cached peer connectivity (#19699) 2026-05-12 12:01:05 -07:00
jsondb all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
k8s-operator cmd/k8s-operator: add nodeSelector to DNSConfig resource (#19429) 2026-04-29 15:56:33 +01:00
kube all: migrate code off Notify.NetMap to Notify.SelfChange 2026-05-01 06:51:40 -07:00
licenses licenses: update license notices 2026-05-04 10:34:27 -07:00
log cmd/vet: add subtestnames analyzer; fix all existing violations 2026-04-05 15:52:51 -07:00
logpolicy all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
logtail logtail: run HTTP tests in-memory with memnet + synctest 2026-04-20 13:33:10 -07:00
metrics cmd/vet/lowerell, drive/driveimpl: forbid variables named "l" or "I" 2026-05-04 14:03:28 -07:00
misc misc/git_hook: propagate shared HOOK_VERSION (#19476) 2026-05-04 12:38:28 -04:00
net wgengine/netstack, net/ping: stop using pro-bing and use our net/ping instead 2026-05-04 14:05:24 -07:00
omit all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
packages/deb all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
paths all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
portlist portlist: also tb.Skip benchmarks (not just tests) on bad Linux kernels 2026-02-12 13:19:09 -08:00
posture posture: add HealthTracker for serial number retrieval (#19181) 2026-04-25 15:42:47 -03:00
prober all: use Go 1.26 things, run most gofix modernizers 2026-03-06 13:32:03 -08:00
proxymap all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
release release/dist/qnap: preserve .codesigning files as build artifacts 2026-04-28 12:29:56 +01:00
safesocket safesocket, ipn/ipnserver: use PeerCreds on solaris and illumos 2026-03-23 07:45:35 -07:00
safeweb safeweb: add CSRF token helpers and set cookie path to root (#19265) 2026-04-06 12:52:36 -04:00
scripts scripts/installer.sh: add openSUSE Slowroll as a Tumbleweed derivative (#19662) 2026-05-07 12:43:55 +01:00
sessionrecording cmd/vet: add subtestnames analyzer; fix all existing violations 2026-04-05 15:52:51 -07:00
ssh/tailssh ipn/ipnlocal, all: split LocalBackend.NetMap into NetMapNoPeers / NetMapWithPeers 2026-04-30 11:14:06 -07:00
syncs cmd/vet: add subtestnames analyzer; fix all existing violations 2026-04-05 15:52:51 -07:00
tailcfg tailcfg: add node capability for services in desktop clients (#19605) 2026-05-01 12:07:33 -07:00
tempfork misc/genreadme,tempfork/pkgdoc,tsnet: generate README.md files from godoc 2026-04-22 15:13:09 -07:00
tka tka,ipn: reduce boilerplate in Tailnet Lock tests 2026-05-07 21:49:27 +01:00
tool tool/updateflakes, cmd/nardump: replace update-flake.sh with Go tool 2026-04-28 10:18:32 -07:00
tsconsensus all: migrate code off Notify.NetMap to Notify.SelfChange 2026-05-01 06:51:40 -07:00
tsconst all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
tsd tsd, all: add Sys.ExtraRootCAs, plumb through TLS dial paths 2026-04-07 18:10:54 -07:00
tsnet tsnet: make workload identity federation opt-in 2026-05-06 18:43:45 -07:00
tstest ipn/ipnlocal,wgengine/magicsock: add basic counters for cached peer connectivity (#19699) 2026-05-12 12:01:05 -07:00
tstime all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
tsweb all: fix six tests that failed with -count=2 2026-04-13 18:52:57 -07:00
types wgengine, all: remove LazyWG, use wireguard-go callback API for on-demand peers 2026-04-29 19:46:19 -07:00
util util/eventbus: extract non-generic SubscriberFunc constructor body and cache type name 2026-05-12 11:16:04 -07:00
version version: use debug.ReadBuildInfo in CmdName on non-Windows 2026-04-24 09:48:11 -07:00
wf wf: allow limited broadcast to/from permitted interfaces when using an exit node on Windows 2026-01-23 18:30:38 -06:00
wgengine ipn/ipnlocal,wgengine/magicsock: add basic counters for cached peer connectivity (#19699) 2026-05-12 12:01:05 -07:00
wif wif: add AWS ecs for autogenerated OIDC tokens 2026-03-25 14:41:41 -06:00
words Add 'fish' to the list of scales 2026-03-27 08:41:33 +00:00
.gitattributes .: add .gitattributes entry to use Go hunk-header driver 2021-12-03 17:56:02 -08:00
.gitignore .gitignore: explicitly include tool/go.exe 2026-04-13 18:44:59 -07:00
.golangci.yml .golangci.yml: enforce gliderssh import alias via importas linter 2026-04-07 11:59:38 +01:00
.stignore Add .stignore for syncthing (#18540) 2026-01-27 16:15:17 -08:00
ALPINE.txt docker: bump alpine v3.19 -> 3.22 (#17155) 2025-09-17 20:22:24 +01:00
api.md {api.md,publicapi}: remove old API docs (#13468) 2024-09-13 14:10:33 -06:00
assert_ts_toolchain_match.go .: permit running binary built with TS_GO_NEXT=1 2026-02-23 09:37:04 -08:00
build_dist.sh build_dist.sh: keep --extra-small making a usable build, add --min 2025-10-06 21:15:25 -07:00
build_docker.sh docker: add riscv64 to container image architectures 2026-03-29 07:47:39 -07:00
cache_key_test.go tailscaleroot: add test that tsgo rev is in Go build cache keys 2026-04-13 10:17:22 -07:00
CODE_OF_CONDUCT.md CODE_OF_CONDUCT.md: update code of conduct 2025-10-28 08:58:00 -07:00
CODEOWNERS CODEOWNERS: add the start of an owners file 2023-08-16 15:57:29 -07:00
Dockerfile go.toolchain.branch: switch to Go 1.26 2026-03-04 21:57:05 -08:00
Dockerfile.base all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
flake.lock nix: update flakes to get a nixpkgs version with go 1.26 2026-03-06 04:06:57 -08:00
flake.nix wgengine/netstack, net/ping: stop using pro-bing and use our net/ping instead 2026-05-04 14:05:24 -07:00
flakehashes.json go.toolchain.rev: bump to Go 1.26.3 2026-05-07 15:33:05 -07:00
go.mod go.toolchain.rev: bump to Go 1.26.3 2026-05-07 15:33:05 -07:00
go.sum wgengine/netstack, net/ping: stop using pro-bing and use our net/ping instead 2026-05-04 14:05:24 -07:00
go.toolchain.branch go.toolchain.branch: switch to Go 1.26 2026-03-04 21:57:05 -08:00
go.toolchain.next.branch tool/gocross, pull-toolchain.sh: support a "next" Go toolchain 2026-01-27 14:07:35 -08:00
go.toolchain.next.rev go.toolchain.rev: bump to Go 1.26.3 2026-05-07 15:33:05 -07:00
go.toolchain.rev go.toolchain.rev: bump to Go 1.26.3 2026-05-07 15:33:05 -07:00
go.toolchain.version go.toolchain.rev: bump to Go 1.26.3 2026-05-07 15:33:05 -07:00
gomod_test.go all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
header.txt all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
LICENSE all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
license_test.go all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
Makefile tool/updateflakes, cmd/nardump: replace update-flake.sh with Go tool 2026-04-28 10:18:32 -07:00
PATENTS Move Linux client & common packages into a public repo. 2020-02-09 09:32:57 -08:00
pkgdoc_test.go cmd/vet/lowerell, drive/driveimpl: forbid variables named "l" or "I" 2026-05-04 14:03:28 -07:00
pull-toolchain.sh tool/updateflakes, cmd/nardump: replace update-flake.sh with Go tool 2026-04-28 10:18:32 -07:00
README.md README: update the version of Go in the README (#19168) 2026-03-28 22:21:41 -03:00
SECURITY.md Add a SECURITY.md for vulnerability reports. 2020-02-11 10:26:41 -08:00
shell.nix wgengine/netstack, net/ping: stop using pro-bing and use our net/ping instead 2026-05-04 14:05:24 -07:00
staticcheck.conf all: cleanup unused code, part 2 (#10670) 2023-12-21 17:40:03 -08:00
version_tailscale_test.go all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
version_test.go all: remove AUTHORS file and references to it 2026-01-23 15:49:45 -08:00
version-embed.go cmd/printdep: add --next flag to use rc Go build hash instead 2026-01-27 14:49:56 -08:00
VERSION.txt VERSION.txt: this is v1.99.0 (#19645) 2026-05-05 15:07:20 -04:00

Tailscale

https://tailscale.com

Private WireGuard® networks made easy

Overview

This repository contains the majority of Tailscale's open source code. Notably, it includes the tailscaled daemon and the tailscale CLI tool. The tailscaled daemon runs on Linux, Windows, macOS, and to varying degrees on FreeBSD and OpenBSD. The Tailscale iOS and Android apps use this repo's code, but this repo doesn't contain the mobile GUI code.

Other Tailscale repos of note:

For background on which parts of Tailscale are open source and why, see https://tailscale.com/opensource/.

Using

We serve packages for a variety of distros and platforms at https://pkgs.tailscale.com.

Other clients

The macOS, iOS, and Windows clients use the code in this repository but additionally include small GUI wrappers. The GUI wrappers on non-open source platforms are themselves not open source.

Building

We always require the latest Go release, currently Go 1.26. (While we build releases with our Go fork, its use is not required.)

go install tailscale.com/cmd/tailscale{,d}

If you're packaging Tailscale for distribution, use build_dist.sh instead, to burn commit IDs and version info into the binaries:

./build_dist.sh tailscale.com/cmd/tailscale
./build_dist.sh tailscale.com/cmd/tailscaled

If your distro has conventions that preclude the use of build_dist.sh, please do the equivalent of what it does in your distro's way, so that bug reports contain useful version information.

Bugs

Please file any issues about this code or the hosted service on the issue tracker.

Contributing

PRs welcome! But please file bugs. Commit messages should reference bugs.

We require Developer Certificate of Origin Signed-off-by lines in commits.

See commit-messages.md (or skim git log) for our commit message style.

About Us

Tailscale is primarily developed by the people at https://github.com/orgs/tailscale/people. For other contributors, see:

WireGuard is a registered trademark of Jason A. Donenfeld.