SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor

Jak wdrożyć LinkBreeze na własnym serwerze VPS

Instrukcja konfiguracji LinkBreeze przy użyciu Docker Compose i Caddy. Dowiedz się jak skonfigurować cookieless tracking, przypiąć tagi obrazów i zabezpieczyć dane w SQLite.

Czym jest LinkBreeze

LinkBreeze to samodzielnie hostowana alternatywa dla Linktree: pojedynczy kontener Docker, który udostępnia publiczną stronę typu link-in-bio oraz panel administracyjny, przechowujący dane w jednym pliku SQLite. Projekt jest udostępniony na licencji MIT, napisany w TypeScript z wykorzystaniem Next.js i opublikowany jako obraz kontenera w serwisie Docker Hub pod nazwą omnirise/linkbreeze oraz w GHCR jako ghcr.io/omnirise/linkbreeze; starsze wydania korzystały z ghcr.io/manak-hash/linkbreeze. Do uruchomienia wymagany jest VPS, domena z rekordem A wskazującym na ten serwer, otwarte porty 80 i 443 oraz Docker Engine z wtyczką Compose.

Niniejszy przewodnik opisuje wdrożenie wspierane przez repozytorium: Docker Compose za reverse proxy, które samodzielnie pobiera certyfikaty. Omówiono również przyczyny awarii, ponieważ strona typu link-in-bio to publiczny adres URL, a niedziałający link oznacza utratę kliknięcia.

Zanim przejdziesz dalej, miej na uwadze, jak wczesnym projektem jest to oprogramowanie.

Czy LinkBreeze jest wystarczająco dojrzały do obsługi publicznego profilu z linkami?

Pierwsze oznaczone wydanie, v1.0.0, datowane jest na 1 lipca 2026. Jest to projekt mający kilka miesięcy, a nie lat.

Dziennik zmian wspomina o problemach z widocznością konta GitHub. Na dzień 2 listopada 2026 kanoniczne repozytorium GitHub pod adresem github.com/OmniRise/LinkBreeze jest publiczne, podobnie jak oficjalne lustro projektu w serwisie GitLab, gitlab.com/omnirise00/linkbreeze, wraz z obrazem w serwisie Docker Hub.

WykresLinkBreeze tagged releases per week, v1.0.0 to v1.4.1
Dane, na których opiera się ten wykres
[
  {
    "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
  }
]

Od wersji v1.0.0 projekt doczekał się 22 oznaczonych wydań w ciągu 13 tygodni kalendarzowych, aż do wersji v1.4.1 z dnia 23 września 2026. Wykres kończy się na wersji v1.4.1; wersja v1.5.0 pojawiła się 24 października, a v1.5.1 dnia 27 października 2026.

Należy to odczytywać jako dwa oddzielne fakty. Utrzymujący projekt jest aktywny, a błędy są usuwane w ciągu kilku dni. Schemat bazy danych oraz wartości domyślne wciąż ulegają zmianom, więc instancja wdrożona i pozostawiona bez opieki znacząco odbiegnie od aktualnie rozwijanego kodu.

Licencja chroni przed najgorszym scenariuszem. Licencja MIT w połączeniu z obrazem kontenera oraz plikiem SQLite na własnym dysku oznacza, że w przypadku zaprzestania prac rozwojowych, posiadane rozwiązanie będzie nadal działać. Nie chroni to jednak przed sytuacją, w której publicznie dostępna aplikacja przestaje otrzymywać poprawki bezpieczeństwa, co z czasem staje się obciążeniem. Należy wdrażać to rozwiązanie z założeniem regularnych aktualizacji oraz utrzymywać poniższą procedurę tworzenia kopii zapasowych od pierwszego dnia.

Przypnij tag obrazu i nie używaj latest

