Ir al contenido
mofcloud

Variables de entorno (ENV)

Última actualización:

Define solo lo que necesites cambiar. Deja los valores predeterminados fuera de tu archivo de despliegue.

Dónde definir ENV

Compose: environment en el servicio indicado. Kubernetes: env / envFrom en el contenedor indicado. Recrea o reinicia la carga de trabajo después de los cambios.

Los nombres RK_* se corresponden con boot.yaml; los números son índices de array. En Compose, pon los booleanos entre comillas y escapa un $ literal como $$. RK también interpreta comas y barras invertidas; usa una contraseña hexadecimal larga y aleatoria para bases de datos nuevas. Conserva las contraseñas existentes al actualizar.

Esta página enumera las más comunes. Cualquier valor de boot.yaml se puede sobrescribir de la misma forma; consulta rk-boot: Override boot ↗.

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

Base de datos

VariablePredeterminadoDescripción
RK_POSTGRES_0_ADDRlocalhost:5432Dirección:puerto de PostgreSQL.
RK_POSTGRES_0_USERpostgresRol de base de datos con permisos de login y CREATEDB.
RK_POSTGRES_0_PASSpasswordUsa tu contraseña de base de datos existente.
RK_POSTGRES_0_DATABASE_0_MAXOPENCONN30Número máximo de conexiones a la base de datos por proceso de MOF. Con varios procesos, mantén el total por debajo del límite de la base de datos.

Todas las opciones en la documentación de rk-boot ↗

Si Params de la base de datos está vacío, se usa sslmode=disable y TimeZone=Asia/Shanghai. MOF no aplica TLS a las bases de datos de proveedores; PostgreSQL solo con TLS no es compatible.

Servidor y Admin

VariablePredeterminadoDescripción
MOF_ADMIN_PASSWORD—Sobrescritura opcional de la contraseña de Admin; si no, se genera en la primera configuración.
RK_CONFIG_0_CONTENT_MODE_WEBfalseModo solo web. Deja ambos flags de modo sin definir para all-in-one.
RK_CONFIG_0_CONTENT_MODE_WORKERfalseModo solo worker; no lo habilites junto con el modo solo web.
RK_CONFIG_0_CONTENT_JOBS_SYNCWORKERS2Trabajos de sincronización (facturas, recursos, exportaciones) que se ejecutan a la vez en un proceso.
RK_CONFIG_0_CONTENT_JOBS_OPSWORKERS2Trabajos de operaciones (eliminar una cuenta, purgar facturas, aplicar una etiqueta virtual) que se ejecutan a la vez en un proceso.
MOF_JWT_SECRET—Clave de firma de inicio de sesión opcional, de al menos 32 caracteres. Sin definir: se genera en el primer arranque y se guarda en la base de datos. Si se define, usa el mismo valor en todos los procesos de MOF.

CORS

VariablePredeterminadoDescripción
RK_GIN_0_MIDDLEWARE_CORS_ALLOWORIGINS_0*Origen de navegador permitido, con esquema y puerto; sin ruta.
RK_GIN_0_MIDDLEWARE_CORS_ALLOWCREDENTIALSfalsePara credenciales entre orígenes, usa orígenes explícitos en lugar de *.

Todas las opciones en la documentación de rk-boot ↗

Ejemplo: credenciales entre orígenes
Compose · mof.environment
RK_GIN_0_MIDDLEWARE_CORS_ALLOWORIGINS_0: "https://mof.example.com"
RK_GIN_0_MIDDLEWARE_CORS_ALLOWCREDENTIALS: "true"

Añade orígenes con _1, _2, etc. Sustituye el * predeterminado cuando se habiliten las credenciales.

Logs

VariablePredeterminadoDescripción
RK_LOGGER_0_ZAP_LEVELinfoNivel de log de la aplicación: debug, info, warn, error.
RK_LOGGER_0_ZAP_ENCODINGconsoleFormato de log de la aplicación: console o json (para recolectores de logs).
RK_GIN_0_MIDDLEWARE_LOGGING_ENABLEDtrueLogging de solicitudes HTTP; independiente de los logs de la aplicación.
RK_POSTGRES_0_LOGGER_LEVELwarnLogging de SQL: info, warn, error, silent.

Todas las opciones en la documentación de rk-boot ↗

MCP y OAuth

VariablePredeterminadoDescripción
MOF_MCP_INTERNAL_URLhttp://mof-mcp:8001Dirección interna de MCP: el nombre del servicio de compose / Service de Kubernetes. Déjala sin definir.
MOF_PUBLIC_URL—Origen HTTPS público de OAuth compartido por Dash y MOF, sin ruta.
MOF_MCP_OAUTH_SECRET—Secreto de OAuth, de al menos 32 caracteres; compartido entre los nodos de MOF.
Ejemplo: OAuth
Compose · mof.environment
MOF_PUBLIC_URL: "https://mof.example.com"
MOF_MCP_OAUTH_SECRET: "REPLACE_WITH_A_RANDOM_SECRET_AT_LEAST_32_CHARACTERS"

Los tokens personales no necesitan OAuth. Habilita el acceso MCP en Admin → Configuración → MCP. El estado de configuración de OAuth no garantiza que la callback pública sea accesible.

Upstream de Dash

VariablePredeterminadoDescripción
MOF_UPSTREAMhttp://mof:8080Dirección de MOF: el nombre del servicio de compose / Service de Kubernetes. Defínela solo cuando MOF se ejecute con otro nombre.

Proxy saliente

VariablePredeterminadoDescripción
HTTP_PROXY—Proxy HTTP saliente opcional.
HTTPS_PROXY—Proxy HTTPS saliente opcional.
NO_PROXY—Excluye los hosts internos y las direcciones de la base de datos. La compatibilidad varía según el SDK.

— significa sin definir. La licencia y la gestión de usuarios se hacen en Admin.