Proxy-Assistent

Eine leistungsstarke Browser-Proxy-Verwaltungserweiterung, die Chrome/Firefox/Edge und mehrere andere Browser unterstützt, mit Multi-Szenarien-Management, die Ihnen hilft, Netzwerk-Proxys einfach zu konfigurieren und zu wechseln.

1. ✨ Funktionen

1.1 🔌 Unterstützung mehrerer Proxy-Protokolle

HTTP - Traditioneller HTTP-Proxy
HTTPS - Sicherer HTTPS-Proxy
SOCKS5 - SOCKS5-Proxy mit TCP/UDP-Unterstützung
SOCKS4 - Legacy SOCKS4-Proxy-Kompatibilität

1.2 🌐 Multi-Browser-Unterstützung

Chrome - Verwendung von Manifest V3 + Service Worker
Firefox - Verwendung von Manifest V3 + proxy.onRequest API für Proxy-Anfragen-Intercept
Edge - Perfekt kompatibel mit Chrome-Erweiterungen, basierend auf Chromium-Kernel

1.3 🔄 Drei Proxy-Modi

Modus	Beschreibung
Deaktiviert	Proxy deaktivieren, Standard-Netzwerkverbindung des Systems verwenden
Manuell	Proxy manuell aus der Liste auswählen
Automatisch	Automatisch passenden Proxy basierend auf URL-Regeln auswählen (PAC-Modus)

1.4 🎬 Szenario-Modus

Multi-Szenario-Unterstützung: Erstellen verschiedener Proxy-Konfigurationssets (z.B.: Unternehmen, Zuhause, Entwicklungsumgebung)
Schnelles Wechseln: Ein-Klick-Wechsel der Proxy-Listen zwischen verschiedenen Szenarien
Flexible Verwaltung: Unterstützung für Hinzufügen, Umbenennen, Löschen und Sortieren von Szenarien
Proxy-Migration: Unterstützung für das Verschieben von Proxies zwischen verschiedenen Szenarien
Auto-Anwendung: Automatische Proxy-Auswahl und -Anwendung beim Wechseln von Szenarien im manuellen Modus

1.5 📥 Proxy-Abonnementfunktion

Multi-Format-Unterstützung: Unterstützt AutoProxy, SwitchyLegacy, SwitchyOmega, PAC-Abonnementformate
Auto-Update: Unterstützt geplante Auto-Updates (1Min/6Std/12Std/1Tag)
Regelumkehrung: Unterstützt die Umkehrung von Abonnement-Match- und Umgehungsregeln (Whitelist/Blacklist-Modus)
Regelvorschau: Schnelle Ansicht der aus dem Abonnement extrahierten Match- und Umgehungsregeln
Eindeutige ID: Jeder Proxy und jedes Szenario hat eine eindeutige ID für präzise Verwaltung

1.6 📋 Flexible URL-Regelkonfiguration

Adressen ohne Proxy (bypass_rules): Direktverbindungs-Domains/IPs im manuellen Modus
Adressen mit Proxy (include_rules): Domains, die Proxy-Zugriff im automatischen Modus erfordern
Fallback-Strategie: Im automatischen Modus direkte Verbindung oder Ablehnung bei Verbindungsfehler wählen
Unterstützt Wildcard * und Domain-Matching
Geeignet für Szenarien, in denen verschiedene Websites verschiedene Proxys verwenden

1.7 🔐 Proxy-Authentifizierungsunterstützung

Benutzername/Passwort-Authentifizierung
Automatische Behandlung von Authentifizierungsanforderungen des Proxy-Servers
Sichere Speicherung von Anmeldeinformationen

1.8 🧪 Proxy-Testfunktionen

Verbindungstest: Proxy-Verfügbarkeit überprüfen
Latenzmessung: Proxy-Antwortzeit testen
Batch-Test: Alle Proxys mit einem Klick testen
Farbindikatoren: Grün(<500ms) / Orange(≥500ms) / Rot(Fehlgeschlagen)

