Netzwerkzugriff einschränken

Das brauchst du, wenn deine Strings in deinem eigenen Netz bleiben müssen, etwa mit einem selbst gehosteten Modell hinter openai-compatible oder einem LibreTranslate-Server hinter libretranslate. Eine vertippte baseUrl, ein vergessenes OPENAI_BASE_URL oder der Wechsel zu einem gehosteten Provider würde Strings sonst an einen öffentlichen Endpunkt schicken. Mit einer Netzwerk-Richtlinie lehnt verbatra einen nicht erlaubten Host ab, bevor eine Anfrage den Rechner verlässt. Was eine Anfrage enthält, steht unter Datenverarbeitung und Datenschutz.

Eine Richtlinie festlegenLink zu diesem Abschnitt kopieren

Ergänz einen Block network in der Konfiguration (network in der Referenz):

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

Jeder Eintrag in allowedHosts ist ein Hostname (llm.internal, ohne Rücksicht auf Groß- und Kleinschreibung), ein Platzhalter (*.corp.example, nur Subdomains, mindestens zwei Labels nach *.), eine IP-Adresse oder ein CIDR-Bereich wie 100.64.0.0/10. Schreib kein Schema, keinen Port und keinen Pfad. Ein Oktett über 255, ein Präfix länger als die Adresse (über /32 oder /128) oder eine fehlerhafte IPv6-Adresse wird schon beim Laden der Konfiguration oder der Umgebung abgelehnt.

local-only lässt Link-Local-Adressen aus (169.254.0.0/16, das die Cloud-Metadaten-Adresse enthält, und fe80::/10), den Carrier-Grade-NAT-Bereich 100.64.0.0/10 sowie 0.0.0.0 und ::. Lauscht dein Server auf 0.0.0.0, richte baseUrl auf 127.0.0.1; nutzt du einen VPN-Bereich, trag ihn in allowedHosts ein.

Gehostete ProviderLink zu diesem Abschnitt kopieren

Unter local-only werden anthropic, openai, gemini, deepl, google-translate und opencode abgelehnt, weil ihre Endpunkte öffentlich sind. Um einen davon zu erlauben, listest du seinen Host auf:

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

Die Hosts sind api.anthropic.com, api.openai.com, generativelanguage.googleapis.com, api.deepl.com (api-free.deepl.com für einen Key, der auf :fx endet), translation.googleapis.com und opencode.ai. Ist ANTHROPIC_BASE_URL, OPENAI_BASE_URL oder GOOGLE_GEMINI_BASE_URL gesetzt, prüft verbatra stattdessen diesen Endpunkt. Gemini im Vertex-AI-Modus (GOOGLE_GENAI_USE_VERTEXAI oder GOOGLE_GENAI_USE_ENTERPRISE auf true) wird unter einer einschränkenden Richtlinie immer abgelehnt.

Eine Richtlinie aus der Umgebung festlegenLink zu diesem Abschnitt kopieren

So setzt du eine Richtlinie in CI durch, egal was die Konfiguration des Repositorys sagt:

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

VERBATRA_NETWORK_ALLOWED_HOSTS ist eine kommagetrennte Liste von allowedHosts-Einträgen. Setzen Konfiguration und Umgebung beide eine Richtlinie, muss ein Host beide erfüllen, sodass eine Konfiguration nie lockern kann, was die Umgebung festlegt.

Ein unbekannter Wert wie local_only oder die Host-Liste ohne die Richtlinien-Variable lässt den Lauf mit CONFIG_INVALID scheitern, statt jeden Host zu erlauben. translate --dry-run und --estimate prüfen diese Variablen ebenfalls, außer beim Provider none.

Die Richtlinie prüfenLink zu diesem Abschnitt kopieren

Führ verbatra doctor aus: Es meldet die wirksame Richtlinie, woher jeder Teil stammt, den Host des Providers und ob dieser Host erlaubt ist. Es löst keine Namen auf und sendet nichts, und die Sprachliste, die doctor --live abruft, unterliegt derselben Richtlinie.

Ein abgelehnter Host stoppt translate, watch beim Start, das Neuübersetzen in Studio und MCP sowie retranslateEntry im SDK mit NETWORK_POLICY_VIOLATION und Exit-Code 2, bevor ein Key gelesen wird. Ein Probelauf und --estimate rufen keinen Provider auf und werden deshalb nicht abgelehnt.

Wissen, wann Anfragen geprüft werdenLink zu diesem Abschnitt kopieren

Die erste Prüfung löst keine Namen auf, also kommt ein Hostname, den sie allein nicht einordnen kann, etwa llm.internal, durch. Jede Anfrage von anthropic, openai, gemini, google-translate, opencode, openai-compatible und libretranslate wird direkt vor dem Senden erneut geprüft:

• ein Hostname wird aufgelöst, und jede Adresse, zu der er auflöst, muss erlaubt sein;
• nur ein 307 oder 308 zum selben Origin wird verfolgt, bis zu fünf hintereinander; eine Weiterleitung zu einem anderen Origin, auch von https zu http, lässt die Anfrage scheitern.

Eine hier abgelehnte Anfrage lässt ihren Teil-Batch mit dem Provider-Fehler NETWORK_POLICY_VIOLATION scheitern, der nur den Host nennt, und wird nie wiederholt.

GrenzenLink zu diesem Abschnitt kopieren

• DNS-Rebinding. Der Name wird einmal zur Prüfung und erneut zum Verbinden aufgelöst, sodass ein DNS-Server, der anders antwortet, durchrutschen kann. Schreib eine IP-Adresse oder trag den Namen in allowedHosts ein, dem ohne Auflösung vertraut wird.
• DeepL wird einmal geprüft, bevor der Provider gebaut wird, nicht pro Anfrage oder Weiterleitung.
• Proxys. Unter einer einschränkenden Richtlinie muss jeder Proxy, den der Provider nutzen würde, selbst erlaubt sein, als IP-Adresse oder als aufgelisteter Name. DeepL nutzt HTTPS_PROXY, HTTP_PROXY und ALL_PROXY oder deren Kleinschreibung; die anderen Provider nutzen sie nur unter Node 24 mit NODE_USE_ENV_PROXY=1 oder --use-env-proxy. NO_PROXY wird ignoriert.
• Eigene Provider. Ein Provider, den du über createProvider im SDK übergibst, wird vor dem Bau geprüft und erhält die wirksame Richtlinie; sie auf seine eigenen Anfragen anzuwenden, liegt bei diesem Code.

Maschinelle Übersetzung ohne SprachmodellLink zu diesem Abschnitt kopieren

Manche NDAs verbieten Sprachmodelle, akzeptieren aber klassische maschinelle Übersetzung auf deiner eigenen Hardware. LibreTranslate ist genau das: ein Open-Source-Server mit Argos-Translate-Modellen. Starte ihn mit den Sprachen, die du brauchst:

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

Dann richte verbatra darauf aus und leg das Netzwerk fest:

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

verbatra doctor --locales --live prüft jede Ziel-Locale gegen die installierten Modelle. Seine Werte werden trotzdem mit der Herkunft machine festgehalten.

Siehe auchLink zu diesem Abschnitt kopieren

• network: der Konfigurationsschlüssel.
• verbatra doctor: die Richtlinie prüfen, ohne zu übersetzen.
• Datenverarbeitung und Datenschutz: was den Rechner verlässt und wann.