Netzwerk Proxy Einstellungen

Mit dem NetworkProxy Modul kannst du anpassen, welche Proxy-Einstellungen eine Anwendung verwendet. Dieses Modul ist optional. Lässt du es weg, wird kein Proxy für Netzwerkverbindungen verwendet.

Schema der Konfiguration

Das folgende Schema zeigt die Struktur der Konfiguration:

Module

NetworkProxy

Value

mode

String

• Must be one of this: None, System, Custom

Default Value:

None

Value

type

Optional

String

• Must be one of this: Socks5, HTTP

Default Value:

Socks5

Value

host

Optional

String

Value

port

Optional

Integer

• Minimum value: 1

• Maximum value: 65535

Value

username

Optional

String

Value

password

Optional

Password

Der Wert mode

Mit dem Wert mode bestimmst du eine von drei grundlegenden Einstellungen:

Bezeichner	Beschreibung
None	Wählst du diese Einstellung, verwendet die Anwendung keinen Proxy, selbst wenn im Betriebssystem einer konfiguriert ist.
System	Wird diese Einstellung verwendet, nutzt die Anwendung die Proxy-Einstellungen des Betriebssystems. Weitere Details dazu findest du im nächsten Abschnitt.
Custom	Mit dieser Option hast du die Möglichkeit, die Proxy-Einstellungen manuell zu konfigurieren. Dafür stehen dir die Werte type, host, port, username und password zur Verfügung.

Wir empfehlen dir, von der Nutzung der Option System abzusehen. Wie im nächsten Abschnitt erläutert, kann es schwierig sein, die genaue Herkunft der Einstellungen zu ermitteln. Solltest du einen Proxy benötigen, raten wir dir dazu, diesen mithilfe der Option Custom selbst zu konfigurieren.

Einstellung die keinen Proxy verwendet

<Module name="NetworkProxy">
    <Value name="mode">None</Value>
</Module>

Einstellung die die Proxyeinstellungen des Betriebssystems verwendet

<Module name="NetworkProxy">
    <Value name="mode">System</Value>
</Module>

Benutzerdefinierte Proxyeinstellungen

<Module name="NetworkProxy">
    <Value name="mode">Custom</Value>
    <Value name="type">HTTP</Value>
    <Value name="host">proxy.example.com</Value>
    <Value name="port">8080</Value>
    <Value name="username">proxy</Value>
    <Value name="password">[password]</Value>
</Module>

Über die Proxyeinstellungen des Betriebssystems

Wenn du mode auf System setzt, übernimmt die Software die Proxyeinstellungen deines Betriebssystems. Leider ist es nicht immer offensichtlich, woher diese Einstellungen stammen. Die genaue Quelle variiert je nach verwendetem Betriebssystem:

Unter Windows nutzt die Funktion die WinHTTP DLL-Funktionen. Trotz des Namens empfiehlt Microsoft, es für alle Anwendungen zu verwenden, die Netzwerkverbindungen benötigen, nicht nur für HTTP. Es respektiert die mit dem proxycfg.exe-Tool im Register festgelegten Proxy-Einstellungen. Wenn diese Einstellungen nicht gefunden werden, versucht die Funktion, die Einstellungen von Internet Explorer zu übernehmen und zu verwenden.

Unter macOS holt sich die Funktion die Proxyeinstellungen mit dem SystemConfiguration-Framework von Apple. Sie wendet die FTP-, HTTP- und HTTPS-Proxy-Konfigurationen für Anfragen an, die die Protokoll-Tag „ftp“, „http“ und „https“ enthalten. Wenn der SOCKS-Proxy in dieser Konfiguration aktiviert ist, verwendet die Funktion den SOCKS-Server für alle Anfragen. Ist SOCKS nicht aktiviert, verwendet sie den HTTPS-Proxy für alle TcpSocket- und UrlRequest-Anfragen.

Auf den meisten Linux Systemen, die mit der Unterstützung von libproxy konfiguriert sind, verlässt sich diese Funktion auf libproxy, um die Proxyeinstellungen zu ermitteln. Abhängig von den libproxy-Konfigurationen kann dies wiederum auf Desktop-Einstellungen, Umgebungsvariablen usw. zurückgreifen.