Obecny proces wydawniczy wypycha dwa tagi na wersję do Docker Hub oraz GHCR: latest oraz tag git dokładnie w takiej formie, w jakiej został wypchnięty, co skutkuje uwzględnieniem v. Przypiętym tagiem dla wydania v1.4.1 jest zatem docker.io/omnirise/linkbreeze:v1.4.1. Wydania sprzed v1.4.0 były tagowane inaczej: proces usuwał v, a te wersje istnieją tylko w GHCR jako same liczby, takie jak ghcr.io/manak-hash/linkbreeze:1.2.7. Wpisanie tagu w nieprawidłowej formie dla danego wydania spowoduje, że Docker zgłosi manifest unknown, ponieważ taki tag nigdy nie został wypchnięty. Docker Hub, który w pliku README jest obecnie domyślną ścieżką pobierania, zawiera również v1.5.1, czyli tag określony przez oficjalną paczkę Unraid dla tego projektu.

Przypnij tag, ponieważ latest ulega zmianie. Przy częstotliwości aktualizacji przedstawionej w powyższym wykresie, docker compose pull względem latest stanowi niezweryfikowaną aktualizację strony, z której korzystają użytkownicy. Dzięki przypiętemu tagowi aktualizacja następuje dopiero w momencie edycji pliku.

Jeszcze jedna uwaga dotycząca obrazu. Od wersji v1.4.0 jest to manifest wieloarchitektoniczny dla linux/amd64 oraz linux/arm64, z których każdy jest budowany na natywnym runnerze. Jeśli uruchamiasz VPS z architekturą ARM zamiast x86, ten sam tag pobierze kompilację arm64 i nic nie musi być kompilowane na serwerze. Wydania do wersji v1.3.2 były publikowane wyłącznie dla linux/amd64, a 32-bitowe płyty arm/v7 zostały celowo pominięte, więc starsze przypięcie lub 32-bitowa płyta nadal kończą się błędem no matching manifest.

Wdrożenie LinkBreeze za Caddy z automatycznym TLS

Caddy samodzielnie żąda i odnawia certyfikaty z Let's Encrypt, więc TLS (transport layer security) nie wymaga osobnej konfiguracji certyfikatów. Całe wdrożenie składa się z trzech plików w jednym katalogu.

Najpierw wygeneruj sekret:

mkdir -p ~/linkbreeze && cd ~/linkbreeze
printf 'SECRET_KEY=%s\n' "$(openssl rand -hex 32)" > .env
chmod 600 .env

SECRET_KEY podpisuje ciasteczko sesji administratora i soluje hash odwiedzających w analityce, a od wersji v1.4.0 wyprowadza również klucz szyfrujący przechowywane sekrety dwuskładnikowe (TOTP). Plik compose opublikowany wraz z v1.4.1 domyślnie ustawia go na ${SECRET_KEY:-changeme-in-production}, więc instancja używająca tego pliku bez ustawienia sekretu działa z kluczem podpisywania sesji, który jest jawny w publicznym repozytorium projektu. Ustaw go przed pierwszym uruchomieniem, ponieważ późniejsza zmiana wyloguje użytkownika i zresetuje sól analityki.

Utwórz 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 jest opcjonalne, ale warto je ustawić: informuje aplikację o jej rzeczywistym publicznym adresie, dzięki czemu żądanie przychodzące z sfałszowanym nagłówkiem Host nie spowoduje wygenerowania przez aplikację linków do cudzej domeny.

Obok utwórz Caddyfile, wpisując własną domenę:

links.example.com {
    encode zstd gzip
    reverse_proxy linkbreeze:3000
}

Caddy domyślnie ustawia X-Forwarded-For oraz X-Forwarded-Proto w żądaniach proxy, co dostarcza adres klienta dla analityki oraz transport dla bezpieczeństwa ciasteczek sesji. Uruchom usługę:

docker compose up -d
docker compose ps
docker compose logs -f caddy

