Verwendung von Axe DevTools Linter mit einem Proxy

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Wie man Axe DevTools Linter für die Arbeit mit HTTP-Proxies konfiguriert

Not for use with personal data

Axe DevTools Linter unterstützt die Proxy-Konfiguration über Umgebungsvariablen, sodass Sie Linting-Anforderungen über die Proxy-Infrastruktur Ihrer Organisation leiten können.

Anforderungen

Um die Proxy-Unterstützung mit Axe DevTools Linter zu nutzen, benötigen Sie:

Proxy-Software, die lokal oder auf den Servern Ihrer Organisation läuft
Das Endpunkt für Ihren Proxy
Das Zertifikat der Zertifizierungsstelle (CA) des Proxys (um es auf Ihrem Computer zu autorisieren)

important

Bei Verwendung der von Deque gehosteten SaaS-Server wird nur HTTPS unterstützt. Wenn Sie eine lokale Instanz betreiben, können Sie HTTP verwenden und benötigen den HTTP-Endpunkt Ihres Proxys. Der HTTP-Endpunkt befindet sich normalerweise auf demselben Host wie der HTTPS-Endpunkt, jedoch auf Port 80 statt 443; überprüfen Sie dies mit Ihrem Netzwerkadministrator.

Umgebungsvariablen

Die Proxy-Konfiguration für Axe DevTools Linter erfolgt vollständig über Umgebungsvariablen, die in zwei Kategorien fallen.

Standard-Proxy-Umgebungsvariablen

Variable	Beschreibung
`HTTPS_PROXY`	Der Endpunkt, der für HTTPS-Protokollanforderungen verwendet wird
`HTTP_PROXY`	Der Endpunkt, der für HTTP-Protokollanforderungen verwendet wird
`NO_PROXY`	Eine kommagetrennte Liste von Hostnames, die den Proxy umgehen sollen

Axe DevTools Linter- und Node.js-Umgebungsvariablen

Variable	Beschreibung
`AXE_LINTER_USE_ENV_PROXY`	Aktiviert die Proxy-Unterstützung speziell für Axe DevTools Linter
`AXE_USE_ENV_PROXY`	Aktiviert die Proxy-Unterstützung für alle Deque-Tools, die diese Variable unterstützen
`NODE_USE_ENV_PROXY`	Node.js-native Proxy-Unterstützung (nur Version 24 oder später)
`NODE_EXTRA_CA_CERTS`	Pfad zu vertrauenswürdigen CA-Zertifikaten für HTTPS-Verbindungen

note

Die NODE_USE_ENV_PROXY-Variable wurde in Node.js Version 24 eingeführt, um die Proxy-Unterstützung global für einen Prozess zu aktivieren. Axe DevTools Linter hat die Unterstützung für diese Variable auf alle Node.js-Versionen zurückportiert.

Aktivierung der Proxy-Unterstützung

Um die Proxy-Unterstützung zu aktivieren, setzen Sie eine der AXE_*-Variablen auf 1. Um die Proxy-Unterstützung für Axe DevTools Linter zu deaktivieren, während sie für Node.js aktiviert bleibt, setzen Sie entweder AXE_LINTER_USE_ENV_PROXY oder AXE_USE_ENV_PROXY auf 0.

important

Nur die Werte 1 (aktiviert) und 0 (deaktiviert) werden erkannt. Jeder andere Wert wird die Proxy-Unterstützung deaktivieren.

Für HTTPS-Verbindungen müssen Sie den Pfad zum Zertifikat Ihrer Proxy-Zertifizierungsstelle (CA) mit NODE_EXTRA_CA_CERTS angeben. Ohne dies werden Verbindungen als nicht vertrauenswürdig abgelehnt.

Konfigurationsbeispiele

Sie können Umgebungsvariablen auf zwei Arten setzen: global für einen Computer oder CI-Job, oder inline für einen einzelnen Befehl.

GitHub Actions Workflow

