1
传统模型（城堡-护城河）：
2
        互联网（危险）
3
            │
4
    ┌───────▼────────┐
5
    │   防火墙 / VPN   │  ← 边界防御
6
    └───────┬────────┘
7
            │
8
    ┌───────▼────────┐
9
    │   内网（安全）   │  ← 一旦进来，畅通无阻
10
    │  [数据库] [NAS] │
11
    │  [CI/CD]  [API] │
12
    └────────────────┘
13

14
零信任模型：
15
         互联网
16
            │
17
    ┌───────▼────────────────────────┐
18
    │  身份网关（每次访问都验证）      │
19
    │  [你是谁] → [用什么设备]          │
20
    │  → [想访问什么] → [允许/拒绝]     │
21
    └───────┬────────────────────────┘
22
            │
23
    ┌───────▼────────┐
24
    │  每个资源独立验证 │
25
    │  [数据库] ← Bob 可以
26
    │  [CI/CD]  ← Alice 可以
27
    │  [NAS]    ← 所有人都可以
28
    │  [HR系统] ← 只有 HR 可以
29
    └────────────────┘

1
WireGuard 的企业级优势：
2
┌─────────────────────────────────────────────┐
3
│ 1. Cryptokey Routing（密钥即路由）            │
4
│    每个 Peer 的公钥绑定特定的 AllowedIPs      │
5
│    → 天然的身份-网络绑定机制                  │
6
│                                               │
7
│ 2. 极简攻击面                                  │
8
│    ~4,000 行代码 vs OpenVPN ~100,000 行       │
9
│    → 审计成本低，漏洞概率低                    │
10
│                                               │
11
│ 3. 无声端点                                    │
12
│    不对没有正确密钥的包做任何响应               │
13
│    → 对扫描器完全不可见                        │
14
│                                               │
15
│ 4. 内核级性能                                  │
16
│    Linux 5.6+ 内置，路由和加密零上下文切换     │
17
│    → 10Gbps 线速加密无压力                    │
18
│                                               │
19
│ 5. 完美的前向保密（PFS）                       │
20
│    每 2 分钟轮换会话密钥                      │
21
│    → 即使密钥泄露，历史流量也无法解密           │
22
└─────────────────────────────────────────────┘

1
┌──────────────────────────────────────────────────┐
2
│              Tailscale 企业架构                    │
3
│                                                    │
4
│  ┌──────────┐    ┌──────────┐    ┌──────────┐     │
5
│  │ Identity │    │ Control  │    │   Data   │     │
6
│  │  Layer   │    │  Plane   │    │  Plane   │     │
7
│  └────┬─────┘    └────┬─────┘    └────┬─────┘     │
8
│       │               │               │           │
9
│  ┌────▼─────┐    ┌────▼─────┐    ┌────▼─────┐     │
10
│  │ Okta/     │    │ ACL as   │    │ WireGuard│     │
11
│  │ Azure AD/ │    │ JSON     │    │ P2P Mesh │     │
12
│  │ Google    │    │ Policy   │    │ 直连/     │     │
13
│  │ Workspace │    │ Engine   │    │ DERP中继  │     │
14
│  └──────────┘    └──────────┘    └──────────┘     │
15
│                                                    │
16
│  ┌──────────┐    ┌──────────┐    ┌──────────┐     │
17
│  │  Audit   │    │  Device  │    │   DERP   │     │
18
│  │  Logs    │    │ Posture  │    │  Relays  │     │
19
│  └──────────┘    └──────────┘    └──────────┘     │
20
└──────────────────────────────────────────────────┘