1.9 🏃 Proxy-Statuserkennung

Erkennen der aktuellen Browser-Proxy-Einstellungen
Überprüfen, ob die Erweiterung die Proxy-Steuerung erfolgreich übernommen hat
Identifizieren, ob andere Erweiterungen die Proxy-Steuerung übernommen haben
Drei Erkennungsergebnisse bereitstellen: Status, Warnung, Fehler

1.10 🔍 PAC-Skript-Vorschau

Skript-Ansicht: Automatisch generierten PAC-Skript-Inhalt anzeigen
Regelliste: Klare Anzeige aller aktiven Proxy-Matching-Regeln
Debug-Support: Einfache Fehlerbehebung bei Matching-Problemen im Auto-Modus

1.11 🌙 Themen-Modi

Hellmodus: Für den Tag
Dunkelmodus: Für die Nacht
Automatischer Wechsel: Thema basierend auf der Zeit automatisch wechseln (konfigurierbarer Zeitraum)

1.12 ☁️ Datenspeicherung und Synchronisierung

1.12.1 Speicherstrategie

Speichertyp	Speicherinhalt	Beschreibung
Lokalspeicher (local)	Proxy-Liste, Themeneinstellungen, Spracheinstellungen, Synchronisierungseinstellungen	Immer aktiv, Offline-Verfügbarkeit und Datenpersistenz gewährleistet
Cloud-Synchronisierung (sync)	Vollständige Konfigurationsdaten (Chunk-Speicher)	Optional, verwendet Chunk-Speicher, um Quotenlimits zu umgehen

1.12.2 Synchronisierungsmethoden

1.12.2.1 Native Browser-Synchronisierung (Native Sync)

Verwendet chrome.storage.sync API (Chrome) oder browser.storage.sync (Firefox)
Automatische Synchronisierung über Chrome/Firefox-Konto
Geeignet für Multi-Geräte-Synchronisierung mit demselben Browser-Konto
Chunk-Speicher: Konfigurationsdaten werden automatisch in Chunks (7KB pro Chunk) aufgeteilt, um das 8KB-Limit für einzelne Elemente zu umgehen
Datenintegrität: Verwendet Prüfsummen, um die Integrität der Synchronisierungsdaten sicherzustellen
Atomare Operationen: Push-Vorgang löscht alte Daten, bevor neue Daten geschrieben werden, um Konsistenz zu gewährleisten
Quotenanzeige: Echtzeitanzeige der genutzten/gesamten Quote (100KB) und Anzahl der Chunks

1.12.2.2 GitHub Gist-Synchronisierung

Synchronisierung der Konfiguration über Browser und Geräte hinweg via GitHub Gist
Erfordert GitHub Personal Access Token
Unterstützt manuelles Push/Pull oder automatische Synchronisierung
Konfigurationsinhalt verschlüsselt gespeichert, sensible Informationen werden beim Export automatisch gelöscht

Konfigurationselement	Beschreibung
Zugriffsschlüssel	GitHub Personal Access Token (benötigt gist-Berechtigung)
Dateiname	Dateiname in Gist, Standard `proxy_assistant_config.json`
Gist-ID	Automatisch erkannt und gespeichert, keine manuelle Eingabe erforderlich

1.12.3 Synchronisierungsvorgänge

Vorgang	Beschreibung
Push	Lokale Konfiguration in die Cloud/Gist hochladen
Pull	Konfiguration aus der Cloud/Gist herunterladen
Verbindung testen	Gist Token-Gültigkeit und Konfigurationsstatus überprüfen

1.12.4 Import/Export

Exportieren: JSON-Datei mit allen Proxy-Informationen, Themen-Einstellungen, Spracheinstellungen usw. generieren
Importieren: Wiederherstellung der Konfiguration aus JSON-Datei unterstützen
Datensicherheit: Export-Datei löscht automatisch sensible Informationen (Token, Passwort)
Format-Kompatibilität: Import von Konfigurationsdateien aus älteren Versionen unterstützt

