ServBay 文件:為您的專案、腳本與網站設定特定 Node.js 版本
ServBay 作為一套強大的本機 Web 開發環境,支援多種程式語言與技術棧,其中包含 Node.js。不論是不同專案、單一腳本,還是整個網站,您都可能會需要使用不同版本的 Node.js。例如,某個舊專案可能依賴 Node.js 14,而新專案則需要 Node.js 20 的新功能。ServBay 提供了高度彈性與便利的方法來滿足這些多變的需求。
本篇文件將詳細介紹如何在 ServBay 中輕鬆為 Node.js 腳本及網站指派明確的 Node.js 版本,以及如何運用專案級別的設定。
使用 .servbay.config 檔案為專案指定 Node.js 版本與設定
對於需嚴格控管 Node.js 版本及相關環境變數的專案,ServBay 提供了專案層級的設定機制:於專案根目錄建立 .servbay.config
檔案。透過這份設定檔,您可以為該專案指定 Node.js 的執行版本、套件管理器倉庫地址、快取目錄等,確保專案運行環境的隔離性與一致性。
以下是一份設定特定 Node.js 版本並配置 npm/yarn 倉庫與快取目錄的 .servbay.config
檔案範例:
NODE_VERSION=20
YARN_CONFIG_REGISTRY=https://registry.npmmirror.com/ # 範例:使用指定映像站
NPM_CONFIG_REGISTRY=https://registry.npmmirror.com/ # 範例:使用指定映像站
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache # 範例:指定快取路徑
YARN_CONFIG_CACHE=/Applications/ServBay/tmp/yarn/cache # 範例:指定快取路徑
2
3
4
5
說明:
NODE_VERSION
:指定此專案所使用的 Node.js 主版本。ServBay 會自動尋找並使用已安裝、與該主版本相符的 Node.js。YARN_CONFIG_REGISTRY
、NPM_CONFIG_REGISTRY
:配置專案所用 npm 或 yarn 套件管理器的註冊倉庫地址。NPM_CONFIG_CACHE
、YARN_CONFIG_CACHE
:設定 npm 或 yarn 用於此專案的快取目錄。範例中使用 ServBay 預設的暫存資料夾/Applications/ServBay/tmp/
下的子目錄。
通常,.servbay.config
應該放置於您專案的根目錄。詳細設定說明及使用方法,請參考 ServBay 官方文檔中 .servbay.config 檔案 這一章節。
透過命令列運行特定版本的 Node.js 腳本
若您不打算為專案設下固定的 Node.js 版本,而是僅需臨時指定某個版本來執行腳本或指令,則可善用 ServBay 提供的指令列別名功能。
在 ServBay 的終端機環境中(可經 ServBay 主程式介面開啟終端機),只需使用 node-<版本號>
指令,即可輕鬆指定欲執行 Node.js 腳本時所採用的 Node.js 版本。ServBay 會自動為每一已安裝的 Node.js 版本創建此類別名。
舉例而言,欲以 Node.js 14 執行 script.js
,可如下操作:
$ node-14 script.js
Hello World
Node.js Version: 14.17.0 # 範例輸出,實際版本號或有不同
$ node-16 script.js
Hello World
Node.js Version: 16.3.0 # 範例輸出,實際版本號或有不同
$ node-20 script.js
Hello World
Node.js Version: 20.10.0 # 範例輸出,實際版本號或有不同
2
3
4
5
6
7
8
9
10
11
範例說明
$ node-14 script.js
:以 ServBay 安裝的 Node.js 14 版本(14.x.x,實際小版本依安裝狀況而異)執行script.js
。$ node-16 script.js
:以 Node.js 16 版本執行script.js
。$ node-20 script.js
:以 Node.js 20 版本執行script.js
。
此方式可讓您彈性測試各 Node.js 版本間的兼容性,或臨時以特定版本執行需相容的腳本而不必調整全域 Node.js 版本。
透過 ServBay 管理介面為網站指定 Node.js 版本
您亦可直接從 ServBay 管理介面,為每個託管網站設定預設 Node.js 執行版本。這一功能特別適用於需依賴 Node.js 作為後端(如以 Node.js 框架建構並透過 Caddy 或 Nginx 反向代理的應用)或需特定 Node.js 環境的網站。
操作步驟
- 打開 ServBay 管理介面:啟動 ServBay 應用程式,並於瀏覽器輸入管理介面網址(通常為
http://localhost:5200
,或可從主視窗點擊快捷連結)。 - 前往網站管理:於側邊導航列中,點擊「網站」(Website)選項。
- 選取並編輯網站:在網站列表中尋找欲設定的網站(例如
/Applications/ServBay/www/servbay.demo
所建立網站),點擊該站右側的編輯按鈕(多為齒輪或鉛筆圖示),或點擊網站名稱進入詳情頁。 - 設定 Node.js 版本:於網站設定頁尋找 Node.js 版本相關選項,常為下拉選單。由下拉選單選取作為本網站預設執行的 Node.js 版本。
- 儲存變更:選定版本後,請務必點擊頁底的【儲存】或【套用】按鈕,將設定存檔。
- 重啟網站或 ServBay(如有必要):個別設定變更需重啟相關 Web 伺服器(如 Caddy, Nginx)或重啟整個 ServBay 才會生效。ServBay 會提示是否須重啟服務以套用變更。
注意事項
- 確認欲選版本已安裝並運作中:於網站設定時選定的 Node.js 版本必須已於 ServBay 「套件」(Packages)頁安裝並處於啟動狀態。如尚未安裝或啟動,請先前往該頁操作。
- 網站型態:此設置主要影響需使用 Node.js 作為執行環境的網站(如用 Express.js、Next.js、NestJS 等打造的應用)。純靜態網站或僅以 PHP/Python/Go 等語言為後端者則不適用或影響有限。
- 兼容性測試:變更 Node.js 版本後,請務必完整測試網站功能,確保所有依賴與服務可於新環境下順利運作,無兼容性疑慮。
- 與
.servbay.config
的關係:網站層級設置為預設值,若網站目錄下同時存在.servbay.config
並指定NODE_VERSION
,則以.servbay.config
為準,因專案級設定優先權較高,可做更細緻的控管。
總結
ServBay 作為一款全方位本機開發環境,提供數種靈活且強大的 Node.js 執行環境管理方式。您可藉由專案根目錄的 .servbay.config
進行嚴謹專案級與環境變數控管,也能透過簡潔的 node-<版本號>
指令列語法快速使用指定版本 Node.js 執行腳本,或直接於 ServBay 管理介面為網站設定預設 Node.js 執行環境。這些功能能協助您輕鬆應對多專案、多場景下的 Node.js 版本需求,不論是兼容舊專案、測試新特性,或確保開發生產一致性,ServBay 都可為您提供完善支援,大幅提升開發效率與環境管理能力。