1
{
2
  // ===== 用户组定义 =====
3
  "groups": {
4
    "group:infra":   ["[email protected]", "[email protected]"],
5
    "group:dev":     ["[email protected]", "[email protected]"],
6
    "group:data":    ["[email protected]"],
7
    "group:all":     ["group:infra", "group:dev", "group:data"]
8
  },
9

10
  // ===== 主机标签 =====
11
  "tagOwners": {
12
    "tag:prod-db":    ["group:infra"],
13
    "tag:prod-app":   ["group:infra"],
14
    "tag:dev-server": ["group:dev"],
15
    "tag:bastion":    ["group:infra"],
16
    "tag:monitoring": ["group:infra"],
17
    "tag:ci":         ["group:dev"]
18
  },
19

20
  // ===== 访问规则（方向性，默认拒绝） =====
21
  "acls": [
22
    // 基础设施组可以 SSH 登录生产数据库
23
    {
24
      "action": "accept",
25
      "src":    ["group:infra"],
26
      "dst":    ["tag:prod-db:22"],
27
      "users":  ["root", "dbadmin"]
28
    },
29

30
    // 开发组只能访问开发服务器
31
    {
32
      "action": "accept",
33
      "src":    ["group:dev"],
34
      "dst":    ["tag:dev-server:*"]
35
    },
36

37
    // 数据团队只能访问数据库的 5432（PostgreSQL）和 HTTP
38
    {
39
      "action": "accept",
40
      "src":    ["group:data"],
41
      "dst":    ["tag:prod-db:5432,443"]
42
    },
43

44
    // 所有人可以访问监控仪表盘
45
    {
46
      "action": "accept",
47
      "src":    ["group:all"],
48
      "dst":    ["tag:monitoring:443,9090"]
49
    }
50
  ],
51

52
  // ===== SSH 策略 =====
53
  "ssh": [
54
    {
55
      "action": "accept",
56
      "src":    ["group:infra"],
57
      "dst":    ["tag:prod-db", "tag:prod-app", "tag:bastion"],
58
      "users":  ["root"]
59
    },
60
    {
61
      "action": "accept",
62
      "src":    ["group:dev"],
63
      "dst":    ["tag:dev-server"],
64
      "users":  ["dev", "deploy"]
65
    }
66
  ],
67

68
  // ===== 设备姿态检查（Premium/Enterprise） =====
69
  "nodeAttrs": [
70
    {
71
      // 要求生产数据库必须运行在特定操作系统版本上
72
      "target": ["tag:prod-db"],
73
      "attr":   ["node:os:linux", "node:osVersion:>=5.15"]
74
    }
75
  ]
76
}

1
version: "3.9"
2

3
services:
4
  headscale:
5
    image: headscale/headscale:0.29.1
6
    container_name: headscale
7
    restart: unless-stopped
8
    volumes:
9
      - ./config:/etc/headscale
10
      - ./data:/var/lib/headscale
11
    ports:
12
      - "127.0.0.1:8080:8080"  # Headscale API（仅本地暴露）
13
    command: headscale serve
14
    networks:
15
      - headscale-net
16

17
  headscale-ui:
18
    image: ghcr.io/gurucomputing/headscale-ui:latest
19
    container_name: headscale-ui
20
    restart: unless-stopped
21
    ports:
22
      - "127.0.0.1:443:443"
23
    networks:
24
      - headscale-net
25

26
  # TLS 反向代理（推荐 Caddy）
27
  caddy:
28
    image: caddy:2-alpine
29
    container_name: caddy
30
    restart: unless-stopped
31
    ports:
32
      - "80:80"
33
      - "443:443"
34
    volumes:
35
      - ./Caddyfile:/etc/caddy/Caddyfile
36
      - caddy_data:/data
37
    networks:
38
      - headscale-net
39

40
networks:
41
  headscale-net:
42

43
volumes:
44
  caddy_data:

1
hs.yourcompany.com {
2
    reverse_proxy headscale:8080
3
}
4

5
hs-ui.yourcompany.com {
6
    reverse_proxy headscale-ui:443 {
7
        transport http {
8
            tls_insecure_skip_verify
9
        }
10
    }
11
}

