Initial commit: Tailscale Docker deployment with Headscale

Docker Compose 部署 Tailscale 連線至自架 Headscale 控制伺服器,
包含子網路由、出口節點、iptables NAT 設定及完整中文文件。

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-10 09:17:12 +08:00
commit 2ffa06ac80
15 changed files with 399 additions and 0 deletions

44
QUICKSTART.md Normal file
View File

@@ -0,0 +1,44 @@
# Quick Start
## 前置需求
- Docker 與 Docker Compose
- `/dev/net/tun` 裝置(主機需支援 TUN/TAP
- 具備 `NET_ADMIN` 權限的環境
## 步驟
### 1. 設定 Auth Key
`.env` 檔案中填入 Headscale 預認證金鑰:
```
TS_AUTHKEY=your-preauth-key-here
```
### 2. 啟動容器
```bash
./run.sh
```
### 3. 連線至 Headscale
```bash
./docker_exec_tailscale_up.sh
```
### 4. 設定防火牆(如需子網路由/出口節點)
```bash
sudo ./iptables_reset_and_configure.sh
```
### 5. 驗證
```bash
./docker_exec_tailscale_status.sh
./docker_exec_tailscale_ip.sh
```
看到 Tailscale IP 和節點列表即代表連線成功。