Auf anderen Systemen wiederum bezieht diese Einstellung die Proxyeinstellungen aus der Umgebungsvariable http_proxy. Diese Variable muss eine URL sein, die eines der folgenden Schemata verwendet: http, socks5 oder socks5h.

Der Wert type

Mit dem Parameter type legst du die Art deines Proxyservers fest. Dir stehen dabei die folgenden beiden Optionen zur Verfügung:

Auswahl	Erläuterung
Socks5	Mit dieser Option entscheidest du dich für das SOCKS Protokoll.
HTTP	Diese Option steht für einen HTTP Proxy zur Verfügung.

Hinweis

Beachte, dass diese Einstellung nur dann relevant ist, wenn du den Parameter mode auf Custom gesetzt hast. Ansonsten wird diese Einstellung stillschweigend ignoriert.

<Module name="NetworkProxy">
    <Value name="mode">Custom</Value>
    <Value name="type">HTTP</Value>
    <Value name="host">proxy.example.com</Value>
    <Value name="port">8080</Value>
    <Value name="username">proxy</Value>
    <Value name="password">[password]</Value>
</Module>

Der Wert host

Mit dem Parameter host legst du den Hostnamen oder die IP-Adresse des Proxyservers fest.

Hinweis

Beachte, dass diese Einstellung nur dann relevant ist, wenn du den Parameter mode auf Custom gesetzt hast. Ansonsten wird diese Einstellung stillschweigend ignoriert.

<Module name="NetworkProxy">
    <Value name="mode">Custom</Value>
    <Value name="type">HTTP</Value>
    <Value name="host">proxy.example.com</Value>
    <Value name="port">8080</Value>
    <Value name="username">proxy</Value>
    <Value name="password">[password]</Value>
</Module>

Der Wert port

Mit dem optionalen Parameter port bestimmst du den Port des Proxyservers. Solltest du diesen Parameter nicht angeben, werden die Standardports der jeweiligen Protokolle verwendet:

• Für das HTTP Protokoll wird Port 8080 genutzt.

• Für das SOCKS Protokoll wird Port 1080 genutzt.

Hinweis

Beachte, dass diese Einstellung nur dann relevant ist, wenn du den Parameter mode auf Custom gesetzt hast. Ansonsten wird diese Einstellung stillschweigend ignoriert.

<Module name="NetworkProxy">
    <Value name="mode">Custom</Value>
    <Value name="type">HTTP</Value>
    <Value name="host">proxy.example.com</Value>
    <Value name="port">8080</Value>
    <Value name="username">proxy</Value>
    <Value name="password">[password]</Value>
</Module>

Der Wert username

Sollte dein Proxyserver eine Authentifizierung erfordern, kannst du mit dem optionalen Parameter username den entsprechenden Benutzernamen festlegen. Beachte jedoch, dass wenn du einen Benutzernamen angibst, du auch das zugehörige Passwort mit password setzen musst.

Hinweis

Beachte, dass diese Einstellung nur dann relevant ist, wenn du den Parameter mode auf Custom gesetzt hast. Ansonsten wird diese Einstellung stillschweigend ignoriert.

<Module name="NetworkProxy">
    <Value name="mode">Custom</Value>
    <Value name="type">HTTP</Value>
    <Value name="host">proxy.example.com</Value>
    <Value name="port">8080</Value>
    <Value name="username">proxy</Value>
    <Value name="password">[password]</Value>
</Module>

Der Wert password

Mit dem optionalen Parameter password legst du das Passwort für die Authentifizierung am Proxyserver fest.

Hinweis

Beachte, dass diese Einstellung nur dann relevant ist, wenn du den Parameter mode auf Custom gesetzt hast. Ansonsten wird diese Einstellung stillschweigend ignoriert.

<Module name="NetworkProxy">
    <Value name="mode">Custom</Value>
    <Value name="type">HTTP</Value>
    <Value name="host">proxy.example.com</Value>
    <Value name="port">8080</Value>
    <Value name="username">proxy</Value>
    <Value name="password">[password]</Value>
</Module>