[彭于晏の教程]Headscale+Derper的最新教程
同步来源：树洞剪藏 源站剪藏 ID：575 原文地址：https://www.nodeseek.com/post-253641-1
[彭于晏の教程]Headscale+Derper的最新教程
NodeSeek beta 日常 技术 情报 测评 交易 拼车 推广
日常 技术 情报 测评 交易 拼车 推广 生活 Dev 贴图 曝光 内版 沙盒
[彭于晏の教程]Headscale+Derper的最新教程 1
彭于晏 Lv 6 楼主 活跃 交易中介 150days ago edited 150days ago in 技术 #0
写在开头
教程有点长，希望多多点赞收藏
对于大部分来说， 自建一个Derper服务器，然后使用官方的Tailscale就够用了 ，也就是看本教程的第二点就够用了，后面将自建Derper服务器加入Tailscale的方法请自行搜索，不难的。
对于愿意折腾的人来说就可以继续看下去了，建议先搞清楚第一点的内容，尤其是端口和配置文件。
教程写的比较仓促，若存在错误请留言指出，谢谢。
参考教程在文章最后面，若有什么不清楚的可以去查阅参考。
- 简介
Tailscale（Headscale）就是组建一个大的局域网，可以将你手里头的所有设备都拉到这个局域网内，进而使用局域网IP进行互联。
此外，Tailscale（Headscale）还有一个作用就是内网穿透，局域网内的设备之间的访问会通过穿透进行打洞（成功概率挺高），进而实现公网的点对点互联。而且就算打洞失败，也可以利用中转服务器进行互联。
应用场景举例：家里没有公网IP，但是可以通过Tailscale组网和穿透的方式实现在任意网络下对家里设备的访问。
- 准备
1.1 一个域名
后文以 headscale.example.com 为例，记得改成自己的域名，并域名解析到IP上
1.2 一台带公网IP的服务器
以Debian12系统为例，后文的IP以 123.123.123.123 为例，记得改成自己的IP
1.3 一个邮箱
申请证书，后文以 [email protected] 为例，记得改成自己的邮箱
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
- 搭建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
- 搭建Headscale和Headscale-ui
3.1 ACME申请证书
安装依赖
apt update - y && apt install - y curl && apt install - y socat
申请证书
curl https: //g et.acme.sh | sh -s [email protected]
~/ .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/v 0. 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:
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 并提交
- 将设备添加到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
- 参考教程
Tailscale 搭建derp中继节点，不需要域名，不需要备案，不需要申请证书（最新）
Tailscale实现内网穿透、异地组网、远程访问，纯IP搭建DERP服务器，点对点传输，更好的使用体验！轻松打通内外网！群晖、威联通NAS，替代zerotier#一瓶奶油
域名搭建Tailscale开源版本Headscale，配合headscale-ui使用，全方面提升使用体验，实现内网穿透、远程访问，点对点传输，轻松打通内外网！更适合国内的方案
自建Headscale后windows登录login无反应的问题解决方法
Tailscale玩法之内网穿透、异地组网、全隧道模式、纯IP的双栈DERP搭建、Headscale协调服务器搭建，用一期搞定，看一看不亏吧？
Tailscale+Headscale+自建Derp踩坑记录
Cannot connect to coordination server warning #13906
任命公告 | 论坛私信 | Telegram | Telegram小号 | Telegram频道
中介费5%(交易金额60元以下的为3元) | 已接325单, 共158,425元 (2025/1/13)
29 0 65 引用 回复
1 2 3 4 5 6
彭于晏 楼主 活跃 交易中介 150days ago #1
占楼
任命公告 | 论坛私信 | Telegram | Telegram小号 | Telegram频道
中介费5%(交易金额60元以下的为3元) | 已接325单, 共158,425元 (2025/1/13)
0 0 引用 回复
houzai 150days ago #2
好文 支持
0 0 引用 回复
彭于晏 楼主 活跃 交易中介 150days ago #3
@admin 能否来个加精~
任命公告 | 论坛私信 | Telegram | Telegram小号 | Telegram频道
中介费5%(交易金额60元以下的为3元) | 已接325单, 共158,425元 (2025/1/13)
0 0 引用 回复
geryson911 150days ago #4
感谢大佬分享，不过能说说这两个东西有什么用吗
0 0 引用 回复
MyrnaGrote 150days ago #5
好
0 0 引用 回复
Alilang 150days ago #6
D
正在播放《 闺蜜的探针 》━━━●──── 22:36/58:28
TG ㅤㅤ ◁ ㅤㅤ❚❚ ㅤㅤ ▷ ㅤㅤ PM ㅤ 下一集《 女友的图床 》
0 0 引用 回复
彭于晏 楼主 活跃 交易中介 150days ago #7
@geryson911 #4 说大白话就是组建一个大的局域网，可以将你手里头的所有设备都拉到这个局域网内，使用局域网的IP进行互联。此外还有一个作用就是穿透，局域网内的设备直接的访问会通过穿透进行打洞（成功概率挺高），进而实现公网的点对点互联。就算打洞失败，也可以利用中转服务器进行互联
任命公告 | 论坛私信 | Telegram | Telegram小号 | Telegram频道
中介费5%(交易金额60元以下的为3元) | 已接325单, 共158,425元 (2025/1/13)
0 0 引用 回复
huhbo 150days ago #8
支持，下午刚问，这教程就出来了
电报 |
HZ20欧
0 0 引用 回复
jayvzh 150days ago #9
虽然我已经部署好了 但是支持一下
✉️ 私信PM | ✈️ TG联系
0 0 引用 回复
frederick 150days ago #10
先收藏
✉️私信
0 0 引用 回复
1 2 3 4 5 6
内容 预览 对照
支持 markdown语法
鼓励友善发言，禁止人身攻击
xxxxxxxxxx
1
1
AC娘
洋葱头
小黄鸡
App
发布评论(Ctrl+Enter)
88
等级 Lv 5 鸡腿 2798 关注 0 回复 0 我 0
主题帖 11 评论数 379 粉丝 2 收藏 312 私信 0 发帖
快捷功能区 推荐阅读 管理记录 幸运抽奖 邀请好友 合作商家 友站链接
📈用户数目📈
目前论坛共有34182位seeker
🎉欢迎新用户🎉
Richard-R
eMPTY404
zhbone
Z807
fcc370227241
lasonneil
beck-8
loverlacer
相关网站 LowEndTalk LowEndSpirit HostLoc ServerHunter
站内导航 关于本站 隐私协议 RSS订阅 sitemap
商业推广 商家申请规则 Premium Provider 合作商家展示 广告合作
其他平台 电报频道 电报群组
联系我们
Copyright © 2022 - 2025 All rights Reserved