Headscale+Derper的最新教程

heardic · 发表于 2025-2-9 02:11:00

立刻注册账号，享受更清爽的界面！

您需要登录才可以下载或查看，没有账号？注册

×

写在开头

教程有点长，希望多多点赞收藏
对于大部分来说，自建一个Derper服务器，然后使用官方的Tailscale就够用了，也就是看本教程的第二点就够用了，后面将自建Derper服务器加入Tailscale的方法请自行搜索，不难的。
对于愿意折腾的人来说就可以继续看下去了，建议先搞清楚第一点的内容，尤其是端口和配置文件。
教程写的比较仓促，若存在错误请留言指出，谢谢。
参考教程在文章最后面，若有什么不清楚的可以去查阅参考。

0. 简介

Tailscale（Headscale）就是组建一个大的局域网，可以将你手里头的所有设备都拉到这个局域网内，进而使用局域网IP进行互联。
此外，Tailscale（Headscale）还有一个作用就是内网穿透，局域网内的设备之间的访问会通过穿透进行打洞（成功概率挺高），进而实现公网的点对点互联。而且就算打洞失败，也可以利用中转服务器进行互联。
应用场景举例：家里没有公网IP，但是可以通过Tailscale组网和穿透的方式实现在任意网络下对家里设备的访问。

1. 准备

1.1 一个域名

后文以headscale.example.com为例，记得改成自己的域名，并域名解析到IP上

1.2 一台带公网IP的服务器

以Debian12系统为例，后文的IP以123.123.123.123为例，记得改成自己的IP

1.3 一个邮箱

申请证书，后文以example@gmail.com为例，记得改成自己的邮箱

1.4 需要用到的端口：

Derper端口：13445（自己改成喜欢的端口）
Https端口：13446（自己改成喜欢的端口）
Headscale端口：8080
80 443端口

1.5 需要用到的配置文件

Derper：/var/www/derp.json，/etc/systemd/system/derp.service
Headscale：/etc/headscale/config.yaml
Nginx: /etc/nginx/sites-available/default

2. 搭建Derper

由于官方新版本的Derp支持自签证书了，所以方法方便很多了，废话不多说，直接开始

2.1 安装最新版GO

更新软件包，安装依赖

apt update && apt upgrade
apt install -y wget git openssl curl

下载最新版GO

wget https://go.dev/dl/go1.23.5.linux-amd64.tar.gz
rm -rf /usr/local/go && tar -C /usr/local -xzf go1.23.5.linux-amd64.tar.gz

目前最新版为1.23.5，后续若有更新则可以去 https://go.dev/dl/ 查看最新版并替换下载即可，记得后面的版本号都要改

配置环境变量

export PATH=$PATH:/usr/local/go/bin
go version
echo "export PATH=$PATH:/usr/local/go/bin" >> /etc/profile
source /etc/profile
go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct

2.2 安装最新版Derper

安装

go install tailscale.com/cmd/derper@latest

拷贝二进制文件

mkdir /etc/derp/
cp ~/go/bin/derper /etc/derp/

查看是否拷贝成功

ls /etc/derp

2.3 生成Derper自签证书

DERP_IP="123.123.123.123"
openssl req -x509 -newkey rsa:4096 -sha256 -days 3650 -nodes -keyout ${DERP_IP}.key -out ${DERP_IP}.crt -subj "/CN=${DERP_IP}" -addext "subjectAltName=IP:${DERP_IP}"

这时候/root文件夹下会有两个证书文件：/root/123.123.123.123.crt和/root/123.123.123.123.key，拷贝到/etc/derp/:

mv /root/123.123.123.123.crt /etc/derp
mv /root/123.123.123.123.key /etc/derp

2.4 启动Derper服务器

写入后台

新建文件derp.service

touch /etc/systemd/system/derp.service

写入以下内容

[Unit]
Description=TS Derper
After=network.target
Wants=network.target
[Service]
User=root
Restart=always
ExecStart=/etc/derp/derper -hostname 123.123.123.123 -a :13445 -http-port 13446 -certmode manual -certdir /etc/derp
RestartPreventExitStatus=1
[Install]
WantedBy=multi-user.target

启动

systemctl enable derp
systemctl restart derp
systemctl status derp

2.5 验证Derper是否搭建成功

浏览器打开https://123.123.123.123:13445，忽略不安全，看看是不是显示下面的内容：

DERP
This is a Tailscale DERP server.

It provides STUN, interactive connectivity establishment, and relaying of end-to-end encrypted traffic for Tailscale clients.

Documentation:

About DERP
Protocol & Go docs
How to run a DERP server

3. 搭建Headscale和Headscale-ui

3.1 ACME申请证书

安装依赖

apt update -y&&apt install -y curl&&apt install -y socat

申请证书

curl https://get.acme.sh | sh -s email=example@gmail.com
~/.acme.sh/acme.sh --issue -d headscale.example.com --standalone
~/.acme.sh/acme.sh --installcert -d headscale.example.com --key-file /root/private.key --fullchain-file /root/cert.crt

3.2 安装最新版Headscale

下载

wget --output-document=headscale.deb \
  https://github.com/juanfont/headscale/releases/download/v0.24.1/headscale_0.24.1_linux_amd64.deb

目前最新版为0.24.1，后续若有更新则可以去 https://github.com/juanfont/headscale/releases 查看最新版并替换下载即可，记得后面的版本号都要改

安装

mv headscale_0.24.1_linux_amd64.deb headscale.deb
dpkg --install headscale.deb

修改配置文件（/etc/headscale/config.yaml）

仅列出需要修改的地方

server_url: https://headscale.example.com
listen_addr: 0.0.0.0:8080
metrics_listen_addr: 0.0.0.0:9090
prefixes:
  v4: 100.64.0.0/10
