設定 Nginx 開發伺服器¶

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

運作原理¶

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

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

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

設定步驟¶

步驟 1：編輯 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;
        }
    }
}

步驟 2：啟動 Nginx 服務¶

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

成功後，您的外掛模組將可透過 http://localhost:8899/ 存取。

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

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

常見問題排解¶

Nginx 無法啟動¶

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

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

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

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

版本資訊無法取得¶

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

下一步¶

繼續後續步驟

回到開發地圖