mirror of
https://github.com/acepanel/acepanel.github.io.git
synced 2026-02-04 14:07:16 +08:00
136 lines
1.9 KiB
Markdown
136 lines
1.9 KiB
Markdown
# 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
|
||
```
|
||
|
||
3. 建立專案：
|
||
- **專案名**：`myapp`
|
||
- **專案目錄**：`/opt/ace/project/myapp`
|
||
- **啟動命令**：`node24 app.js`
|
||
4. 開啟 **反向代理**
|
||
|
||
## 啟動命令範例
|
||
|
||
```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
|
||
```
|
||
|
||
### 連接埠被佔用
|
||
|
||
修改應用程式監聽的連接埠，或檢查是否有其他進程佔用。
|