docker compose ps powinno pokazać kontener LinkBreeze jako healthy. Obraz zawiera własny healthcheck, wget --spider -q http://127.0.0.1:3000/api/health, więc nie trzeba dodawać go samodzielnie. Nie kopiuj healthchecka z przykładu Caddy znajdującego się w repozytorium: wywołuje on curl, a obraz jest zbudowany na node:22-alpine, który zawiera busybox wget i nie posiada curl. Taki kontener zgłasza unhealthy, mimo że poprawnie serwuje strony.

Otwórz https://links.example.com w przeglądarce. Pierwsza wizyta prowadzi do kreatora konfiguracji pod adresem /setup, który tworzy pojedyncze konto administratora. Następnie pulpit nawigacyjny znajduje się pod /dashboard, a formularz logowania pod /login. W przypiętym wydaniu v1.4.1 konto to jest lokalne dla tej instancji i nie ma mechanizmu single sign-on, więc jeśli pulpit ma być chroniony tym samym logowaniem co inne hostowane usługi, należy użyć forward auth proxy, takiego jak samodzielnie hostowany Authentik. Natywny single sign-on OIDC znajduje się na liście funkcji niewydanych na dzień 2 listopada 2026.

Zwróć uwagę, czego plik compose nie robi: nigdy nie publikuje portu 3000. Tylko Caddy nasłuchuje na interfejsie publicznym. Jeśli składnia pliku Compose jest nowością, podstawy Docker Compose dla VPS omawiają elementy, które zakłada ten plik, a jeśli przed nim działa już inne rozwiązanie, porównanie Nginx, Caddy i Traefik wyjaśnia, co należy zmienić. Repozytorium zawiera działające przykłady dla Nginx z Certbot, Traefik oraz tunelu Cloudflare.

Gdzie przechowywane są dane i co musi zawierać kopia zapasowa

DATABASE_PATH wskazuje na /app/data/linkbreeze.db. Przesłane awatary oraz miniatury linków są zapisywane obok niego w /app/data/uploads. Oba elementy znajdują się w wolumenie nazwanym linkbreeze-data, dlatego jednostką kopii zapasowej jest cały wolumen, a nie sam plik bazy danych. Przywrócenie pliku bez katalogu z przesłanymi plikami spowoduje, że każdy obraz na stronie będzie zwracał błąd 404.

Wszystkie pozostałe dane znajdują się w tej jednej bazie: strony, linki, ustawienia, motyw, subskrybenci poczty e-mail oraz wiersze analityki.

Wykonaj kopię przy zatrzymanym kontenerze:

docker compose stop linkbreeze
docker compose cp linkbreeze:/app/data ./backup-$(date +%F)
docker compose start linkbreeze

Zatrzymaj kontener przed wykonaniem kopii, ponieważ kopiowanie bazy danych SQLite w trakcie zapisu przez proces może przechwycić nieukończoną transakcję, co sprawi, że kopia będzie uszkodzonym plikiem. Strona jest niedostępna podczas wykonywania kopii. Przywracanie polega na wykonaniu tych samych czynności w odwrotnej kolejności:

docker compose stop linkbreeze
docker compose cp ./backup-2026-08-14/. linkbreeze:/app/data
docker compose start linkbreeze
docker compose logs -f linkbreeze

Panel administracyjny oferuje również eksport do formatu JSON, dostępny pod adresem /api/backup jako linkbreeze-backup-YYYY-MM-DD.json. Zawiera on profil, linki i ich sekcje, ustawienia, zapisane motywy oraz wpisy niestandardowych czcionek. Nie zawiera historii analityki, subskrybentów e-mail, konta administratora ani przesłanych plików. Przywrócenie tego pliku usuwa bieżące wiersze z sześciu tabel, które obsługuje, przed wstawieniem danych z pliku. Traktuj to jako migawkę konfiguracji służącą do przenoszenia hostów lub cofania błędów edycji. Kopia wolumenu jest właściwą kopią zapasową.

