連上 NetBird
實驗室的服務皆位於內網,您的電腦須先登入 NetBird 才能存取。
開始之前
- 您需要一組 Keycloak 帳號。若尚未擁有,請先開通帳號。
安裝
請依 NetBird 官方的 Windows 安裝說明下載並執行安裝程式。安裝完成後,請開啟新的終端機,再進行下一步。
curl -fsSL https://pkgs.netbird.io/install.sh | sh
腳本結束時會提示執行 netbird up,請勿直接執行,否則會連至 NetBird 官方的雲端服務。請改用下方第一次連線的指令。
您也可以下載安裝檔:Intel 或 Apple Silicon。
curl -fsSL https://pkgs.netbird.io/install.sh | sh
腳本結束時會提示執行 netbird up,請勿直接執行,否則會連至 NetBird 官方的雲端服務。請改用下方第一次連線的指令。
請確認安裝結果:
netbird version
您應該會看到
NetBird 的版本號碼。
第一次連線
-
開始連線
您可以使用下列任一種方式。
netbird up --management-url https://netbird.toolmen.bime.ntu.edu.tw:443您應該會看到瀏覽器開啟登入頁面。
完整操作約 30 秒,可暫停影片並依序操作。 - 開啟 NetBird,從右上角的選單進入 Settings。
- 前往 Profiles,按 Add Profile。
- 在 Profile Name 輸入易於辨識的名稱。
- 在 Management Server 選取 Self-hosted,輸入
https://netbird.toolmen.bime.ntu.edu.tw,再按 Add Profile。 - 返回主畫面,確認上方選取的是剛才新增的 Profile,再按下方的開關。瀏覽器將開啟登入頁面。
-
在瀏覽器中登入
選取 Continue with Keycloak。
輸入帳號與密碼,再按 Sign In。 -
確認連線狀態
netbird status您應該會看到Management: Connected Signal: Connected
請確認這兩行即可。若
Peers count顯示 0/N,並非故障:NetBird 會在實際連線時才與其他裝置建立連線。
再次連線
再次連線時不需指定網址:
netbird up
延長登入狀態
登入狀態每 24 小時過期
過期後連線將會中斷,請於過期前延長。
使用桌面程式時:
- 請點選 NetBird 圖示。Windows 的圖示位於工作列右下角,若未看到,請先按
^展開;macOS 的圖示位於畫面上方的選單列。 - 選單中的 Session expires in 一行會顯示剩餘時間。請點選此行,開啟 Session Expiring 視窗。
- 請按 Renew session,再於瀏覽器中登入。延長期間連線不會中斷。
使用終端機時,請執行下列指令;此指令僅能在連線狀態下執行。
netbird login --extend
若要查看剩餘時間,請執行 netbird status,並查看 Session expires 一行:
netbird status
您應該會看到
Session expires: 2026-11-06T08:30:59Z (in 23h 55m)
登入狀態已過期時
連線中斷後無法使用 netbird login --extend,請重新登入。
使用桌面程式時,系統會顯示下列視窗。請按 Authenticate,再於瀏覽器中登入。
使用終端機時,請執行下列指令,再於瀏覽器中登入:
netbird up