在預算型 VPS 上設置簡單的客戶門戶網站

確保您部署的是一個重點明確的第一階段門戶網站，而不是一個定義不明的未來系統。

在接觸服務器之前，寫下您門戶網站最小的可用版本。

例如，您的第一階段可能僅包括：

• 安全登錄
• 狀態顯示
• 文件上傳或文件交付
• 小型請求列表
• 一個後台內部工作流程

您要避免的是為一個仍沒有明確界限的門戶網站部署基礎設施。

當應用程序首先只需要支持少數真實的工作流程時，簡單的生產部署會變得容易得多。

在安裝應用程序技術棧之前，從乾淨的服務器狀態開始。

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git ufw

如果您尚未配置防火牆，請允許您將會用到的基本端口：

sudo ufw allow OpenSSH
sudo ufw allow 80
sudo ufw allow 443
sudo ufw enable

這為公共 Web 服務提供了一個簡單的基準，同時不會讓主機完全暴露。

設置您的門戶應用程序在生產環境中將使用的運行環境和進程管理器。

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
sudo npm install -g pm2

檢查安裝情況：

node -v
npm -v
pm2 --version

PM2 將幫助您保持應用程序運行，並在重啟或崩潰後重新啟動它。

將應用程序移至服務器並為生產構建做準備。

cd /var/www
sudo mkdir -p client-portal
sudo chown $USER:$USER client-portal
cd client-portal

git clone <your-repo-url> app
cd app
npm install

如果您的存儲庫已經包含 lockfile，請保留它，以確保生產環境的安裝保持一致。

在啟動之前，配置門戶網站所需的生產設置。

根據您的應用程序預期的變量創建生產環境文件。

cp .env.example .env.production
nano .env.production

然後構建應用程序：

npm run build

典型的生產變量可能包括：

• 應用程序 URL
• 數據庫連接字符串
• 身份驗證密鑰
• 文件存儲配置
• 電子郵件發送設置

不要將這些值硬編碼到應用程序本身中。

以一種在斷開連接後仍能生存並可以自動重新啟動的方式運行應用程序。

對於典型的 Next.js 部署，您可以像這樣啟動生產服務器：

pm2 start npm --name client-portal -- start

保存進程列表並啟用重啟時啟動：

pm2 save
pm2 startup

pm2 startup 之後，PM2 會打印出另一個命令。請完全按照顯示的方式運行該命令。

然後確認進程已在線：

pm2 status

將 Caddy 放在應用程序前面，以便您的門戶網站通過您的域名安全地提供服務。

安裝 Caddy：

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
sudo apt install -y caddy

編輯 Caddyfile：

sudo nano /etc/caddy/Caddyfile

將內容替換為您的域名和本地應用程序端口：

portal.example.com {
    reverse_proxy 127.0.0.1:3000
}

然後重新加載 Caddy：

sudo systemctl reload caddy
sudo systemctl status caddy

一旦 DNS 指向正確，Caddy 就可以自動請求並更新 HTTPS 證書。

確認部署運作起來像一個真實的客戶門戶網站，而不僅僅是一個正在運行的 Web 應用程序。

在宣佈部署完成之前，測試對實際用戶重要的部分。

至少檢查以下內容：

• 門戶網站是否在正確的域名上加載
• HTTPS 是否已激活
• 登錄是否正常
• 主儀表板或落地頁是否正確渲染
• 任何與文件相關的工作流程是否按預期運行
• 瀏覽器控制台或 PM2 日誌中是否沒有錯誤

您可以使用以下命令檢查應用程序日誌：

pm2 logs client-portal

這次最終檢查非常重要，因為只有當業務工作流程正常運作時，門戶網站才是有用的，而不僅僅是服務器在線。