#  v6: fd7a:115c:a1e0::/48
  # List of externally available DERP maps encoded in JSON
  urls:
    - http://127.0.0.1/d/derp.json
  base_domain: headscale.example.com
  # List of DNS servers to expose to clients.（建议改成国内适合自己的DNS）
  nameservers:
    global:
      - 114.114.114.114

启动

systemctl enable headscale
systemctl restart headscale
systemctl status headscale

3.3 安装最新版Headscale-ui

下载

wget https://github.com/gurucomputing/headscale-ui/releases/download/2025.01.20/headscale-ui.zip

目前最新版为2025.01.20，后续若有更新则可以去 https://github.com/gurucomputing/headscale-ui 查看最新版并替换下载即可，记得后面的版本号都要改

安装

apt-get install unzip
unzip -d /var/www headscale-ui.zip

3.4 配置Derper服务器

配置/var/www/derp.json文件

新建

touch /var/www/derp.json

写入以下内容

{
    "Regions": {
        "901": {
            "RegionID":   901,
            "RegionCode": "Myself",
            "RegionName": "Myself Derper",
            "Nodes": [
                    {
                    "Name":             "901a",
                    "RegionID":         901,
                    "DERPPort":         13445,
                    "IPv4":   "123.123.123.123",
                    "InsecureForTests": true
                }
            ]
        }
    }
}

3.5 安装并配置Nginx

下载

apt install -y nginx

打开/etc/nginx/sites-available/default并添加以下内容：

map $http_upgrade $connection_upgrade {
    default      upgrade;
    ''           close;
}
server {
    listen 80;
    listen [::]:80;
    listen 443      ssl http2;
    listen [::]:443 ssl http2;
    server_name headscale.example.com;
    ssl_certificate /root/cert.crt;
    ssl_certificate_key /root/private.key;
    ssl_protocols TLSv1.2 TLSv1.3;
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        proxy_set_header Host $server_name;
        proxy_redirect http:// https://;
        proxy_buffering off;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        add_header Strict-Transport-Security "max-age=15552000; includeSubDomains" always;
    }
    location /web {
        index  index.html;
            alias  /var/www/web;
    }
}
server {
    listen 80;
    listen [::]:80;

    server_name 127.0.0.1;

    root /var/www;
    index index.html index.htm index.nginx-debian.html;
    location /d {
        alias   /var/www;
        autoindex on;
    }
    location / {
        try_files $uri $uri/ =404;
    }
}

启动

systemctl enable nginx
systemctl restart nginx
systemctl status nginx

3.6 验证安装

重启Derper，Headscale和Nginx服务

systemctl restart derp
systemctl status derp
systemctl restart headscale
systemctl status headscale
systemctl restart nginx
systemctl status nginx

打开网站

https://headscale.example.com/web

如无意外应该是三个服务的状态应该是全绿的，网页也能正常打开，有报错的话建议按教程自查或在帖子底下留言

3.7 配置Headscale-ui

生成API Key

headscale apikeys create --expiration 9999d

并将其写入到https://headscale.example.com/web/settings.html的Headscale API Key里面，点击Save API Key提交，见到右侧有小对勾即可

新建用户Default

打开https://headscale.example.com/web/users.html，点击New User，输入Default并提交

4. 将设备添加到Headscale局域网中

4.1 下载最新客户端

https://tailscale.com/download

4.2 启动指令解析

--login-server: 指定使用的Headscale服务器地址，即https://headscale.example.com
--advertise-routes: 向Headscale服务器报告当前客户端处于哪个内网网段下, 便于Headscale服务器让同内网设备直接内网直连(可选的)或者将其他设备指定流量路由到当前内网(可选)，多条路由英文逗号隔开
--accept-routes: 是否接受Headscale服务器下发的用于路由到其他客户端内网的路由规则(可选)
--accept-dns: 是否使用Headscale服务器下发的 DNS 相关配置(可选, 推荐关闭)
--force-reauth：强制重新认证
--advertise-exit-node：作为出口节点

4.3 不同客户端的启动方法

Windows

以管理员身份启动PowerShell，输入以下代码：

tailscale login --login-server https://headscale.example.com

iOS

用非国区Apple ID下载，配置V P N文件

点击右上角头像，点击Log In...，点击右上角三个点,点击Use a custom coordination server，输入https://headscale.example.com,点击Login in

Linux

安装

curl -fsSL https://tailscale.com/install.sh | sh

运行

tailscale up --reset --advertise-routes=192.168.x.0/24 --accept-routes=true --login-server=https://headscale.example.com

4.4 到Headscale-ui中允许设备加入局域网

上面在客户端执行了tailscale up之后，在客户都会显示一个带Device Key的代码，格式类似于：

headscale nodes register --user USERNAME --key mkey:ed8f19e22f51c9c231c8bc8ccbxxxxxxxxxxxxxxf86c8211e4ad32b6c6e

拷贝mkey:ed8f19e22f51c9c231c8bc8ccbxxxxxxxxxxxxxxf86c8211e4ad32b6c6e，去 https://headscale.example.com/web/devices.html中导入Device Key

4.5 开启Derper防白嫖功能

将Derper服务器加入到Headscale局域网中

修改/etc/systemd/system/derp.service文件

在ExecStart=/etc/derp/derper -hostname 123.123.123.123 -a :13445 -http-port 13446 -certmode manual -certdir /etc/derp的后面加入--verify-clients（注意空格）

重启Derper，Headscale和Nginx服务

systemctl restart derp
systemctl status derp
systemctl restart headscale
systemctl status headscale
systemctl restart nginx
systemctl status nginx