1
server_url: https://hs.yourcompany.com
2
listen_addr: 0.0.0.0:8080
3

4
# 使用本地 SQLite（中小规模）或 PostgreSQL（大规模）
5
database:
6
  type: sqlite3
7
  sqlite:
8
    path: /var/lib/headscale/db.sqlite
9

10
# OIDC 配置（以 Keycloak 为例）
11
oidc:
12
  only_start_if_oidc_is_available: true
13
  issuer: "https://keycloak.yourcompany.com/realms/headscale"
14
  client_id: "headscale"
15
  client_secret: "${OIDC_CLIENT_SECRET}"
16
  scope: ["openid", "profile", "email"]
17

18
# DERP 配置
19
derp:
20
  server:
21
    enabled: true
22
    region_id: 900
23
    region_code: "my-derp"
24
    region_name: "My DERP Server"
25
    stun_listen_addr: "0.0.0.0:3478"
26
  urls:
27
    - https://controlplane.tailscale.com/derpmap/default  # 也使用官方的 DERP 作为 fallback
28
  paths: []
29
  auto_update_enabled: true
30
  update_frequency: 24h
31

32
# DERP 节点间的证书检查（生产环境建议开启）
33
tls_letsencrypt_hostname: "hs.yourcompany.com"
34
tls_letsencrypt_cache_dir: "/var/lib/headscale/cache"

1
┌─────────────────────────────────────────────────────────┐
2
│                     企业零信任网络                        │
3
│                                                           │
4
│  ┌─────────────────────────────────────────────────┐    │
5
│  │  第一层：控制平面（Headscale/Tailscale）          │    │
6
│  │  · 身份认证 (OIDC/SSO)                          │    │
7
│  │  · ACL 策略引擎                                  │    │
8
│  │  · 密钥分发与轮换                                │    │
9
│  │  · MagicDNS 名称解析                             │    │
10
│  └──────────────────────┬──────────────────────────┘    │
11
│                         │                                 │
12
│  ┌──────────────────────▼──────────────────────────┐    │
13
│  │  第二层：数据平面（WireGuard Mesh）               │    │
14
│  │  · 设备间 P2P 直连（首选）                        │    │
15
│  │  · DERP 中继（NAT 穿透失败时的 fallback）        │    │
16
│  │  · Subnet Router 广播内网                        │    │
17
│  │  · Exit Node 统一出口                             │    │
18
│  └──────────────────────┬──────────────────────────┘    │
19
│                         │                                 │
20
│  ┌──────────────────────▼──────────────────────────┐    │
21
│  │  第三层：安全与审计平面                           │    │
22
│  │  · 配置审计日志 → SIEM                           │    │
23
│  │  · 网络流日志 → 入侵检测                          │    │
24
│  │  · SSH 会话录制 → S3/本地存储                     │    │
25
│  │  · 设备姿态检查 → 不合规设备自动隔离              │    │
26
│  └─────────────────────────────────────────────────┘    │
27
└─────────────────────────────────────────────────────────┘

1
                    ┌─────────────────┐
2
                    │  Headscale      │
3
                    │  (香港 VPS)     │
4
                    │  控制平面        │
5
                    └───┬────┬────┬───┘
6
                        │    │    │
7
        ┌───────────────┤    │    ├───────────────┐
8
        │               │    │    │               │
9
   ┌────▼─────┐   ┌─────▼──┐ │ ┌──▼─────┐   ┌────▼─────┐
10
   │ 北京办公室 │   │ 上海办 │ │ │ 东京办 │   │ 新加坡办  │
11
   │           │   │       │ │ │       │   │         │
12
   │ Subnet    │   │Subnet │ │ │Subnet │   │ Subnet  │
13
   │ Router    │   │Router │ │ │Router │   │ Router  │
14
   │ 10.1.0/24 │   │10.2.0 │ │ │10.3.0 │   │ 10.4.0  │