1.13 🌍 Mehrsprachige Unterstützung

Diese Erweiterung unterstützt die folgenden Sprachen:

Sprache	Code	Status
简体中文	zh-CN	✅ Unterstützt
繁體中文	zh-TW	✅ Unterstützt
English	en	✅ Unterstützt
日本語	ja	✅ Unterstützt
Français	fr	✅ Unterstützt
Deutsch	de	✅ Unterstützt
Español	es	✅ Unterstützt
Português	pt	✅ Unterstützt
Русский	ru	✅ Unterstützt
한국어	ko	✅ Unterstützt

2. 📷 Einstellungsseite

3. 📁 Projektstruktur

ProxyAssistant/
├── conf/                     # Beispielkonfiguration
│   └── demo.json             # Beispielkonfigurationsdatei
├── readme/                   # Mehrsprachige Dokumentation
│   ├── README-zh-TW.md       # Traditionelles Chinesisch
│   ├── README-en.md          # Englisch
│   ├── README-ja.md          # Japanisch
│   ├── README-fr.md          # Französisch
│   ├── README-de.md          # Deutsch
│   ├── README-es.md          # Spanisch
│   ├── README-pt.md          # Portugiesisch
│   ├── README-ru.md          # Russisch
│   └── README-ko.md          # Koreanisch
├── src/                      # Quellcode
│   ├── manifest_chrome.json  # Chrome-Erweiterungskonfiguration (Manifest V3)
│   ├── manifest_firefox.json # Firefox-Erweiterungskonfiguration
│   ├── main.html             # Einstellungsseite
│   ├── popup.html            # Popup-Seite
│   ├── _locales/             # Internationalisierungsressourcen
│   ├── js/
│   │   ├── main.js           # Hauptlogik der Einstellungsseite
│   │   ├── popup.js          # Hauptlogik des Popups
│   │   ├── worker.js         # Hintergrunddienst (Chrome: Service Worker)
│   │   ├── i18n.js           # Internationalisierungsunterstützung
│   │   ├── storage.js        # Speicherverwaltungsmodul
│   │   ├── proxy.js          # Proxy-Verwaltungsmodul
│   │   ├── scenarios.js      # Szenario-Verwaltungsmodul
│   │   ├── sync.js           # Datensynchronisierungsmodul
│   │   ├── subscription.js   # Abonnementfunktionsmodul
│   │   ├── theme.js          # Themen-Wechselmodul
│   │   ├── detection.js      # Proxy-Erkennungsmodul
│   │   ├── validator.js      # Datenvalidierungsmodul
│   │   ├── language.js       # Sprachauswahlmodul
│   │   ├── utils.js          # Hilfsfunktionenmodul
│   │   ├── config.js         # Konfigurationskonstantenmodul
│   │   ├── version.js        # Versionsverwaltungsmodul
│   │   └── jquery.js         # jQuery-Bibliothek
│   ├── css/
│   │   ├── main.css          # Stile der Einstellungsseite (inkl. allgemeine Komponenten)
│   │   ├── popup.css         # Popup-Stile
│   │   ├── theme.css         # Themen-Stile
│   │   ├── tabs.css          # Tab-Stile
│   │   └── eye-button.css    # Passwort-sichtbar-Button-Stile
│   └── images/               # Bildressourcen
│       ├── icon-16.png
│       ├── icon-32.png
│       ├── icon-48.png
│       ├── icon-128.png
│       └── logo-128.png
├── public/                   # Öffentliche Ressourcen
│   └── img/                  # Demo- und Werbebilder
├── tests/                    # Tests
│   ├── jest.config.js        # Jest-Konfiguration
│   ├── setup.js              # Testumgebung-Setup
│   ├── __mocks__/            # Mock-Dateien
│   │   └── chrome.js         # Chrome API Mock
│   ├── unit/                 # Unit-Tests
│   ├── integration/          # Integrationstests
│   └── e2e/                  # End-to-End-Tests
├── script/                   # Build-Skripte
│   └── build.sh              # Erweiterungs-Build-Skript
├── release/                  # Release-Notizen
│   └── *.md                  # Update-Logs für Versionen
├── doc/                      # Dokumentationsverzeichnis
├── build/                    # Build-Ausgabeverzeichnis
├── package.json              # Projektabhängigkeiten
├── package-lock.json         # Abhängigkeitsversionen-Sperre
├── Makefile                  # Build-Befehlseingang
├── jest.config.js            # Jest-Konfiguration (verweist auf tests/jest.config.js)
├── AGENTS.md                 # Entwicklungsleitfaden
└── LICENSE                   # MIT-Lizenz

