LinkBreeze selbst hosten: Alternative zu Linktree
Betreiben Sie LinkBreeze per Docker Compose und Caddy auf einem VPS. Mit festen Image-Tags, cookielosem Klick-Tracking und einem Volume für die gesamte Site.
Was LinkBreeze ist
LinkBreeze ist eine selbst gehostete Linktree-Alternative: ein Docker-Container, der eine öffentliche Link-in-Bio-Seite und ein Admin-Dashboard bereitstellt und dessen Datenbank in einer einzelnen SQLite-Datei liegt. Das Projekt ist unter der MIT-Lizenz veröffentlicht, in TypeScript auf Next.js geschrieben und als Container-Image auf Docker Hub unter omnirise/linkbreeze sowie auf GHCR unter ghcr.io/omnirise/linkbreeze veröffentlicht; ältere Releases verwendeten ghcr.io/manak-hash/linkbreeze. Für den Betrieb benötigen Sie einen VPS, eine Domain mit einem auf diesen VPS zeigenden A-Record, geöffnete Ports 80 und 443 sowie Docker Engine mit dem Compose-Plugin.
Diese Anleitung behandelt die vom Repository tatsächlich unterstützte Bereitstellung: Docker Compose hinter einem Reverse Proxy, der seine Zertifikate selbst abruft. Sie behandelt außerdem typische Fehler, weil ein Link in einer Bio eine öffentliche URL ist, die andere Personen anklicken, und ein defekter Link diesen Klick kostet.
Bevor Sie damit beginnen, sollten Sie sich darüber im Klaren sein, wie neu dieses Projekt ist.
Ist LinkBreeze ausgereift genug für einen öffentlichen Profil-Link?
Die erste getaggte Version, v1.0.0, ist auf den 1. Juli 2026 datiert. Das Projekt ist erst einige Monate alt, nicht einige Jahre.
Im Changelog werden Probleme mit der Sichtbarkeit des GitHub-Kontos erwähnt. Am 2. November 2026 ist das maßgebliche GitHub-Repository unter github.com/OmniRise/LinkBreeze öffentlich, ebenso wie der offizielle GitLab-Mirror des Projekts unter gitlab.com/omnirise00/linkbreeze; das Image liegt auf Docker Hub.
Die Daten hinter diesem Diagramm
[
{
"week": "2026-06-29",
"releases": 3,
"cumulative": 3
},
{
"week": "2026-07-06",
"releases": 3,
"cumulative": 6
},
{
"week": "2026-07-13",
"releases": 1,
"cumulative": 7
},
{
"week": "2026-07-20",
"releases": 2,
"cumulative": 9
},
{
"week": "2026-07-27",
"releases": 3,
"cumulative": 12
},
{
"week": "2026-08-03",
"releases": 2,
"cumulative": 14
},
{
"week": "2026-08-10",
"releases": 4,
"cumulative": 18
},
{
"week": "2026-08-17",
"releases": 1,
"cumulative": 19
},
{
"week": "2026-08-24",
"releases": 1,
"cumulative": 20
},
{
"week": "2026-08-31",
"releases": 0,
"cumulative": 20
},
{
"week": "2026-09-07",
"releases": 0,
"cumulative": 20
},
{
"week": "2026-09-14",
"releases": 1,
"cumulative": 21
},
{
"week": "2026-09-21",
"releases": 1,
"cumulative": 22
}
]Seit v1.0.0 hat das Projekt 22 getaggte Versionen über 13 Kalenderwochen hinweg veröffentlicht, bis v1.4.1 am 23. September 2026. Das Diagramm endet bei v1.4.1; v1.5.0 folgte am 24. Oktober und v1.5.1 am 27. Oktober 2026.
Betrachten Sie das als zwei getrennte Fakten. Der Maintainer ist aktiv, und Fehler werden innerhalb weniger Tage behoben. Das Schema und die Standardwerte ändern sich jedoch ebenfalls noch regelmäßig. Eine Instanz, die Sie bereitstellen und anschließend nicht mehr beachten, wird sich daher stark vom aktuellen Entwicklungsstand entfernen.
Die Lizenz schützt Sie vor dem schlimmsten Fall. MIT, ein Container-Image und eine SQLite-Datei auf Ihrer eigenen Festplatte bedeuten, dass Ihre Installation weiterläuft, wenn die Entwicklung eingestellt wird. Sie schützt Sie jedoch nicht vor einer öffentlich erreichbaren Webanwendung, für die keine Sicherheitskorrekturen mehr veröffentlicht werden. Eine solche Anwendung wird mit der Zeit zu einem Haftungsrisiko. Betreiben Sie sie daher nur, wenn Sie sie regelmäßig aktualisieren, und stellen Sie sicher, dass die folgende Backup-Routine ab dem ersten Tag funktioniert.
Das Image-Tag festlegen und nicht latest verwenden
Der aktuelle Release-Workflow pusht pro Version zwei Tags zu Docker Hub und GHCR: latest sowie den Git-Tag exakt in der Form, in der er gepusht wurde, einschließlich des führenden v. Das festgelegte Tag für Release v1.4.1 lautet daher docker.io/omnirise/linkbreeze:v1.4.1. Releases vor v1.4.0 wurden anders getaggt: Der Workflow entfernte v, und diese Releases existieren nur auf GHCR als reine Zahlen wie ghcr.io/manak-hash/linkbreeze:1.2.7. Wenn Sie für ein Release ein Tag in der falschen Form angeben, meldet Docker manifest unknown, weil dieses Tag nie gepusht wurde. Docker Hub enthält ebenfalls v1.5.1. Dieses Tag gibt das offizielle Unraid-Paket des Projekts vor und wird in der README inzwischen als Standardpfad für pull verwendet.
Legen Sie das Tag fest, weil sich latest ändert. Bei der im Diagramm oben gezeigten Frequenz ist ein docker compose pull gegen latest ein nicht überprüftes Upgrade einer Seite, die Ihr Publikum verwendet. Mit einem festgelegten Tag erfolgt ein Upgrade erst, wenn Sie die Datei bearbeiten.
Noch ein Hinweis zum Image: Seit v1.4.0 ist es eine Multi-Arch-Manifest-Liste für linux/amd64 und linux/arm64. Beide Images werden auf einem nativen Runner erstellt. Wenn Sie einen ARM-VPS statt x86 verwenden, lädt dasselbe Tag den arm64-Build. Auf dem Server muss nichts kompiliert werden. Releases bis einschließlich v1.3.2 wurden nur für linux/amd64 veröffentlicht. 32-Bit-arm/v7-Boards werden absichtlich nicht unterstützt. Ein älteres festgelegtes Tag oder ein 32-Bit-Board führt daher weiterhin zu einem no matching manifest-Fehler.
LinkBreeze mit Caddy und automatischem TLS bereitstellen
Caddy fordert Zertifikate bei Let's Encrypt selbstständig an und erneuert sie. Daher ist für TLS (Transport Layer Security) kein separater Zertifikatsschritt erforderlich. Die gesamte Bereitstellung besteht aus drei Dateien in einem Verzeichnis.
Generieren Sie zuerst das Secret:
mkdir -p ~/linkbreeze && cd ~/linkbreeze
printf 'SECRET_KEY=%s\n' "$(openssl rand -hex 32)" > .env
chmod 600 .envSECRET_KEY signiert das Admin-Session-Cookie und salzt den Hash der Analytics-Besucher. Seit v1.4.0 leitet es außerdem den Schlüssel ab, der gespeicherte Zwei-Faktor-Geheimnisse (TOTP) verschlüsselt. Die mit v1.4.1 veröffentlichte Compose-Datei setzt den Standardwert auf ${SECRET_KEY:-changeme-in-production}. Eine Instanz, die diese Datei ohne eigenes Secret verwendet, läuft daher mit einem Session-Signaturschlüssel, der im öffentlichen Repository des Projekts angezeigt wird. Setzen Sie das Secret vor dem ersten Start. Wenn Sie es später ändern, werden Sie abgemeldet und der Analytics-Salt wird zurückgesetzt.
Schreiben Sie docker-compose.yml:
services:
linkbreeze:
image: docker.io/omnirise/linkbreeze:v1.4.1
restart: unless-stopped
volumes:
- linkbreeze-data:/app/data
environment:
- DATABASE_PATH=/app/data/linkbreeze.db
- SECRET_KEY=${SECRET_KEY}
- BASE_URL=https://links.example.com
networks:
- linkbreeze-net
caddy:
image: caddy:2-alpine
restart: unless-stopped
ports:
- "80:80"
- "443:443"
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile:ro
- caddy-data:/data
- caddy-config:/config
networks:
- linkbreeze-net
networks:
linkbreeze-net:
volumes:
linkbreeze-data:
caddy-data:
caddy-config:BASE_URL ist optional, aber empfehlenswert. Damit teilen Sie der Anwendung ihre tatsächlich öffentlich erreichbare Adresse mit. Ein Request mit einem gefälschten Host-Header kann die Anwendung dann nicht dazu bringen, Links für die Domain eines anderen Betreibers zu generieren.
Schreiben Sie daneben Caddyfile mit Ihrer eigenen Domain:
links.example.com {
encode zstd gzip
reverse_proxy linkbreeze:3000
}Caddy setzt bei weitergeleiteten Requests standardmäßig X-Forwarded-For und X-Forwarded-Proto. Diese Werte liefern die Client-Adresse für Analytics und das Transportprotokoll für die Sicherheit der Session-Cookies. Starten Sie die Umgebung:
docker compose up -d
docker compose ps
docker compose logs -f caddydocker compose ps sollte den LinkBreeze-Container als healthy anzeigen. Das Image enthält bereits einen eigenen Healthcheck, wget --spider -q http://127.0.0.1:3000/api/health. Sie müssen daher keinen weiteren hinzufügen. Übernehmen Sie den Healthcheck aus dem Caddy-Beispiel des Repositorys nicht unverändert. Er ruft curl auf. Das Image basiert auf node:22-alpine, das busybox wget, aber kein curl enthält. Der Container meldet deshalb unhealthy, obwohl er Seiten problemlos ausliefert.
Öffnen Sie https://links.example.com in einem Browser. Beim ersten Aufruf gelangen Sie unter /setup zum Einrichtungsassistenten. Dieser erstellt das einzige Administratorkonto. Danach erreichen Sie das Dashboard unter /dashboard und das Anmeldeformular unter /login. In der festgelegten Version v1.4.1 ist dieses Konto auf diese Instanz beschränkt. Es gibt keine Schnittstelle für Single Sign-on. Wenn das Dashboard durch dieselbe Anmeldung wie alle anderen von Ihnen betriebenen Dienste geschützt werden soll, muss dies daher ein Forward-Auth-Proxy davor übernehmen, beispielsweise ein selbst gehostetes Authentik. Native OIDC-Anmeldung per Single Sign-on ist am 2. November 2026 unter Unreleased aufgeführt.
Beachten Sie, was die Compose-Datei nicht tut: Sie veröffentlicht Port 3000 niemals. Nur Caddy lauscht auf der öffentlichen Schnittstelle. Wenn die Syntax von Compose-Dateien für Sie neu ist, erklärt Docker-Compose-Grundlagen für einen VPS die vorausgesetzten Bestandteile dieser Datei. Wenn bereits ein anderer Dienst vorgeschaltet ist, erläutert Nginx, Caddy und Traefik im Vergleich, welche Änderungen erforderlich sind. Das Repository enthält funktionierende Beispiele für Nginx mit Certbot, Traefik und einen Cloudflare-Tunnel.
Wo Ihre Daten liegen und was ein Backup enthalten muss
DATABASE_PATH verweist auf /app/data/linkbreeze.db. Hochgeladene Avatare und Link-Vorschaubilder werden daneben in /app/data/uploads gespeichert. Beide befinden sich im benannten Volume linkbreeze-data, daher ist das Volume die Einheit für das Backup, nicht die Datenbankdatei allein. Stellen Sie die Datei ohne das Upload-Verzeichnis wieder her, liefert jedes Bild auf der Seite einen 404-Fehler.
Alles andere befindet sich tatsächlich in dieser einen Datenbank: Seiten, Links, Einstellungen, Themes, E-Mail-Abonnenten und Analytics-Datensätze.
Erstellen Sie die Kopie bei gestopptem Container:
docker compose stop linkbreeze
docker compose cp linkbreeze:/app/data ./backup-$(date +%F)
docker compose start linkbreezeStoppen Sie den Container zuerst, da das Kopieren einer SQLite-Datenbank während eines Schreibvorgangs eine halbfertige Transaktion erfassen kann; die Kopie wäre dann eine beschädigte Datei. Die Seite ist während des Kopiervorgangs offline. Die Wiederherstellung erfolgt durch den umgekehrten Vorgang:
docker compose stop linkbreeze
docker compose cp ./backup-2026-08-14/. linkbreeze:/app/data
docker compose start linkbreeze
docker compose logs -f linkbreezeDas Dashboard bietet zudem einen JSON-Export an, der unter /api/backup als linkbreeze-backup-YYYY-MM-DD.json bereitgestellt wird. Er enthält das Profil, die Links und deren Abschnitte, die Einstellungen, die gespeicherten Themes und die Einträge für benutzerdefinierte Schriftarten. Er enthält keine Analytics-Historie, keine E-Mail-Abonnenten, kein Administratorkonto und keine hochgeladenen Dateien. Bei der Wiederherstellung werden die aktuellen Zeilen in den sechs betroffenen Tabellen gelöscht, bevor die Daten aus der Datei eingefügt werden. Betrachten Sie dies als Konfigurations-Snapshot für den Umzug auf einen anderen Host oder zum Rückgängigmachen eines Bearbeitungsfehlers. Die Kopie des Volumes ist das eigentliche Backup.
Hier gelten dieselben zwei Speicherregeln wie überall sonst, wenn Sie SQLite produktiv auf einem VPS betreiben. Belassen Sie die Datenbank auf einem lokalen Datenträger, da das Locking von SQLite auf Netzwerkdateisystemen unzuverlässig ist und Sie dies erst durch eine beschädigte Seite bemerken würden. Wenn Sie das benannte Volume durch einen Host-Bind-Mount ersetzen, führen Sie zuerst ein chown auf das Host-Verzeichnis aus: Der Container läuft als Nicht-Root-Benutzer node mit der UID 1000 in node:22-alpine. Ein von root erstelltes Verzeichnis ist für diesen Benutzer nicht beschreibbar, wodurch die Anwendung die Datenbank nicht öffnen kann und der Container beim Start beendet wird. Bind-Mounts gegenüber benannten Volumes in Compose erläutert diesen Kompromiss ausführlich.
Die Analytics und das Consent-Banner, die Sie nicht benötigen
Das ist das Feature, das das Self-Hosting einer Seite rechtfertigt, die Sie andernorts kostenlos erhalten könnten.
Die Analytics arbeiten ohne Cookies. Die integrierten Analytics setzen kein Besucher-Cookie und laden kein Tracking-Skript eines Drittanbieters. Externe Analytics und Embeds sind optionale Features. Ein Besucher wird anhand eines SHA-256-Hashs aus der IP-Adresse, der User-Agent-Zeichenfolge und einem Salt identifiziert. Der Hash wird auf 16 hexadezimale Zeichen gekürzt. Das Salt selbst ist ein Hash aus dem aktuellen UTC-Datum und Ihrem SECRET_KEY. Es ändert sich um Mitternacht UTC. Hashes des Vortags können dann nicht mehr mit den Hashes des aktuellen Tages abgeglichen werden. Die ursprüngliche IP-Adresse wird nie in die Datenbank geschrieben.
Klicks werden auf dem Server gezählt. Jeder http-Link auf der öffentlichen Seite verweist auf /go/<id> in Ihrer eigenen Domain. Dort wird der Klick erfasst. Anschließend antwortet der Server mit einer 302-Weiterleitung auf das eigentliche Ziel. Die Zählung funktioniert daher auch bei Lesern mit deaktiviertem JavaScript und in In-App-Browsern, die Hintergrundanfragen blockieren. Seitenaufrufe werden serverseitig erfasst, sobald die öffentliche Seite gerendert wird. /api/track verarbeitet Klick- und Popup-Öffnungsereignisse.
Zwei Ausschlüsse sollten Sie kennen. Eine Anfrage mit einer gültigen Admin-Session wird übersprungen. Dadurch erhöhen Sie die Zahlen beim Bearbeiten Ihrer eigenen Seite nicht. Bekannte Crawler-User-Agents werden ebenfalls übersprungen.
Zu Einwilligungen: Die integrierten Analytics verwenden kein Tracking-Cookie. Die Cookie-Regeln gelten jedoch auch für ähnliche Technologien, einschließlich Device Fingerprinting. Tracking ohne Cookies allein beweist daher nicht, dass kein Consent-Banner erforderlich ist. Ihre Pflichten hängen weiterhin davon ab, wo Ihre Leser leben. Prüfen Sie diese Pflichten ebenso wie alle externen Analytics oder Embeds, die Sie aktivieren.
Ein Hinweis, der viele überrascht: Wenn Sie SECRET_KEY rotieren, ändert sich auch das tägliche Salt. Ab diesem Zeitpunkt wird daher jeder wiederkehrende Besucher als neu gezählt.
Warum ist die Länderspalte in den Analytics leer?
In Ihrem Stack setzt nichts einen Länder-Header. LinkBreeze ermittelt das Land aus Proxy-Headern wie cf-ipcountry und x-vercel-ip-country. Wenn ein VPS hinter Ihrem eigenen Caddy oder Nginx läuft, sind diese Header nicht vorhanden. Deshalb wird das Land als null gespeichert, und die Aufschlüsselung bleibt leer. Im Container ist keine GeoIP-Datenbank enthalten.
Dafür gibt es zwei Möglichkeiten. Schalten Sie Cloudflare vor die Domain und aktivieren Sie in Managed Transform die Option Add visitor location headers, damit cf-ipcountry bereitgestellt wird. Oder setzen Sie einen dieser Header in Ihrem eigenen Reverse Proxy anhand einer lokalen GeoIP-Abfrage.
Die damit verbundene Falle ist schwerwiegender. Prüfen Sie sie daher ebenfalls. Die Click- und View-Handler lesen die Client-Adresse zuerst aus X-Forwarded-For, dann aus X-Real-IP und verwenden 0.0.0.0 als Fallback, wenn keiner der beiden Header vorhanden ist. Wenn Sie Port 3000 ohne einen dieser Adress-Header direkt im Internet veröffentlichen, teilen sich Besucher mit demselben User-Agent innerhalb jedes UTC-Tages einen Hash. Unterschiedliche User-Agents erzeugen weiterhin unterschiedliche Hashes. Der Hash wird täglich neu erzeugt. Die auf 60 Ereignisse pro Minute begrenzten Ratenlimits pro IP für /api/track und /go/<id> gelten dann jeweils für Ihre gesamte Zielgruppe unter der Fallback-Adresse. Hinter der oben genannten reverse_proxy-Direktive setzt Caddy den Header für Sie. Damit verschwinden beide Probleme.
Import aus Linktree und was nicht übernommen wird
Der Migrationsassistent im Dashboard akzeptiert eine öffentliche Profil-URL oder eine exportierte Datei. Er erkennt linktr.ee-, bento.me-, lnk.bio-, tap.link-, hopp.bio-, beacons.ai-, solo.to-, linkfly-, mssg.me- und LittleLink-Seiten sowie generische HTML- und JSON-Exporte. Bei einer Linktree- oder Bento-URL liest er das eingebettete __NEXT_DATA__ JSON dieser Seiten. Bei einer statischen Seite liest er die Anchor-Tags.
Übernommen werden der Titel, die URL, die Beschreibung und das Bild jedes Links, außerdem, ob der Link auf ein Social-Media-Profil verweist, sowie Ihr Anzeigename, Ihre Biografie und Ihr Avatar. Sie wählen aus, welche der gefundenen Links beibehalten werden, bevor etwas in die Datenbank geschrieben wird.
Nicht übernommen werden der Verlauf der Analytics-Daten, Theme und Layout, E-Mail-Abonnenten, geplante Veröffentlichungszeitpunkte und alle Inhalte, die die alte Plattform nur nach einer Anmeldung bereitstellt. Planen Sie ein, das Erscheinungsbild manuell neu aufzubauen. Akzeptieren Sie außerdem, dass der alte Klickverlauf beim alten Dienst bleibt.
Der Importer ruft die URL von Ihrem Server und nicht von Ihrem Browser ab. Deshalb weist er Adressen zurück, die nicht öffentlich erreichbar sind. Private/local URLs are not allowed bedeutet, dass Sie eine Adresse innerhalb Ihres eigenen Netzwerks angegeben haben. Die Zurückweisung ist beabsichtigt: Ohne diese Prüfung könnte jeder Benutzer mit Dashboard-Zugriff Ihren Server verwenden, um Maschinen zu prüfen, die nur Ihr Server erreichen kann. Die anderen Meldungen, die möglicherweise angezeigt werden, sind Only http and https URLs are allowed, Request timed out und Response too large.
Das Scraping hängt vom Markup einer anderen Anwendung ab. In v1.5.1 behebt der Importer einen Linktree-Fehler, durch den die Affiliate-Links der Plattform statt der Links des Profils abgerufen wurden. Aktualisieren Sie vor dem Import aus Linktree. Profile, deren Links nur im Browser gerendert werden, erfordern weiterhin den Tab File oder eine manuelle Eingabe. Wenn der Assistent auf einer Seite mit offensichtlich vorhandenen Links nichts findet, fügen Sie die Links manuell hinzu, statt auf eine Fehlerbehebung zu warten. Wenn Sie tatsächlich messbare Kurz-URLs statt einer Profilseite benötigen, erledigt ein selbst gehosteter URL-Shortener wie Shlink diese Aufgabe und läuft problemlos auf demselben Server.
Aktualisieren einer angepinnten Bereitstellung
# edit the image tag in docker-compose.yml, then
docker compose pull
docker compose up -d
docker compose logs -f linkbreezeDatenbankschema-Migrationen werden automatisch beim Start des Containers ausgeführt. Es gibt keine dokumentierte Möglichkeit, sie rückgängig zu machen. Erstellen Sie daher zuerst eine Kopie des Volumes. Ein Upgrade, das Sie nicht rückgängig machen können, ist nur dann sicher, wenn Sie den vorherigen Zustand wiederherstellen können.
Das Dashboard soll ein Banner anzeigen, wenn eine neuere Version verfügbar ist. Die angepinnte Version v1.4.1 prüft eine kleine Versionsdatei auf GitHub. Seit v1.5.0, veröffentlicht am 24. October 2026, ruft die Prüfung des Banners linkbreeze.omnirise.dev/latest-version.json ab. Die Ergebnisse werden 24 Stunden lang zwischengespeichert. Die Schaltfläche Check now umgeht diesen Cache jedoch, auch in v1.4.1. Diese Prüfungen senden keine Instanzdaten im Request-Payload. Laut Changelog fragte v1.2.0 bis v1.4.0 eine Adresse ab, die mit 404 antwortete, und zeigte das Banner nie an. Solange Sie keine Version mit dem Website-Endpunkt ausführen, sollten Sie nicht auf das Banner warten. Überwachen Sie den Changelog unter linkbreeze.omnirise.dev/changelog selbst. In v1.5.1 enthält Settings außerdem eine Update-Statuskarte, die GitHub und die Website prüft. Die Schaltfläche Recheck umgeht den Cache. Lesen Sie die Release Notes, bevor Sie den Tag ändern. In dieser Projektphase kann eine Minor-Version Standardwerte ändern, von denen Ihre Konfiguration abhängt.
Fehlerbilder und die angezeigten Zeichenfolgen
manifest unknown beim Abrufen. Das Tag hat für diese Version die falsche Form. Ab v1.4.0 enthalten Tags das v. Verwenden Sie daher :v1.4.1. GHCR-Releases bis v1.3.2 verwenden einfache Versionsnummern wie :1.2.7. Auch Docker Hub enthält neuere Versionstags wie v1.5.1.
no matching manifest for linux/arm64/v8 in the manifest list entries. Sie haben eine Version vor v1.4.0 festgelegt, die nur für amd64 veröffentlicht wurde. Ändern Sie die Festlegung auf v1.4.1. Diese Version enthält einen arm64-Build. Ein arm/v7-Board mit 32 Bit erzeugt bei jeder Version denselben Fehler, weil diese Plattform absichtlich nicht gebaut wird.
Der Container meldet unhealthy, während die Seite problemlos geladen wird. Ein Healthcheck in Ihrer Compose-Datei ruft curl auf. Dieses Programm ist im Image nicht enthalten. Entfernen Sie den Healthcheck und lassen Sie den containerinternen wget-Healthcheck ausführen.
Caddy liefert einen Zertifikatsfehler oder überhaupt keine Antwort. Prüfen Sie docker compose logs caddy. Stellen Sie sicher, dass der A-Record auf diesen VPS zeigt und die Ports 80 und 443 erreichbar sind. Caddy kann die Validierung über eine HTTP-Challenge auf Port 80 oder eine TLS-ALPN-Challenge auf Port 443 durchführen.
Die Zahl der eindeutigen Besucher bleibt bei 1. Prüfen Sie, ob der Proxy X-Forwarded-For oder X-Real-IP setzt. Ohne einen dieser Header verwenden Besucher mit identischen User-Agents innerhalb jedes UTC-Tages denselben Hash. Der Hash enthält außerdem ein tägliches Salt. Fehlende Header führen daher nicht dazu, dass alle Besucher dauerhaft denselben Hash erhalten.
Der Container wird direkt nach dem Start beendet, obwohl er gestern noch funktioniert hat. Wenn Sie von einem benannten Volume auf einen Host-Bind-Mount gewechselt haben, gehört das Datenverzeichnis root. Die Anwendung läuft jedoch mit der uid 1000 und kann deshalb die Datenbankdatei nicht öffnen. sudo chown -R 1000:1000 Sie das Verzeichnis auf dem Host.
Tracking-Anfragen werden mit HTTP 429 beantwortet. Das Limit pro IP auf /api/track wurde erreicht. Das separate Limit auf /go/<id> überspringt die Aufzeichnung des Klicks, gibt aber weiterhin die 302-Weiterleitung zum Ziel zurück.
FAQ
Ist LinkBreeze für einen öffentlichen Link-in-Bio-Einsatz bereit?
Das Projekt ist noch jung. Die erste Veröffentlichung datiert vom 1 July 2026. Bis zu v1.4.1 am 23 September 2026 wurden 22 getaggte Releases veröffentlicht, die meisten davon vor Mitte August. Das Verhalten hat sich daher schnell geändert. Die Releases v1.5.0 und v1.5.1 folgten am 24 und 27 October 2026. Das kanonische GitHub-Repository ist seit dem 2 November 2026 öffentlich. Die MIT-Lizenz und die lokale SQLite-Datei stellen sicher, dass Ihre Seite auch bei einem Entwicklungsstopp weiter funktioniert. Eine öffentliche Webanwendung ohne Sicherheitsupdates wird jedoch zum Haftungsrisiko. Betrachten Sie LinkBreeze daher als Software, die Sie regelmäßig aktualisieren müssen, und nicht als Anwendung, die Sie einmal installieren.
Welchen LinkBreeze-Image-Tag sollte ich verwenden?
Verwenden Sie den Versions-Tag, zum Beispiel docker.io/omnirise/linkbreeze:v1.4.1, und ändern Sie ihn bewusst. Seit v1.4.0 veröffentlicht der Release-Workflow latest und den Git-Tag mit dem vorangestellten v. Daher existiert :1.4.1 ohne v nicht, und Docker antwortet mit manifest unknown. Bei Releases bis einschließlich v1.3.2 ist es umgekehrt: Auf GHCR gibt es dort nur die Versionen ohne Präfix. Das Image wird seit v1.4.0 für linux/amd64 und linux/arm64 erstellt. Ein arm64-VPS kann es daher direkt ohne lokalen Build herunterladen.
Warum bleibt die Länderaufschlüsselung in der LinkBreeze-Analyse leer?
LinkBreeze liest das Besucherland aus Proxy-Headern wie cf-ipcountry oder x-vercel-ip-country. Eine eigene GeoIP-Datenbank enthält die Anwendung nicht. Ein VPS hinter Ihrem eigenen Caddy oder Nginx setzt keinen dieser Header. Daher wird das Land als null gespeichert. Schalten Sie Cloudflare vor die Domain und aktivieren Sie dort die Managed Transform Add visitor location headers. Alternativ kann Ihr Reverse Proxy einen dieser Header anhand einer lokalen GeoIP-Abfrage setzen.
Was muss ich genau sichern, und wie stelle ich die Daten wieder her?
Sichern Sie das gesamte linkbreeze-data-Volume und nicht nur die Datenbankdatei. /app/data/linkbreeze.db enthält alle Links, Seiten, Einstellungen, Abonnenten und Analysezeilen. /app/data/uploads enthält die Avatar- und Vorschaubilder, auf die die Seite verweist. Stoppen Sie den Container, führen Sie docker compose cp linkbreeze:/app/data ./backup-$(date +%F) aus und starten Sie ihn anschließend wieder. Kopieren Sie zur Wiederherstellung das Verzeichnis zurück in den gestoppten Container und starten Sie ihn. Der JSON-Export aus dem Dashboard ist ein Konfigurationssnapshot von Profil, Links, Einstellungen, Themes und Schrifteinträgen. Er enthält keine Analysedaten und keine Bilder.
Werden meine Analysedaten und mein Theme beim Import von Linktree übernommen?
Nein. Der Migrationsassistent liest die Linktitel, URLs, Beschreibungen und Bilder aus Ihrem alten öffentlichen Profil sowie Ihren Anzeigenamen, Ihre Biografie und Ihren Avatar. Der Analyseverlauf, das Theme, E-Mail-Abonnenten und geplante Veröffentlichungszeitpunkte werden nicht übernommen. Stellen Sie das Erscheinungsbild nach dem Import im Theme-Editor wieder her. Der Klickverlauf bleibt auf der alten Plattform.