docs: add NPM gRPC fix for external HTTPS exposure

Document the fix for 'server closed the stream without sending trailers'
gRPC error when exposing NetBird via Nginx Proxy Manager:
- NPM proxy_host advanced_config with grpc_pass for Signal/Management
- Caddy h2c listener enabled via 'protocols h1 h2 h2c'
This commit is contained in:
2026-04-18 09:23:23 +08:00
parent 6e956f7334
commit 655f07a198
3 changed files with 199 additions and 1 deletions

View File

@@ -80,6 +80,7 @@ reopen fd 8: permission denied
| Docker Compose `crun` runtime 未知 | `/etc/docker/daemon.json` 設定未生效 | `systemctl restart docker` |
| apt 的 crun 1.14.1 報 `unknown version specified` | crun 的 OCI spec 1.0.0 與 Docker 29.4 不相容 | 從 GitHub 下載 crun 1.20 |
| 502 Bad Gateway所有 API 端點) | netbird-server 下載 GeoLite2 中,尚未開始監聽 port 80 | 等待 2-5 分鐘 |
| 手機 App`server closed the stream without sending trailers` | 透過 NPM 對外公開時NPM 用 `proxy_pass` 而非 `grpc_pass` 轉 gRPC加上 Caddy `:80` 預設不支援 h2c | NPM 加 `advanced_config`gRPC 路由)+ Caddy 全域啟用 `protocols h1 h2 h2c`;見 [npm-grpc-fix.md](./npm-grpc-fix.md) |
## 檔案位置
@@ -89,7 +90,8 @@ reopen fd 8: permission denied
├── README.md ← 專案總覽
├── QUICKSTART.md ← 快速部署步驟
├── SUMMARY.md ← 本檔(部署摘要)
── netbird-selfhosted-setup.md ← 完整安裝指南
── netbird-selfhosted-setup.md ← 完整安裝指南
└── npm-grpc-fix.md ← 經 NPM 對外公開時的 gRPC 修復
```
### 遠端伺服器192.168.42.127:/opt/netbird/