Skip to content

docs: a proxy is not the answer to an unreachable endpoint #189

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Sev7eNup merged 1 commit into from
Aug 12, 2026
Merged

docs: a proxy is not the answer to an unreachable endpoint #189

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions docs/ai-features.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -108,6 +108,16 @@ Neu-Eintippen.

**Outbound-Proxy (`Llm:Proxy:*`):**

> **Erst die Stufe feststellen, dann konfigurieren.** Ein Proxy ist die Antwort auf „ausgehender
> Verkehr **darf** dieses Netz nur über den Proxy verlassen" — **nicht** auf „der Endpunkt ist
> nicht erreichbar". Liegt der Endpunkt in einem anderen Netzsegment und fehlt die
> Firewall-Freischaltung, hilft kein Proxy; hier einen zu setzen verschiebt nur, wohin die
> Verbindung *nicht* aufgebaut wird. Welche Stufe scheitert, sagt
> [„Endpunkt nicht erreichbar"](#endpunkt-nicht-erreichbar--welche-stufe-gescheitert-ist) weiter
> unten in Sekunden — das ist der billigere erste Schritt. (Real passiert: ein
> `LLM endpoint TCP:`-Fehlschlag wurde als Proxy-Problem gelesen und kostete mehrere Runden, bis
> die fehlende Firewall-Regel gefunden war.)

Gilt für **alle** ausgehenden LLM-Aufrufe — Script-/Workflow-Generierung, beide Chats, die
`llmQuery`-Activity und den „Testen"-Button in den Settings. Ein Block pro Installation, nicht pro
Profil: der Fall „Cloud-Profil über den Proxy, lokales Ollama direkt" wird über `BypassList`
Expand Down
7 changes: 7 additions & 0 deletions src/nodepilot-docs-ui/content/ai-features.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -183,6 +183,13 @@ Einstellungen. Es ist bewusst ein Block für die gesamte Installation und nicht
der gemischte Fall — Cloud-Modell über den Proxy, lokales Modell direkt — wird über die
Ausnahmeliste abgebildet.

Ein Proxy ist dabei die Antwort auf „ausgehender Verkehr **darf** dieses Netz nur über den Proxy
verlassen" — nicht auf „der Endpunkt ist nicht erreichbar". Liegt der Endpunkt in einem anderen
Netzsegment und fehlt die Freischaltung in der Firewall, ändert ein Proxy daran nichts. Prüfen Sie
deshalb zuerst, welche Stufe scheitert: der Abschnitt
[Wenn der Endpunkt nicht erreichbar ist](#wenn-der-endpunkt-nicht-erreichbar-ist) beantwortet das
in Sekunden.

| Einstellung | Bedeutung |
|---|---|
| `Mode` | `Off` verbindet direkt (Voreinstellung), `System` übernimmt den Proxy des Dienstkontos samt dessen Ausnahmeregeln, `Custom` verwendet die Adresse unten |
Expand Down
Loading