Dokumentation

Schnellstart + Funktionsbeschreibung für jeden Bereich und jedes Gerät (wird laufend erweitert)

Image-Quellen wechseln

Dieser Artikel beschreibt die Funktion „Regionale Image-Quellen“ im Panel – sie stellt die Software-Quelle bzw. die Docker-Installationsquelle eines Servers in China auf die regionale Quelle von Alibaba Cloud um.

Zuerst verstehen: Was ist eine „Quelle“

Beim Installieren von Software lädt Linux die Pakete aus einem „Software-Repository“ (Quelle). Die offiziellen Quellen, die ausländische Server standardmäßig nutzen, sind aus China oft sehr langsam oder gar nicht erreichbar – Installationen bleiben dann hängen oder laufen in einen Timeout. Quellen wechseln heißt: die Download-Adresse von der „offiziellen Quelle im Ausland“ auf einen „regionalen Spiegel“ (etwa Alibaba Cloud) umstellen; die Download-Geschwindigkeit steigt sofort.

Funktionsbeschreibung

Server in Festlandchina erreichen ausländische Software-Quellen (get.docker.com, download.docker.com usw.) häufig nur sehr langsam oder überhaupt nicht. Diese Funktion stellt die System-Softwarequelle und die Docker-Installationsquelle des Zielservers mit einem Klick auf die regionale Spiegel-Quelle von Alibaba Cloud um und behebt damit Probleme wie hängende oder in einen Timeout laufende Installationen von Software bzw. Docker sowie zurückgesetzte SSL-Verbindungen.

Anwendungsfälle

  • Der Server steht in China und der Zugriff auf ausländische Quellen ist langsam oder schlägt fehl
  • Die Installation von Software über die App-Übersicht schlägt fehl, Docker lässt sich nicht installieren
  • Bei apt-get / dnf / apk soll die Installation über eine regionale Beschleunigung laufen

Verwendung

Für den Quellenwechsel gibt es zwei Einstiegspunkte:

Einstieg 1: Systemverwaltungs-Panel (empfohlen)

1. In der Serverliste bei einem Server auf die Schaltfläche „Systemverwaltung“ klicken

2. Oben in den Registerkarten „Image-Quellen“ finden (⚡-Symbol, zwischen „Geplante Aufgaben“ und „Einstellungen“)

3. Das Panel erkennt das System des Servers automatisch (Distribution + Paketmanager)

4. Nach Bedarf klicken:

  • System-Quelle wechseln (Alibaba Cloud): System-Softwarequelle (apt/dnf/apk) auf Alibaba Cloud umstellen
  • Docker-Quelle wechseln (Alibaba Cloud): Docker-Installationsquelle auf Alibaba Cloud umstellen
  • Offizielle System-Quelle wiederherstellen / Offizielle Docker-Quelle wiederherstellen: mit einem Klick auf die offizielle Quelle zurücksetzen

Einstieg 2: Schnellschaltfläche auf der Server-Karte

Im Schaltflächenbereich jeder Karte in der Serverliste gibt es ein ⚡-Blitzsymbol (rechts neben der Schaltfläche „Systemverwaltung“, links vom Bearbeiten-Stift). Ein Klick öffnet das Panel für den Quellenwechsel direkt, ohne Umweg über die Systemverwaltung.

Unterstützte Systeme

DistributionPaketmanagerSystem-QuelleDocker-Quelle
Debian / Ubuntuapt✅✅
Rocky / AlmaLinuxdnf✅✅
CentOSyum / dnf✅✅
Fedoradnf✅✅
Alpineapk✅—

Hinweise zu den Image-Quellen

  • Verwendet wird der Alibaba-Cloud-Spiegel (mirrors.aliyun.com) – die Quelle eines großen chinesischen Anbieters, langfristig stabil.
  • Für die Docker-Installationsquelle wird das docker-ce-Repository von Alibaba Cloud genutzt; das Herunterladen der Docker-Engine selbst läuft über die regionale Beschleunigung.

> ⚠️ Achtung: Gewechselt wird hier die Installationsquelle (Software-Quelle + Docker-Engine-Quelle), nicht der „Docker-Image-Beschleuniger“ (die Beschleunigung für den Bezug von docker pull-Images). Letzterer erfordert, dass Nutzer selbst eine persönliche Alibaba-Cloud-Beschleuniger-ID beantragen, da öffentliche Beschleunigungsquellen großflächig ausgefallen sind.

Sicherheit

1. Automatisches Backup: Vor dem Quellenwechsel wird die ursprüngliche Konfigurationsdatei automatisch gesichert und kann jederzeit mit einem Klick wiederhergestellt werden.

2. Rollback möglich: Die Schaltfläche zum Wiederherstellen setzt die offizielle Quelle zurück und aktualisiert den Cache.

3. Nur die Quellenkonfiguration wird geändert: Andere Konfigurationen des Servers werden nicht angetastet.

Zu beachten

1. Der Quellenwechsel ist eine bewusste Aktion des Nutzers; das Panel erkennt nicht automatisch, „ob der Server in China steht“, und erzwingt keinen Wechsel (um Fehlbedienung in Umgebungen zu vermeiden, in denen nicht gewechselt werden sollte).

2. Bei sehr alten Distributionen (etwa Fedora 32, bereits EOL) kann der Wechsel trotzdem fehlschlagen, weil die offiziellen Quellen nicht mehr gepflegt werden und die Spiegel die entsprechenden Versionen nicht mehr vorhalten.

3. Schlägt beim Installieren von Docker das offizielle Skript fehl, fällt das Panel automatisch auf die Installation über die Alibaba-Cloud-Quelle zurück – ohne manuelles Eingreifen.