Obowiązują tu dwie zasady przechowywania, takie same jak w każdym innym przypadku uruchamiania SQLite w środowisku produkcyjnym na VPS. Przechowuj bazę danych na lokalnym dysku, ponieważ mechanizm blokowania SQLite jest zawodny w sieciowych systemach plików, a uszkodzenie strony jest sygnałem, że doszło do błędu. Jeśli zamienisz wolumen nazwany na bind mount hosta, najpierw zmień właściciela katalogu za pomocą chown: kontener działa jako użytkownik niebędący rootem node, o identyfikatorze uid 1000 w node:22-alpine. Katalog utworzony przez roota nie będzie dla niego zapisywalny, przez co aplikacja nie otworzy bazy danych, a kontener zakończy działanie przy starcie. Bind mounts a wolumeny nazwane w Compose szczegółowo omawia to zagadnienie.

Analityka i brak konieczności stosowania banera zgody

Jest to funkcja uzasadniająca samodzielne hostowanie strony, którą można uzyskać bezpłatnie w innym miejscu.

Analityka nie wykorzystuje plików cookie. Wbudowane narzędzia analityczne nie ustawiają plików cookie odwiedzających ani nie ładują skryptów śledzących stron trzecich; zewnętrzna analityka i elementy osadzone są funkcjami opcjonalnymi. Odwiedzający jest identyfikowany za pomocą skrótu SHA-256 adresu IP, ciągu user agent oraz soli, skróconego do 16 znaków szesnastkowych. Sól jest sama w sobie skrótem bieżącej daty UTC oraz Twojego SECRET_KEY, więc zmienia się o północy czasu UTC, co uniemożliwia dopasowanie wczorajszych skrótów do dzisiejszych. Surowy adres IP nigdy nie jest zapisywany w bazie danych.

Kliknięcia są zliczane po stronie serwera. Każdy link http na stronie publicznej wskazuje na /go/<id> w Twojej własnej domenie, co rejestruje kliknięcie, a następnie odpowiada przekierowaniem 302 do właściwego miejsca docelowego. Dzięki temu zliczanie działa dla czytelników z wyłączoną obsługą JavaScript oraz w przeglądarkach wewnątrz aplikacji, które blokują żądania w tle. Wyświetlenia stron są rejestrowane po stronie serwera podczas renderowania strony publicznej; /api/track obsługuje zdarzenia kliknięć oraz otwarcia wyskakujących okienek.

Warto znać dwa wykluczenia. Żądanie zawierające ważną sesję administratora jest pomijane, więc edytowanie własnej strony nie zawyża statystyk. Znane user agenty robotów indeksujących również są pomijane.

W kwestii zgody: wbudowana analityka nie używa plików cookie śledzących, jednak przepisy dotyczące plików cookie obejmują również podobne technologie, w tym fingerprinting urządzenia. Samo śledzenie bez plików cookie nie oznacza automatycznie, że baner zgody nie jest wymagany. Twoje obowiązki nadal zależą od miejsca zamieszkania czytelników, więc sprawdź je, uwzględniając również wszelkie zewnętrzne narzędzia analityczne lub osadzone elementy, które aktywujesz.

Jedno zastrzeżenie, które zaskakuje użytkowników: rotacja SECRET_KEY powoduje zmianę dziennej soli, więc od tego momentu każdy powracający odwiedzający jest liczony jako nowy.

Dlaczego kolumna kraju w analityce jest pusta?

Ponieważ żaden element stosu technologicznego nie ustawia nagłówka kraju. LinkBreeze rozpoznaje kraj na podstawie nagłówków proxy, takich jak cf-ipcountry oraz x-vercel-ip-country. Na serwerze VPS działającym za własnym Caddy lub Nginx żaden z tych nagłówków nie istnieje, więc kraj jest rejestrowany jako null, a zestawienie pozostaje puste. Wewnątrz kontenera nie ma bazy danych GeoIP.

Istnieją dwa sposoby na uzupełnienie tych danych. Umieść Cloudflare przed domeną i włącz funkcję Add visitor location headers w ramach Managed Transform, aby dostarczyć cf-ipcountry. Alternatywnie, ustaw jeden z tych nagłówków we własnym reverse proxy na podstawie lokalnego wyszukiwania GeoIP.

