【MERN】佈署注意事項:記得分離前後端路由

在佈署前,把React.js建立的前端build目錄上傳到主機後,後端API可能會不見,因為路徑被前端覆蓋了。要怎麼解決呢?你需要在Node.js的啟動檔中設定前後端的路徑,將前後端分離。

一、建立前端頁面

1-1. 建立前端頁面之前的所需設定

在MERN專案中,伺服器端(server)與客戶端(client)是分離的,它們都有各自的目錄與package.json檔,第一步需要找到客戶端的package.json,並對 homepage 屬性填入即將佈署的網域,例如:

{
  "name": "mobuyashea",
  "version": "0.1.0",
  "private": true,
  "homepage": "https://mobuyashea.club/",
  "dependencies": {
   //下略

1-2. 生成build資料夾

接著,你需要幫客戶端的內容建立靜態頁面,確定位於client目錄下,於終端機輸入:

npm run build

按下確認鍵後,npm會於client目錄建立一個build資料夾,裡面的內容為前端靜態頁面。

二、MERN佈署時的目錄結構

MERN專案的佈署目錄結構大概如下,外面根目錄放伺服器端的內容,包括啟動檔、伺服器端的package.json、資料表或路由等;build則是客戶端的內容,就是把第一步建立的目錄整包上傳:

/root
|– /build(前端)
|– /models
|– /public
|– /routes
|– server.js (啟動檔)
|– package.json
|– package-lock.json

也可以把伺服器端跟客戶端的目錄完全分開,不過要注意下一步路由的設定,根據路由文件與首頁相對位置的不同,可能會變成“/../client/build”

/root
|– /client/build(前端)
|– /server
|–– server.js (啟動檔)

三、分離MERN專案的前後端路由

打開你的啟動檔(假設文件叫server.js),引入path模組:

const path = require('path');

‘ * ‘ 將所有路由通通歸類於前端頁面,不管訪問哪個路由都返回build目錄下的index.html:

app.get('*', (req, res) => {
  res.sendFile(path.join(__dirname, 'build', 'index.html'));
});
app.get('*', (req, res) => {
  res.sendFile(path.resolve(__dirname, 'build', 'index.html'));
});

用path.join() 簡單的規範路徑,或用path.resolve() 返回絕對路徑,兩者在此範例下返回的是相同的路徑__dirname 是目前文件所處的位置。

四、注意先後順序

撰寫API時,定位前端靜態目錄的程式碼必須位於後端路由之後,後端路由都發配完後才輪到'*'。順序不能優先於其他後端路徑,否則會把其他路徑給覆蓋掉。

【主機管理】讓2個不同域名/網站共用同一個主機

你想要經營第二個網站,但覺得主機的空間還很大,不想再買新主機。那麼,兩個擁有不同域名的網站可以共用一個主機嗎?絕對可以。

以下是你一定要先做的第一步:

第一步、到網域供應商後台設定第二個域名的DNS

到網域供應商的管理後台,設定DNS的A紀錄 以及 CNAME紀錄,才能節省時間,順利進行下一步。

兩個域名共用一主機-更改或新增A RECORD
Record 類型Record 名稱Record 值
A record@填寫主機的IP位址,例如123.199.123.888
A record子網域名稱(選填)填寫主機的IP位址,可跟主網域不同
CNAME recordWWW填寫網域名稱,以本站為例就是mobuyashea.club

修改DNS之後,需要過一段時間才會生效,第二步如果執行失敗,可能是因為DNS設置有誤或尚未生效導致的。

第二步、到主機後台(C-Panel)新增第二個網站的域名

登入主機的CPanel,找到並點選 Domains

想安裝在子網域,點選進入domain頁面

進入網域管理畫面後,點選右上角新增域名(Create A New Domain)按鈕。

新增網域-輸入第二個網域的名稱

Domain 輸入框中,例如 example.com。
確保 Document Root 位於一个新的目錄,例如/home/yourcpenal/example.com

建議不要跟第一個網域共用public_html目錄,如果public_html裡面有第一個網站在運作中,會比較容易混淆。請讓他在File Manager建立最外側一個新的目錄,目錄名稱為第二個網域。

如果第一步的DNS設定有順利完成,新增時應該不會出現錯誤提示。

第三步、把第二個網站的內容上傳到新目錄

把第二個網站的內容打包上傳到上一步建好的新目錄(/home/yourcpenal/example.com),這樣一來,當你輸入第二個網站的網址(example.com),就能看到剛剛上傳的網站。

新站與原本放在public_html目錄的網站有所區隔,實現了不同網域、網站內容放在同一個主機上運作的目標。

【主機管理】如何在C-panel管理介面新增信箱

已經買了主機跟網域,接著想使用自購網域的信箱寄Email,或收發訪客填表訊息嗎?跟著以下步驟,在C-penal後台建立一個專屬的聯絡信箱吧。

進入C-penal主機管理後台,找到Email Accounts,點選進入。

第一次進入,會問你之後要不要直接登入管理畫面(記得是英文,可惜我截不到畫面了),把問題的選項打勾,按下確認送出。

如果英文不好,請善用瀏覽器的英翻中功能,確保能看懂大部分的字

接著就會進到管理畫面,裡面有個系統預設的email帳號(不能刪)。

按右上角的『+Create』按鈕,新增自訂的email使用者帳密,例如:support@domain.com

創建完信箱後,你就可以使用這個email來收發網站訪客的填表訊息

Node.js 網站佈署 – 共享主機可以安裝Node.js嗎?

Node.js 是 JavaScript 框架愛好者的福音,它實現了用 JavaScript 撰寫後端程式碼的需求。但要如何將 Node.js 放到主機上運作呢?你可能已經嘗試過靜態網站部署,但還不知道將自己製作的 API 放到主機上的方法。這篇文章將為你詳細介紹相關操作。

1.共享主機可以安裝Node.js

共享主機可以安裝Node.js,但在安裝之前,你需要於檔案管理員(File Manager)建立一個空的文件夾,用於安裝Node App。這個資料夾的名稱會根據網域名稱有所不同,主要有以下兩種狀況:

-狀況1. 安裝於主網域,於根目錄建立與主網域同名的文件夾

找到File Manager按鈕,並點選。

node.js安裝第一步-先找到file manager

進入主機檔案管理畫面,按左上角的『+Folder』 於根目錄新增文件夾,若主網域為domain.com,該文件夾命名為domain.com(關於命名方式,請看下方Tips)。

node.js安裝第二步-進入file manager後,新增folder文件夾
維持App URI和 App Root Directory的一致性是約定俗成的慣例,沒有硬性規定。目錄名稱和App URI可以不同,但可能會導致其他人在查找時混淆。

-狀況2. 安裝於子網域,同步建立子網域的同名文件夾

在cPenal建立子網域,並同步建立子網域的同名文件夾。
找到Domains按鈕,並點選進入網域管理頁。

想安裝在子網域,點選進入domain頁面

點選右上角Create A New Domain按鈕,建立新的子網域,並在欄位上填入子網域名稱,例如:test.domain.com,Document root會自動填入子網域的名稱。

進入domain頁面後,按下新增按鈕
輸入你想使用的子網域名稱,此情況不用手動創建,當子網域建立時,file manager會自動創建根目錄
此情況不用手動創建,當子網域建立時,file manager會自動創建根目錄
你可以在網域管理頁面(Domains)新增其他的主網域,把其他主網域指向此主機的某個目錄文件夾。

2.把網站打包上傳至File Manager

把.env、node modules目錄、.git排除在外,選擇其餘必要檔案並壓縮成zip,上傳到第一步建立好的目錄文件夾,並在裡面解壓縮。
不管你使用什麼框架,裡面至少要有:

  1. node.js啟動文件(名稱可能為server.js、app.js或index.js)
  2. 紀錄npm套件的package.json檔案

Node.js才能依據這份依賴清單(package.json)去安裝npm套件,並透過啟動文件進行啟動。

node.js網站的npm依賴文件
網站的npm依賴文件

3.安裝Node.js


登入主機的cPanal後台,找到Setup Node.js App選項,並點選進入。

找到node.js app按鈕並點選進入

進入Node.js App管理頁面,如果你曾經在這個主機建立過Node.js App,下方會有一串列表顯示目前Node.js App的狀態。

要創建新的Node.js App,請點選右上角的『Create Application』按鈕。

按右上角的創建新App按鈕
  1. 選擇需要Node.js的版本
  2. App mode選Production
  3. App root如果位於根目錄,直接填寫目錄文件夾的名稱(例如:domain.com或test.domain.com)
  4. App URL可點選更換網域,如果設在子目錄下再去填空白的欄位,沒有則略過
  5. 填寫啟動文件名稱(通常是server.js)
  6. 新增環境變數,例如資料庫的URI
  7. 按下右上角Create按鈕
確定填完所有node.js的設定項目後,按下Create創建按鈕
確定填完所有node.js的設定項目後,按下Create創建按鈕

創建完成後,先暫時停止App,執行Run npm install安裝套件,再重新啟動Node App。

先停止運行,再安裝npm套件,安裝完再啟動
在Node.js運作的狀態下,點選安裝npm套件,可能會導致安裝不成功,變更選項時盡量按部就班操作,先關閉node.js,安裝完之後再啟動。