4. 🚀 Schnellstart

4.1 Installation der Erweiterung

4.1.1 Chrome

Methode 1 (Empfohlen): Aus dem offiziellen Chrome Web Store installieren

Chrome öffnen und Chrome Web Store besuchen
Nach "Proxy-Assistent" suchen
Auf "Zu Chrome hinzufügen" klicken

Methode 2: Lokale Installation

Option A (Quellcode verwenden): Quellcode herunterladen, src/manifest_chrome.json in manifest.json umbenennen, dann das src-Verzeichnis laden
Option B (Installationspaket verwenden):
1. Zur Seite GitHub Releases gehen
2. Datei proxy-assistant-chrome-x.x.x.zip herunterladen
3. Die heruntergeladene ZIP-Datei in ein beliebiges Verzeichnis entpacken
4. Chrome öffnen und chrome://extensions/ besuchen
5. Den "Entwicklermodus" oben rechts aktivieren
6. Auf den Button "Entpackte Erweiterung laden" oben links klicken
7. Den in Schritt 3 entpackten Ordner auswählen
8. Die Erweiterung erscheint in der Erweiterungsliste nach erfolgreicher Installation

4.1.2 Firefox

Methode 1 (Empfohlen): Aus den offiziellen Firefox-Add-ons installieren

Firefox öffnen und Firefox-Add-ons besuchen
Nach "Proxy-Assistent" suchen
Auf "Zu Firefox hinzufügen" klicken

Methode 2: Lokale Installation

Das Firefox-Erweiterungs-Installationspaket (.xpi-Datei) aus dem release-Verzeichnis herunterladen
Firefox öffnen und about:addons besuchen
Auf Zahnradsymbol → Add-on aus Datei installieren klicken
Die heruntergeladene .xpi-Datei auswählen

4.1.3 Microsoft Edge

Der Edge-Browser basiert auf dem Chromium-Kernel und kann Chrome-Erweiterungen direkt installieren.

Methode 1 (Empfohlen): Aus dem Chrome Web Store installieren

Edge öffnen und edge://extensions/ besuchen
Im Abschnitt "Neue Erweiterungen finden" auf "Erweiterungen aus dem Chrome Web Store abrufen" klicken, Chrome Web Store besuchen
Nach "Proxy-Assistent" suchen
Auf "Abrufen" klicken und dann "Zu Microsoft Edge hinzufügen"

Methode 2: Lokale Installation

Zur Seite GitHub Releases gehen
Datei proxy-assistant-chrome-x.x.x.zip herunterladen
Die heruntergeladene ZIP-Datei in ein beliebiges Verzeichnis entpacken
Edge öffnen und edge://extensions/ besuchen
Den "Entwicklermodus" unten links aktivieren
Auf den Button "Entpacktes Verzeichnis auswählen" klicken
Den in Schritt 3 entpackten Ordner auswählen
Die Erweiterung erscheint in der Erweiterungsliste nach erfolgreicher Installation

4.2 Hinzufügen eines Proxys

