2025年10月17日 星期五

Ubuntu 安裝 Node.js 的兩種最佳實踐方式

Ubuntu 安裝 Node.js 的兩種最佳實踐方式

在 Ubuntu 系統中,Node.js 其實已經存在於官方套件庫中,可以直接透過 apt 安裝。但這個版本通常落後於官方最新版本

若希望取得最新版或方便切換多版本,建議使用以下兩種方式之一




方法一:使用 NodeSource(官方建議的 APT 外部庫)

這是最常見的「系統層級」安裝方式,由 NodeSource 提供編譯好的二進制檔。
它能讓你直接透過 apt 安裝最新的穩定版 Node.js。


官方來源參考: distributions/DEV_README.md

步驟:

# 加入 NodeSource 官方提供的最新 Node.js 安裝腳本(以 24.x 為例)
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -

# 安裝 Node.js 與 npm
sudo apt install -y nodejs

# 驗證版本
node -v
npm -v

優點:

  • 系統層級安裝,所有使用者可共用。
  • 可與 Ubuntu 的自動更新整合。
  • 適合伺服器、CI/CD 環境。

缺點:

  • 安裝或升級需使用 sudo
  • 若需多版本切換(例如 Node 16 與 22 共存)不方便。




方法二:使用 NVM(Node Version Manager)

這是由社群維護的 Node.js 版本管理器,能讓你以使用者身份安裝 Node.js(非系統層級)。
適合開發者或有多專案需求的環境。

官方來源參考: nvm-sh/nvm GitHub Repository

步驟:

# 下載並安裝 nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# 不想重新啟動 shell 時,執行:
\. "$HOME/.nvm/nvm.sh"

# 下載並安裝 Node.js:
nvm install 24

# 核對板本:
node -v # Should print "v24.10.0".
npm -v # 應會印出 "11.6.1"。

優點:

  • 不需 sudo 權限即可安裝。
  • 可快速切換 Node.js 版本。
  • npm 安裝時自動位於使用者目錄(例如 ~/.npm),更安全。

缺點:

  • 只對目前使用者有效。
  • 系統服務(如 systemd)不會直接使用 NVM 環境。



2025年10月1日 星期三

npm 反向代理 http 服務 cockpit (自動更新SSL)

使用 Nginx Proxy Manager(NPM)做反向代理並自動更新 SSL 憑證

這是連續的關於架設網站的系列

  1. 在 ubuntu 使用 docker 架設 nginx 靜態網站伺服器
  2. 使用 duckdns 轉發自建的靜態網頁伺服器
  3. npm 反向代理 nginx 靜態網站 (自動更新SSL)
  4. npm 反向代理 http 服務 portainer (私簽SSL)
  5. npm 反向代理 http 服務 cockpit (自動更新SSL)



這是接續 npm 反向代理 nginx 靜態網站 (自動更新SSL) 的進階篇,前面的東西不再重複,記得先回到這篇做完才接著繼續看這裡

在上一篇已經完成網站的建制,現在要把改成一個實際的別人做的專案做練習
這裡使用 cockpit 當範例,創建一個 duck.dns 對外網域的網站

這篇跟直接反向代理 nginx 的那篇差異在於,範例用的靜態網站完全沒有安全限制所以不需要特別處理,這裡抓一個正常有安全限制的服務 cockpit 來當範例



安裝 cockpit

這個有被內建在 ubuntu 中直接用 apt 就可以安裝了

sudo apt install cockpit
sudo systemctl enable --now cockpit.socket

安裝好之後就可以用 http:\localhost:9090 直接打開了



反向代理設定注意事項

在使用 Nginx Proxy Manager 等反向代理時,需要在 cockpit.conf 中進行以下設定:

  1. AllowUnencrypted = true - 允許後端 HTTP 通訊
    由於反向代理與 Cockpit 之間通常使用未加密的 HTTP 連接,此設定讓 Cockpit 接受來自代理服務器的 HTTP 請求,而 SSL/TLS 加密則由前端代理統一處理。
  2. ProtocolHeader = X-Forwarded-Proto - 識別真實協議類型
    反向代理會通過 X-Forwarded-Proto header 告知 Cockpit 用戶端實際使用的協議(HTTPS),確保 Cockpit 生成正確的重定向 URL 並避免瀏覽器混合內容警告。
  3. Origins = https://your-domain.com - 限制跨域請求來源
    明確指定允許的域名以防止 CSRF 攻擊,切勿使用 Origins = https: 或 Origins = *,否則任何第三方網站都能向您的 Cockpit 發送請求,造成安全風險。


編輯 cockpit.conf

sudo nano /etc/cockpit/cockpit.conf

輸入以下 (第三行記得改成自己的網域)

[WebService]
AllowUnencrypted = true
ProtocolHeader = X-Forwarded-Proto
Origins = https://cockpit.yourdomain.com

然後存檔即可



npm 反向代理

這裡用上一篇已經生成的網域就好,回到 npm 的 proxy 頁面把 Forward Port 從 8081 改成 9090 即可續用。

然後再瀏覽你自己的網域 https://chgsite.duckdns.org 應該就能看見你的網站了