Overview
- Full name
docker.io/runyf/derper- Registry
- docker.io
- Namespace
- runyf
- Repository
- derper
- Cached tags
- 7
- Last synced
- 07/06/2026, 08:26 PM
Introduction
Tailscale DERP 中继服务器镜像（runyf 构建），为 NAT 后节点提供加密 UDP/TCP 转发，可自建替代官方中继。
Details
DERP（Designated Encrypted Relay for Packets）是 Tailscale 在直连失败时的兜底中继。runyf/derper 封装官方 derper 二进制，监听 443 端口同时承载 TLS 与 STUN。自建中继需有效域名与证书（或 -certmode manual），并在 Tailscale ACL 中配置 derpMap 指向本节点。与需 hostNetwork 的裸金属部署不同，标准 Deployment 可通过 Service 暴露 443 供集群外 Tailscale 节点接入。
快速启动
docker run -d --name derper \
-p 443:443 \
-e DERP_DOMAIN=derp.example.com \
docker.io/runyf/derper:latest
推荐实践
docker run -d --name derper \
--restart unless-stopped \
-p 443:443 \
-e DERP_DOMAIN=derp.example.com \
-e DERP_VERIFY_CLIENTS=true \
-v /etc/letsencrypt:/etc/letsencrypt:ro \
docker.io/runyf/derper:v0.2.1
核心参数说明
-p 443:443— DERP/STUN 标准端口，需公网可达-e DERP_DOMAIN— 证书域名，Tailscale 客户端据此连接-e DERP_VERIFY_CLIENTS=true— 仅允许已注册 Tailscale 节点使用中继-v /etc/letsencrypt:...:ro— 挂载 ACME 证书（-certmode manual时）--restart unless-stopped— 中继服务持续在线
Kubernetes
apiVersion: apps/v1
kind: Deployment
metadata:
name: derper
spec:
replicas: 1
selector:
matchLabels:
app: derper
template:
metadata:
labels:
app: derper
spec:
containers:
- name: derper
image: docker.io/runyf/derper:v0.2.1
ports:
- containerPort: 443
env:
- name: DERP_DOMAIN
value: derp.example.com
- name: DERP_VERIFY_CLIENTS
value: "true"
---
apiVersion: v1
kind: Service
metadata:
name: derper
spec:
type: LoadBalancer
selector:
app: derper
ports:
- port: 443
targetPort: 443
443 需 LoadBalancer 或 NodePort 对外暴露；TLS 证书经 Secret 挂载或 cert-manager 签发，并在 Tailscale ACL derpMap 中注册该节点地址。
Latest tags (20)
View all 7 tags →| Tag | Arch | Pushed At | Size | Digest | Sync | Wish | Action |
|---|---|---|---|---|---|---|---|
docker.io/runyf/derper :latest | linux/amd64 | 2026/06/18 16:56 | 10.3 MB | sha256:7a4282e2fb1a… | |||
docker.io/runyf/derper :v1.96.5 | linux/amd64 | 2026/04/15 13:01 | 10.3 MB | sha256:d47960e47367… | |||
docker.io/runyf/derper :v1.92.0 | linux/amd64 | 2025/11/27 17:27 | 10.1 MB | sha256:6e5d2210aad7… | |||
docker.io/runyf/derper :v1.72.1 | linux/amd64linux/arm64 | 2024/08/29 23:08 | 63.0 MB | sha256:62173eae9efc… | |||
docker.io/runyf/derper :v1.66.4 | linux/amd64linux/arm64 | 2024/08/14 12:36 | 62.6 MB | sha256:bbea11dca456… | |||
docker.io/runyf/derper :v1.70.0 | linux/amd64linux/arm64 | 2024/08/14 10:46 | 62.7 MB | sha256:a0061f6b3ac1… | |||
docker.io/runyf/derper :v1.68.1 | linux/amd64linux/arm64 | 2024/08/13 13:59 | 62.5 MB | sha256:1dd418b1ce2b… |