> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Externe URL

> Benutzern in einem Kubernetes-Deployment das Hinzufügen von Dateien aus externen URLs ermöglichen und die internen Adressen des Clusters unerreichbar halten.

Dateien "From External URL" (sowie die Dateien, die die [Import API](https://ayakaleaf-pro.mintlify.site/de/on-premises/configuration/kubernetes/integrations/overleaf-import-api.md) und `web_fetch` des KI-Assistenten herunterladen) werden vom **linked-url-proxy**-Dienst in jedem Ayakaleaf-Pro-Pod abgerufen. Er lehnt Adressen ab, die nicht öffentlich sind, sodass Benutzer darüber keine internen Dienste auslesen können. Die Funktion und ihre Einstellungen sind unter [Externe URL](https://ayakaleaf-pro.mintlify.site/de/on-premises/configuration/overleaf-toolkit/external-url.md) beschrieben.

| | |
| - | - |
| Dienst | linked-url-proxy (`127.0.0.1:3066` in jedem Pod); web zeigt das Menü an, wenn `url` in `ENABLED_LINKED_FILE_TYPES` enthalten ist |
| Pod → außen | die von Benutzern angegebenen URLs, auf jedem Port, direkt oder über `OVERLEAF_LINKED_URL_OUTBOUND_PROXY` |
| Zustand | keiner |
| Periodische Jobs | keine: Eine Datei wird nur aktualisiert, wenn ein Benutzer dies anfordert |

### Konfiguration

```yaml title="30-config.yaml (additions)" wrap theme={null}
  ENABLED_LINKED_FILE_TYPES: project_file,project_output_file,url
  # Public addresses of your nodes and load balancer, see below
  OVERLEAF_LINKED_URL_BLOCKED_NETWORKS: 203.0.113.0/24 198.51.100.7/32
  # optional
  # OVERLEAF_LINKED_URL_ALLOWED_RESOURCES: ^https?://www\.example\.com/public/
  # OVERLEAF_LINKED_URL_OUTBOUND_PROXY: http://proxy.example.com:3128
```

```bash theme={null}
kubectl apply -f 30-config.yaml
kubectl -n overleaf rollout restart deployment/overleaf     # or statefulset/overleaf
```

### Was auf Kubernetes blockiert wird

Der Proxy lehnt jede Adresse ab, die keine öffentliche Unicast-Adresse ist: Loopback, Link-Local (einschließlich der Cloud-Metadaten-Adresse `169.254.169.254`), die privaten Bereiche `10.0.0.0/8`, `172.16.0.0/12` und `192.168.0.0/16`, den Carrier-Grade-NAT-Bereich `100.64.0.0/10` sowie deren IPv6-Entsprechungen. Pod- und Service-Netzwerke in diesen Bereichen, wie es bei kubeadm, flannel, Calico und den meisten verwalteten Clustern standardmäßig der Fall ist, werden daher ohne jede Einstellung blockiert, ebenso die clusterinternen Namen wie `redis` oder `git-bridge`, die auf sie aufgelöst werden.

Öffentliche Adressen sind erlaubt. Wenn Ihre Knoten oder Ihr Load Balancer öffentliche Adressen haben, fügen Sie diese zu `OVERLEAF_LINKED_URL_BLOCKED_NETWORKS` hinzu (durch Leerzeichen oder Kommas getrennt), damit Benutzer darüber nicht die NodePorts oder eine Statusseite abrufen können.

Wenn `OVERLEAF_LINKED_URL_OUTBOUND_PROXY` gesetzt ist, werden Hostnamen vom Proxy aufgelöst, sodass nur URLs geprüft werden, die eine IP-Adresse enthalten: Der Proxy muss Ihre internen Netzwerke dann selbst blockieren.

### Mehrere Replikate

Nichts weiter: Jeder Pod ruft mit seinem eigenen linked-url-proxy und denselben Einstellungen ab.

### Getestet auf Kubernetes

Auf Kubernetes 1.37 mit drei Replikaten, flannels Pod-Netzwerk `10.244.0.0/16` und kubeadms Service-Netzwerk `10.96.0.0/12` lehnte der Proxy ohne jedes `OVERLEAF_LINKED_URL_BLOCKED_NETWORKS` Downloads von der ClusterIP eines Service, von den clusterinternen Namen `redis`, `garage` und `overleaf-1.overleaf-hl.overleaf.svc.cluster.local` sowie von der Adresse eines Knotens ab. Unsere End-to-End-Tests bestehen außerdem für das Ablehnen von Loopback und der Cloud-Metadaten-Adresse über die Import API sowie dafür, dass der KI-Assistent nur die Seiten liest, die `OVERLEAF_LINKED_URL_ALLOWED_RESOURCES` erlaubt.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.