Powiązany problem jest poważniejszy, więc należy go sprawdzić. Procedury obsługi kliknięć i wyświetleń odczytują adres klienta najpierw z X-Forwarded-For, następnie z X-Real-IP, a w przypadku braku obu nagłówków korzystają z 0.0.0.0. Upublicznienie portu 3000 bezpośrednio w Internecie bez nagłówka adresu powoduje, że użytkownicy z tym samym user agent współdzielą hash w obrębie każdego dnia UTC; różni user agenci nadal generują różne hashe, a hash zmienia się codziennie. Limity prędkości (rate limits) wynoszące 60 zdarzeń na minutę dla /api/track oraz /go/<id> są wówczas stosowane do całej grupy odbiorców pod adresem zastępczym. Po zastosowaniu dyrektywy reverse_proxy opisanej powyżej, Caddy automatycznie ustawia nagłówek i oba problemy zostają wyeliminowane.

Import z Linktree i dane, które nie są przenoszone

Kreator migracji w panelu sterowania akceptuje publiczny adres URL profilu lub wyeksportowany plik. Rozpoznaje strony linktr.ee, bento.me, lnk.bio, tap.link, hopp.bio, beacons.ai, solo.to, linkfly, mssg.me oraz LittleLink, a także ogólne eksporty HTML i JSON. W przypadku adresów URL Linktree lub Bento odczytywany jest kod __NEXT_DATA__ JSON osadzony na tych stronach. W przypadku stron statycznych odczytywane są znaczniki kotwic.

Przenoszone są: tytuł, adres URL, opis i obraz każdego linku, informacja czy link jest profilem społecznościowym, a także nazwa wyświetlana, biogram oraz awatar. Przed zapisaniem jakichkolwiek danych w bazie użytkownik wybiera, które z odnalezionych linków mają zostać zachowane.

Nie są przenoszone: historia analityki, motyw i układ strony, subskrybenci e-mail, zaplanowane daty publikacji oraz wszelkie dane, które stara platforma przechowuje za własnym panelem logowania. Należy zaplanować ręczne odtworzenie wyglądu strony i zaakceptować fakt, że stara historia kliknięć pozostaje w poprzednim serwisie.

Importer pobiera adres URL z poziomu serwera, a nie z przeglądarki, dlatego odrzuca adresy, które nie są publiczne. Komunikat Private/local URLs are not allowed oznacza podanie adresu znajdującego się wewnątrz sieci lokalnej; odmowa jest celowa. Bez tego zabezpieczenia każda osoba z dostępem do panelu mogłaby wykorzystać serwer do skanowania maszyn dostępnych tylko dla niego. Inne komunikaty, które mogą się pojawić, to Only http and https URLs are allowed, Request timed out oraz Response too large.

Pobieranie danych (scraping) zależy od struktury znaczników zewnętrznych serwisów. W wersji v1.5.1 importer naprawia błąd Linktree, który powodował pobieranie linków afiliacyjnych platformy zamiast linków profilu. Przed importem z Linktree należy wykonać aktualizację. Profile, których linki są renderowane wyłącznie w przeglądarce, nadal wymagają użycia zakładki Plik lub ręcznego wprowadzenia danych. Jeśli kreator nie odnajdzie niczego na stronie, która ewidentnie zawiera linki, należy dodać je ręcznie zamiast oczekiwać na poprawkę. Jeśli celem są mierzalne krótkie linki, a nie strona profilowa, samodzielnie hostowany skracacz adresów URL, taki jak Shlink wykonuje to zadanie i działa bez problemów na tym samym serwerze.

Aktualizacja przypiętego wdrożenia

# edit the image tag in docker-compose.yml, then
docker compose pull
docker compose up -d
docker compose logs -f linkbreeze

