diff --git a/OPERATIONS.md b/OPERATIONS.md index e567ae0..5be6037 100644 --- a/OPERATIONS.md +++ b/OPERATIONS.md @@ -46,6 +46,38 @@ `./tailscale` 是 `docker exec -i tailscale tailscale` 的包裝腳本。 +部署後建議建立 symlink 讓系統全域可用: + +```bash +ln -sf /opt/tailscale/tailscale /usr/local/bin/tailscale +``` + +之後即可在任何路徑直接執行 `tailscale status` 等指令。 + +## Proxmox LXC 部署注意事項 + +LXC 容器環境下 `/dev/net/tun` 不存在且無法用 `mknod` 建立,tailscaled 會啟動失敗。 + +**解法:** 使用 userspace networking 模式: + +```yaml +# docker-compose.yml +command: > + sh -c "tailscaled --tun=userspace-networking" +``` + +並移除 volumes 中的 `/dev/net/tun:/dev/net/tun` 掛載。 + +**注意:** +- `TS_USERSPACE=true` 環境變數在新版 Tailscale(v1.96+)無效,必須直接傳 `--tun=userspace-networking` 參數 +- userspace networking 模式**不支援** `--advertise-routes` 和 `--advertise-exit-node`,該節點無法作為子網路由器或出口節點 + +## 節點部署對照表 + +| 主機 | 類型 | Tailscale IP | 主機名稱 | 備註 | +|------|------|-------------|---------|------| +| 192.168.42.126 | Proxmox LXC | 100.64.0.8 | ip-192-168-42-126 | userspace networking,無路由/出口功能 | + ## 防火牆與路由設定 在主機上執行: diff --git a/README.md b/README.md index 3591ad4..dc36a7a 100644 --- a/README.md +++ b/README.md @@ -58,7 +58,25 @@ Tailscale 節點 ──► Headscale (headscale.lotimmy.com) ## 主機名稱慣例 -使用 `ip-192-168-88-XX` 格式,對應主機的區域網路 IP。 +使用 `ip-{LAN-IP}` 格式,例如 `ip-192-168-42-126`,對應主機的區域網路 IP。 + +## 部署後設定 + +建立 symlink 讓 `tailscale` 指令全域可用: + +```bash +ln -sf /opt/tailscale/tailscale /usr/local/bin/tailscale +``` + +## LXC 容器注意事項 + +Proxmox LXC 環境無 TUN 裝置,需使用 `tailscaled --tun=userspace-networking`。詳見 [OPERATIONS.md](OPERATIONS.md#proxmox-lxc-部署注意事項)。 + +## 節點部署對照表 + +| 主機 | 類型 | Tailscale IP | 主機名稱 | 備註 | +|------|------|-------------|---------|------| +| 192.168.42.126 | Proxmox LXC | 100.64.0.8 | ip-192-168-42-126 | userspace networking | ## 相關文件