Dokumentation · Systemanforderungen
Hosting-Anforderungen
Einführung
ADP Car Market Hub stellt keine ungewöhnlichen Anforderungen an einen WordPress-Host: Jeder Provider, der die offiziellen WordPress-Anforderungen erfüllt und ausgehende HTTPS-Verbindungen zur AutoScout24-API zulässt, kann das Plugin ausführen. Dennoch umfassen Fahrzeugimporte Tausende von API-Aufrufen, Bilddownloads, geplante Hintergrundaufgaben und eine wachsende Mediathek, sodass das praktische Hosting-Profil eher dem eines gut besuchten WooCommerce-Shops als dem einer einfachen Website entspricht.
Dieses Dokument beschreibt das Hosting, die Serverressourcen, den ausgehenden HTTPS-Zugriff, den Speicherplatz, Backups, Staging und Überlegungen zur Produktionsreife für ADP Car Market Hub.
Wann Sie dieses Dokument verwenden sollten
Verwenden Sie dieses Dokument, wenn Sie:
- Einen Hosting-Tarif für eine neue Garagen-Website auswählen.
- Überprüfen, ob ein bestehender Host die Import-Arbeitslast des Plugins problemlos bewältigen kann.
- Die Speicherkapazität für Fahrzeugbilder und Plugin-Logs planen.
- Eine Staging-Umgebung, eine Backup-Richtlinie oder eine Checkliste für den Produktionsstart einrichten.
Übersicht
Das Hosting-Profil des Plugins wird durch folgende Arbeitslasten geprägt:
- Regelmässige ausgehende HTTPS-Verbindungen zu AutoScout24 (bei jedem Cron-Lauf) und zum verwalteten Google Gemini-Endpunkt, wenn der AI Assistant aktiviert ist.
- Bilddownloads von AutoScout24-Bild-Hosts in
wp-content/uploads/, optional mit WebP-Rekodierung. - PHP-CPU- und Speicher-Spitzen während des Batch-Wizards, des Full Syncs und der KI-Generierungsaufgaben.
- Kontinuierliche Datenbank-Schreibvorgänge mit geringem Volumen für Analytics-Ereignisse, Leads, Suchaufträge und Cron-Heartbeats.
- Dateibasierte Logs in
wp-content/uploads/as24ci-logs/(rotiert bei 10 MB, 7 Tage Aufbewahrungsfrist).
Ein Host, der einen mittelgrossen WooCommerce-Shop problemlos betreiben kann, wird dieses Plugin ohne Probleme ausführen.
Anforderungen
Webserver
- Software: Jeder Webserver, der offiziell von WordPress unterstützt wird – typischerweise Nginx oder Apache (LiteSpeed und Caddy sind in der Praxis ebenfalls in Ordnung).
- HTTPS: Ein gültiges TLS-Zertifikat auf der öffentlichen Website. Es gibt keine Erzwingung auf Plugin-Ebene, aber die AutoScout24-API und moderne Browser erwarten HTTPS.
- PHP-Handler: PHP-FPM (oder gleichwertig) mit PHP 8.1+ (siehe PHP and Database Requirements für Details).
- URL-Rewriting: Aktive Rewrite-Engine (mod_rewrite für Apache,
try_filesfor Nginx), damit sprechende Permalinks und die REST-API funktionieren.
Serverressourcen
Dies sind praktische Empfehlungen; der Plugin-Code erzwingt keine spezifischen Werte, die über die im Tab "System & Hilfe" überprüften PHP-Grenzwerte hinausgehen.
- CPU: Mindestens 1 vCPU für kleine Bestände (< 100 Fahrzeuge); 2 vCPU+ empfohlen für mittelgrosse Bestände oder wenn die KI-Generierung aktiviert ist.
- RAM: Mindestens 1 GB Gesamtarbeitsspeicher des Servers; 2 GB+ empfohlen. Das PHP-
memory_limitdes Plugins sollte mindestens 256 MB betragen (der Tab "System & Hilfe" markiert alles unter 128 MB als "zu niedrig"). - PHP-Ausführungszeit: Ein
max_execution_timevon 120 Sekunden oder mehr wird für bildintensive Importe empfohlen; der Tab "System & Hilfe" markiert 30–60 Sekunden lediglich als "akzeptabel". - Gleichzeitigkeit: Erlauben Sie mindestens 2 gleichzeitige PHP-Worker, damit ein lang laufender Import nicht die öffentliche Website oder das Admin-Dashboard blockiert.
Ausgehender HTTPS-Zugriff
Der Server muss in der Lage sein, ausgehende HTTPS-Anfragen (Port 443) an folgende Ziele zu senden:
https://api.autoscout24.com– zwingend erforderlich. Wird vom Importer für OAuth-Tokens, Inserate und Bild-URLs verwendet.- AutoScout24-Bild-CDN-Hosts – zwingend erforderlich. Von der API zurückgegebene Fahrzeug-Bild-URLs werden direkt heruntergeladen.
https://generativelanguage.googleapis.com– erforderlich, wenn der AI Assistant aktiviert ist. Wird verwendet, um den inAS24CI\Ai_Configkonfigurierten verwalteten Google Gemini-Endpunkt aufzurufen.https://api.wordpress.org– empfohlen, damit WordPress und Plugin-Updates normal funktionieren.
Wenn der Host eine ausgehende Firewall oder einen Proxy verwendet, geben Sie diese Ziele frei und stellen Sie sicher, dass die Standard-WordPress-HTTP-Transporte (wp_remote_get / wp_remote_post, die im Hintergrund cURL verwenden) funktionieren.
Wenn andere Connections-Quellen verwendet werden, benötigt der Server ebenfalls den entsprechenden ausgehenden Zugriff (nur für die von Ihnen konfigurierten Quellen):
- mobile.de – ausgehendes HTTPS zum mobile.de-API-Host.
- carcuro – ausgehendes HTTPS zum carcuro-API-Host.
- Automatischer Feed – ausgehendes HTTPS für
https://-URLs und Cloud-Freigabelinks oder ausgehendes FTP/FTPS (TCP/21 + passive Ports) / SFTP (TCP/22, über die PHP-ssh2-Erweiterung oder einen SFTP-Stream-Wrapper) zum Feed-Server. Ein Feed aus einem Server-Ordner benötigt keinen Netzwerkzugriff. - E-Mail-Import – ausgehendes IMAP zum Mailbox-Host (TCP/993 IMAPS oder TCP/143 STARTTLS); erfordert die PHP-
imap-Erweiterung.
Siehe API, Network and SSL Requirements für die vollständige Liste der Endpunkte pro Quelle.
Speicherplatz
- Freier Mindestspeicherplatz: Der Tab "System & Hilfe" markiert < 100 MB frei als kritisch und < 500 MB frei als Warnung. Betrachten Sie 1 GB freien Speicherplatz als absolutes Minimum, selbst bei kleinen Beständen.
- Praktische Dimensionierung: Planen Sie mit etwa 5–25 MB Medienspeicher pro Fahrzeug, je nach Anzahl der Bilder und ob die WebP-Konvertierung aktiviert ist. Eine Garage mit 200 Fahrzeugen benötigt typischerweise 1–5 GB an Uploads.
- Dateisystem-Berechtigungen:
wp-content/uploads/muss für den PHP-Prozess beschreibbar sein. Das Plugin erstelltwp-content/uploads/as24ci-logs/bei der ersten Verwendung und schützt es mit den Standard-WordPress-Härtungsdateien. - Inode-Grenzwerte: Hosts mit strengen Inode-Quotas sollten mit vielen kleinen Dateien rechnen (jedes Fahrzeugbild plus die von WordPress generierten Zwischengrössen).
Ein funktionierender transaktionaler E-Mail-Pfad ist für Endbenutzer-Funktionen erforderlich:
- Lead-Benachrichtigungen aus dem Kontaktformular.
- Benachrichtigungen über Probefahrt-Buchungen.
- Double-Opt-In-Bestätigungen für Suchaufträge (Smart Stock Alerts).
- Administrative E-Mails von WordPress (Passwort-Resets, Fehlerbenachrichtigungen).
Ein vom Hosting bereitgestellter MTA, ein SMTP-Plugin, das auf einen Zustellungsdienst verweist (Postmark, SendGrid, Brevo, Amazon SES usw.), oder ein firmeneigenes SMTP-Relay funktionieren alle.
Backups
Das Plugin enthält keinen Backup-Mechanismus – Backups liegen in der Verantwortung des Hostings. Eine Produktionsumgebung sollte Folgendes umfassen:
- Tägliche Datenbank-Backups, die alle WordPress-Tabellen abdecken, einschliesslich der benutzerdefinierten Tabellen des Plugins (
{prefix}as24_vehicles, die Analytics-Tabelle, die Suchauftrags-Tabelle). - Tägliche Dateisystem-Backups von
wp-content/uploads/(Fahrzeugbilder und Plugin-Logs) undwp-content/plugins/. - Externe Aufbewahrung von mindestens 7 Tagen; länger, wenn lokale Datenschutzrichtlinien dies erfordern.
- Test-Wiederherstellungen mindestens vierteljährlich. Löschungen durch den Full Sync sind dauerhaft, daher sind getestete Backups der einzige Wiederherstellungsweg.
Staging und Produktionsreife
Eine saubere Staging-Umgebung wird vor dem Start oder vor Upgrades dringend empfohlen:
- Eine separate WordPress-Instanz auf denselben PHP-/MySQL-Versionen wie die Produktion.
- Eigene AutoScout24-Zugangsdaten, wo immer möglich, oder schreibgeschützte Nutzung, um eine Veränderung der Produktionsdaten zu vermeiden.
- Eigene Cron-Tokens für jede Umgebung.
- Ein dokumentierter Bereitstellungsprozess (Datenbank-Export/-Import, Suchen-Ersetzen von URLs, Reaktivierung des Plugins zur Aktualisierung von Rollen und Rewrite-Regeln).
- Der Tab "System & Hilfe" / Zustand des Plugins muss auf der Staging-Umgebung alle Prüfungen bestehen, bevor Änderungen in die Produktion übernommen werden.
Empfohlenes Produktions-Setup
- Verwaltetes WordPress Hosting auf einem aktuellen PHP 8.x-Zweig mit PHP-FPM, Nginx oder Apache, MySQL 8 / MariaDB 10.6+ und einem Container oder einer VM mit mindestens 1 vCPU / 2 GB RAM.
- TLS 1.2+ bei eingehenden Verbindungen und ein moderner ausgehender TLS-Stack mit aktuellen CA-Zertifikaten.
- 256 MB+ PHP
memory_limit, 300 smax_execution_time, 64 MB+upload_max_filesize. - Mindestens 10 GB Festplattenspeicher, der
wp-content/uploads/von Tag eins an zugewiesen ist. - Cron auf Betriebssystemebene, der
wp-cron.php(oder den REST-Cron-Endpunkt des Plugins) alle 5–15 Minuten auslöst, wobeiDISABLE_WP_CRONinwp-config.phpdefiniert ist. - SMTP über einen Transaktions-E-Mail-Anbieter mit korrekt konfiguriertem SPF/DKIM/DMARC.
- Tägliche Off-Site-Backups der Datenbank + Uploads, die mindestens 30 Tage lang aufbewahrt werden.
- Identische Staging-Umgebung, die regelmässig aus der Produktion aktualisiert wird.
- Uptime-Überwachung für die öffentliche Archiv-URL und den Cron-Trigger-Endpunkt.
Betriebliche Hinweise
- Fahrzeugbilder machen den grössten Teil des Festplattenwachstums aus. Überwachen Sie die Speichernutzung der Uploads im Laufe der Zeit und löschen Sie entweder veraltete Medien (das Plugin entfernt Bilder für gelöschte Fahrzeuge automatisch) oder verschieben Sie Uploads über ein Media-Offload-Plugin in einen Object Storage.
- Hosting-Anbieter mit aggressivem PHP-Worker-Recycling (z. B. Beenden von Workern nach 30 s) können grosse Importe unterbrechen. Verwenden Sie den Batch-Wizard (kleine, adaptive Batches) oder die Bildwarteschlange (asynchrone Verarbeitung) anstelle eines einzigen riesigen Imports.
- CDNs und Reverse-Proxies sollten den Query-Parameter des Cron-Tokens unverändert durchlassen und die Antworten von
wp-admin/,wp-login.php,wp-cron.phpoder/wp-json/as24ci/v1/*nicht zwischenspeichern. - Der verwaltete Gemini-Endpunkt kann eine hohe Latenz pro Anfrage aufweisen. Wenn Sie die KI-Generierung während des Imports aktivieren, erhöhen Sie
max_execution_timeentsprechend und bevorzugen Sie die asynchrone KI-Generierungswarteschlange. - Die Plugin-Protokolle wachsen stetig an, wenn die detaillierte Protokollierung (Verbose Logging) aktiviert ist. Das Plugin rotiert diese bei 10 MB und löscht rotierte Dateien, die älter als 7 Tage sind. Dennoch sollte das Verzeichnis in die regelmässige Überwachung des Festplattenspeichers einbezogen werden.
Fehlerbehebung
- Langsame Importe / häufige Timeouts: Erhöhen Sie den PHP-Arbeitsspeicher und die maximale Ausführungszeit, verringern Sie die Fahrzeug-Batchgrösse pro Cron-Durchlauf und stellen Sie sicher, dass die Bildwarteschlange aktiviert ist.
- "Verbindungsproblem – Fahrzeuge konnten nicht abgerufen werden": Überprüfen Sie die ausgehende HTTPS-Verbindung zu
api.autoscout24.com, die DNS-Auflösung des Servers und ob ein Firmen-Proxy oder eine WAF die Anfrage abfängt. - Bilder können nicht heruntergeladen werden: Überprüfen Sie den freien Festplattenspeicher, die Berechtigungen des Upload-Ordners und ob die AutoScout24 Bild-Hosts erreichbar sind.
- Warnungen zum Festplattenspeicher: Verwenden Sie die Speicherkarte im Tab "System & Hilfe", um den freien Speicherplatz zu überprüfen, und bereinigen Sie anschliessend alte Medien oder erweitern Sie das Volume.
- E-Mails werden nicht zugestellt: Konfigurieren Sie ein SMTP-Plugin oder einen Hosting-MTA; viele Shared-Hosting-Anbieter blockieren den direkten PHP-Versand via
mail(). - Backups erfassen nicht alle Plugin-Daten: Stellen Sie sicher, dass das Backup-Tool die gesamte WordPress Datenbank (einschliesslich der benutzerdefinierten Tabellen mit dem Präfix
{wp_prefix}as24_) und das gesamtewp-content/uploads/Verzeichnis abdeckt.