Auf das Erweiterungssymbol klicken, um das Popup zu öffnen
Auf die "Einstellungen"-Schaltfläche klicken, um die Einstellungsseite zu öffnen
Auf die "Neuer Proxy"-Schaltfläche klicken, um einen neuen Proxy hinzuzufügen
Die Proxy-Informationen ausfüllen:
- Proxy-Name
- Protokolltyp (HTTP/HTTPS/SOCKS4/SOCKS5)
- Proxy-Adresse (IP oder Domain)
- Port
- (Optional) Benutzername und Passwort
- (Optional) URL-Regelkonfiguration
Auf die "Speichern"-Schaltfläche klicken

4.3 Verwenden von Proxys

Manueller Modus:

"Manuell" Modus im Popup auswählen
Den Proxy aus der Liste auswählen
Der Status "Verbunden" zeigt an, dass er aktiv ist

Automatischer Modus:

"Automatisch" Modus im Popup auswählen
URL-Regeln für jeden Proxy auf der Einstellungsseite konfigurieren
Der Proxy wird automatisch basierend auf der besuchten Website ausgewählt

5. 🛠️ Entwicklerhandbuch

5.1 Entwicklungsumgebung

Voraussetzungen:

Node.js >= 14
npm >= 6
Chrome / Firefox Browser (zum Testen)
web-ext (für Firefox XPI Build, optional)

Abhängigkeiten installieren:

make test_init
# oder
npm install

5.2 Testbefehle

Befehl	Beschreibung
`make test`	Alle Tests ausführen (Unit + Integration + E2E)
`make test_nocache`	Tests ohne Cache ausführen
`make test_unit`	Nur Unit-Tests ausführen
`make test_integration`	Nur Integrationstests ausführen
`make test_e2e`	Nur E2E-Tests ausführen
`make test_clean`	Test-Cache und Abdeckungsdateien bereinigen

npm direkt verwenden:

npm test                    # Alle Tests ausführen
npm run test:unit           # Nur Unit-Tests ausführen
npm run test:integration    # Nur Integrationstests ausführen
npm run test:e2e            # Nur E2E-Tests ausführen
npm run test:watch          # Tests im Watch-Modus ausführen
npm run test:coverage       # Tests ausführen und Abdeckungsbericht generieren

5.3 Build-Befehle

Befehl	Beschreibung
`make build`	Chrome- und Firefox-Erweiterungen bauen
`make clean`	Build-Artefakte bereinigen
`make test_clean`	Test-Cache und Abdeckungsdateien bereinigen

Version angeben:

make build VERSION=dev
# oder
./script/build.sh dev

Build-Artefakte:

build/
├── ProxyAssistant_{VERSION}_chrome.zip      # Chrome Installationspaket
├── ProxyAssistant_{VERSION}_chrome.tar.gz   # Chrome Quellpaket
├── ProxyAssistant_{VERSION}_firefox.zip     # Firefox Installationspaket
├── ProxyAssistant_{VERSION}_firefox.tar.gz  # Firefox Quellpaket
└── ProxyAssistant_{VERSION}_firefox.xpi     # Firefox offizielles Erweiterungspaket

5.4 Lokale Entwicklung

Chrome Lokale Installation:

src/manifest_chrome.json in manifest.json umbenennen
Chrome öffnen, chrome://extensions/ besuchen
"Entwicklermodus" aktivieren
"Entpackte Erweiterung laden" klicken
src Verzeichnis auswählen

Firefox Lokale Installation:

make build verwenden, um XPI-Datei zu generieren
Firefox öffnen, about:addons besuchen
Zahnradsymbol → Add-on aus Datei installieren klicken
Die generierte .xpi-Datei auswählen

5.5 Code-Stil

Einrückung: 2 Leerzeichen
Anführungszeichen: Einfache Anführungszeichen
Benennung: camelCase, Konstanten verwenden UPPER_SNAKE_CASE
Semikolons: Konsistente Verwendung

Detaillierte Spezifikationen finden Sie in AGENTS.md

6. 📖 Detaillierte Dokumentation

6.1 URL-Regelsyntax

Unterstützt die folgenden Matching-Regeln:

# Exakte Übereinstimmung
google.com

# Subdomain-Übereinstimmung
.google.com
www.google.com

