只設定需要修改的項目,預設值不必寫入部署檔案。
在哪裡填寫
Compose 填在對應服務的 environment;K8S 填在對應容器的 env / envFrom。修改後請重建或重新啟動工作負載。
RK_* 對應 boot.yaml,數字為陣列索引。Compose 的布林值需加引號,字面上的 $ 要寫成 $$。RK 也會解析逗號和反斜線;新資料庫建議使用較長的隨機十六進位密碼,升級時保留原密碼。
本頁只列常用項目。boot.yaml 裡的任何值都能用同樣方式覆寫,規則見 rk-boot:覆寫設定 ↗。
Terminal · Compose
docker compose up -dTerminal · Kubernetes
kubectl -n mof rollout restart deployment/mof資料庫
| 變數 | 預設值 | 說明 |
|---|---|---|
RK_POSTGRES_0_ADDR | localhost:5432 | PostgreSQL 位址:連接埠。 |
RK_POSTGRES_0_USER | postgres | 具備登入和 CREATEDB 權限的資料庫使用者。 |
RK_POSTGRES_0_PASS | password | 填寫資料庫既有密碼。 |
RK_POSTGRES_0_DATABASE_0_MAXOPENCONN | 30 | 每個 MOF 程序的最大資料庫連線數。多台或多個 Worker 時,總數不要超過資料庫上限。 |
資料庫 Params 為空時預設為 sslmode=disable、TimeZone=Asia/Shanghai。MOF 的 TLS 設定未涵蓋雲端廠商資料庫,暫不支援強制 TLS 的 PostgreSQL。
服務與 Admin
| 變數 | 預設值 | 說明 |
|---|---|---|
MOF_ADMIN_PASSWORD | — | 選用的 Admin 密碼覆寫值;未設定時於首次初始化自動產生。 |
RK_CONFIG_0_CONTENT_MODE_WEB | false | 僅 Web 模式;一體式部署請勿設定兩個模式開關。 |
RK_CONFIG_0_CONTENT_MODE_WORKER | false | 僅 Worker 模式,不能與僅 Web 模式同時開啟。 |
RK_CONFIG_0_CONTENT_JOBS_SYNCWORKERS | 2 | 單一程序同時執行的同步工作數(帳單、資源、匯出)。 |
RK_CONFIG_0_CONTENT_JOBS_OPSWORKERS | 2 | 單一程序同時執行的操作工作數(刪除帳號、清除帳單、套用虛擬標籤)。 |
MOF_JWT_SECRET | — | 選用的登入簽章金鑰,至少 32 個字元。未設定時首次啟動自動產生並存入資料庫;設定後所有 MOF 程序必須一致。 |
跨來源
| 變數 | 預設值 | 說明 |
|---|---|---|
RK_GIN_0_MIDDLEWARE_CORS_ALLOWORIGINS_0 | * | 允許的瀏覽器來源,包含協定和連接埠,不包含路徑。 |
RK_GIN_0_MIDDLEWARE_CORS_ALLOWCREDENTIALS | false | 跨來源攜帶憑證時,必須使用明確來源,不能使用 *。 |
範例:跨來源攜帶憑證
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_LEVEL | info | 應用程式日誌層級:debug、info、warn、error。 |
RK_LOGGER_0_ZAP_ENCODING | console | 應用程式日誌格式:console 或 json(接日誌收集系統時用 json)。 |
RK_GIN_0_MIDDLEWARE_LOGGING_ENABLED | true | HTTP 請求日誌開關,與應用程式日誌獨立。 |
RK_POSTGRES_0_LOGGER_LEVEL | warn | SQL 日誌:info、warn、error、silent。 |
MCP 與 OAuth
| 變數 | 預設值 | 說明 |
|---|---|---|
MOF_MCP_INTERNAL_URL | http://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_UPSTREAM | http://mof:8080 | MOF 位址,即 compose 服務名稱 / Kubernetes Service 名稱;只有 MOF 使用其他名稱時才需設定。 |
對外代理
| 變數 | 預設值 | 說明 |
|---|---|---|
HTTP_PROXY | — | 選用的對外 HTTP 代理。 |
HTTPS_PROXY | — | 選用的對外 HTTPS 代理。 |
NO_PROXY | — | 排除內部主機和資料庫位址;各 SDK 的代理支援可能不同。 |
— 表示未設定。License 和使用者在 Admin 中管理。