Zurück zum Import-Center

So importieren Sie Wörterbücher aus R2/S3 Buckets

Eine Schritt-für-Schritt-Anleitung zum Einrichten des Cloud-Speichers und zum Importieren Ihrer Wörterbücher aus R2- oder S3-kompatiblen Buckets.

Was Sie brauchen:

  • Ein Cloudflare R2-Konto (empfohlen) oder ein beliebiger S3-kompatibler Speicheranbieter
  • MDict Wörterbuchdateien (.mdx- und optionale .mdd-Dateien), die in Ihren Bucket hochgeladen wurden
  • API-Anmeldeinformationen (Zugriffsschlüssel ID und geheimer Zugriffsschlüssel)

Schritt 1: Einrichten von Cloudflare R2

1.1 Erstellen Sie einen R2 Bucket

  1. Log in to your Cloudflare dashboard
  2. Navigate to R2 from the left sidebar
  3. Click Create bucket
  4. Enter a name for your bucket (e.g., my-dictionaries)
  5. Wählen Sie Ihren bevorzugten Standort (wählen Sie einen in Ihrer Nähe für bessere Leistung)
  6. Click Create bucket

1.2 Wörterbuchdateien hochladen

  1. Öffnen Sie Ihren neu erstellten Bucket
  2. Click Upload
  3. Laden Sie Ihre Wörterbuchdateien hoch (.mdx-Dateien und ihre zugehörigen .mdd-Ressourcendateien)
  4. Make sure related files share the same base name (e.g., Oxford.mdx, Oxford.mdd)

1.3 Öffentlichen Zugriff aktivieren (Erforderlich)

  1. In your bucket settings, find the Public Access section
  2. Click Connect Domain or Allow Access
  3. Sie können entweder:
    • Use R2's default public URL (e.g., https://pub-xxxxx.r2.dev)
    • Verbinden Sie eine benutzerdefinierte Domäne, die Sie besitzen, um sauberere URLs zu erhalten
  4. Copy the Public Bucket URL - you'll need this later

1.4 Generieren Sie API Tokens

  1. Go back to the R2 overview page
  2. Click Manage R2 API Tokens
  3. Click Create API Token
  4. Token konfigurieren:
    • Token name: e.g., "WordHub Dictionary Access"
    • Permissions: Select Object Read (read-only is sufficient)
    • TTL: Choose "Forever" or set an expiration date
    • (Optional) Auf bestimmte Buckets beschränken für bessere Sicherheit
  5. Click Create API Token
  6. Important: Copy and save these credentials immediately (they won't be shown again):
    • Zugriffsschlüssel ID
    • Geheimer Zugangsschlüssel
    • Endpoint URL (usually https://<account-id>.r2.cloudflarestorage.com)

Schritt 2: Verwendung anderer S3-kompatibler Anbieter

WordHub unterstützt auch andere S3-kompatible Speicherdienste wie AWS S3, MinIO, Backblaze B2, DigitalOcean Spaces und mehr. Der Einrichtungsprozess ist ähnlich:

Erstellen Sie einen Bucket in der Konsole Ihres Anbieters

Laden Sie Ihre Wörterbuchdateien in den Bucket hoch

Aktivieren Sie den öffentlichen Lesezugriff oder konfigurieren Sie entsprechende Berechtigungen

Zugangsdaten generieren (Zugriffsschlüssel ID und geheimer Zugangsschlüssel)

Notieren Sie sich den öffentlichen URL und den Endpunkt URL Ihres Buckets.

Schritt 3: Wörterbücher in WordHub importieren

3.1 Importvorgang starten

  1. Go to the Dictionary Import Center
  2. Click Start Dictionary Import
  3. Select Bucket URL (not Local Files)

3.2 Geben Sie Ihre Anmeldedaten ein

  1. Bucket URL: Paste your bucket's public URL (e.g., https://pub-xxxxx.r2.dev)
  2. Access Key ID: Paste the Access Key ID from Step 1.4
  3. Secret Access Key: Paste the Secret Access Key from Step 1.4
  4. Region: For Cloudflare R2, select Auto. For other providers, select the appropriate region.
  5. Endpoint (Optional): If using a custom endpoint, enter it here (e.g., for Cloudflare R2: https://<account-id>.r2.cloudflarestorage.com)

3.3 Testen und Entdecken

  1. Click Test Connection to verify your credentials
  2. If the connection is successful, click Discover Files
  3. WordHub scannt Ihre Bucket- und Gruppenwörterbuchdateien automatisch
  4. Überprüfen Sie die gefundenen Wörterbücher und wählen Sie aus, welche importiert werden sollen
  5. Click Import Selected Dictionaries to begin the import

Fehlerbehebung

„Verbindung fehlgeschlagen“ oder „Zugriff verweigert“

  • Überprüfen Sie, ob Ihr Zugriffsschlüssel ID und Ihr geheimer Zugriffsschlüssel korrekt sind
  • Überprüfen Sie, dass Ihr Bucket öffentlichen Lesezugriff aktiviert hat
  • Stellen Sie sicher, dass das API-Token über die richtigen Berechtigungen verfügt (mindestens Object Read).
  • Stellen Sie sicher, dass der Bucket URL der öffentliche Endpunkt URL und nicht der Endpunkt API ist

„Keine Wörterbuchdateien gefunden“

  • Bestätigen Sie, dass .mdx-Dateien in Ihrem Bucket vorhanden sind
  • Überprüfen Sie, dass sich die Dateien auf der Root-Ebene oder direkt im Bucket befinden (nicht in tief verschachtelten Ordnern)
  • Verify file names follow the correct naming convention (e.g., Dictionary.mdx, Dictionary.mdd)

„Region/Endpoint-Probleme“

  • Verwenden Sie für Cloudflare R2 die Region „Auto“ und geben Sie optional den Endpunkt an
  • Wählen Sie für AWS S3 die richtige Region aus, in der sich Ihr Bucket befindet
  • Informationen zu den richtigen Endpunkt-URL- und Regionseinstellungen finden Sie in der Dokumentation anderer Anbieter

Best Practices für die Sicherheit

Use read-only permissions: Grant only Object Read access to your API tokens to prevent unauthorized modifications.

Restrict token scope: Limit API tokens to specific buckets rather than giving account-wide access.

Set token expiration: Consider setting an expiration date for your API tokens and rotate them regularly.

Keep credentials private: Never share your Access Key ID and Secret Access Key publicly.

Sind Sie bereit, Ihre Wörterbücher zu importieren?

Gehen Sie zum Importcenter