專屬伺服器（裸機）

後台位置： Infrastructure › Bare Metal (Servers /infra/baremetal, IP Pools, Stock / iDRAC import, Operations, Templates, Customer ISOs, Safety)。方案與訂閱：Services › Dedicated Server (/dedicated)。在 System › Admin › License & updates (/license) 下啟用模組。

功能

NexCMP 直接透過 iDRAC 經由 Redfish API 管理實體伺服器。客戶租用整台伺服器：他們可以開關機、開啟瀏覽器主控台、掛載 ISO 或從範本安裝作業系統，並檢視硬體與計量數據。他們永遠不會看到 iDRAC 位址、使用者名稱或密碼。

用它來轉售來自您自己機櫃的專屬伺服器。

需求

項目	需求
硬體	具備 iDRAC 9 與 Redfish API 的 Dell 伺服器。
管理網路	由您自行提供。面板伺服器必須能夠透過HTTPS 443連線至每台iDRAC（以及供主控台使用的iDRAC VNC連接埠，預設為5901），且每台iDRAC都必須能夠連線至下方的ISO網頁伺服器。iDRAC位址必須是您在設定dedicated_bmc_cidrs中所列出的私人範圍IPv4位址（RFC 1918，/16或更小的前綴）。系統不接受DNS名稱與IPv6。NexCMP不會建立此網路，也無法為您進行測試。
iDRAC 帳號	每台iDRAC上需有一個具備Administrator權限的帳號。NexCMP會使用此帳號讀取伺服器資訊，並傳送其允許執行的少數指令（電源、虛擬媒體、單次開機、主控台）。NexCMP絕不會為您的客戶建立iDRAC帳號。
面板伺服器上的工具	xorriso與genisoimage（建置每台伺服器的安裝ISO）以及novnc（瀏覽器主控台頁面）。請使用sudo apt-get install -y xorriso genisoimage novnc進行安裝，或由安裝程式代勞：加上--baremetal執行安裝程式，或提供ISO伺服器選項；若Bare Metal模組已啟用，執行更新時也會一併安裝。若缺少任一工具，Safety會以紅色提示列出，live ops將拒絕啟用（錯誤tools_missing），且主控台與作業系統安裝會直接回應缺少工具，而非在後續步驟才失敗。
ISO 網頁伺服器	管理網路上的一般HTTP伺服器，負責將NexCMP ISO資料夾提供給各iDRAC。其位址為私人IPv4位址與選填的連接埠（例如http://10.20.0.2:8080，不含路徑），儲存於dedicated_iso_base_url中。該伺服器必須支援位元組範圍。由於該資料夾由面板的Worker寫入，因此網頁伺服器通常直接在面板伺服器本身運作，並監聽該伺服器在管理網路上的位址。NexCMP隨附了現成的nginx站台與單一步驟指令以供配置（見下文）。
ISO 資料夾	用於儲存ISO檔案的資料夾，內部包含pub（供iDRAC讀取）與server（客戶ISO）。單一步驟指令會使用/srv/nexcmp-iso；若未使用該指令，預設值將依循安裝設定（設定項dedicated_iso_lib_dir、dedicated_iso_pub_dir、dedicated_iso_server_dir）。NexCMP Worker必須能夠對其進行寫入。除/var/lib/nexcmp外，Worker以唯讀檔案系統運作，因此位於其他位置的資料夾需要systemd drop-in設定檔（單一步驟指令會自動安裝）。
回呼位址	dedicated_callback_base，一個安裝中的伺服器可以存取並指向您的面板的 https://<your-domain>。
儲存	供 ISO 圖書館與客戶提供的 ISO 使用的可用磁碟空間。
相依於	Bare Metal 模組、一個區域，以及伺服器的 IP 池。

範例值並非正式設定

全新安裝會在dedicated_bmc_cidrs、dedicated_iso_base_url與dedicated_callback_base中帶有範例值（私人範例網路與https://example.com）。這些都不是您的實際網路。只要其中任何一項仍為範例值，Bare Metal頁面就會顯示紅色的Management network not configured提示、匯入iDRAC時將無法通過允許清單檢查，且live ops開關會拒絕開啟（錯誤config_placeholder）。請在Infrastructure › Bare Metal › Safety › Management network connection下設定這三個數值（見下文）。

準備基礎設施

