Wie kann ich die Netzwerk-Einstellungen der Bitbucket App anpassen, um hinter einem Proxy zu arbeiten?
- Einleitung
- Proxy-Konfiguration auf Betriebssystemebene
- Proxy-Einstellungen im Git-Client konfigurieren
- Direkte Proxy-Einstellungen in der Bitbucket Desktop App
- Prüfung und Fehlerbehebung
- Zusammenfassung
Einleitung
Die Bitbucket App, welche zur Verwaltung von Git-Repositories verwendet wird, nutzt Netzwerkverbindungen, um mit den Bitbucket-Servern zu kommunizieren. Wenn Sie sich hinter einem Proxy befinden, kann dies die Verbindung erschweren oder verhindern. Um die App trotzdem erfolgreich nutzen zu können, müssen die Netzwerk-Einstellungen so angepasst werden, dass der Proxy berücksichtigt wird. Im Folgenden erfahren Sie ausführlich, wie Sie dies tun können.
Proxy-Konfiguration auf Betriebssystemebene
Viele Anwendungen, einschließlich einiger Bitbucket Clients, nutzen die Proxy-Einstellungen des Betriebssystems. Daher ist der erste Schritt sicherzustellen, dass Ihr Proxy korrekt auf Systemebene konfiguriert ist. Unter Windows finden Sie diese Einstellungen meist unter Netzwerk und Internet – Proxy. Unter macOS finden Sie die Proxy-Einstellungen in den Systemeinstellungen unter Netzwerk – Erweitert – Proxies. Stellen Sie sicher, dass dort die richtigen Proxy-Server-Adressen und Ports eingetragen sind und gegebenenfalls auch Benutzername und Passwort, falls Ihr Proxy dies verlangt.
Proxy-Einstellungen im Git-Client konfigurieren
Die Bitbucket App nutzt Git für die Versionsverwaltung, und daher ist es wichtig, Git selbst zu veranlassen, den Proxy zu verwenden. Dies geschieht über die Git-Konfiguration, die Sie global oder projektspezifisch anpassen können. Öffnen Sie dazu ein Terminal oder die Eingabeaufforderung und geben Sie folgende Befehle ein:
git config --global http.proxy http://proxyuser:proxypassword@proxy.server.com:8080
Falls Ihr Proxy keine Authentifizierung benötigt, können Sie den Benutzername und das Passwort weglassen:
git config --global http.proxy http://proxy.server.com:8080
Ebenso für HTTPS-Verbindungen:
git config --global https.proxy http://proxyuser:proxypassword@proxy.server.com:8080
Diese Einstellungen sorgen dafür, dass Git-Anfragen über den Proxy geleitet werden. Prüfen Sie anschließend die Verbindung mit einem einfachen Git-Befehl wie git fetch oder git pull.
Direkte Proxy-Einstellungen in der Bitbucket Desktop App
Die offizielle Bitbucket Desktop App bietet in manchen Versionen keine direkte Benutzeroberfläche zur Konfiguration eines Proxys. In diesem Fall hängt die App von den Umgebungsvariablen oder Git-Einstellungen ab. Dennoch können Sie versuchen, Umgebungsvariablen für den Proxy zu setzen, welche von der App genutzt werden könnten. Unter Windows können Sie beispielsweise Umgebungsvariablen erstellen namens HTTP_PROXY und HTTPS_PROXY mit folgendem Aufbau:
http://proxyuser:proxypassword@proxy.server.com:8080
Unter Linux und macOS können Sie diese Variablen in Ihrem Terminal exportieren:
export HTTP_PROXY="http://proxyuser:proxypassword@proxy.server.com:8080"
export HTTPS_PROXY="http://proxyuser:proxypassword@proxy.server.com:8080"
Starten Sie danach die Bitbucket App neu, damit diese Variablen wirksam werden.
Prüfung und Fehlerbehebung
Falls die Bitbucket App weiterhin keine Verbindung herstellen kann, kontrollieren Sie zunächst, ob der Proxy selbst ordnungsgemäß funktioniert und keine speziellen Einschränkungen vorliegen. Testen Sie auch, ob andere Anwendungen oder Git-Befehle über den Proxy funktionieren. Prüfen Sie gegebenenfalls die Log-Dateien der Bitbucket App, um Fehlermeldungen zu analysieren. In manchen Fällen kann ein Proxy-Zertifikat notwendig sein, wenn der Proxy SSL/TLS-Verbindungen mit eigenen Zertifikaten entschlüsselt. Dieses Zertifikat muss dann in Ihrem Betriebssystem oder Git-TLS-Konfiguration als vertrauenswürdig hinterlegt werden.
Zusammenfassung
Um die Bitbucket App hinter einem Proxy erfolgreich zu nutzen, sollten Sie sicherstellen, dass der Proxy korrekt auf Systemebene eingestellt ist, Git so konfiguriert ist, dass es den Proxy nutzt, und falls möglich, Umgebungsvariablen gesetzt werden, die von der App berücksichtigt werden. Da die Bitbucket Desktop App selbst keine explizite Proxy-Konfiguration bietet, beruht ihre Netzwerkfunktionalität vor allem auf den Git-Einstellungen und Systemvariablen. Mit diesen Anpassungen sollten Sie den Proxy umgehen und problemlos mit Bitbucket arbeiten können.