Restringe el acceso a la red

Úsalo cuando tus cadenas deban quedarse en tu propia red, por ejemplo con un modelo autoalojado detrás de openai-compatible o un servidor LibreTranslate detrás de libretranslate. Una baseUrl mal escrita, un OPENAI_BASE_URL olvidado o el cambio a un proveedor alojado enviarían si no las cadenas a un endpoint público. Con una política de red, verbatra rechaza un host que la política no permite antes de que ninguna petición salga de la máquina. Qué contiene una petición se explica en Tratamiento de datos y privacidad.

Define una políticaCopiar enlace a esta sección

Añade un bloque network a la configuración (network en la referencia):

network: {
  policy: "local-only",
}

Cada entrada de allowedHosts es un nombre de host (llm.internal, sin distinguir mayúsculas), un comodín (*.corp.example, solo subdominios, con al menos dos etiquetas tras *.), una dirección IP o un rango CIDR como 100.64.0.0/10. No escribas esquema, puerto ni ruta. Un octeto mayor que 255, un prefijo más largo que la dirección (más de /32 o /128) o una dirección IPv6 malformada se rechaza al cargar la configuración o el entorno.

local-only deja fuera las direcciones link-local (169.254.0.0/16, que incluye la dirección de metadatos de la nube, y fe80::/10), el rango de NAT de operador 100.64.0.0/10, y 0.0.0.0 y ::. Si tu servidor escucha en 0.0.0.0, apunta baseUrl a 127.0.0.1; si usas un rango de VPN, añádelo a allowedHosts.

Proveedores alojadosCopiar enlace a esta sección

Con local-only, anthropic, openai, gemini, deepl, google-translate y opencode se rechazan, porque sus endpoints son públicos. Para permitir uno, añade su host:

network: {
  policy: "local-only",
  allowedHosts: ["api.deepl.com"],
}

Los hosts son api.anthropic.com, api.openai.com, generativelanguage.googleapis.com, api.deepl.com (api-free.deepl.com para una clave que termina en :fx), translation.googleapis.com y opencode.ai. Si ANTHROPIC_BASE_URL, OPENAI_BASE_URL o GOOGLE_GEMINI_BASE_URL está definida, verbatra comprueba ese endpoint en su lugar. Gemini en modo Vertex AI (GOOGLE_GENAI_USE_VERTEXAI o GOOGLE_GENAI_USE_ENTERPRISE a true) siempre se rechaza con una política restrictiva.

Fija una política desde el entornoCopiar enlace a esta sección

Para imponer una política en CI, diga lo que diga la configuración del repositorio:

export VERBATRA_NETWORK_POLICY=local-only
export VERBATRA_NETWORK_ALLOWED_HOSTS=gpu.lan,10.20.0.0/16

VERBATRA_NETWORK_ALLOWED_HOSTS es una lista separada por comas de entradas de allowedHosts. Cuando la configuración y el entorno definen una política, un host debe cumplir ambas, así que una configuración nunca puede relajar lo que fija el entorno.

Un valor desconocido, como local_only, o la lista de hosts sin la variable de política hacen fallar la ejecución con CONFIG_INVALID en lugar de permitir cualquier host. translate --dry-run y --estimate también comprueban estas variables, salvo con el proveedor none.

Comprueba la políticaCopiar enlace a esta sección

Ejecuta verbatra doctor: informa de la política efectiva, de dónde sale cada parte, del host del proveedor y de si ese host está permitido. No resuelve nombres ni envía nada, y la lista de idiomas que descarga doctor --live está sujeta a la misma política.

Un host rechazado detiene translate, watch al arrancar, la retraducción en Studio y MCP, y retranslateEntry del SDK con NETWORK_POLICY_VIOLATION y el código de salida 2, antes de leer ninguna clave. Una ejecución de prueba y --estimate no llaman a ningún proveedor, así que no se rechazan.

Cuándo se comprueban las peticionesCopiar enlace a esta sección

La primera comprobación no resuelve nombres, así que un nombre de host que no sabe clasificar por sí sola, como llm.internal, la supera. Cada petición de anthropic, openai, gemini, google-translate, opencode, openai-compatible y libretranslate se vuelve a comprobar justo antes de enviarse:

• un nombre de host se resuelve, y todas las direcciones a las que resuelve deben estar permitidas;
• solo se sigue un 307 o 308 al mismo origen, hasta cinco seguidos; una redirección a otro origen, incluido pasar de https a http, hace fallar la petición.

Una petición rechazada aquí hace fallar su sublote con el error de proveedor NETWORK_POLICY_VIOLATION, que solo nombra el host, y nunca se reintenta.

LímitesCopiar enlace a esta sección

• DNS rebinding. El nombre se resuelve una vez para comprobarlo y otra para conectar, así que un servidor DNS que responda distinto puede colarse. Escribe una dirección IP o añade el nombre a allowedHosts, en el que se confía sin resolverlo.
• DeepL se comprueba una vez, antes de construir el proveedor, no por petición ni por redirección.
• Proxies. Con una política restrictiva, cada proxy que usaría el proveedor debe estar permitido, como dirección IP o nombre listado. DeepL usa HTTPS_PROXY, HTTP_PROXY y ALL_PROXY, o su forma en minúsculas; los demás proveedores solo los usan en Node 24 con NODE_USE_ENV_PROXY=1 o --use-env-proxy. NO_PROXY se ignora.
• Proveedores propios. Un proveedor que pases con createProvider del SDK se comprueba antes de construirlo y recibe la política efectiva; aplicarla a sus propias peticiones depende de ese código.

Traducción automática sin modelo de lenguajeCopiar enlace a esta sección

Algunos NDA prohíben los modelos de lenguaje pero aceptan la traducción automática clásica en tu propio hardware. LibreTranslate es eso: un servidor de código abierto con modelos de Argos Translate. Ejecútalo con los idiomas que necesites:

docker run -d -p 5000:5000 libretranslate/libretranslate --load-only en,de,fr

Después apunta verbatra a él y fija la red:

provider: {
  id: "libretranslate",
  options: { baseUrl: "http://127.0.0.1:5000" },
},
network: { policy: "local-only" },

verbatra doctor --locales --live comprueba cada locale de destino frente a los modelos instalados. Sus valores se siguen registrando con el origen machine.

RelacionadoCopiar enlace a esta sección

• network: la clave de configuración.
• verbatra doctor: comprobar la política sin traducir.
• Tratamiento de datos y privacidad: qué sale de la máquina y cuándo.