1. 將每個 iDRAC 放在客戶無法存取的管理網路上，並為每一個指派固定的私有 IPv4 位址。從面板伺服器檢查 Redfish API：

   curl -sk -u 'nexcmp-admin:XXXX' https://10.20.0.11/redfish/v1/Systems | head

2. 在 iDRAC 上為 NexCMP 建立管理員帳號（透過 iDRAC 網頁 UI 或 racadm）。請使用強固且唯一的密碼。切勿重複使用 iDRAC 的內建帳號。

3. **將ISO資料夾發布給iDRAC — 單一指令。**在面板伺服器上以root身分執行，並附帶該伺服器在管理網路上的位址與iDRAC網路：

   sudo nexcmp dedicated-setup-iso --listen 10.20.0.2:8080 --allow 10.20.0.0/24

   --listen必須是此伺服器的位址（私人IPv4，若省略則連接埠為8080）。--allow列出iDRAC網路（私人CIDR，/16或更小，最多8個，以半形逗點分隔）；僅允許這些網路下載，且當該設定仍為範例值時，指令也會將它們做為dedicated_bmc_cidrs使用。--dir /path可指定其他ISO資料夾（預設為/srv/nexcmp-iso）。該指令會：

   • 建立包含內部pub與server的資料夾，擁有者為NexCMP服務使用者；
   • 建立群組nexcmp-iso並將nginx使用者加入其中，以便當iDRAC掛載ISO時nginx可讀取該ISO，而其他人皆無法讀取；
   • 安裝nginx站台nexcmp-iso（僅在nginx -t接受時保留，若未安裝nginx則會自動安裝）以及systemd drop-innexcmp-vmd.service.d/iso.conf（針對該資料夾的ReadWritePaths，SupplementaryGroups=nexcmp-iso）；
   • 寫入ISO設定（dedicated_iso_base_url、三個資料夾、群組）並重啟NexCMP Worker。

   您可以傳入其他數值再次執行，而sudo nexcmp dedicated-setup-iso --remove會將nginx站台與drop-in設定檔移除（ISO檔案將保留）。此操作亦可在安裝時執行：只需在安裝指令中加入--iso-listen、--iso-allow（以及--iso-dir）。此指令不會建立管理網路，也不會連線至任何iDRAC；若數值有誤、位址不在這台伺服器上或連接埠已被佔用，它會在變更任何設定前停止並顯示訊息，且若nginx -t拒絕該nginx站台，則不會予以保留。

4. **ISO Web伺服器提供服務的內容。**nginx站台僅回應GET（以及支援byte ranges的HEAD）針對/pub/<name>.iso的請求，此外一概不回應：沒有目錄列表、該資料夾下沒有其他路徑（資源庫與server/皆無法存取）、沒有其他方法，且僅限來自--allow網路（其他所有來源皆傳回403）。NexCMP會將iDRAC需要讀取的每個ISO以檔案或短期連結的形式公開於pub；nginx只有在連結與其目標擁有相同擁有者（服務使用者）時才會跟隨連結，因此指向系統檔案的連結會被拒絕。請從管理網路上的另一台主機進行檢查：

   curl -I http://10.20.0.2:8080/            # 403 or 404, never a listing
   curl -I http://10.20.0.2:8080/pub/        # 403 or 404

   在pub中的測試檔案應以206回應Range請求。

   *改為手動操作：*nginx站台與drop-in在發行套件中以範本形式提供（即share/dedicated/nginx-iso.conf與share/dedicated/vmd-iso.conf，位於/opt/nexcmp/releases/<version>/之下）。複製它們並替換__...__標記（監聽位址、資料夾、allow行、群組），同時保留上述規則。

5. 準備好作業系統映像檔。 將自動安裝的 ISO 放置在程式庫資料夾中（請參閱下方的 Templates）。客戶也可以從連結新增 ISO；這些會被下載到伺服器，絕不會作為 URL 提供給 iDRAC。

在 NexCMP 中連線

1. 啟用模組

在 System › Admin › License & updates 上，開啟 Bare Metal。Bare Metal 分類會出現在「基礎設施」下方。請參閱 Modules。

2. 設定管理網路連線

開啟Infrastructure › Bare Metal › Safety。Management network connection卡片包含決定各項功能是否可運作的三個數值：

