Mirror of tailscale/tailscale@github.com
Go to file
Brad Fitzpatrick c1e6888fc7 derp: add a README.md with some docs
Updates #docs

Signed-off-by: Brad Fitzpatrick <bradfitz@tailscale.com>
2023-05-02 13:42:25 -07:00
.bencher bencher: add config to suppress failures on benchmark regressions. 2021-10-01 16:16:02 -07:00
.github .github: test installer script in CI in docker 2023-04-29 08:48:19 +01: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/tailscale various: add golangci-lint, fix issues (#7905) 2023-04-17 18:38:24 -04:00
cmd cmd/sniproxy: Set App name in tsnet hostinfo 2023-04-28 21:50:30 -07:00
control control/controlclient: use dnscache.Resolver for Noise client 2023-05-01 13:22:10 -07:00
derp derp: add a README.md with some docs 2023-05-02 13:42:25 -07:00
disco all: update to Go 1.20, use strings.CutPrefix/Suffix instead of our fork 2023-02-01 15:23:54 -08:00
docs all: update copyright and license headers 2023-01-27 15:36:29 -08:00
doctor doctor/permissions: add new check to print process permissions 2023-03-29 11:50:23 -04:00
envknob envknob,net/tstun,wgengine: use TS_DEBUG_MTU consistently 2023-03-30 14:26:10 -07:00
health health, net/tlsdial: add healthcheck for self-signed cert 2023-02-01 23:17:41 -05:00
hostinfo ci: add more lints (#7909) 2023-04-19 21:54:19 -04:00
internal/tooldeps various: add golangci-lint, fix issues (#7905) 2023-04-17 18:38:24 -04:00
ipn ipn/ipnlocal: fix fmt format arg type mismatch in log line 2023-04-26 14:28:09 -07:00
jsondb all: update copyright and license headers 2023-01-27 15:36:29 -08:00
kube ipn/store: add support for stores to hook into a custom dialer 2023-03-29 16:35:46 -07:00
licenses licenses: update win/apple licenses 2023-05-01 09:13:43 -07:00
log all: avoid repeated default interface lookups 2023-04-20 15:46:01 -07:00
logpolicy all: avoid repeated default interface lookups 2023-04-20 15:46:01 -07:00
logtail all: move network monitoring from wgengine/monitor to net/netmon 2023-04-20 10:15:59 -07:00
metrics metrics: add SetInt64 to ease using LabelMap for gauge metrics 2023-02-18 17:43:43 +00:00
net net/tstun: handle exit nodes in NAT configs 2023-05-02 13:03:30 -07:00
packages/deb all: update copyright and license headers 2023-01-27 15:36:29 -08:00
paths all: update copyright and license headers 2023-01-27 15:36:29 -08:00
portlist various: add golangci-lint, fix issues (#7905) 2023-04-17 18:38:24 -04:00
prober all: avoid repeated default interface lookups 2023-04-20 15:46:01 -07:00
release release/dist/cli: add --verbose to print subcommand output 2023-03-01 17:16:31 -08:00
safesocket safesocket: enable test to run on Windows unpriviliged 2023-04-19 19:06:18 -07:00
scripts .github: test installer script in CI in docker 2023-04-29 08:48:19 +01:00
smallzstd all: update copyright and license headers 2023-01-27 15:36:29 -08:00
ssh/tailssh ssh/tailssh: improve debug logging around revoked sessions 2023-05-01 14:10:16 -07:00
syncs syncs: add Map.Len to get the length of the Map 2023-04-27 19:10:28 -07:00
tailcfg ssh/tailssh: handle dialing multiple recorders and failing open 2023-04-22 10:23:13 -07:00
tempfork net/tstun/table: add initial RoutingTable implementation 2023-03-29 12:30:18 -07:00
tka various: add golangci-lint, fix issues (#7905) 2023-04-17 18:38:24 -04:00
tool various: add golangci-lint, fix issues (#7905) 2023-04-17 18:38:24 -04:00
tsconst all: update copyright and license headers 2023-01-27 15:36:29 -08:00
tsnet all: avoid repeated default interface lookups 2023-04-20 15:46:01 -07:00
tstest all: move network monitoring from wgengine/monitor to net/netmon 2023-04-20 10:15:59 -07:00
tstime tstime/rate: add Value (#7491) 2023-03-09 11:13:09 -08:00
tsweb tsweb: move varz handler(s) into separate modules 2023-04-11 08:37:32 +01:00
types net/packet: add NAT support for DCCP and GRE 2023-04-24 15:30:50 -07:00
util various: add golangci-lint, fix issues (#7905) 2023-04-17 18:38:24 -04:00
version version/mkversion: don't break on tagged go.mod entries 2023-03-14 14:25:18 -07:00
wf all: update copyright and license headers 2023-01-27 15:36:29 -08:00
wgengine wgengine/magicsock: add hysteresis to endpoint selection 2023-05-02 08:56:16 -07:00
words words: charlotte 1 spell-checking-linter 0 (#7993) 2023-04-27 08:58:52 -07:00
.gitattributes .: add .gitattributes entry to use Go hunk-header driver 2021-12-03 17:56:02 -08:00
.gitignore release: open-source release build logic for unix packages 2023-02-24 21:31:09 +00:00
.golangci.yml ci: add more lints (#7909) 2023-04-19 21:54:19 -04:00
ALPINE.txt Docker: add ALPINE.txt to manage alpine versions 2022-06-29 11:47:09 -07:00
AUTHORS Move Linux client & common packages into a public repo. 2020-02-09 09:32:57 -08:00
CODE_OF_CONDUCT.md Add a code of conduct. 2020-02-10 22:16:30 -08:00
Dockerfile Dockerfile: fix docker build 2023-02-14 00:59:09 +00:00
Dockerfile.base all: update copyright and license headers 2023-01-27 15:36:29 -08:00
LICENSE all: update tools that manage copyright headers 2023-01-27 15:36:29 -08:00
Makefile Makefile: add help text to Makefile 2023-02-16 22:39:09 +00:00
PATENTS Move Linux client & common packages into a public repo. 2020-02-09 09:32:57 -08:00
README.md all: update to Go 1.20, use strings.CutPrefix/Suffix instead of our fork 2023-02-01 15:23:54 -08:00
SECURITY.md Add a SECURITY.md for vulnerability reports. 2020-02-11 10:26:41 -08:00
VERSION.txt VERSION.txt: this is v1.41.0 2023-04-26 15:58:30 -07:00
api.md api.md: update example auth key value 2023-04-14 11:35:33 -07:00
build_dist.sh build_dist.sh: make cross-compilation friendly for env CC specified 2023-04-27 18:51:59 -07:00
build_docker.sh Dockerfile: fix docker build 2023-02-14 00:59:09 +00:00
flake.lock nix: update nixpkgs flake, override go_1_20 for tailscale_go (#7139) 2023-02-01 12:27:04 -05:00
flake.nix go.mod.sri: update SRI hash for go.mod changes 2023-04-21 21:36:21 -07:00
go.mod various: add golangci-lint, fix issues (#7905) 2023-04-17 18:38:24 -04:00
go.mod.sri go.mod.sri: update SRI hash for go.mod changes 2023-04-21 21:36:21 -07:00
go.sum various: add golangci-lint, fix issues (#7905) 2023-04-17 18:38:24 -04:00
go.toolchain.branch go.toolchain.branch: update to Go 1.20 2023-02-01 15:14:05 -08:00
go.toolchain.rev go.toolchain.rev: update for go 1.20.3 2023-04-04 11:44:02 -07:00
pull-toolchain.sh pull-toolchain.sh: don't run update-flake.sh 2023-02-09 15:04:01 -08:00
shell.nix go.mod.sri: update SRI hash for go.mod changes 2023-04-21 21:36:21 -07:00
staticcheck.conf staticcheck.conf: remove unnecessary warning 2021-06-22 12:26:13 -07:00
update-flake.sh .github/workflows: add workflow to update go.mod Nix SRI hash 2023-02-14 03:28:43 +00:00
version-embed.go version: return correct Meta.MajorMinorPatch in non-dev builds 2023-02-10 13:00:44 -08:00
version_test.go all: update copyright and license headers 2023-01-27 15:36:29 -08:00

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:

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.20. (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.