# Wildcard-Übereinstimmung
*.google.com
*.twitter.com

# IP-Adresse
192.168.1.1
10.0.0.0/8

6.2 Fallback-Strategie

Im automatischen Modus, wenn die Proxy-Verbindung fehlschlägt:

Strategie	Beschreibung
Direktverbindung (DIRECT)	Proxy umgehen, direkt zur Zielwebsite verbinden
Verbindung ablehnen (REJECT)	Die Anfrage ablehnen

6.3 PAC-Skript-Automatikmodus

Der automatische Modus verwendet PAC (Proxy Auto-Config) Skripte:

Wählt automatisch den Proxy basierend auf der aktuellen URL
In der Reihenfolge der Proxy-Liste abgleichen, ersten übereinstimmenden Proxy zurückgeben
Unterstützt Fallback-Strategie
Stellt automatisch die letzte Konfiguration beim Browser-Start wieder her

6.4 Schnelloperationen

Operation	Methode
Proxy-Karte erweitern/zuklappen	Auf Kartenüberschrift klicken
Alle Karten erweitern/zuklappen	Auf "Alle erweitern/zuklappen"-Button klicken
Proxy per Drag & Drop neu ordnen	Ziehen am Griff auf der Kartenüberschrift
Passwort anzeigen/ausblenden	Auf das Auge-Symbol rechts vom Passwortfeld klicken
Einzelnen Proxy aktivieren/deaktivieren	Toggle auf der Karte
Einzelnen Proxy testen	Auf "Verbindung testen"-Button klicken
Alle Proxys testen	Auf "Alle testen"-Button klicken
Popup schnell schließen	Auf der Seite `ESC` Taste drücken

6.5 Konfiguration importieren/exportieren

Exportieren: Auf "Konfiguration exportieren" klicken, um eine JSON-Datei herunterzuladen
Importieren: Auf "Konfiguration importieren" klicken und eine JSON-Datei zum Wiederherstellen auswählen

Die Konfiguration enthält:

Alle Proxy-Informationen
Themen-Einstellungen
Dunkelmodus-Zeitraum
Spracheinstellungen
Synchronisationsschalter-Status

6.6 Proxy-Statuserkennung

Auf den Button "Proxy-Effekt erkennen" klicken kann:

Den aktuellen Browser-Proxy-Modus anzeigen
Überprüfen, ob die Erweiterung den Proxy erfolgreich gesteuert hat
Erkennen, ob andere Erweiterungen die Steuerung übernommen haben
Problemdiagnose und Vorschläge erhalten

7. 🔧 Technische Architektur

7.1 Manifest V3

Chrome verwendet Manifest V3-Spezifikation
Service Worker ersetzt Hintergrundseiten
Firefox verwendet background scripts + onRequest API
Unterstützt native Browser-Synchronisierungsspeicher und GitHub Gist-Synchronisierung

7.2 Kernmodule

Modul	Datei	Funktionsbeschreibung
Hauptprogramm	main.js	Einstellungsseitenlogik, Szenarioverwaltung, Proxy-CRUD, Drag&Drop-Sortierung, Import/Export, Proxy-Erkennung
Popup	popup.js	Popup-Schnittstelleninteraktion, Proxy-Statusanzeige, schneller Proxy-Wechsel, automatische Übereinstimmungsanzeige
Hintergrund	worker.js	Proxy-Konfigurationsverwaltung, PAC-Skript-Generierung, Authentifizierungsbehandlung, Proxy-Test, Abonnement-Auto-Update, Speicheränderungsüberwachung
Speicher	storage.js	Lokale/Cloud-Speicherverwaltung, Chunk-Synchronisierung, Datenvalidierung, Konfigurations-Import/Export
i18n	i18n.js	Mehrsprachige Unterstützung, Echtzeit-Wechsel, dynamische Übersetzungsladung
Thema	theme.js	Hell/Dunkel-Thema-Wechsel, automatischer Wechsel nach Zeit
Szenarien	scenarios.js	Multi-Szenario-Unterstützung, Szenario-Wechsel, Szenario-Umbenennung/Löschen/Sortierung
Synchronisierung	sync.js	Native Browser-Synchronisierung, GitHub Gist-Synchronisierung
Abonnement	subscription.js	Proxy-Abonnement-Parsing (AutoProxy/SwitchyLegacy/SwitchyOmega/PAC), Auto-Update
Proxy	proxy.js	Proxy-Listen-Rendering, Bearbeitung, Test, Drag&Drop-Sortierung
Erkennung	detection.js	Proxy-Statuserkennung, Erweiterungs-Steuerungsübernahme-Erkennung, Konflikterkennung
Validierung	validator.js	IP/Domain/Port/Regelformat-Validierung
Hilfsfunktionen	utils.js	Allgemeine Hilfsfunktionen, DOM-Operationshilfen
Sprache	language.js	Dropdown-Menü-Interaktionsbehandlung
Konfiguration	config.js	Standard-Konfigurationskonstanten, Systemkonfigurationsverwaltung