欄位	設定	輸入內容
iDRAC網路（CIDR）	dedicated_bmc_cidrs	您的iDRAC私人網路，例如10.20.0.0/24。僅限私人CIDR、/16或更小、最多8個、以逗號分隔。僅能匯入這些範圍內的iDRAC。
供iDRAC使用的ISO伺服器	dedicated_iso_base_url	http://<private IPv4>[:port]，不含路徑：上一節中ISO網頁伺服器的位址，例如http://10.20.0.2:8080。一步指令會自動為您填入。
控制台回呼位址	dedicated_callback_base	https://<your-domain>，不含路徑：正在安裝的伺服器回報完成時呼叫的位址。該位址必須能從該伺服器的網路存取。系統會拒絕example.com、localhost及類似位址。

表單會在您輸入時檢查格式，伺服器則會在儲存時再次檢查；不正確的數值會連同原因一起被拒絕，而已儲存的值則維持原狀。仍保留隨附範例值的欄位會帶有紅色的Not configured標籤，且在三個值皆填入真實數值之前，每個Bare Metal頁面都會顯示紅色提示Management network not configured。變更連同您的原因皆會記錄至稽核日誌中。除非是您自行輸入，否則再次儲存範例值不算完成設定。

3. 檢查安全閘門（目前先保持關閉）

開啟Infrastructure › Bare Metal › Safety。Live ops是全系統層級的開關，控制所有傳送至iDRAC的寫入指令（電源、虛擬媒體、主控台與作業系統安裝）。其初始狀態為關閉，且在上述管理網路連線仍保留範例數值時無法開啟（該開關會回應config_placeholder並指出欄位名稱）。寫入操作會在API層級與worker內部再次被拒絕，而讀取狀態功能則持續運作。第二道鎖ops_locked用於保護個別伺服器：即使live ops已開啟，新匯入的伺服器也一律處於鎖定狀態。

4. 匯入伺服器

1. 開啟 Infrastructure › Bare Metal › Stock / iDRAC import。

2. 在 Add one server 下方輸入 iDRAC 位址、帳號與密碼，然後點擊 Test connection。此測試僅傳送讀取指令且不儲存任何內容。

   欄位	範例值
   iDRAC位址（URL或主機）	10.20.0.11
   帳號	nexcmp-admin
   Password	XXXX
   Label	rack1-01（空白：自動產生）
   從位址池指派IP	選填；選擇伺服器的服務 IP 池
   納入銷售清單	在準備好之前保持關閉

   

3. 點擊 Save to stock。NexCMP 會從 iDRAC 讀取型號、CPU、RAM、磁碟、NIC 與服務標籤。該伺服器將以上鎖狀態進入庫存。

4. 若要處理多台伺服器，請使用 Bulk import：每行一台伺服器，欄位以逗號、分號或 Tab 分隔。Preview 會檢查允許清單、iDRAC 位址或服務標籤的重複項，並讀取硬體資訊（一次最多四台伺服器）。

5. 客戶ISO與ISO網頁位址

開啟 Infrastructure › Bare Metal › Customer ISOs。

• HTTP address serving ISOs to iDRAC為dedicated_iso_base_url，與Safety卡片中的值相同（在任一處皆可編輯）。請輸入您ISO網頁伺服器的管理網路位址。
• Customer ISO limits 可設定單一 ISO 的大小、總 ISO 儲存空間、最低可用空間、ISO 保留時間（小時）、最大下載時間與同時下載次數。

6. 作業系統範本

開啟Infrastructure › Bare Metal › Templates。此處會列出在資源庫資料夾中找到的自動安裝ISO。在檔案上按一下Register以填寫OS系列、版本與帳號（會根據檔案名稱預先填入），接著將範本切換為Enable。啟用範本不會啟動任何作業：每次安裝仍需通過安全閘門。Unregister只會移除範本資料列，絕不會刪除檔案。

7. IP池

開啟 Infrastructure › Bare Metal › IP Pools 並新增伺服器作為服務地址接收的 IPv4 範圍。每台伺服器會取得一個地址；匯入時的 Assign an IP from a pool 會取得下一個可用地址。每個池會獨立計算可用地址數。

8. 方案與銷售

