Toolmen 使用指南

連上 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 的版本號碼。

第一次連線

  1. 開始連線

    您可以使用下列任一種方式。

    終端機
    netbird up --management-url https://netbird.toolmen.bime.ntu.edu.tw:443
    您應該會看到

    瀏覽器開啟登入頁面。

    完整操作約 30 秒,可暫停影片並依序操作。
    1. 開啟 NetBird,從右上角的選單進入 Settings。
    2. 前往 Profiles,按 Add Profile。
    3. 在 Profile Name 輸入易於辨識的名稱。
    4. 在 Management Server 選取 Self-hosted,輸入 https://netbird.toolmen.bime.ntu.edu.tw,再按 Add Profile。
    5. 返回主畫面,確認上方選取的是剛才新增的 Profile,再按下方的開關。瀏覽器將開啟登入頁面。
  2. 在瀏覽器中登入

    NetBird 的 Sign in 頁面,有 Continue with Email 和 Continue with Keycloak 兩個按鈕
    選取 Continue with Keycloak。
    Keycloak 的登入頁面,有帳號和密碼欄位,以及 Sign In 按鈕
    輸入帳號與密碼,再按 Sign In。
  3. 確認連線狀態

    終端機
    netbird status
    您應該會看到
    Management: Connected
    Signal: Connected

    請確認這兩行即可。若 Peers count 顯示 0/N,並非故障:NetBird 會在實際連線時才與其他裝置建立連線。

    沒有顯示 Connected?

再次連線

再次連線時不需指定網址:

終端機
netbird up

延長登入狀態

登入狀態每 24 小時過期

過期後連線將會中斷,請於過期前延長。

使用桌面程式時:

  1. 請點選 NetBird 圖示。Windows 的圖示位於工作列右下角,若未看到,請先按 ^ 展開;macOS 的圖示位於畫面上方的選單列。
  2. 選單中的 Session expires in 一行會顯示剩餘時間。請點選此行,開啟 Session Expiring 視窗。
  3. 請按 Renew session,再於瀏覽器中登入。延長期間連線不會中斷。
NetBird 的選單顯示 Session expires in 19 hours;旁邊的 Session Expiring 視窗有倒數計時,以及 Renew session 和 Logout 兩個按鈕
點選 Session expires in 一行,再按 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 的 Session expired 視窗,說明裝置已斷線,有 Authenticate 和 Close 兩個按鈕
登入狀態過期時顯示的視窗。

使用終端機時,請執行下列指令,再於瀏覽器中登入:

終端機
netbird up