15
   └────┬─────┘   └───┬───┘ │ └──┬───┘   └────┬─────┘
16
        │             │     │    │              │
17
   ┌────▼─────┐   ┌───▼───┐ │ ┌──▼───┐   ┌────▼─────┐
18
   │ 办公电脑  │   │ 办公   │ │ │ 办公  │   │ 办公     │
19
   │ 打印机   │   │ 电脑   │ │ │ 电脑  │   │ 电脑     │
20
   │ NAS     │   │ 开发   │ │ │ 开发  │   │ 云服务   │
21
   │ 门禁系统  │   │ 服务器 │ │ │ 测试  │   │ (AWS)   │
22
   └─────────┘   └───────┘ │ └──────┘   └──────────┘
23
                             │
24
                        ┌────▼─────┐
25
                        │ DERP     │
26
                        │ Relay    │
27
                        │ (东京)   │
28
                        └──────────┘

1
         ┌──────────────────┐
2
         │   等保 2.0        │
3
         │  （GB/T 22239）   │
4
         │  网络安全等级保护  │
5
         └────────┬─────────┘
6
                  │
7
    ┌─────────────┼─────────────┐
8
    │             │             │
9
┌───▼──────┐ ┌───▼──────┐ ┌───▼──────────┐
10
│数据安全法 │ │个人信息   │ │网络安全法     │
11
│数据分类   │ │保护法     │ │VPN 备案      │
12
│分级+出境  │ │最小必要   │ │实名制         │
13
│风险评估   │ │+ 同意的   │ │+ 日志留存    │
14
└──────────┘ └──────────┘ └──────────────┘
15
                  │
16
        ┌─────────▼──────────┐
17
        │  GA/T 2380-2026    │
18
        │  等保数据安全新规   │
19
        │  （2026 年新发布）  │
20
        │  · 资产梳理         │
21
        │  · 分类分级         │
22
        │  · 数据跨境管控     │
23
        │  · 全量审计日志     │
24
        └────────────────────┘

1
# Tailscale 配置审计日志 → SIEM
2
# 在 Tailscale Admin Console → Logs → Log Streaming 中配置
3
# 支持的 SIEM 集成：
4
# - Splunk
5
# - Elasticsearch
6
# - AWS S3（自建分析管道）
7
# - 自定义 webhook
8

9
# 使用 webhook 推送到自建的日志收集器
10
# Tailscale → 你的日志服务器 → 长期存储（满足 180 天）

1
场景分类：
2

3
1. 纯控制面元数据出境（设备名、公钥、ACL）
4
   → 用 Headscale 自建在中国境内，元数据不出境 ✅
5
   → 合规等级：完全合规
6

7
2. 数据面 P2P 直连（设备间端到端加密）
8
   → 数据不经任何中心节点，P2P 直连 ✅
9
   → 合规等级：不涉及出境评估（因为没有"出境"动作）
10

11
3. 数据面经 DERP 中继
12
   → DERP 节点如果是海外节点，加密数据经过该节点
13
   → 合规建议：在中国及业务所在国各部署一个 DERP
14
   → 确保 DERP 之间只有加密流量，不落地
15

16
4. 用户使用 Exit Node 出国
17
   → 这是典型的数据出境
18
   → 合规建议：限制 Exit Node 的使用，别让员工用公司设备翻墙

1
┌───────────────────────────────────────┐
2
│  推荐：三层数据隔离策略                │
3
│                                        │
4
│  第一层：中国境内（Headscale 自建）     │
5
│    · 控制面完全本地化                  │
6
│    · 设备列表、用户信息不出境          │
7
│                                        │
8
│  第二层：P2P 直连（端到端加密）         │
9
│    · 跨境流量不经过任何中心服务器      │
10
│    · 加密数据仅两端可解                │
11
│                                        │
12
│  第三层：DERP 区域化                   │
13
│    · 中国部署 1 个 DERP               │
14
│    · 目标区域各部署 1 个 DERP          │
15
│    · DERP 设备全部自建，不使用官方中继  │
16
│    · 所有 DERP 节点日志完整留存        │
17
└───────────────────────────────────────┘

