[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-1376":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":25,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":31,"readmeContent":32,"aiSummary":33,"trendingCount":16,"starSnapshotCount":16,"syncStatus":34,"lastSyncTime":35,"discoverSource":36},1376,"headscale","juanfont\u002Fheadscale","juanfont","An open source, self-hosted implementation of the Tailscale control server","",null,"Go",39914,2184,192,75,0,33,239,1646,168,45,"BSD 3-Clause \"New\" or \"Revised\" License",false,"main",true,[27,28,29,30],"tailscale","tailscale-control-server","tailscale-server","wireguard","2026-06-12 02:00:27","![headscale logo](.\u002Fdocs\u002Fassets\u002Flogo\u002Fheadscale3_header_stacked_left.png)\n\n![ci](https:\u002F\u002Fgithub.com\u002Fjuanfont\u002Fheadscale\u002Factions\u002Fworkflows\u002Ftest.yml\u002Fbadge.svg)\n\nAn open source, self-hosted implementation of the Tailscale control server.\n\nJoin our [Discord server](https:\u002F\u002Fdiscord.gg\u002Fc84AZQhmpx) for a chat.\n\n**Note:** Always select the same GitHub tag as the released version you use\nto ensure you have the correct example configuration. The `main` branch might\ncontain unreleased changes. The documentation is available for stable and\ndevelopment versions:\n\n- [Documentation for the stable version](https:\u002F\u002Fheadscale.net\u002Fstable\u002F)\n- [Documentation for the development version](https:\u002F\u002Fheadscale.net\u002Fdevelopment\u002F)\n\n## What is Tailscale\n\nTailscale is [a modern VPN](https:\u002F\u002Ftailscale.com\u002F) built on top of\n[Wireguard](https:\u002F\u002Fwww.wireguard.com\u002F).\nIt [works like an overlay network](https:\u002F\u002Ftailscale.com\u002Fblog\u002Fhow-tailscale-works\u002F)\nbetween the computers of your networks - using\n[NAT traversal](https:\u002F\u002Ftailscale.com\u002Fblog\u002Fhow-nat-traversal-works\u002F).\n\nEverything in Tailscale is Open Source, except the GUI clients for proprietary OS\n(Windows and macOS\u002FiOS), and the control server.\n\nThe control server works as an exchange point of Wireguard public keys for the\nnodes in the Tailscale network. It assigns the IP addresses of the clients,\ncreates the boundaries between each user, enables sharing machines between users,\nand exposes the advertised routes of your nodes.\n\nA [Tailscale network (tailnet)](https:\u002F\u002Ftailscale.com\u002Fdocs\u002Fconcepts\u002Ftailnet) is\nprivate network which Tailscale assigns to a user in terms of private users or an\norganisation.\n\n## Design goal\n\nHeadscale aims to implement a self-hosted, open source alternative to the\n[Tailscale](https:\u002F\u002Ftailscale.com\u002F) control server. Headscale's goal is to\nprovide self-hosters and hobbyists with an open-source server they can use for\ntheir projects and labs. It implements a narrow scope, a _single_ Tailscale\nnetwork (tailnet), suitable for a personal use, or a small open-source\norganisation.\n\n## Supporting Headscale\n\nIf you like `headscale` and find it useful, there is a sponsorship and donation\nbuttons available in the repo.\n\n## Features\n\nPlease see [\"Features\" in the documentation](https:\u002F\u002Fheadscale.net\u002Fstable\u002Fabout\u002Ffeatures\u002F).\n\n## Client OS support\n\nPlease see [\"Client and operating system support\" in the documentation](https:\u002F\u002Fheadscale.net\u002Fstable\u002Fabout\u002Fclients\u002F).\n\n## Running headscale\n\n**Please note that we do not support nor encourage the use of reverse proxies\nand container to run Headscale.**\n\nPlease have a look at the [`documentation`](https:\u002F\u002Fheadscale.net\u002Fstable\u002F).\n\nFor NixOS users, a module is available in [`nix\u002F`](.\u002Fnix\u002F).\n\n## Builds from `main`\n\nDevelopment builds from the `main` branch are available as container images and\nbinaries. See the [development builds](https:\u002F\u002Fheadscale.net\u002Fstable\u002Fsetup\u002Finstall\u002Fmain\u002F)\ndocumentation for details.\n\n## Talks\n\n- Fosdem 2026 (video): [Headscale & Tailscale: The complementary open source clone](https:\u002F\u002Ffosdem.org\u002F2026\u002Fschedule\u002Fevent\u002FKYQ3LL-headscale-the-complementary-open-source-clone\u002F)\n  - presented by Kristoffer Dalby\n- Fosdem 2023 (video): [Headscale: How we are using integration testing to reimplement Tailscale](https:\u002F\u002Ffosdem.org\u002F2023\u002Fschedule\u002Fevent\u002Fgoheadscale\u002F)\n  - presented by Juan Font Alonso and Kristoffer Dalby\n\n## Disclaimer\n\nThis project is not associated with Tailscale Inc.\n\nHowever, one of the active maintainers for Headscale [is employed by Tailscale](https:\u002F\u002Ftailscale.com\u002Fblog\u002Fopensource) and he is allowed to spend work hours contributing to the project. Contributions from this maintainer are reviewed by other maintainers.\n\nThe maintainers work together on setting the direction for the project. The underlying principle is to serve the community of self-hosters, enthusiasts and hobbyists - while having a sustainable project.\n\n## Contributing\n\nPlease read the [CONTRIBUTING.md](.\u002FCONTRIBUTING.md) file.\n\n### Requirements\n\nTo contribute to headscale you would need the latest version of [Go](https:\u002F\u002Fgolang.org)\nand [Buf](https:\u002F\u002Fbuf.build) (Protobuf generator).\n\nWe recommend using [Nix](https:\u002F\u002Fnixos.org\u002F) to setup a development environment. This can\nbe done with `nix develop`, which will install the tools and give you a shell.\nThis guarantees that you will have the same dev env as `headscale` maintainers.\n\n### Code style\n\nTo ensure we have some consistency with a growing number of contributions,\nthis project has adopted linting and style\u002Fformatting rules:\n\nThe **Go** code is linted with [`golangci-lint`](https:\u002F\u002Fgolangci-lint.run) and\nformatted with [`golines`](https:\u002F\u002Fgithub.com\u002Fsegmentio\u002Fgolines) (width 88) and\n[`gofumpt`](https:\u002F\u002Fgithub.com\u002Fmvdan\u002Fgofumpt).\nPlease configure your editor to run the tools while developing and make sure to\nrun `make lint` and `make fmt` before committing any code.\n\nThe **Proto** code is linted with [`buf`](https:\u002F\u002Fdocs.buf.build\u002Flint\u002Foverview) and\nformatted with [`clang-format`](https:\u002F\u002Fclang.llvm.org\u002Fdocs\u002FClangFormat.html).\n\nThe **docs** are formatted with [`mdformat`](https:\u002F\u002Fmdformat.readthedocs.io).\n\nThe **rest** (Markdown, YAML, etc) is formatted with [`prettier`](https:\u002F\u002Fprettier.io).\n\nCheck out the `.golangci.yaml` and `Makefile` to see the specific configuration.\n\n### Install development tools\n\n- Go\n- Buf\n- Protobuf tools\n\nInstall and activate:\n\n```shell\nnix develop\n```\n\n### Testing and building\n\nSome parts of the project require the generation of Go code from Protobuf\n(if changes are made in `proto\u002F`) and it must be (re-)generated with:\n\n```shell\nmake generate\n```\n\n**Note**: Please check in changes from `gen\u002F` in a separate commit to make it easier to review.\n\nTo run the tests:\n\n```shell\nmake test\n```\n\nTo build the program:\n\n```shell\nmake build\n```\n\n### Development workflow\n\nWe recommend using Nix for dependency management to ensure you have all required tools. If you prefer to manage dependencies yourself, you can use Make directly:\n\n**With Nix (recommended):**\n\n```shell\nnix develop\nmake test\nmake build\n```\n\n**With your own dependencies:**\n\n```shell\nmake test\nmake build\n```\n\nThe Makefile will warn you if any required tools are missing and suggest running `nix develop`. Run `make help` to see all available targets.\n\n## Contributors\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fjuanfont\u002Fheadscale\u002Fgraphs\u002Fcontributors\">\n  \u003Cimg src=\"https:\u002F\u002Fcontrib.rocks\u002Fimage?repo=juanfont\u002Fheadscale\" \u002F>\n\u003C\u002Fa>\n\nMade with [contrib.rocks](https:\u002F\u002Fcontrib.rocks).\n","headscale 是一个开源的、自托管的 Tailscale 控制服务器实现。它基于 Go 语言开发，提供了一个轻量级且易于部署的解决方案，用于管理 WireGuard 密钥交换和 IP 地址分配，特别适合个人或小型组织构建私有的点对点网络。通过 headscale，用户可以轻松创建和管理自己的 Tailscale 网络（tailnet），支持跨设备的安全连接，而无需依赖第三方服务。该项目适用于需要自定义网络配置或希望完全控制其网络基础设施的技术爱好者和开发者。",2,"2026-06-11 02:43:22","top_all"]