只配置需要修改的项,默认值无需写入部署文件。
在哪里填写
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 中管理。