1. 開啟Services › Dedicated Server › Plans & pricing。編輯四個範例方案（在1.6.1中名為BM-40C-<RAM>）或建立您自己的方案：價格、週期與設定費。在全新安裝中，價格以美元為單位輸入至分，且電子錢包將扣除完全相同的金額：無需匯率換算。若原有安裝已採用越南盾定價方案，則會保留越南盾，且設定中仍需配置匯率（若未設定，訂單將會被拒絕並顯示dedicated_fx_unavailable）。範例方案的初始價格為0且處於已停用狀態：上架銷售的方案價格必須大於0。請根據您實際匯入的硬體檢查每個方案；範例方案名稱不會偵測或變更伺服器的硬體。
2. 開啟伺服器（Infrastructure › Bare Metal › the server › Sales），附加方案並開啟Sellable。
3. 開啟live ops（安全頁面，需輸入確認文字）並解鎖您想要操作的伺服器（伺服器的 Lock 分頁，需填入會記錄至稽核日誌的原因）。
4. 在 Services › Dedicated Server 中開啟銷售功能。這需要兩個步驟：閱讀後果說明，然後輸入 ENABLE SALES。在此之前，客戶不會看到訂單頁面且不會被收費。

客戶在其伺服器頁面上可執行的操作

客戶的伺服器頁面包含7個群組共16個分頁（Overview、Control、Network、Hardware、Billing、Activity、Settings）。Billing群組包含：

• 方案與續約：一次預先支付1到24個月；新到期日自目前續約日開始起算，並自錢包扣款一次。可隨時開啟或關閉自動續約。
• Billing cycle：選擇其他週期（例如每季）；自下次續約時生效，目前不會扣款或退款。
• Change plan：客戶可以申請更換方案。提交申請不會產生任何費用。在您升級硬體或遷移伺服器後，可在Services › Dedicated Server › Plan changes批准或拒絕。批准升級時會針對客戶已付款週期的剩餘天數收取差額；降級則不予退款，並自下一週期起生效。
• Invoices：該伺服器的所有帳單（訂單、續約、升級）。

在Plan changes中，可依ID、日期、狀態、方案或伺服器排序請求；排序會套用至伺服器端的所有結果。在較窄的螢幕上水平捲動時，操作欄將保持可見。

在Overview頂部，四個即時資訊圖塊顯示CPU、RAM、Disk與Network，並附有過去24小時的微型圖表。CPU、RAM與Disk為上次iDRAC輪詢的使用率百分比（Disk為I/O活動，非可用空間）；Network為目前連入與連出速度加上當月總計，取自流量計數器。當伺服器關機、無法連線至iDRAC，或機器未回報該數值時，圖塊會顯示**—及簡短原因；絕不會顯示捏造的0。這些讀數來自Dell iDRAC，若沒有流量計數器，Network圖塊將維持—。頁面開啟時圖塊每分鐘重新整理一次，點擊即可開啟Hardware或Bandwidth**分頁。

在Overview中，Access卡片會顯示您安裝的作業系統使用者名稱與密碼，預設隱藏並提供Show與Copy按鈕。每次安裝後皆可查看，不限一次，且伺服器的新擁有者絕不會看到前任擁有者的密碼。若在伺服器內部變更了作業系統密碼，該卡片仍會顯示安裝時設定的密碼。Bandwidth分頁僅在有流量計數器提供數據時顯示（請參閱限制）。系統未提供Subnet分頁：NexCMP不支援將自備IP前綴帶入租用的伺服器。

客戶可以與不可以執行的操作

客戶可以	永遠無法執行
查看硬體狀態、健康狀況、電源狀態與計量數據	查看 iDRAC 位址、使用者名稱或密碼
開機、正常關機、重新開機、強制關機、重設	變更 iDRAC 帳號或 iDRAC 網路設定
開啟瀏覽器主控台（一次一個連線工作階段）	變更 BIOS 或 RAID、清除日誌、更新韌體、重設 iDRAC
掛載 ISO 或自訂 ISO 連結、設定單次開機、從啟用的範本重新安裝作業系統	執行原始 Redfish 呼叫（這些功能在 NexCMP 中不存在）

NexCMP不會為客戶建立iDRAC帳號：客戶僅能使用入口網站的控制功能，且系統絕不會向其顯示iDRAC位址與登入資訊。

驗證

