You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

Go to file

Tom Proctor 24095e4897 cmd/containerboot: serve health on local endpoint (#14246 ) * cmd/containerboot: serve health on local endpoint We introduced stable (user) metrics in #14035, and `TS_LOCAL_ADDR_PORT` with it. Rather than requiring users to specify a new addr/port combination for each new local endpoint they want the container to serve, this combines the health check endpoint onto the local addr/port used by metrics if `TS_ENABLE_HEALTH_CHECK` is used instead of `TS_HEALTHCHECK_ADDR_PORT`. `TS_LOCAL_ADDR_PORT` now defaults to binding to all interfaces on 9002 so that it works more seamlessly and with less configuration in environments other than Kubernetes, where the operator always overrides the default anyway. In particular, listening on localhost would not be accessible from outside the container, and many scripted container environments do not know the IP address of the container before it's started. Listening on all interfaces allows users to just set one env var (`TS_ENABLE_METRICS` or `TS_ENABLE_HEALTH_CHECK`) to get a fully functioning local endpoint they can query from outside the container. Updates #14035, #12898 Signed-off-by: Tom Proctor <tomhjp@users.noreply.github.com>		3 days ago
.bencher	bencher: add config to suppress failures on benchmark regressions.	3 years ago
.github	.github: Bump actions/setup-go from 5.0.2 to 5.1.0 (#13934 )	3 weeks ago
appc	appc: track metrics for route info storing	5 months ago
atomicfile	various: add golangci-lint, fix issues (#7905 )	2 years ago
chirp	all: update copyright and license headers	2 years ago
client	client/tailscale,ipn/{ipnlocal,localapi}: add a pre-shutdown localAPI endpoint that terminates control connections. (#14028 )	4 weeks ago
clientupdate	clientupdate: don't link distsign on platforms that don't download	2 months ago
cmd	cmd/containerboot: serve health on local endpoint (#14246 )	3 days ago
control	control/controlhttp: set *health.Tracker in tests	1 week ago
derp	derp/derphttp: don't link websockets other than on GOOS=js	4 weeks ago
disco	disco: correct noun for nacl box type in disco docs	12 months ago
docs	docs/windows/policy: update ADMX policy definitions to reflect the syspolicy settings	1 week ago
doctor	net/{interfaces,netmon}, all: merge net/interfaces package into net/netmon	7 months ago
drive	drive/driveimpl: use su instead of sudo	3 months ago
envknob	envknob,kube/kubetypes,cmd/k8s-operator: add app type for ProxyGroup (#14029 )	4 weeks ago
gokrazy	gokrazy, various: use point versions of Go and update Nix deps	3 months ago
health	health: move health metrics test to health_test	7 days ago
hostinfo	types/result, util/lineiter: add package for a result type, use it	4 weeks ago
internal	all: add test for package comments, fix, add comments as needed	5 months ago
ipn	ipn/localapi: count localapi requests to metric endpoints	1 week ago
jsondb	all: update copyright and license headers	2 years ago
k8s-operator	cmd/{containerboot,k8s-operator},k8s-operator: new options to expose user metrics (#14035 )	2 weeks ago
kube	cmd/k8s-operator,kube/kubeclient,docs/k8s: update rbac to emit events + small fixes (#14164 )	2 weeks ago
licenses	licenses: update license notices	2 weeks ago
log	log/sockstatlog: don't block for more than 5s on shutdown	5 months ago
logpolicy	cmd/tsconnect, logpolicy: fixes for wasm_js.go	2 months ago
logtail	logtail: avoid bytes.Buffer allocation (#11858 )	1 week ago
metrics	metrics: revert changes to MultiLabelMap's String method	2 months ago
net	net/netmon: improve panic reporting from #14202	1 week ago
omit	cmd/tailscaled, ipn/conffile: support ec2 user-data config file	6 months ago
packages/deb	go.mod: upgrade nfpm to v2 (#8786 )	1 year ago
paths	all: use Go 1.22 range-over-int	8 months ago
portlist	all: use Go 1.22 range-over-int	8 months ago
posture	control/controlclient,posture,util/syspolicy: use predefined syspolicy keys instead of string literals	3 months ago
prober	cmd/derpprobe,prober: add ability to restrict derpprobe to a single region	3 weeks ago
proxymap	ipnlocal,proxymap,wgengine/netstack: add optional WhoIs/proxymap debug	3 months ago
release	release/dist: clamp min / max version for synology package centre (#13857 )	2 months ago
safesocket	safesocket: don't depend on go-ps on iOS	2 months ago
safeweb	safeweb: add a Shutdown method to the Server type (#14048 )	4 weeks ago
scripts	scripts/installer.sh: allow Archcraft for Arch packages (#13870 )	1 month ago
sessionrecording	sessionrecording: implement v2 recording endpoint support (#14105 )	2 weeks ago
smallzstd	all: use Go 1.22 range-over-int	8 months ago
ssh/tailssh	sessionrecording: implement v2 recording endpoint support (#14105 )	2 weeks ago
syncs	syncs: allocate map with Map.WithLock (#13755 )	2 months ago
tailcfg	wgengine/filter: actually use the passed CapTestFunc [capver 109]	2 weeks ago
taildrop	taildrop: fix defer in loop (#13757 )	2 months ago
tempfork	cmd/tailscale: add shell tab-completion	8 months ago
tka	tka: truncate long rotation signature chains	3 months ago
tool	tool/gocross: remove trimpath from test builds	1 month ago
tsconst	cmd/tailscale/cli: support passing network lock keys via files	4 months ago
tsd	util/usermetrics: make usermetrics non-global	2 months ago
tsnet	tsnet: remove flaky test marker from metrics	7 days ago
tstest	tstest/integration/testcontrol: remove a vestigial unused parameter	3 weeks ago
tstime	all: use math/rand/v2 more	6 months ago
tsweb	tsweb: change RequestID format to have a date in it	2 weeks ago
types	all: use iterators over slice views more	3 weeks ago
util	cmd/checkmetrics: add command for checking metrics against kb	3 days ago
version	version: fix earlier test/wording mistakes	2 weeks ago
wf	wf/firewall: allow link-local multicast for permitted local routes when the killswitch is on on Windows	2 months ago
wgengine	wgengine/magicsock: packet/bytes metrics should not count disco	7 days ago
words	words: Add scoville to scales.txt (#14084 )	3 weeks ago
.gitattributes	.: add .gitattributes entry to use Go hunk-header driver	3 years ago
.gitignore	tstest/tailmac: add customized macOS virtualization tooling (#13146 )	4 months ago
.golangci.yml	ci: run 'go vet' in golangci-lint; fix errors in tests	1 year ago
ALPINE.txt	ALPINE.txt,Dockerfile{.base},build_docker.sh: bump alpine (#10543 )	12 months ago
AUTHORS	Move Linux client & common packages into a public repo.	5 years ago
CODEOWNERS	CODEOWNERS: add the start of an owners file	1 year ago
CODE_OF_CONDUCT.md	Add a code of conduct.	5 years ago
Dockerfile	all: switch to and require Go 1.23	3 months ago
Dockerfile.base	ALPINE.txt,Dockerfile{.base},build_docker.sh: bump alpine (#10543 )	12 months ago
LICENSE	all: update tools that manage copyright headers	2 years ago
Makefile	Makefile,./build_docker.sh: update kube operator image build target name (#14251 )	5 days ago
PATENTS	Move Linux client & common packages into a public repo.	5 years ago
README.md	all: switch to and require Go 1.23	3 months ago
SECURITY.md	Add a SECURITY.md for vulnerability reports.	5 years ago
VERSION.txt	VERSION.txt: this is v1.77.0 (#13779 )	2 months ago
api.md	{api.md,publicapi}: remove old API docs (#13468 )	3 months ago
assert_ts_toolchain_match.go	tailscaleroot: panic if tailscale_go build tag but Go toolchain mismatch	2 months ago
build_dist.sh	cmd/tailscale: add shell tab-completion	8 months ago
build_docker.sh	Makefile,./build_docker.sh: update kube operator image build target name (#14251 )	5 days ago
flake.lock	nix: update nix and use go 1.23	3 months ago
flake.nix	gokrazy, various: use point versions of Go and update Nix deps	3 months ago
go.mod	go.mod: bump tailscale/wireguard-go	3 weeks ago
go.mod.sri	go.mod.sri: update SRI hash for go.mod changes	3 months ago
go.sum	go.mod: bump tailscale/wireguard-go	3 weeks ago
go.toolchain.branch	all: switch to and require Go 1.23	3 months ago
go.toolchain.rev	go.toolchain.rev: bump from Go 1.23.1 to Go 1.23.3	3 weeks ago
gomod_test.go	go.mod: add test that replace directives aren't added in oss	1 year ago
header.txt	cmd/k8s-operator: operator can create subnetrouter (#9505 )	12 months ago
pkgdoc_test.go	all: add test for package comments, fix, add comments as needed	5 months ago
pull-toolchain.sh	pull-toolchain.sh: don't run update-flake.sh	2 years ago
shell.nix	go.mod.sri: update SRI hash for go.mod changes	3 months ago
staticcheck.conf	all: cleanup unused code, part 2 (#10670 )	12 months ago
update-flake.sh	Code Improvements (#11311 )	9 months ago
version-embed.go	tailscaleroot: panic if tailscale_go build tag but Go toolchain mismatch	2 months ago
version_tailscale_test.go	tailscaleroot: panic if tailscale_go build tag but Go toolchain mismatch	2 months ago
version_test.go	go.mod,wgengine/netstack: bump gvisor	11 months ago

README.md

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:

the Android app is at https://github.com/tailscale/tailscale-android
the Synology package is at https://github.com/tailscale/tailscale-synology
the QNAP package is at https://github.com/tailscale/tailscale-qpkg
the Chocolatey packaging is at https://github.com/tailscale/tailscale-chocolatey

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.23. (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 git log for our commit message style. It's basically the same as Go's style.

About Us

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

Legal

WireGuard is a registered trademark of Jason A. Donenfeld.