The easiest, most secure way to use WireGuard and 2FA.
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>
2024-12-02 12:18:09 +00:00
.bencher bencher: add config to suppress failures on benchmark regressions. 2021-10-01 16:16:02 -07:00
.github .github: Bump actions/setup-go from 5.0.2 to 5.1.0 (#13934) 2024-11-13 10:56:44 -07:00
appc appc: track metrics for route info storing 2024-07-12 10:39:48 -07:00
atomicfile various: add golangci-lint, fix issues (#7905) 2023-04-17 18:38:24 -04:00
chirp all: update copyright and license headers 2023-01-27 15:36:29 -08:00
client client/tailscale,ipn/{ipnlocal,localapi}: add a pre-shutdown localAPI endpoint that terminates control connections. (#14028) 2024-11-07 19:27:53 +00:00
clientupdate clientupdate: don't link distsign on platforms that don't download 2024-10-10 06:32:50 -07:00
cmd cmd/containerboot: serve health on local endpoint (#14246) 2024-12-02 12:18:09 +00:00
control control/controlhttp: set *health.Tracker in tests 2024-11-26 18:05:05 -05:00
derp derp/derphttp: don't link websockets other than on GOOS=js 2024-11-07 22:29:41 -08:00
disco disco: correct noun for nacl box type in disco docs 2023-12-14 16:41:53 -08:00
docs docs/windows/policy: update ADMX policy definitions to reflect the syspolicy settings 2024-11-25 10:49:22 -06:00
doctor net/{interfaces,netmon}, all: merge net/interfaces package into net/netmon 2024-04-28 07:34:52 -07:00
drive drive/driveimpl: use su instead of sudo 2024-08-29 16:23:03 -05:00
envknob envknob,kube/kubetypes,cmd/k8s-operator: add app type for ProxyGroup (#14029) 2024-11-07 12:42:29 +00:00
gokrazy gokrazy, various: use point versions of Go and update Nix deps 2024-09-16 16:06:43 -04:00
health health: move health metrics test to health_test 2024-11-28 15:00:26 +01:00
hostinfo types/result, util/lineiter: add package for a result type, use it 2024-11-05 10:27:52 -08:00
internal all: add test for package comments, fix, add comments as needed 2024-07-10 09:57:00 -07:00
ipn ipn/localapi: count localapi requests to metric endpoints 2024-11-27 09:25:06 +00:00
jsondb all: update copyright and license headers 2023-01-27 15:36:29 -08:00
k8s-operator cmd/{containerboot,k8s-operator},k8s-operator: new options to expose user metrics (#14035) 2024-11-22 15:41:07 +00:00
kube cmd/k8s-operator,kube/kubeclient,docs/k8s: update rbac to emit events + small fixes (#14164) 2024-11-20 14:22:34 +00:00
licenses licenses: update license notices 2024-11-19 09:25:57 -08:00
log log/sockstatlog: don't block for more than 5s on shutdown 2024-07-12 17:50:11 +01:00
logpolicy cmd/tsconnect, logpolicy: fixes for wasm_js.go 2024-10-16 09:39:48 -07:00
logtail logtail: avoid bytes.Buffer allocation (#11858) 2024-11-27 11:18:04 -08:00
metrics metrics: revert changes to MultiLabelMap's String method 2024-09-25 19:20:50 -04:00
net net/netmon: improve panic reporting from #14202 2024-11-25 12:31:24 -08:00
omit cmd/tailscaled, ipn/conffile: support ec2 user-data config file 2024-05-30 09:49:18 -07:00
packages/deb go.mod: upgrade nfpm to v2 (#8786) 2023-08-03 13:00:45 -07:00
paths all: use Go 1.22 range-over-int 2024-04-16 15:32:38 -07:00
portlist all: use Go 1.22 range-over-int 2024-04-16 15:32:38 -07:00
posture control/controlclient,posture,util/syspolicy: use predefined syspolicy keys instead of string literals 2024-09-04 15:25:19 -05:00
prober cmd/derpprobe,prober: add ability to restrict derpprobe to a single region 2024-11-15 13:42:58 -06:00
proxymap ipnlocal,proxymap,wgengine/netstack: add optional WhoIs/proxymap debug 2024-09-10 14:23:33 -07:00
release release/dist: clamp min / max version for synology package centre (#13857) 2024-10-18 14:20:40 -06:00
safesocket safesocket: don't depend on go-ps on iOS 2024-10-09 18:35:53 -07:00
safeweb safeweb: add a Shutdown method to the Server type (#14048) 2024-11-08 10:02:16 -08:00
scripts scripts/installer.sh: allow Archcraft for Arch packages (#13870) 2024-10-21 18:13:06 +01:00
sessionrecording sessionrecording: implement v2 recording endpoint support (#14105) 2024-11-18 09:55:54 -08:00
smallzstd all: use Go 1.22 range-over-int 2024-04-16 15:32:38 -07:00
ssh/tailssh sessionrecording: implement v2 recording endpoint support (#14105) 2024-11-18 09:55:54 -08:00
syncs syncs: allocate map with Map.WithLock (#13755) 2024-10-09 14:03:37 -07:00
tailcfg wgengine/filter: actually use the passed CapTestFunc [capver 109] 2024-11-19 19:18:35 +00:00
taildrop taildrop: fix defer in loop (#13757) 2024-10-09 14:09:58 -07:00
tempfork cmd/tailscale: add shell tab-completion 2024-04-17 18:54:10 +01:00
tka tka: truncate long rotation signature chains 2024-09-04 22:17:21 +01:00
tool tool/gocross: remove trimpath from test builds 2024-10-28 16:10:55 -07:00
tsconst cmd/tailscale/cli: support passing network lock keys via files 2024-08-14 09:18:34 -07:00
tsd util/usermetrics: make usermetrics non-global 2024-09-25 15:57:00 +02:00
tsnet tsnet: remove flaky test marker from metrics 2024-11-28 15:00:26 +01:00
tstest tstest/integration/testcontrol: remove a vestigial unused parameter 2024-11-15 10:05:35 -08:00
tstime all: use math/rand/v2 more 2024-06-05 15:24:04 -07:00
tsweb tsweb: change RequestID format to have a date in it 2024-11-20 15:55:09 -08:00
types all: use iterators over slice views more 2024-11-11 13:22:34 -08:00
util cmd/checkmetrics: add command for checking metrics against kb 2024-12-02 10:30:46 +01:00
version version: fix earlier test/wording mistakes 2024-11-19 10:59:21 -08:00
wf wf/firewall: allow link-local multicast for permitted local routes when the killswitch is on on Windows 2024-10-02 18:36:01 -05:00
wgengine wgengine/magicsock: packet/bytes metrics should not count disco 2024-11-28 15:00:26 +01:00
words words: Add scoville to scales.txt (#14084) 2024-11-13 09:25:12 -08:00
.gitattributes .: add .gitattributes entry to use Go hunk-header driver 2021-12-03 17:56:02 -08:00
.gitignore tstest/tailmac: add customized macOS virtualization tooling (#13146) 2024-08-19 15:01:19 -04:00
.golangci.yml ci: run 'go vet' in golangci-lint; fix errors in tests 2023-12-07 15:08:28 -05:00
ALPINE.txt ALPINE.txt,Dockerfile{.base},build_docker.sh: bump alpine (#10543) 2023-12-11 07:03:18 +00:00
api.md {api.md,publicapi}: remove old API docs (#13468) 2024-09-13 14:10:33 -06:00
assert_ts_toolchain_match.go tailscaleroot: panic if tailscale_go build tag but Go toolchain mismatch 2024-10-06 15:22:04 -07:00
AUTHORS Move Linux client & common packages into a public repo. 2020-02-09 09:32:57 -08:00
build_dist.sh cmd/tailscale: add shell tab-completion 2024-04-17 18:54:10 +01:00
build_docker.sh Makefile,./build_docker.sh: update kube operator image build target name (#14251) 2024-11-29 15:32:18 +00:00
CODE_OF_CONDUCT.md Add a code of conduct. 2020-02-10 22:16:30 -08:00
CODEOWNERS CODEOWNERS: add the start of an owners file 2023-08-16 15:57:29 -07:00
Dockerfile all: switch to and require Go 1.23 2024-08-22 12:31:08 -07:00
Dockerfile.base ALPINE.txt,Dockerfile{.base},build_docker.sh: bump alpine (#10543) 2023-12-11 07:03:18 +00:00
flake.lock nix: update nix and use go 1.23 2024-08-29 17:25:13 +02:00
flake.nix gokrazy, various: use point versions of Go and update Nix deps 2024-09-16 16:06:43 -04:00
go.mod go.mod: bump tailscale/wireguard-go 2024-11-16 15:31:07 -08:00
go.mod.sri go.mod.sri: update SRI hash for go.mod changes 2024-09-05 10:06:02 -07:00
go.sum go.mod: bump tailscale/wireguard-go 2024-11-16 15:31:07 -08:00
go.toolchain.branch all: switch to and require Go 1.23 2024-08-22 12:31:08 -07:00
go.toolchain.rev go.toolchain.rev: bump from Go 1.23.1 to Go 1.23.3 2024-11-14 10:57:49 -08:00
gomod_test.go go.mod: add test that replace directives aren't added in oss 2023-09-29 12:31:52 -07:00
header.txt cmd/k8s-operator: operator can create subnetrouter (#9505) 2023-12-14 13:51:59 +00:00
LICENSE all: update tools that manage copyright headers 2023-01-27 15:36:29 -08:00
Makefile Makefile,./build_docker.sh: update kube operator image build target name (#14251) 2024-11-29 15:32:18 +00:00
PATENTS Move Linux client & common packages into a public repo. 2020-02-09 09:32:57 -08:00
pkgdoc_test.go all: add test for package comments, fix, add comments as needed 2024-07-10 09:57:00 -07:00
pull-toolchain.sh pull-toolchain.sh: don't run update-flake.sh 2023-02-09 15:04:01 -08:00
README.md all: switch to and require Go 1.23 2024-08-22 12:31:08 -07:00
SECURITY.md Add a SECURITY.md for vulnerability reports. 2020-02-11 10:26:41 -08:00
shell.nix go.mod.sri: update SRI hash for go.mod changes 2024-09-05 10:06:02 -07:00
staticcheck.conf all: cleanup unused code, part 2 (#10670) 2023-12-21 17:40:03 -08:00
update-flake.sh Code Improvements (#11311) 2024-03-08 15:24:36 -08:00
version_tailscale_test.go tailscaleroot: panic if tailscale_go build tag but Go toolchain mismatch 2024-10-06 15:22:04 -07:00
version_test.go go.mod,wgengine/netstack: bump gvisor 2024-01-19 18:23:53 -08:00
version-embed.go tailscaleroot: panic if tailscale_go build tag but Go toolchain mismatch 2024-10-06 15:22:04 -07:00
VERSION.txt VERSION.txt: this is v1.77.0 (#13779) 2024-10-10 11:34:14 -07: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.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:

WireGuard is a registered trademark of Jason A. Donenfeld.