Das folgende Beispiel zeigt, wie man Proxy-Umgebungsvariablen in einem GitHub Actions Workflow konfiguriert:

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run Axe DevTools Linter
        env:
          HTTPS_PROXY: https://localhost:9090
          NODE_EXTRA_CA_CERTS: /path/to/ca.pem
          AXE_LINTER_USE_ENV_PROXY: 1
        run: npm run lint

Lokale Befehlszeile

Um Proxy-Variablen für einen einzelnen Befehl unter Linux oder macOS zu setzen:

AXE_LINTER_USE_ENV_PROXY=1 HTTPS_PROXY=https://localhost:9090 NODE_EXTRA_CA_CERTS=/path/to/ca.pem npm run lint

Verwendung des Axe DevTools Linter Connectors mit einem Proxy

Bei der Verwendung des Axe DevTools Linter Connector konfigurieren Sie die Proxy-Variablen, bevor Sie den Connector ausführen:

export HTTPS_PROXY=https://proxy.example.com:9090
export NODE_EXTRA_CA_CERTS=/path/to/ca.pem
export AXE_LINTER_USE_ENV_PROXY=1

axe-linter-connector -s . -d . --api-key YOUR_API_KEY --url https://axe-linter.deque.com/

Umgehen des Proxys für bestimmte Hosts

Verwenden Sie die NO_PROXY-Umgebungsvariable, um Zielhosts oder -domänen anzugeben, die nicht über den Proxy geleitet werden sollen. Dies ist nützlich, wenn bestimmte Domänen direkten Zugriff benötigen.

NO_PROXY=internal.example.com,localhost axe-linter-connector -s . -d .

Node.js 24 und später

In Node.js Version 24 und später ist NODE_USE_ENV_PROXY standardmäßig für alle Anforderungen aktiviert. Wenn Sie den Proxy für Axe DevTools Linter umgehen müssen, während er für andere Anforderungen aktiviert bleibt, verwenden Sie die NO_PROXY-Variable:

NODE_USE_ENV_PROXY=1 HTTPS_PROXY=https://our.intranet/proxy NO_PROXY=axe.deque.com,axe-linter.deque.com npm run lint

tip

Selbst wenn Sie AXE_LINTER_USE_ENV_PROXY=0 setzen, wird Node.js Version 24 oder später Anforderungen dennoch über den Proxy leiten, da der globale Anforderungsdispatcher aktiv ist. Verwenden Sie NO_PROXY, um den Proxy für bestimmte Domänen zu umgehen.

Fehlerbehebung

Zertifikatsfehler

Wenn Sie zertifikatsbezogene Fehler erhalten, stellen Sie sicher, dass:

Der NODE_EXTRA_CA_CERTS-Pfad auf eine gültige Zertifikatsdatei verweist
Das Zertifikat im PEM-Format vorliegt
Das Zertifikat mit der CA Ihres Proxys übereinstimmt

Verbindung verweigert

Wenn Verbindungen abgelehnt werden:

Stellen Sie sicher, dass der Proxy-Endpunkt korrekt und zugänglich ist.
Überprüfen Sie, ob der Proxy läuft und Verbindungen akzeptiert.
Bestätigen Sie, dass Sie das richtige Protokoll verwenden (HTTP vs. HTTPS).

Proxy wird nicht verwendet

Wenn Anfragen nicht über den Proxy geleitet werden:

Überprüfen Sie, ob AXE_LINTER_USE_ENV_PROXY gesetzt ist und nicht auf einen anderen Wert als 1 eingestellt ist.
Prüfen Sie, ob HTTPS_PROXY (oder HTTP_PROXY für lokale Bereitstellungen) korrekt eingestellt ist.
Stellen Sie sicher, dass der Zielhost oder die Zieldomain nicht in NO_PROXY gelistet ist.

Siehe auch

Verwendung des Axe DevTools Linter Connectors für Befehlszeilen-Lint-Optionen
Einrichtung des lokalen Servers für selbstgehostete Installationen
Verwendung von Axe DevTools Linter mit einem Reverse Proxy zur Sicherung Ihres lokalen Servers