Migracje schematu bazy danych uruchamiają się automatycznie podczas startu kontenera. Brak udokumentowanej metody ich cofania, dlatego najpierw należy wykonać kopię wolumenu. Aktualizacja, której nie można wycofać, jest bezpieczna tylko wtedy, gdy istnieje możliwość przywrócenia stanu sprzed operacji.

Panel sterowania wyświetla baner, gdy dostępna jest nowsza wersja oprogramowania. Przypięta wersja v1.4.1 sprawdza niewielki plik wersji w serwisie GitHub; od wersji v1.5.0, wydanej 24 października 2026, mechanizm sprawdzania banera pobiera linkbreeze.omnirise.dev/latest-version.json. Wyniki są buforowane przez 24 godziny, jednak ręczny przycisk Check now pomija ten bufor, również w wersji v1.4.1. Zapytania te nie przesyłają żadnych danych instancji w treści żądania. Dziennik zmian wskazuje, że wersje od v1.2.0 do v1.4.0 odpytywały adres zwracający błąd 404, przez co baner nigdy się nie pojawiał. Do momentu uruchomienia wersji z poprawnym punktem końcowym witryny, nie należy polegać na banerze: należy samodzielnie monitorować dziennik zmian pod adresem linkbreeze.omnirise.dev/changelog. W wersji v1.5.1 sekcja Settings zawiera również kartę statusu aktualizacji, która sprawdza serwis GitHub oraz witrynę, z przyciskiem Recheck pomijającym bufor. Przed zmianą tagu należy zapoznać się z informacjami o wydaniu, ponieważ na obecnym etapie projektu wersja minor może zmieniać domyślne ustawienia, od których zależy działanie systemu.

Tryby awarii i komunikaty błędów

manifest unknown podczas pobierania obrazu. Tag został zapisany w formacie nieodpowiednim dla danej wersji. Od wersji v1.4.0 tagi zawierają v, dlatego należy używać :v1.4.1. Wydania w GHCR do wersji v1.3.2 używają samych numerów, takich jak :1.2.7, a Docker Hub zawiera również nowsze tagi wersji, takie jak v1.5.1.

no matching manifest for linux/arm64/v8 in the manifest list entries. Przypięto wersję sprzed v1.4.0, która została opublikowana wyłącznie dla architektury amd64. Należy zmienić przypięcie na v1.4.1, która zawiera kompilację dla arm64. Płyta arm/v7 w architekturze 32-bitowej generuje ten sam błąd przy każdej wersji, ponieważ ta platforma nie jest wspierana.

Kontener zgłasza unhealthy, mimo że strona ładuje się poprawnie. Healthcheck w pliku compose wywołuje curl, którego obraz nie zawiera. Należy go usunąć i pozwolić działać wbudowanemu w obraz mechanizmowi wget.

Caddy zgłasza błąd certyfikatu lub nie odpowiada. Sprawdź docker compose logs caddy. Upewnij się, że rekord A wskazuje na ten VPS oraz że porty 80 i 443 są dostępne: Caddy może przeprowadzić walidację poprzez wyzwanie HTTP na porcie 80 lub wyzwanie TLS-ALPN na porcie 443.

Liczba unikalnych odwiedzających zatrzymała się na 1. Sprawdź, czy proxy ustawia nagłówek X-Forwarded-For lub X-Real-IP. Bez któregokolwiek z tych nagłówków odwiedzający z identycznymi user agentami współdzielą hash w obrębie każdego dnia UTC; hash zawiera również dzienną sól, więc brak nagłówków nie powoduje, że każdy odwiedzający ma identyczny hash na stałe.

Kontener wyłącza się zaraz po starcie, mimo że wczoraj działał. Jeśli nastąpiło przejście z wolumenu nazwanego na host bind mount, katalog danych jest własnością root, a aplikacja działa jako uid 1000, więc nie może otworzyć pliku bazy danych. Wykonaj sudo chown -R 1000:1000 na katalogu hosta.

