From a2946efeda11bea18bb91da029479a65a9d7a110 Mon Sep 17 00:00:00 2001 From: Timmy Date: Fri, 10 Apr 2026 09:59:56 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=96=B0=E5=A2=9E=20LXC=20=E9=83=A8?= =?UTF-8?q?=E7=BD=B2=E6=B3=A8=E6=84=8F=E4=BA=8B=E9=A0=85=E3=80=81=E7=AF=80?= =?UTF-8?q?=E9=BB=9E=E5=B0=8D=E7=85=A7=E8=A1=A8=E3=80=81symlink=20?= =?UTF-8?q?=E8=A8=AD=E5=AE=9A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 記錄 Proxmox LXC 環境需使用 --tun=userspace-networking 的解法、 TS_USERSPACE 環境變數在新版失效的坑，以及 /usr/local/bin 的 symlink 設定。 Co-Authored-By: Claude Opus 4.6 (1M context) --- OPERATIONS.md | 32 ++++++++++++++++++++++++++++++++ README.md | 20 +++++++++++++++++++- 2 files changed, 51 insertions(+), 1 deletion(-) 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 | ## 相關文件