Nginx 基礎設定教學：安裝、設定檔檢查與反向代理入門

如何安裝與啟動 Nginx？

macOS 可用 Homebrew 安裝 Nginx。Linux 伺服器則通常用發行版套件管理工具，例如 `apt`、`dnf` 或 `yum`。

macOS 安裝：

```bash

brew install nginx

```

常用控制指令：

```bash

nginx

nginx -s stop

nginx -s reload

```

在 Linux production 環境，通常會交給 systemd 管理：

```bash

sudo systemctl start nginx

sudo systemctl enable nginx

sudo systemctl reload nginx

```

Nginx 設定檔在哪裡？

Nginx 設定檔位置會因安裝方式而不同。最可靠的方式是執行 `nginx -t`，它會顯示設定檔路徑並檢查語法。

```bash

nginx -t

```

常見位置：

注意：原文提到 `ngix.conf`，正確檔名通常是 `nginx.conf`。修改設定前先備份，修改後一定要跑 `nginx -t`。

Nginx 主要可以做什麼？

Nginx 最常見用途是提供靜態資源與反向代理。靜態資源由 Nginx 直接回應，動態 API 則轉發給後端應用程式。

資訊增益：把 Nginx 放在 Node.js、Python 或 Java 應用程式前面，通常不是為了「讓程式變快」而已，更重要的是把 TLS、靜態檔案、壓縮、proxy header 與 timeout 集中管理。

反向代理是什麼？

反向代理是由 Nginx 代表後端伺服器接收使用者請求，再把請求轉給內部服務。使用者只看到 Nginx 的網址，不需要知道後面有幾台 application server。

最小反向代理範例：

```nginx

server {

listen 80;

server_name example.com;

location / {

proxy_pass http://127.0.0.1:3000;

proxy_set_header Host $host;

proxy_set_header X-Real-IP $remote_addr;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

proxy_set_header X-Forwarded-Proto $scheme;

}

}

```

如果後端需要 WebSocket，還要補上 upgrade header：

```nginx

proxy_set_header Upgrade $http_upgrade;

proxy_set_header Connection "upgrade";

```

修改 Nginx 設定後怎麼安全套用？

修改 Nginx 設定後，不要直接重啟。先用 `nginx -t` 檢查語法，確認成功後再 reload，避免服務因設定錯誤中斷。

安全流程：

```bash

sudo nginx -t

sudo systemctl reload nginx

```

若不是 systemd 環境：

```bash

sudo nginx -s reload

```

reload 會讓 Nginx 重新讀取設定，通常比 stop/start 更適合線上服務。

常見問題

QNginx 和 Apache 有什麼不同？

Nginx 常被用在高併發靜態檔案與反向代理場景。Apache 模組生態成熟，兩者都能做 Web Server，選擇通常取決於團隊經驗與部署架構。

QNginx 修改設定後一定要重啟嗎？

不一定。多數設定可用 reload 套用，建議先 `nginx -t`，再執行 reload。

QNginx 可以代理 Node.js API 嗎？

可以。常見做法是讓 Node.js 監聽 localhost port，再由 Nginx 對外提供網域、HTTPS 與反向代理。

QNginx 設定檔錯了怎麼辦？

若尚未 reload，修正設定後重新 `nginx -t`。若已造成服務異常，回復備份設定並 reload。

QNginx 反向代理需要設定 header 嗎？

通常需要。`Host`、`X-Real-IP`、`X-Forwarded-For` 與 `X-Forwarded-Proto` 可讓後端知道原始請求資訊。

參考資料

• Nginx Documentation：Beginner's Guide
• Nginx Documentation：Reverse Proxy
• Nginx Documentation：Command-line parameters

最後更新

本文最後更新於 2026-08-27。原文發布於 2019-10-07，本文補上 systemd、設定檔檢查與 WebSocket proxy 注意事項。

延伸閱讀

• CentOS 安裝 Nginx RTMP 模組：openssl、zlib、pcre 編譯流程
• 使用 PM2 管理 Node.js 伺服器教學
• Linux 基本操作指令介紹
• Linux crontab 排程設定教學：時間格式、特殊字元與常用範例

關於作者 {#author}

Claire Chang ｜ 企業 AI 導入與流程轉型顧問。專注於 AI Agent 架構設計、ERP 系統整合與企業 AI 治理。

首次發布：2019-10-07