Toolmen 使用指南

問題排除

以下依症狀列出問題與解決方式。

Windows 沒有 winget，無法安裝 opkssh

執行 winget install openpubkey.opkssh 時，系統顯示找不到 winget。

winget 隨 Windows 的 App Installer 提供，部分電腦並未安裝。您可以使用下列任一種方式解決。

方式一：安裝 App Installer

請依 Microsoft 的 WinGet 說明安裝 App Installer，再開啟新的終端機，重新執行 winget install openpubkey.opkssh。

方式二：直接下載 opkssh

此方式不需要系統管理員權限，也不需要 winget。請在 PowerShell 依序執行下列指令。

  1. 建立存放程式的資料夾

    PowerShell
    New-Item -ItemType Directory -Force "$env:USERPROFILE\bin"

  2. 下載 opkssh

    PowerShell
    curl.exe -L https://github.com/openpubkey/opkssh/releases/latest/download/opkssh-windows-amd64.exe -o "$env:USERPROFILE\bin\opkssh.exe"

    若電腦為 ARM64，請將 opkssh-windows-amd64.exe 改為 opkssh-windows-arm64.exe。

  3. 將資料夾加入 Path 環境變數

    PowerShell
    [Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\bin", "User")

  4. 確認安裝結果

    請開啟新的終端機，再執行：

    PowerShell
    opkssh --version
    您應該會看到

    opkssh 的版本號碼。

    完成後，請回到 設定 Keycloak 繼續操作。

macOS 沒有 Homebrew，無法安裝 opkssh

執行 brew install opkssh 時，系統顯示找不到 brew。

您可以直接下載 opkssh，不需要 Homebrew。請在終端機依序執行下列指令。

  1. 下載 opkssh

    終端機
    curl -L https://github.com/openpubkey/opkssh/releases/latest/download/opkssh-osx-arm64 -o opkssh

    上述為 Apple Silicon 的網址。若為 Intel，請將 opkssh-osx-arm64 改為 opkssh-osx-amd64。您可以執行 uname -m 確認：arm64 為 Apple Silicon，x86_64 為 Intel。

  2. 將 opkssh 移至系統路徑

    終端機
    chmod +x opkssh
    終端機
    sudo mkdir -p /usr/local/bin
    終端機
    sudo mv opkssh /usr/local/bin/

  3. 確認安裝結果

    終端機
    opkssh --version
    您應該會看到

    opkssh 的版本號碼。

    完成後，請回到 設定 Keycloak 繼續操作。

macOS 開啟 iCloud 私密轉送後，NetBird 無法正常使用

已有同仁在 Mac 開啟 iCloud+ 的私密轉送（Private Relay）時，遇到 NetBird 無法正常使用的情況。

請在「系統設定」進入 Apple 帳號，選擇 iCloud，再關閉私密轉送。關閉後，請重新連線並確認狀態：

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

關閉私密轉送後，Safari 將不再透過私密轉送隱藏您的瀏覽活動。詳細說明請參閱 Apple 的私密轉送說明。

聯絡窗口

如有其他問題，請聯絡 Toolmen admin 陳子員（Aaron）：