GitHub nach Codeberg spiegeln

Ein GitHub-Actions-Workflow, der Branches und Tags mit einfachem git push über SSH nach Codeberg spiegelt, ohne Action von Dritten.

Artikel Erstellt Aktualisiert Auch auf Englisch: Mirroring GitHub to Codeberg

Geprüft von adrian am

Ich wollte für mein Repository ein zweites Zuhause, falls GitHub irgendwann verschwindet oder seltsam wird, und Codeberg lag nahe. Was ich nicht wollte, war noch eine Action aus dem Marketplace auf diesem Weg. Ein einfaches git push über SSH reicht.

Das Ziel

  • Bei jedem Push auf main von GitHub nach Codeberg spiegeln.
  • Keine Abhängigkeit von Dritten im Workflow.
  • Nur Branches und Tags: ein sauberes Repository, in das keine origin/*-Refs durchsickern.

Ein eigener SSH-Schlüssel

Der Spiegel soll keinen vorhandenen Schlüssel mitbenutzen. Ich habe lokal ein neues ed25519-Paar nur für diesen Zweck erzeugt:

ssh-keygen -t ed25519 -C "github-actions-codeberg-mirror" -f ~/.ssh/codeberg_mirror -N ""

Die Schlüssel an die richtigen Stellen

Die beiden Hälften des Paares gehören auf entgegengesetzte Seiten, und sie zu verwechseln ist der häufigste Grund, warum es nicht klappt.

  • Deploy-Key bei Codeberg (Repository → Settings → Deploy keys): den Inhalt von ~/.ssh/codeberg_mirror.pub einfügen. Allow write access einschalten, sonst kann der Spiegel nicht pushen.
  • Secret bei GitHub (Settings → Secrets and variables → Actions): CODEBERG_SSH mit dem Inhalt von ~/.ssh/codeberg_mirror anlegen, also dem privaten Schlüssel.

Meldet ein Formular Key is invalid. You must supply a key in OpenSSH public key format, ist der private Schlüssel dort gelandet, wo der öffentliche hingehört. Tausch sie.

Der Workflow

Datei: .github/workflows/sync-mirror.yml:

name: Mirror to Codeberg
on:
  push:
    branches: [main]
  workflow_dispatch:
  schedule:
    - cron: '30 0 * * 0'

jobs:
  codeberg:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Configure SSH
        run: |
          mkdir -p ~/.ssh
          printf '%s\n' "${{ secrets.CODEBERG_SSH }}" > ~/.ssh/id_ed25519
          chmod 600 ~/.ssh/id_ed25519
          ssh-keyscan -H codeberg.org >> ~/.ssh/known_hosts
          cat <<'EOF' > ~/.ssh/config
          Host codeberg.org
            HostName codeberg.org
            User git
            IdentityFile ~/.ssh/id_ed25519
            IdentitiesOnly yes
          EOF

      - name: Verify SSH access
        run: |
          ssh -T git@codeberg.org || true
          git ls-remote git@codeberg.org:adrian-altner/website.git > /dev/null

      - name: Mirror to Codeberg
        run: |
          git remote add mirror git@codeberg.org:adrian-altner/website.git

          # Remove previously mirrored remote-tracking refs (for example refs/remotes/origin/*).
          while IFS= read -r ref; do
            git push mirror ":${ref}"
          done < <(git ls-remote --refs mirror 'refs/remotes/*' | awk '{print $2}')

          # Mirror only real branches and tags.
          git push --prune mirror \
            +refs/heads/*:refs/heads/* \
            +refs/tags/*:refs/tags/*

Drei Auslöser: jeder Push auf main, ein Knopf für workflow_dispatch und ein wöchentlicher Cron am Sonntag um 00:30 UTC. Der Cron ist das Sicherheitsnetz, falls ein Ausfall bei Codeberg einmal einen Push unbemerkt verschluckt.

Der Spiegel-Schritt macht zwei Dinge nacheinander. Erst räumt er alle refs/remotes/* weg, die in früheren Läufen hineingerutscht sind: Ich hatte ein paar refs/remotes/origin/* aus einem älteren Setup auf Codeberg, und sie kamen immer wieder. Dann pusht er refs/heads/* und refs/tags/* ausdrücklich, mit --prune, damit Löschungen auf GitHub mitkommen, statt sich anzuhäufen. --mirror hätte jeden Remote-Tracking-Ref gleich mitgenommen.

Was du beim Testen siehst

Bei einem erfolgreichen SSH-Handshake meldet Forgejo, auf dem Codeberg läuft:

... successfully authenticated ... but Forgejo does not provide shell access.

Das ist kein Fehler. Der Server verweigert eine Shell, nimmt fetch und push aber an. Siehst du die Meldung, hat die Anmeldung geklappt.

Zum Mitnehmen

  • Ein Schlüssel, ein Zweck: Den Schlüssel des Spiegels zu widerrufen trifft nie etwas anderes.
  • Ausdrückliche Refspecs statt --mirror halten das Ziel sauber.

Beruht auf

  • Mirroring GitHub to Codeberg Without a Third-Party Action (raw/2026/2026-03-05/mirroring-github-to-codeberg-without-a-third-party-action.md) [post]

Mehr dazu

Thema

  • Self-Hosting Dienste auf einem Server betreiben, über den du selbst verfügst, statt die gehostete Fassung eines Anbieters zu nutzen.

Siehe auch

  • GitHub-Deploy-Key auf einem VPS Ein Deploy-Key mit reinem Lesezugriff, damit ein VPS ohne Personal Access Token und ohne Passwort von GitHub pullen kann.

In der Graph-Ansicht zeigen