Żądania śledzenia zwracają HTTP 429. Osiągnięto limit dla pojedynczego adresu IP w /api/track. Osobny limit w /go/<id> pomija rejestrację kliknięcia, ale nadal zwraca przekierowanie 302 do miejsca docelowego.

FAQ

Jest to młody projekt, a pierwsze wydanie datowane jest na 1 lipca 2026. Pomiędzy tą datą a wersją v1.4.1 z 23 września 2026 opublikowano 22 wersje, z czego większość przed połową sierpnia, więc zachowanie oprogramowania zmieniało się szybko. Wydania v1.5.0 oraz v1.5.1 pojawiły się 24 i 27 października 2026, a kanoniczne repozytorium GitHub jest publiczne od 2 listopada 2026. Licencja MIT oraz lokalny plik SQLite sprawiają, że strona pozostaje funkcjonalna nawet w przypadku wstrzymania prac rozwojowych, jednak publiczna aplikacja internetowa bez poprawek bezpieczeństwa staje się obciążeniem, dlatego należy traktować to oprogramowanie jako wymagające ciągłych aktualizacji, a nie instalacji jednorazowej.

Którego tagu obrazu LinkBreeze powinienem używać?

Należy używać tagu wersji, na przykład docker.io/omnirise/linkbreeze:v1.4.1, i zmieniać go w sposób świadomy. Od wersji v1.4.0 proces wydawniczy wypycha latest oraz tag git z prefiksem v, więc :1.4.1 bez v nie istnieje, a Docker zwraca manifest unknown. Wydania do wersji v1.3.2 działają odwrotnie: zawierają tylko same numery w GHCR. Obraz jest budowany dla architektur linux/amd64 oraz linux/arm64 od wersji v1.4.0, więc VPS z arm64 pobiera go bezpośrednio bez konieczności lokalnej kompilacji.

Dlaczego zestawienie krajów w analityce LinkBreeze pozostaje puste?

LinkBreeze odczytuje kraj odwiedzającego z nagłówków proxy, takich jak cf-ipcountry lub x-vercel-ip-country, i nie posiada własnej bazy danych GeoIP. VPS działający za własnym serwerem Caddy lub Nginx nie ustawia żadnego z tych nagłówków, więc kraj jest zapisywany jako null. Należy umieścić Cloudflare przed domeną i włączyć funkcję Add visitor location headers w Managed Transform lub skonfigurować reverse proxy tak, aby ustawiało jeden z tych nagłówków na podstawie lokalnego wyszukiwania GeoIP.

Co dokładnie należy archiwizować i jak przeprowadzić przywracanie?

Należy archiwizować cały wolumen linkbreeze-data, a nie tylko plik bazy danych. /app/data/linkbreeze.db przechowuje wszystkie linki, strony, ustawienia, subskrybentów oraz wiersze analityki, a /app/data/uploads zawiera awatary i miniatury, do których odwołuje się strona. Należy zatrzymać kontener, wykonać docker compose cp linkbreeze:/app/data ./backup-$(date +%F), a następnie uruchomić go ponownie. Przywracanie polega na skopiowaniu katalogu z powrotem do zatrzymanego kontenera i jego uruchomieniu. Eksport JSON z panelu sterowania to migawka konfiguracji profilu, linków, ustawień, motywów i wpisów czcionek, która nie zawiera danych analitycznych ani obrazów.

Czy import z Linktree przenosi analitykę i motyw?

Nie. Kreator migracji odczytuje tytuły linków, adresy URL, opisy i obrazy ze starego profilu publicznego, a także nazwę wyświetlaną, bio i awatar. Historia analityki, motyw, subskrybenci e-mail oraz zaplanowane daty publikacji pozostają na starej platformie. Po imporcie należy odtworzyć wygląd w edytorze motywów i liczyć się z tym, że historia kliknięć pozostanie na poprzedniej platformie.

Czy ten artykuł był przydatny?

#linkbreeze#linktree-alternative#docker-compose#sqlite#self-hosting#analytics