7.3 Datenspeicherung

chrome.storage.local: Lokaler Speicher (immer verwendet)
chrome.storage.sync: Cloud-Synchronisierungsspeicher (optional)
chrome.storage.session: Sitzungsspeicher (Authentifizierungsinformationen, Status-Cache)
Lokal-zuerst-Prinzip, löst Problem der Synchronisierungsquote
Chunk-Speicherung (7KB pro Chunk) umgeht 8KB-Quote-Limit

7.4 Konfigurationsformat-Version

Version	Beschreibung
v1	Erstes Format
v2	Szenario-Unterstützung hinzugefügt
v3	Abonnement-Unterstützung hinzugefügt
v4	Einheitlicher Proxy-Deaktivierungsstatus, Verwendung eindeutiger IDs, Abonnement-Regelumkehrung

7.5 Browser-Kompatibilität

Funktion	Chrome	Firefox
Manueller Modus	✅	✅
Automatischer Modus	✅	✅
Proxy-Authentifizierung	✅	✅
Proxy-Test	✅	✅
Themenwechsel	✅	✅
Datensynchronisierung	✅	✅
Proxy-Erkennung	✅	✅
Abonnement	✅	✅

7.6 Kernimplementierungstechnologien

Natives JavaScript + jQuery: Ke Framework-Abhängigkeit, leichtgewichtig
Manifest V3: Chrome verwendet Service Worker, Firefox verwendet background scripts
PAC-Skript: Dynamisch generiertes Proxy-Auto-Config-Skript im Auto-Modus
Proxy-Authentifizierung: Verwendet webRequestAuthProvider API zur Authentifizierungsanfragenbehandlung
Chunk-Synchronisierung: Benutzerdefinierter Chunking-Algorithmus löst Chrome storage.sync Quote-Limits
Abonnement-Parsing: Unterstützt automatisches Parsen und Konvertieren mehrerer Abonnementformate

8. 📝 Anwendungsfälle

8.1 Szenario 1: Mehrfacher Proxy-Wechsel

Verschiedene Proxys für verschiedene Netzwerkumgebungen konfigurieren
Unternehmens-Proxy für Büronetzwerk verwenden
Wissenschaftlichen Proxy für Heimnetzwerk verwenden
Schneller Ein-Klick-Wechsel

8.2 Szenario 2: Intelligentes Routing

Inländische Websites direkte Verbindung
Bestimmte Websites über Proxy
Automatische Auswahl basierend auf Domain

8.3 Szenario 3: Proxy-Pool-Test

Mehrere Proxys importieren
Latenz im Batch testen
Optimalen Proxy zum Verwenden auswählen

8.4 Szenario 4: Teamfreigabe

Konfigurationsdatei exportieren
Mit Teammitgliedern teilen
Einheitliche Proxy-Konfiguration

9. ⚠️ Wichtige Hinweise