1
拓扑 1：星型（Hub-and-Spoke）
2
    适合：总部在 A 国，员工在各国，访问总部资源
3

4
         ┌──────────────┐
5
         │  总部办公室    │
6
         │  (中国)       │
7
         │  Subnet Router│
8
         └───┬───┬───┬──┘
9
        ┌────┘   │   └────┐
10
    [远程员工1] [2] [3] [4] [5]
11
    美  日  英  新  德
12
    ✅ 简单易管理
13
    ❌ 中国到海外延迟高
14
    ❌ 单点故障
15

16

17
拓扑 2：Mesh（完全互联）
18
    适合：各办公室独立，资源分散
19

20
         [中国办公室]←────→[日本办公室]
21
              ↖    ↘        ↗    ↙
22
              [新加坡]←────→[美国办公室]
23
    ✅ 最低延迟（直连）
24
    ❌ ACL 管理复杂度 O(n²)
25
    ❌ 仅当所有办公室都有 Subnet Router 时可用
26

27

28
拓扑 3：分层（Hierarchical）← 推荐
29
    适合：跨国公司，区域化运营
30

31
┌─────────────────────────────────────────┐
32
│          全球控制平面（Headscale）        │
33
│           (香港/新加坡)                   │
34
└───┬──────────┬───────────┬──────────────┘
35
    │          │           │
36
┌───▼──┐  ┌───▼──┐   ┌───▼──┐
37
│亚洲区│  │欧洲区│   │北美区│
38
│网关  │  │网关  │   │网关  │
39
│(东京)│  │(法兰)│   │(加州)│
40
└──┬───┘  └──┬───┘   └──┬───┘
41
   │         │          │
42
  [中国]   [德]  [法]  [美]  [加]
43
  [日]     [英]        [墨]
44
  [新]
45

46
    ✅ 区域延迟最低（区域内直连，跨区域经区域网关）
47
    ✅ 故障隔离（一个区域故障不影响其他区域）
48
    ✅ 合规（数据面可限制在区域内）
49
    ✅ CPU/带宽负载分散

1
// Tailscale ACL：控制谁能用什么 Exit Node
2
{
3
  "acls": [
4
    {
5
      // 海外同事的指定流量可以走中国 Exit Node
6
      // （例如访问国内的 SaaS 服务、政府网站）
7
      "action": "accept",
8
      "src":    ["group:overseas"],
9
      "dst":    ["tag:cn-exit-node:443"]
10
    },
11
    {
12
      // 国内同事可以使用海外 Exit Node
13
      // （合规注意：仅限工作需要，不做日常翻墙）
14
      "action": "accept",
15
      "src":    ["group:china"],
16
      "dst":    ["tag:us-exit-node:443"]
17
    }
18
  ]
19
}

1
Headscale 自建 — 50 人团队年度成本：
2

3
  控制面 VPS（香港，2C4G）：     $10/月 × 12 = $120
4
  DERP x 2（东京 + 法兰克福）：    $10/月 × 2 × 12 = $240
5
  TLS 证书（Let's Encrypt）：     $0
6
  运维人力（预估 4h/月）：         $200/月 × 12 = $2,400
7
  ─────────────────────────────────────
8
  年总计：约 $2,760
9

10
Tailscale Premium — 50 人团队年度成本：
11

12
  许可费：50 × $18/月 × 12 = $10,800
13
  运维：$0（零运维）
14
  ─────────────────────────────────────
15
  年总计：$10,800
16

17
差 距：Tailscale Premium 比 Headscale 自建贵约 $8,000/年
18
代 价：Headscale 需要你有一个运维人员定期维护

1
场景 1：控制面服务器宕机
2
  → 现有设备连接不受影响（P2P 直连已建立）
