跳到內容
mofcloud

環境變數(ENV)

最後更新於:

只設定需要修改的項目,預設值不必寫入部署檔案。

在哪裡填寫

Compose 填在對應服務的 environment;K8S 填在對應容器的 env / envFrom。修改後請重建或重新啟動工作負載。

RK_* 對應 boot.yaml,數字為陣列索引。Compose 的布林值需加引號,字面上的 $ 要寫成 $$。RK 也會解析逗號和反斜線;新資料庫建議使用較長的隨機十六進位密碼,升級時保留原密碼。

本頁只列常用項目。boot.yaml 裡的任何值都能用同樣方式覆寫,規則見 rk-boot:覆寫設定 ↗。

Terminal · Compose
docker compose up -d
Terminal · Kubernetes
kubectl -n mof rollout restart deployment/mof

資料庫

變數預設值說明
RK_POSTGRES_0_ADDRlocalhost:5432PostgreSQL 位址:連接埠。
RK_POSTGRES_0_USERpostgres具備登入和 CREATEDB 權限的資料庫使用者。
RK_POSTGRES_0_PASSpassword填寫資料庫既有密碼。
RK_POSTGRES_0_DATABASE_0_MAXOPENCONN30每個 MOF 程序的最大資料庫連線數。多台或多個 Worker 時,總數不要超過資料庫上限。

全部參數見 rk-boot 文件 ↗

資料庫 Params 為空時預設為 sslmode=disable、TimeZone=Asia/Shanghai。MOF 的 TLS 設定未涵蓋雲端廠商資料庫,暫不支援強制 TLS 的 PostgreSQL。

服務與 Admin

變數預設值說明
MOF_ADMIN_PASSWORD—選用的 Admin 密碼覆寫值;未設定時於首次初始化自動產生。
RK_CONFIG_0_CONTENT_MODE_WEBfalse僅 Web 模式;一體式部署請勿設定兩個模式開關。
RK_CONFIG_0_CONTENT_MODE_WORKERfalse僅 Worker 模式,不能與僅 Web 模式同時開啟。
RK_CONFIG_0_CONTENT_JOBS_SYNCWORKERS2單一程序同時執行的同步工作數(帳單、資源、匯出)。
RK_CONFIG_0_CONTENT_JOBS_OPSWORKERS2單一程序同時執行的操作工作數(刪除帳號、清除帳單、套用虛擬標籤)。
MOF_JWT_SECRET—選用的登入簽章金鑰,至少 32 個字元。未設定時首次啟動自動產生並存入資料庫;設定後所有 MOF 程序必須一致。

跨來源

變數預設值說明
RK_GIN_0_MIDDLEWARE_CORS_ALLOWORIGINS_0*允許的瀏覽器來源,包含協定和連接埠,不包含路徑。
RK_GIN_0_MIDDLEWARE_CORS_ALLOWCREDENTIALSfalse跨來源攜帶憑證時,必須使用明確來源,不能使用 *。

全部參數見 rk-boot 文件 ↗

範例:跨來源攜帶憑證
Compose · mof.environment
RK_GIN_0_MIDDLEWARE_CORS_ALLOWORIGINS_0: "https://mof.example.com"
RK_GIN_0_MIDDLEWARE_CORS_ALLOWCREDENTIALS: "true"

新增來源請使用 _1、_2 等索引;啟用憑證時請替換預設的 *。

日誌

變數預設值說明
RK_LOGGER_0_ZAP_LEVELinfo應用程式日誌層級:debug、info、warn、error。
RK_LOGGER_0_ZAP_ENCODINGconsole應用程式日誌格式:console 或 json(接日誌收集系統時用 json)。
RK_GIN_0_MIDDLEWARE_LOGGING_ENABLEDtrueHTTP 請求日誌開關,與應用程式日誌獨立。
RK_POSTGRES_0_LOGGER_LEVELwarnSQL 日誌:info、warn、error、silent。

全部參數見 rk-boot 文件 ↗

MCP 與 OAuth

變數預設值說明
MOF_MCP_INTERNAL_URLhttp://mof-mcp:8001內部 MCP 位址,即 compose 服務名稱 / Kubernetes Service 名稱,不需設定。
MOF_PUBLIC_URL—OAuth 使用的 Dash 與 MOF 公開 HTTPS 位址,不含路徑。
MOF_MCP_OAUTH_SECRET—OAuth 密鑰,至少 32 個字元;各 MOF 節點保持一致。
範例:OAuth
Compose · mof.environment
MOF_PUBLIC_URL: "https://mof.example.com"
MOF_MCP_OAUTH_SECRET: "REPLACE_WITH_A_RANDOM_SECRET_AT_LEAST_32_CHARACTERS"

個人權杖不需要 OAuth。在 Admin → 設定 → MCP 中啟用存取。OAuth 設定完整不代表公網回呼已經驗證。

Dash 上游

變數預設值說明
MOF_UPSTREAMhttp://mof:8080MOF 位址,即 compose 服務名稱 / Kubernetes Service 名稱;只有 MOF 使用其他名稱時才需設定。

對外代理

變數預設值說明
HTTP_PROXY—選用的對外 HTTP 代理。
HTTPS_PROXY—選用的對外 HTTPS 代理。
NO_PROXY—排除內部主機和資料庫位址;各 SDK 的代理支援可能不同。

— 表示未設定。License 和使用者在 Admin 中管理。