設定 Nginx 開發伺服器¶

本指南將教您如何設定 Nginx 反向代理伺服器，讓 UOF X 能夠讀取您本機開發的項目。

運作原理¶

UOF X 透過以下方式載入您本機開發的項目，以外掛欄位為例：

表單設計時 - 從左側欄位清單拖曳外掛欄位到表單中
Nginx 轉址 - 將 UOF X 的請求轉向您的本機開發伺服器
即時預覽 - 在 UOF X 中直接看到開發中的外掛欄位效果

Image plugin-field-architecture — UOF X 外掛欄位執行架構

設定步驟¶

步驟 1：下載 Nginx¶

前往 Nginx 官方網站下載

注意

路徑不可存放於中文路徑

步驟 2：編輯 Nginx 設定檔案¶

使用文字編輯器（VS Code 或記事本）開啟 nginx.conf：

nginx.conf

# UOF X 外掛開發專用設定

events {
    worker_connections  1024;
}

http {
    include mime.types;
    default_type application/octet-stream;

    sendfile        on;
    keepalive_timeout  65;

    # 定義上游伺服器（您的開發伺服器）
    upstream PluginServer {
        server localhost:40001;  # 外掛專案預設埠號
    }

    # 主要代理伺服器設定
    server {
        listen 8899;  # Nginx 對外服務埠號

        # 處理版本路徑請求
        location /1_0/ {
            proxy_pass http://PluginServer/;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
        }

        # 處理根路徑請求
        location / {
            proxy_pass http://PluginServer/;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
        }
    }
}

步驟 3：設定監聽 Port（非必要）¶

若您於開發專案中修改了預設 Port（40001），請更新設定檔（nginx.conf）中的 server localhost。
（例如：server localhost:40002;）

步驟 4：啟動 Nginx 服務¶

# 在 Nginx 安裝目錄執行
nginx.exe

成功後，您的外掛模組將可透過 http://<your-ip>:8899/ 存取。

提醒

若設定檔（nginx.conf）有變更，需重新啟動 Nginx 服務以套用變更

步驟 5：在 UOF X 中註冊外掛模組¶

前往 UOF X 的 串接服務 > Plugin 管理，新增設定檔：

常見問題排解¶

Nginx 無法啟動¶

# 檢查埠號是否被佔用
netstat -ano | findstr :8899

# 測試設定檔案語法
nginx -t

UOF X 無法連線到外掛模組¶

確認 Nginx 執行中： 瀏覽器開啟 http://localhost:8899/
確認外掛專案執行中： 瀏覽器開啟 http://localhost:40001/
檢查防火牆設定： 允許相關埠號通過

版本資訊無法取得¶

確認外掛模組的版本資訊檔案存在

localhost:8899 出現 502 Bad Gateway¶

確認設定檔（nginx.conf）已依照步驟 2：編輯 Nginx 設定檔案設定，並已重新啟動 Nginx 服務以套用變更
（請將 Nginx 預設設定註解或移除）
確認設定檔（nginx.conf）設定之監聽 Port 與專案設定相符

下一步¶

繼續後續步驟

回到開發地圖