3
  → 新设备无法加入，ACL 变更无法推送
4
  → 应对：
5
      1. 至少部署两台 Headscale（主 + 备）
6
      2. 配置 DNS 故障切换到备用 IP
7
      3. 数据库定期备份（sqlite3 .dump 或 pg_dump）
8

9
场景 2：某个区域的 DERP 节点宕机
10
  → Tailscale 客户端自动切换到下一个可用 DERP
11
  → 如果所有 DERP 都挂，设备之间如果能直连就不受影响
12
  → 应对：
13
      1. 每个区域至少 2 个 DERP 节点
14
      2. 跨区域的 DERP 不要放在同一云服务商
15
      3. 定期测试 DERP 健康（简单的 UDP ping）
16

17
场景 3：Subnet Router 主机宕机
18
  → 该办公室的局域网资源对外不可达
19
  → 应对：
20
      1. 每个办公室部署 2 台 Subnet Router（HA）
21
      2. Tailscale v1.72+ 支持 HA Subnet Router：
22
         两台设备宣告相同的子网，一台故障后自动切换
23

24
场景 4：某员工的设备被窃
25
  → 应对：
26
      1. Admin Console 中立即删除该设备
27
      2. 设备的节点密钥自动失效
28
      3. 如果启用了 Tailnet Lock，被盗设备无法被重新签名

1
#!/bin/bash
2
# headscale-backup.sh — 每日备份脚本
3
# crontab: 0 3 * * * /opt/headscale/headscale-backup.sh
4

5
BACKUP_DIR="/opt/headscale/backups"
6
DB_PATH="/var/lib/headscale/db.sqlite"
7
CONFIG_PATH="/etc/headscale/config.yaml"
8
ACL_PATH="/etc/headscale/acl.hujson"
9
RETENTION_DAYS=30
10

11
# 备份数据库
12
cp "$DB_PATH" "$BACKUP_DIR/headscale-db-$(date +%Y%m%d).sqlite"
13

14
# 备份配置
15
cp "$CONFIG_PATH" "$BACKUP_DIR/config-$(date +%Y%m%d).yaml"
16
cp "$ACL_PATH" "$BACKUP_DIR/acl-$(date +%Y%m%d).hujson"
17

18
# 压缩
19
gzip "$BACKUP_DIR/headscale-db-$(date +%Y%m%d).sqlite"
20

21
# 清理旧备份
22
find "$BACKUP_DIR" -name "*.gz" -mtime +$RETENTION_DAYS -delete
23

24
# 可选：上传到 S3/对象存储
25
# aws s3 cp "$BACKUP_DIR/headscale-db-$(date +%Y%m%d).sqlite.gz" \
26
#     "s3://your-bucket/headscale-backups/"
27

28
echo "[$(date)] Backup completed"

1
#!/bin/bash
2
# headscale-health.sh — 健康检查脚本
3
# 可集成到 Prometheus / Uptime Kuma
4

5
HS_URL="https://hs.yourcompany.com"
6
NODE_ID="your-node-id"  # 一个已知在线的节点 ID
7

8
# 1. Headscale API 健康检查
9
if ! curl -sf "$HS_URL/health" > /dev/null 2>&1; then
10
    echo "CRITICAL: Headscale API unreachable"
11
    exit 2
12
fi
13

14
# 2. 检查关键节点是否在线
15
ONLINE=$(headscale nodes list -o json | jq -r ".[] | select(.id==\"$NODE_ID\") | .online")
16
if [ "$ONLINE" != "true" ]; then
17
    echo "WARNING: Critical node $NODE_ID is offline"
18
    exit 1
19
fi
20

21
# 3. 检查数据库连接
22
if ! headscale nodes list > /dev/null 2>&1; then
23
    echo "CRITICAL: Database connection failed"
24
    exit 2
25
fi
26

27
echo "OK: All health checks passed"
28
exit 0