繁體中文

简体中文
English

繁體中文

简体中文
English

主題

Node.js 專案 ​

Node.js 專案用於部署 Express、Koa、NestJS、Next.js 等 Node.js 應用。

前置要求 ​

  1. 安裝 Node.js 執行環境：應用 > 執行環境 > Node.js
  2. 專案原始碼

部署步驟 ​

  1. 上傳專案程式碼到伺服器
  2. 安裝依賴：
bash
cd /opt/ace/project/myapp
npm24 install
  1. 建立專案：
    • 專案名：myapp
    • 專案目錄：/opt/ace/project/myapp
    • 啟動命令：node24 app.js
  2. 開啟 反向代理

啟動命令範例 ​

bash
# 直接執行
node24 app.js

# 使用 npm scripts
npm24 start

# 使用 npm run
npm24 run start:prod

# 設定環境變數
NODE_ENV=production node24 app.js

# 指定連接埠
PORT=3000 node24 app.js

常用框架 ​

Express ​

javascript
const express = require('express');
const app = express();

app.get('/', (req, res) => {
    res.send('Hello World');
});

app.listen(3000);

啟動命令：node24 app.js

NestJS ​

bash
# 建置
npm24 run build

啟動命令：node24 dist/main.js

Next.js ​

bash
# 建置
npm24 run build

啟動命令：npm24 start

Nuxt.js ​

bash
# 建置
npm24 run build

啟動命令：node24 .output/server/index.mjs

進程管理 ​

AcePanel 使用 systemd 管理 Node.js 進程，自動處理：

  • 進程崩潰自動重啟
  • 開機自動啟動
  • 日誌記錄

環境變數 ​

推薦使用 .env 檔案管理環境變數：

bash
# .env
NODE_ENV=production
PORT=3000
DATABASE_URL=mysql://localhost:3306/mydb

使用 dotenv 套件載入：

javascript
require('dotenv').config();

常見問題 ​

依賴安裝失敗 ​

嘗試清除快取重新安裝：

bash
rm -rf node_modules package-lock.json
npm24 install

記憶體不足 ​

增加 Node.js 記憶體限制：

bash
NODE_OPTIONS="--max-old-space-size=4096" node24 app.js

連接埠被佔用 ​

修改應用程式監聽的連接埠，或檢查是否有其他進程佔用。