# 取得終端安裝包

Canonical: https://www.nsecsoft.com/tw/docs/ping64-platform/platform/endpoint-lifecycle/endpoint-onboarding/

Language: zh-TW

Updated: 2026-11-15T03:16:01.876575Z

管理員可透過「終端列表」取得終端安裝包。成功取得安裝包只表示檔案可供下載，不代表終端已安裝、連線或受到管理。

## 操作前提

-   本頁介紹私有部署中由控制台提供的安裝包取得方式。管理員需要具備新增終端及存取平台設定所需的權限。
-   伺服器需設定相應平台的預設安裝包版本，並提供對應安裝包。若下載失敗，請先聯絡平台管理員檢查安裝包是否已準備完成。
-   確認目標終端能夠存取所選伺服器，並依實際網路規劃準備伺服器位址或識別碼。安裝與批次分發應由具備相應終端管理權限的人員執行。

## 選擇平台與安裝包

1.  在控制台開啟「終端列表」，選擇「新增終端」。
2.  在彈出的視窗中選擇目標平台。
3.  依需要選擇安裝包類型並取得安裝包。

此視窗中，Windows 提供標準安裝包（`.exe`）及 MSI 安裝包（`.msi`）。macOS 提供 Apple Silicon 安裝包（`.pkg`）；Intel 安裝包選項無法選取。Linux 選項在此視窗中也無法選取。這些限制僅描述此入口目前可用的選項，不代表對其他安裝方式或平台能力的判斷。

## 取得 Windows 安裝包

頁面可能自動填入連線方式及伺服器參數；預設資訊不保證目標終端能夠存取伺服器。切換連線方式可能取代或清空已輸入的值，預設資訊載入完成時也可能更新目前輸入。取得標準安裝包或複製 MSI 無訊息安裝命令前，應重新確認連線方式及伺服器參數，並從目標終端所在網路驗證服務入口；不要僅憑格式驗證或下載成功判斷連線可用。

### 標準安裝包

1.  選擇 Windows 與「標準安裝包 (\*.exe)」。
2.  在「設定連線參數」中選擇「IP 位址」「網域」或「NDNS」，並填寫對應的伺服器參數。選擇 IP 位址時，請填寫有效的 IPv4 位址。
3.  選擇「取得安裝包」，下載完成後依組織的終端部署流程安裝。

下載的標準 EXE 檔名帶有所選的基本連線資訊；填寫的位址應與目標端點實際可存取的伺服器一致。下載、轉交或分發時，請保留完整原始檔名，不要重新命名或讓工具自動附加重複檔案標記。檔名改變或無法識別時，安裝可能繼續，但不會寫入初始伺服器位址。請重新取得原名安裝包，並在安裝後驗證端點連線。

### MSI 安裝包與無訊息安裝命令

1.  選擇 Windows，在「下載安裝包」中選擇「MSI 安裝包 (\*.msi)」，然後選擇「取得安裝包」。
2.  如需無訊息安裝，切換至介面的「靜默安裝命令」，選擇連線方式並填寫伺服器參數。
3.  確認命令對應已下載的安裝包與目標伺服器後，選擇複製，依組織的批次分發流程執行。

MSI 的伺服器連線參數由安裝命令提供。無訊息安裝適合自動化或統一分發；執行前應確認命令中的安裝包檔案位置、伺服器參數與目標範圍。

MSI 檔案本身不預設伺服器位址。使用頁面產生的無訊息安裝命令時，應同時保留連線類型與伺服器參數；若兩項均未提供，安裝可能成功但不會寫入伺服器位址。

## 取得 macOS 安裝包

1.  選擇 macOS，確認目標終端使用 Apple 晶片。
2.  選擇「取得安裝包」，下載 `.pkg` 檔案。
3.  依組織的 macOS 終端部署流程安裝，並完成環境要求的必要授權。

下載的 macOS 安裝包不預設伺服器連線資訊。安裝後應依組織的終端接入流程設定連線，並在終端清單驗證；安裝成功不代表已連線。

### 設定 macOS 用戶端連線

選單列入口與設定視窗可能顯示不同語言。繁體中文選單列入口為「客戶端設定…」，英文入口為「Client Settings…」；後續設定項請依視窗實際顯示確認。

1.  在終端開啟已安裝的 NSec 用戶端設定程式；若選單列圖示可見，也可從其選單選擇「客戶端設定…」或 **Client Settings…**。依提示輸入用戶端管理密碼；不清楚密碼時聯絡有權限的管理員，不要反覆猜測。
2.  在「常规／General」的「服务器连接／Server Connection」中，依管理員提供的位址選擇 IPv4、網域或 NDNS，填寫連線參數並選擇「应用／Apply」。位址必須是該終端可存取的服務入口；實際標籤依介面語言顯示。
3.  等待處理並檢查提示。儲存位址或顯示正在連線不代表已入網；返回管理端終端清單核對狀態，如等待審批，依組織流程處理。
4.  若終端原已連線其他伺服器，切換可能要求確認換綁：目前伺服器上的終端身分會被清除，終端必須在新伺服器重新入網。操作前向管理員確認影響；找不到設定入口、密碼驗證失敗或連線未完成時，聯絡管理員排查。

## 安裝後檢查

安裝完成後，在終端列表尋找目標終端，結合終端連線狀態確認是否已接入。若未出現或未連線，先核對安裝結果、伺服器參數、終端網路及相關授權與權限；持續異常時聯絡技術支援。實際生效時間取決於終端及網路狀態。