0. 在Safety中，Management network connection卡片未顯示紅色標籤，且Bare Metal頁面未顯示紅色提示。從管理網路上的主機執行curl -I http://<iso-address>/不會列出檔案。
1. 匯入表單上的 Test connection 會傳回型號、CPU、RAM 與服務標籤。
2. 伺服器會顯示在 Servers 中並帶有其硬體資訊。當 live ops off 時，任何電源操作都會被拒絕，並顯示「Server control is temporarily disabled system-wide」。
3. 在開啟 live ops 並解鎖一台測試伺服器後，從 Operations 或伺服器頁面將伺服器關機再開機，並開啟主控台。
4. 使用測試方案建立測試訂單：指派伺服器、安裝作業系統，並在安裝結束時由伺服器向面板回報。

限制與注意事項

• 每台實體伺服器最多只能有一個現役訂閱。
• 寫入指令只有在同時開啟 live ops 且伺服器鎖定為解鎖狀態時才會送出。此檢查會在背景工作行程中於每個指令執行前立即重複進行。
• Installing 狀態會等待新作業系統在其連接埠（SSH 22、Windows 3389、Proxmox 8006）上回應後才完成訂單；安裝作業設有時間限制（dedicated_install_timeout_min，預設 150 分鐘）。
• 專屬伺服器的頻寬是由非標準安裝隨附的流量計數代理程式計算。若未安裝，將不會記錄任何資料，入口網站會隱藏Bandwidth分頁，且API會將capabilities.bandwidth回報為false。
• 針對租用項目的管理員操作（鎖定、解鎖、退款或不退款取消）與其他所有服務的操作一致，退款會退回當初付款的餘額帳戶。
• 伺服器不會透過經銷商進行二次銷售：Dedicated 僅從主網站銷售。

故障排除

症狀	原因	修正方式
測試失敗並顯示位址錯誤	該位址不是 dedicated_bmc_cidrs 中的 IPv4 字面值（私有位址、/16 或更小），或者不允許該連接埠	請使用iDRAC的IPv4位址，並在Safety › Management network connection（dedicated_bmc_cidrs）下新增其網路。系統不接受DNS名稱與IPv6。
紅色提示「Management network not configured」，或即時操作開關回應config_placeholder	dedicated_bmc_cidrs、dedicated_iso_base_url、dedicated_callback_base其中之一仍保留出廠預設範例值	請在Safety › Management network connection下輸入實際數值。
儲存時欄位遭到拒絕	格式錯誤（CIDR非私有網路或範圍大於/16、ISO位址不是http://<private IPv4>[:port]、callback不是https://<domain>），或是使用了例如example.com的範例位址	請查看欄位下方的訊息；已儲存的數值未變更。
nexcmp dedicated-setup-iso在變更任何內容前即停止	--listen不是此伺服器的位址、連接埠已被佔用，或數值無效	請使用此伺服器在管理網路上的位址、更換其他連接埠，或更正訊息中指出的數值。
「iDRAC TLS 憑證與釘選的不符 - 輪詢與寫入動作已停止」	iDRAC 憑證已更換（新憑證、更換了 iDRAC）	開啟伺服器，進入 Access 分頁，比較兩組指紋，若確為預期變更，請點擊 Repin certificate。
「系統全域已暫時停用伺服器控制」	即時運作已關閉	請在 Safety 中開啟。
「此伺服器已鎖定操作」	個別伺服器鎖定已啟用	請在伺服器的 Lock 標籤頁中解除鎖定並填入原因。
「此伺服器目前有其他正在執行的操作」	先前的操作尚未完成	請稍候；並檢查 Operations。
「此伺服器已有其他開啟的主控台工作階段」	同時只能有一個主控台	請關閉其他工作階段。
「伺服器控制器暫時無法使用」	iDRAC 無回應	請檢查管理網路與 iDRAC。
掛載 ISO 失敗並收到來自 iDRAC 的 403 或 404	網頁伺服器無法讀取檔案，或是基底位址錯誤	請檢查 ISO 網頁伺服器的權限以及 HTTP address serving ISOs to iDRAC。
「所選區域中的此方案目前無庫存」	該區域中沒有使用該方案的可銷售伺服器	請將方案套用至伺服器並開啟 Sellable。
「目前沒有可指派的 IPv4 位址」	IP 池已耗盡	請在池中新增位址。
「目前無法使用自動作業系統安裝」	安裝必要條件不足	請檢查是否已啟用範本且 ISO 資料夾具備寫入權限；客戶仍可透過 ISO 與主控台進行安裝。
安裝停滯	安裝中的伺服器無法連線至回呼位址	請檢查 dedicated_callback_base 以及伺服器網路是否能透過 HTTPS 連線至您的控制台。