Berechtigungsbeschreibung: Die Erweiterung erfordert die folgenden Berechtigungen:
- proxy: Proxy-Einstellungen verwalten
- storage: Konfigurationen speichern
- webRequest / webRequestAuthProvider: Authentifizierungsanfragen bearbeiten
- <all_urls>: Auf alle Website-URLs zugreifen
Konflikte mit anderen Erweiterungen: Bei Proxy-Konflikten bitte andere Proxy/VPN-Erweiterungen deaktivieren
Sicherheit: Anmeldeinformationen werden lokal im Browser gespeichert. Bitte stellen Sie die Sicherheit Ihres Geräts sicher
Netzwerkanforderungen: Stellen Sie sicher, dass der Proxy-Server normal zugänglich ist
Firefox-Einschränkung: Die Mindestversion von Firefox ist 142.0

10. 📄 Datenschutzrichtlinie

Datenschutzrichtlinie

11. 📄 Lizenz

MIT License - Siehe LICENSE-Datei für Details

12. 🤝 Beiträge

Issue-Berichte und Pull-Requests sind willkommen!

13. 📧 Kontakt

Bei Fragen oder Anregungen senden Sie bitte Feedback über GitHub Issues.

Wenn dieses Projekt Ihnen geholfen hat, bitte unterstützen Sie es mit einem Star ⭐!

FilesExpand file tree

README-de.md

Latest commit

History

README-de.md

File metadata and controls

Proxy-Assistent

1. ✨ Funktionen

1.1 🔌 Unterstützung mehrerer Proxy-Protokolle

1.2 🌐 Multi-Browser-Unterstützung

1.3 🔄 Drei Proxy-Modi

1.4 🎬 Szenario-Modus

1.5 📥 Proxy-Abonnementfunktion

1.6 📋 Flexible URL-Regelkonfiguration

1.7 🔐 Proxy-Authentifizierungsunterstützung

1.8 🧪 Proxy-Testfunktionen

1.9 🏃 Proxy-Statuserkennung

1.10 🔍 PAC-Skript-Vorschau

1.11 🌙 Themen-Modi

1.12 ☁️ Datenspeicherung und Synchronisierung

1.12.1 Speicherstrategie

1.12.2 Synchronisierungsmethoden

1.12.2.1 Native Browser-Synchronisierung (Native Sync)

1.12.2.2 GitHub Gist-Synchronisierung

1.12.3 Synchronisierungsvorgänge

1.12.4 Import/Export

1.13 🌍 Mehrsprachige Unterstützung

2. 📷 Einstellungsseite

3. 📁 Projektstruktur

4. 🚀 Schnellstart

4.1 Installation der Erweiterung

4.1.1 Chrome

4.1.2 Firefox

4.1.3 Microsoft Edge

4.2 Hinzufügen eines Proxys

4.3 Verwenden von Proxys

5. 🛠️ Entwicklerhandbuch

5.1 Entwicklungsumgebung

5.2 Testbefehle

5.3 Build-Befehle

5.4 Lokale Entwicklung

5.5 Code-Stil

6. 📖 Detaillierte Dokumentation

6.1 URL-Regelsyntax

6.2 Fallback-Strategie

6.3 PAC-Skript-Automatikmodus

6.4 Schnelloperationen

6.5 Konfiguration importieren/exportieren

6.6 Proxy-Statuserkennung

7. 🔧 Technische Architektur

7.1 Manifest V3

7.2 Kernmodule

7.3 Datenspeicherung

7.4 Konfigurationsformat-Version

7.5 Browser-Kompatibilität

7.6 Kernimplementierungstechnologien

8. 📝 Anwendungsfälle

8.1 Szenario 1: Mehrfacher Proxy-Wechsel

8.2 Szenario 2: Intelligentes Routing

8.3 Szenario 3: Proxy-Pool-Test

8.4 Szenario 4: Teamfreigabe

9. ⚠️ Wichtige Hinweise

10. 📄 Datenschutzrichtlinie

11. 📄 Lizenz

12. 🤝 Beiträge

13. 📧 Kontakt