SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor

Cara Self-host LinkBreeze dengan Docker Compose

Ketahui cara memasang LinkBreeze pada VPS menggunakan Docker Compose dan Caddy. Panduan ini merangkumi penggunaan tag imej tetap, penjejakan klik tanpa kuki dan pengurusan volum.

Apakah itu LinkBreeze

LinkBreeze ialah alternatif Linktree yang dihoskan sendiri: satu kontena Docker yang menyediakan halaman pautan-dalam-bio awam dan papan pemuka pentadbir, dengan pangkalan datanya disimpan dalam satu fail SQLite. Ia dilesenkan di bawah MIT, ditulis dalam TypeScript menggunakan Next.js, dan diterbitkan sebagai imej kontena di Docker Hub sebagai omnirise/linkbreeze serta di GHCR sebagai ghcr.io/omnirise/linkbreeze; keluaran terdahulu menggunakan ghcr.io/manak-hash/linkbreeze. Untuk menjalankannya, anda memerlukan VPS, domain dengan rekod A yang menghala ke VPS tersebut, port 80 dan 443 yang dibuka, serta Docker Engine dengan pemalam Compose.

Panduan ini merangkumi penggunaan yang disokong oleh repositori tersebut: Docker Compose di sebalik reverse proxy yang mengambil sijilnya sendiri. Ia juga merangkumi perkara yang sering menyebabkan kegagalan, kerana pautan dalam bio ialah URL awam yang diklik oleh orang lain, dan pautan yang rosak akan menyebabkan anda kehilangan klik tersebut.

Sebelum memulakan, fahami bahawa projek ini masih baharu.

Adakah LinkBreeze cukup matang untuk pautan profil awam?

Keluaran pertama yang ditanda, v1.0.0, bertarikh 1 Julai 2026. Ini adalah projek yang berusia beberapa bulan, bukannya beberapa tahun.

Log perubahan menyebut isu keterlihatan akaun GitHub. Pada 2 November 2026, repositori GitHub kanonikal di github.com/OmniRise/LinkBreeze adalah awam, bersama-sama dengan cermin GitLab rasmi projek tersebut, gitlab.com/omnirise00/linkbreeze, dengan imej pada Docker Hub.

CartaLinkBreeze tagged releases per week, v1.0.0 to v1.4.1
Data di sebalik carta ini
[
  {
    "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
  }
]

Sejak v1.0.0, projek ini telah mengeluarkan 22 keluaran bertanda sepanjang 13 minggu kalendar, sehingga v1.4.1 pada 23 September 2026. Carta itu berakhir pada v1.4.1; v1.5.0 menyusul pada 24 Oktober dan v1.5.1 pada 27 Oktober 2026.

Baca perkara itu sebagai dua fakta yang berasingan. Penyelenggara adalah aktif dan pepijat dibaiki dalam masa beberapa hari. Skema dan tetapan lalai juga masih berubah, jadi instans yang anda pasang dan biarkan begitu sahaja akan jauh terpesong daripada kod yang sedang ditulis.

Lesen tersebut melindungi anda daripada senario terburuk. MIT ditambah dengan imej kontena serta fail SQLite pada cakera anda sendiri bermakna jika pembangunan dihentikan, apa yang anda miliki akan terus berjalan. Apa yang tidak dilindunginya ialah aplikasi web yang menghadap awam yang berhenti menerima tampalan keselamatan, yang menjadi liabiliti dari masa ke masa. Pasang ini sebagai sesuatu yang akan anda kemas kini secara berterusan, dan pastikan rutin sandaran di bawah berfungsi sejak hari pertama.

Sematkan tag imej, dan jangan jalankan latest

Aliran kerja keluaran semasa menolak dua tag bagi setiap versi, ke Docker Hub dan ke GHCR: latest, serta tag git tepat seperti yang ditolak, yang membawa kepada v disertakan. Oleh itu, tag yang disematkan untuk keluaran v1.4.1 ialah docker.io/omnirise/linkbreeze:v1.4.1. Keluaran sebelum v1.4.0 ditag secara berbeza: aliran kerja membuang v, dan keluaran tersebut hanya wujud pada GHCR sebagai nombor kosong seperti ghcr.io/manak-hash/linkbreeze:1.2.7. Tulis tag dalam bentuk yang salah untuk keluarannya dan Docker akan melaporkan manifest unknown, kerana tag tersebut tidak pernah ditolak. Docker Hub, yang kini digunakan oleh README sebagai laluan tarik lalai, juga membawa v1.5.1, tag yang ditentukan oleh pakej Unraid rasmi projek tersebut.

Sematkan ia kerana latest berubah. Pada kadar dalam carta di atas, docker compose pull terhadap latest merupakan naik taraf yang tidak disemak bagi halaman yang digunakan oleh audiens anda. Dengan tag yang disematkan, naik taraf berlaku apabila anda menyunting fail tersebut.

Satu perkara lagi mengenai imej ini. Sejak v1.4.0, ia merupakan senarai manifes berbilang seni bina untuk linux/amd64 dan linux/arm64, setiap satunya dibina pada pelari asli. Jika anda menjalankan VPS ARM dan bukannya x86, tag yang sama akan menarik binaan arm64 dan tiada apa-apa yang perlu dikompilasi pada kotak tersebut. Keluaran sehingga v1.3.2 diterbitkan untuk linux/amd64 sahaja, dan papan arm/v7 32-bit sengaja ditinggalkan, jadi sematan yang lebih lama atau papan 32-bit masih akan gagal dengan ralat no matching manifest.

Menggunakan LinkBreeze di sebalik Caddy dengan TLS automatik

Caddy meminta dan memperbaharui sijil daripada Let's Encrypt secara automatik, jadi TLS (transport layer security) tidak memerlukan langkah pengurusan sijil yang berasingan. Keseluruhan deployment ini terdiri daripada tiga fail dalam satu direktori.

Jana rahsia (secret) terlebih dahulu:

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

SECRET_KEY menandatangani kuki sesi admin dan memberikan salt kepada hash pelawat analitik. Sejak v1.4.0, ia juga menerbitkan kunci yang menyulitkan rahsia two-factor (TOTP) yang disimpan. Fail compose yang diterbitkan bersama v1.4.1 menetapkan nilai lalai kepada ${SECRET_KEY:-changeme-in-production}. Oleh itu, instans yang menggunakan fail tersebut tanpa menetapkan rahsia akan berjalan dengan kunci penandatanganan sesi yang dipaparkan dalam repositori awam projek. Tetapkan nilai ini sebelum permulaan pertama, kerana menukarnya kemudian akan melog keluar anda dan menetapkan semula salt analitik.

Tulis 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 adalah pilihan tetapi disyorkan untuk ditetapkan. Ia memberitahu aplikasi alamat awam sebenar, supaya permintaan yang tiba dengan header Host yang dipalsukan tidak menyebabkan aplikasi menjana pautan ke domain orang lain.

Tulis Caddyfile di sebelahnya, dengan domain anda sendiri:

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

Caddy menetapkan X-Forwarded-For dan X-Forwarded-Proto pada permintaan yang diproksi secara lalai. Ini membekalkan alamat klien untuk analitik dan pengangkutan untuk keselamatan kuki sesi. Naikkan perkhidmatan:

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

docker compose ps sepatutnya menunjukkan kontena LinkBreeze sebagai healthy. Imej ini membawakan healthcheck sendiri, wget --spider -q http://127.0.0.1:3000/api/health, jadi anda tidak perlu menambahnya. Jangan salin healthcheck daripada contoh Caddy dalam repositori tersebut: ia memanggil curl, manakala imej ini dibina di atas node:22-alpine yang membawa busybox wget dan tiada curl. Kontena tersebut akan melaporkan unhealthy walaupun ia menghidangkan halaman dengan sempurna.

Buka https://links.example.com dalam pelayar. Lawatan pertama akan mendarat di wizard persediaan pada /setup, yang mencipta akaun admin tunggal. Selepas itu, papan pemuka berada di /dashboard dan borang log masuk di /login. Dalam release v1.4.1 yang dipinkan, akaun tersebut adalah tempatan untuk instans ini dan tiada hook single sign-on. Jika anda mahu papan pemuka dilindungi oleh log masuk yang sama dengan aplikasi lain yang anda hoskan, ia perlu datang daripada forward auth proxy di hadapannya seperti Authentik yang dihoskan sendiri. Native OIDC single sign-on disenaraikan di bawah Unreleased setakat 2 November 2026.

Perhatikan apa yang tidak dilakukan oleh fail compose: ia tidak pernah menerbitkan port 3000. Hanya Caddy yang mendengar pada antaramuka awam. Jika sintaks fail Compose adalah perkara baharu bagi anda, asas Docker Compose untuk VPS merangkumi bahagian yang diandaikan oleh fail ini. Jika anda sudah menjalankan perkhidmatan lain di hadapan, perbandingan Nginx, Caddy dan Traefik menjelaskan perubahan yang diperlukan. Repositori ini membekalkan contoh yang berfungsi untuk Nginx dengan Certbot, Traefik dan tunnel Cloudflare.

Lokasi data anda dan kandungan sandaran yang diperlukan

DATABASE_PATH menghala ke /app/data/linkbreeze.db. Avatar yang dimuat naik dan imej kecil pautan ditulis di sebelahnya dalam /app/data/uploads. Kedua-duanya berada dalam volume bernama linkbreeze-data, jadi unit sandaran ialah volume tersebut, bukan sekadar fail pangkalan data sahaja. Jika anda memulihkan fail tanpa direktori muat naik, setiap imej pada halaman akan memaparkan ralat 404.

Segala data lain sebenarnya terkandung dalam pangkalan data tersebut: halaman, pautan, tetapan, tema, pelanggan e-mel dan baris analitik.

Lakukan salinan dengan container dihentikan:

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

Hentikan container terlebih dahulu kerana menyalin pangkalan data SQLite semasa proses sedang menulis kepadanya boleh menangkap transaksi yang belum selesai, dan salinan tersebut akan dibuka sebagai fail yang rosak. Halaman akan berada dalam keadaan luar talian semasa salinan dijalankan. Proses pemulihan adalah langkah yang sama secara terbalik:

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

Papan pemuka juga menawarkan eksport JSON, yang dihidangkan daripada /api/backup sebagai linkbreeze-backup-YYYY-MM-DD.json. Ia membawa profil, pautan dan bahagiannya, tetapan, tema yang disimpan serta entri fon tersuai. Ia tidak membawa sejarah analitik, pelanggan e-mel, akaun pentadbir atau fail yang dimuat naik, dan memulihkannya akan memadamkan baris semasa dalam enam jadual yang dibawa sebelum memasukkan data daripada fail tersebut. Anggap ia sebagai syot kilat konfigurasi untuk memindahkan hos atau membatalkan kesilapan penyuntingan. Salinan volume adalah sandaran yang sebenar.

Dua peraturan storan terpakai di sini sama seperti di tempat lain apabila anda menjalankan SQLite dalam pengeluaran pada VPS. Simpan pangkalan data pada cakera tempatan, kerana penguncian SQLite tidak boleh dipercayai pada sistem fail rangkaian dan halaman yang rosak adalah cara anda menyedarinya. Dan jika anda menukar volume bernama kepada bind mount hos, lakukan chown pada direktori hos terlebih dahulu: container berjalan sebagai pengguna bukan root node, uid 1000 dalam node:22-alpine, dan direktori yang dicipta oleh root tidak boleh ditulis olehnya, jadi aplikasi tidak dapat membuka pangkalan data dan container akan keluar semasa permulaan. Bind mounts berbanding volume bernama dalam Compose membincangkan pertukaran tersebut dengan lengkap.

Analitik dan sepanduk persetujuan yang tidak anda perlukan

Ini adalah ciri yang mewajarkan tindakan self-hosting bagi halaman yang boleh anda peroleh secara percuma di tempat lain.

Analitik ini tidak menggunakan kuki. Analitik terbina dalam tidak menetapkan kuki pelawat dan tidak memuatkan skrip penjejakan pihak ketiga; analitik luaran dan kandungan terbenam adalah ciri pilihan. Pelawat dikenal pasti melalui hash SHA-256 bagi alamat IP, rentetan user agent dan salt, yang dipotong kepada 16 aksara heksadesimal. Salt itu sendiri merupakan hash bagi tarikh UTC semasa dan SECRET_KEY anda, jadi ia berubah pada tengah malam UTC dan hash semalam tidak boleh dipadankan dengan hash hari ini. Alamat IP mentah tidak pernah ditulis ke dalam pangkalan data.

Klik dikira pada pelayan. Setiap pautan http pada halaman awam menghala ke /go/<id> pada domain anda sendiri, yang merekodkan klik tersebut dan kemudian menjawab dengan redirect 302 ke destinasi sebenar. Oleh itu, pengiraan berfungsi untuk pembaca yang menyahdayakan JavaScript, dan di dalam pelayar dalam aplikasi yang menyekat permintaan latar belakang. Paparan halaman direkodkan di bahagian pelayan apabila halaman awam dipaparkan; /api/track mengendalikan peristiwa klik dan pembukaan tetingkap timbul (popup).

Dua pengecualian perlu diketahui. Permintaan yang membawa sesi admin yang sah akan dilangkau, jadi menyunting halaman anda sendiri tidak akan meningkatkan angka tersebut. User agent perangkak (crawler) yang dikenali juga dilangkau.

Mengenai persetujuan: analitik terbina dalam tidak menggunakan kuki penjejakan, tetapi peraturan kuki juga meliputi teknologi serupa, termasuk fingerprinting peranti. Penjejakan tanpa kuki sahaja tidak menetapkan bahawa tiada sepanduk persetujuan diperlukan. Kewajipan anda masih bergantung pada tempat tinggal pembaca anda, jadi semak perkara tersebut, bersama-sama dengan sebarang analitik luaran atau kandungan terbenam yang anda aktifkan.

Satu peringatan yang mengejutkan orang ramai: putarkan SECRET_KEY dan salt harian akan berubah bersamanya, jadi setiap pelawat yang kembali akan dikira sebagai pelawat baharu bermula dari saat itu.

Mengapakah lajur negara analitik kosong?

Ini kerana tiada komponen dalam stack anda yang menetapkan pengepala (header) negara. LinkBreeze menentukan negara berdasarkan pengepala proksi seperti cf-ipcountry dan x-vercel-ip-country. Pada VPS di sebalik Caddy atau Nginx anda sendiri, tiada satu pun pengepala tersebut wujud, jadi negara direkodkan sebagai null dan perinciannya kekal kosong. Tiada pangkalan data GeoIP di dalam container tersebut.

Terdapat dua cara untuk mengisinya. Letakkan Cloudflare di hadapan domain dan aktifkan Managed Transform "Add visitor location headers" untuk membekalkan cf-ipcountry. Atau, tetapkan salah satu pengepala tersebut dalam reverse proxy anda sendiri hasil daripada carian GeoIP setempat.

Perangkap yang berkaitan adalah lebih buruk, jadi sila semak perkara ini. Pengendali klik dan paparan membaca alamat klien daripada X-Forwarded-For terlebih dahulu, kemudian X-Real-IP, dan menggunakan 0.0.0.0 sebagai sandaran apabila kedua-dua pengepala tidak hadir. Jika anda menerbitkan port 3000 terus ke internet tanpa sebarang pengepala alamat, pelawat dengan user agent yang sama akan berkongsi hash yang sama dalam setiap hari UTC; user agent yang berbeza masih menghasilkan hash yang berbeza, dan hash tersebut bertukar setiap hari. Had kadar (rate limit) per-IP sebanyak 60 peristiwa seminit pada /api/track dan /go/<id> kemudiannya akan dikenakan ke atas seluruh audiens anda di bawah alamat sandaran tersebut. Di sebalik arahan reverse_proxy di atas, Caddy akan menetapkan pengepala tersebut untuk anda dan kedua-dua masalah tersebut akan selesai.

Import daripada Linktree, dan perkara yang tidak dipindahkan

Wizard migrasi dalam papan pemuka menerima URL profil awam atau fail yang dieksport. Ia mengenali halaman linktr.ee, bento.me, lnk.bio, tap.link, hopp.bio, beacons.ai, solo.to, linkfly, mssg.me dan LittleLink, serta eksport HTML dan JSON generik. Bagi URL Linktree atau Bento, ia membaca __NEXT_DATA__ JSON yang dibenamkan oleh halaman tersebut. Bagi halaman statik, ia membaca tag anchor.

Perkara yang dipindahkan ialah tajuk, URL, deskripsi dan imej bagi setiap pautan, sama ada pautan tersebut merupakan profil sosial, serta nama paparan, bio dan avatar anda. Anda memilih pautan yang ditemui untuk dikekalkan sebelum sebarang data ditulis ke dalam pangkalan data.

Perkara yang tidak dipindahkan ialah sejarah analitik, tema dan susun atur, pelanggan e-mel, tarikh penerbitan berjadual, dan apa-apa sahaja yang disimpan oleh platform lama di sebalik log masuknya sendiri. Rancang untuk membina semula rupa bentuk secara manual, dan terima hakikat bahawa sejarah klik lama kekal pada perkhidmatan lama tersebut.

Pengimport mengambil URL daripada pelayan anda dan bukannya daripada pelayar anda, jadi ia menolak alamat yang tidak awam. Private/local URLs are not allowed bermaksud anda memberikan alamat di dalam rangkaian anda sendiri, dan penolakan ini adalah sengaja: tanpanya, sesiapa yang mempunyai akses papan pemuka boleh menggunakan pelayan anda untuk meninjau mesin yang hanya boleh dicapai oleh pelayan anda. Mesej lain yang mungkin anda lihat ialah Only http and https URLs are allowed, Request timed out dan Response too large.

Scraping bergantung pada markup pihak lain. Dalam v1.5.1, pengimport membaiki pepijat Linktree yang menarik pautan ahli gabungan platform tersebut dan bukannya pautan profil itu sendiri. Lakukan naik taraf sebelum mengimport daripada Linktree; profil yang pautannya hanya dipaparkan dalam pelayar masih memerlukan tab Fail atau kemasukan manual. Jika wizard tidak menemui apa-apa pada halaman yang jelas mempunyai pautan, tambahkan pautan tersebut secara manual dan bukannya menunggu pembaikan. Jika perkara yang anda sebenarnya mahukan ialah pautan pendek yang boleh diukur dan bukannya halaman profil, pemendek URL yang dihoskan sendiri seperti Shlink melakukan tugas tersebut dan berjalan dengan lancar pada kotak yang sama.

Mengemas kini deployment yang dipinkan

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

Migrasi skema dijalankan secara automatik apabila container bermula. Tiada cara yang didokumentasikan untuk menjalankan migrasi secara terbalik, jadi buat salinan volum terlebih dahulu. Naik taraf yang tidak boleh diterbalikkan hanya selamat jika anda boleh memulihkan keadaan asal sebelum naik taraf tersebut.

Dashboard direka untuk memaparkan banner apabila keluaran baharu tersedia. Versi v1.4.1 yang dipinkan menyemak fail versi kecil pada GitHub; sejak v1.5.0, yang dikeluarkan pada 24 Oktober 2026, semakan banner tersebut mengambil linkbreeze.omnirise.dev/latest-version.json. Keputusan disimpan dalam cache selama 24 jam, tetapi butang Check now secara manual memintas cache tersebut, termasuk dalam v1.4.1. Semakan ini tidak menghantar data instance dalam payload permintaan. Changelog menyatakan bahawa v1.2.0 hingga v1.4.0 meninjau alamat yang memberikan respons 404 dan tidak pernah memaparkan banner. Selagi anda tidak menjalankan versi dengan endpoint laman web, jangan tunggu banner tersebut: pantau changelog di linkbreeze.omnirise.dev/changelog sendiri. Dalam v1.5.1, Settings juga mempunyai kad status kemas kini yang menyemak GitHub dan laman web, dengan butang Recheck yang memintas cache. Baca nota keluaran sebelum anda menukar tag, kerana pada peringkat projek ini, versi minor boleh mengubah tetapan lalai yang anda gunakan.

Mod kegagalan dan rentetan yang akan anda lihat

manifest unknown semasa melakukan pull. Tag ditulis dalam format yang salah untuk keluarannya. Bermula dari v1.4.0, tag mengekalkan v, jadi gunakan :v1.4.1. Keluaran GHCR sehingga v1.3.2 menggunakan nombor kosong seperti :1.2.7, dan Docker Hub juga membawa tag versi yang lebih baharu seperti v1.5.1.

no matching manifest for linux/arm64/v8 in the manifest list entries. Anda telah menetapkan (pin) keluaran sebelum v1.4.0, yang diterbitkan untuk amd64 sahaja. Alihkan penetapan kepada v1.4.1, yang membawa binaan arm64. Papan arm/v7 32-bit mendapat jenis ralat yang sama pada setiap keluaran, kerana platform tersebut tidak dibina secara sengaja.

Kontena melaporkan unhealthy semasa halaman dimuatkan dengan baik. Pemeriksaan kesihatan (healthcheck) dalam fail compose anda memanggil curl, yang tidak terkandung dalam imej tersebut. Padamkannya dan biarkan pemeriksaan kesihatan wget milik imej itu sendiri berjalan.

Caddy memberikan ralat sijil, atau tiada apa-apa langsung. Semak docker compose logs caddy. Pastikan rekod A menghala ke VPS ini dan port 80 serta 443 boleh dicapai: Caddy boleh melakukan pengesahan melalui cabaran HTTP pada port 80 atau cabaran TLS-ALPN pada port 443.

Pelawat unik tersangkut pada 1. Semak sama ada proksi menetapkan X-Forwarded-For atau X-Real-IP. Tanpa salah satu pengepala (header) tersebut, pelawat dengan ejen pengguna (user agent) yang sama berkongsi hash dalam setiap hari UTC; hash tersebut juga merangkumi salt harian, jadi pengepala yang hilang tidak menyebabkan setiap hash pelawat menjadi sama selama-lamanya.

Kontena keluar sejurus selepas dimulakan, walaupun berfungsi semalam. Jika anda berpindah daripada volum bernama (named volume) kepada host bind mount, direktori data dimiliki oleh root dan aplikasi berjalan sebagai uid 1000, jadi ia tidak boleh membuka fail pangkalan data. sudo chown -R 1000:1000 direktori hos tersebut.

Permintaan penjejakan dijawab dengan HTTP 429. Pendikit (throttle) per-IP pada /api/track telah dicapai. Pendikit berasingan pada /go/<id> melangkau rakaman klik tetapi masih mengembalikan redirect 302 ke destinasi.

FAQ

Adakah LinkBreeze sedia untuk pautan bio awam?

Ini merupakan projek baharu, dan keluaran pertamanya bertarikh 1 Julai 2026. Ia telah mengeluarkan 22 keluaran bertanda antara tarikh tersebut sehingga v1.4.1 pada 23 September 2026, dengan kebanyakan daripadanya sebelum pertengahan Ogos, jadi kelakuannya telah berubah dengan pantas. Keluaran v1.5.0 dan v1.5.1 menyusul pada 24 dan 27 Oktober 2026, dan repositori GitHub kanonikal telah dibuka kepada umum mulai 2 November 2026. Lesen MIT dan fail SQLite tempatan bermakna anda masih mempunyai halaman yang berfungsi walaupun pembangunan dihentikan, namun aplikasi web awam tanpa kemas kini keselamatan akan menjadi liabiliti. Oleh itu, anggap ini sebagai perisian yang perlu anda kemas kini secara berterusan dan bukannya perisian yang dipasang sekali sahaja.

Tag imej LinkBreeze yang manakah patut saya jalankan?

Jalankan tag versi, contohnya docker.io/omnirise/linkbreeze:v1.4.1, dan tukarkannya secara sengaja. Sejak v1.4.0, aliran kerja keluaran menolak latest dan tag git dengan awalan v, jadi :1.4.1 tanpa v tidak wujud dan Docker akan memberikan ralat manifest unknown. Keluaran sehingga v1.3.2 adalah sebaliknya: nombor kosong hanya pada GHCR. Imej ini dibina untuk linux/amd64 dan linux/arm64 sejak v1.4.0, jadi VPS arm64 akan menariknya secara terus tanpa perlu binaan tempatan.

Mengapakah pecahan negara kekal kosong dalam analitik LinkBreeze?

LinkBreeze membaca negara pelawat daripada pengepala proksi seperti cf-ipcountry atau x-vercel-ip-country, dan ia tidak membawa pangkalan data GeoIP sendiri. VPS di belakang Caddy atau Nginx anda tidak menetapkan mana-mana pengepala tersebut, jadi negara disimpan sebagai null. Letakkan Cloudflare di hadapan domain dan aktifkan Managed Transform untuk Add visitor location headers, atau minta reverse proxy anda menetapkan salah satu pengepala tersebut daripada carian GeoIP tempatan.

Apakah yang perlu saya sandarkan, dan bagaimana cara untuk memulihkannya?

Sandarkan keseluruhan volum linkbreeze-data, bukan sekadar fail pangkalan data. /app/data/linkbreeze.db menyimpan setiap pautan, halaman, tetapan, pelanggan dan baris analitik, manakala /app/data/uploads menyimpan imej avatar dan imej kecil yang dirujuk oleh halaman tersebut. Hentikan kontena, jalankan docker compose cp linkbreeze:/app/data ./backup-$(date +%F), kemudian mulakan semula. Pulihkan dengan menyalin direktori tersebut kembali ke dalam kontena yang telah dihentikan dan mulakannya. Eksport JSON daripada papan pemuka merupakan syot kilat konfigurasi bagi profil, pautan, tetapan, tema dan entri fon, dan ia tidak mengandungi analitik mahupun imej.

Adakah mengimport daripada Linktree akan membawa analitik dan tema saya bersama?

Tidak. Wizard migrasi membaca tajuk pautan, URL, deskripsi dan imej daripada profil awam lama anda, berserta nama paparan, bio dan avatar anda. Sejarah analitik, tema, pelanggan e-mel dan tarikh penerbitan berjadual akan kekal di platform lama. Bina semula rupa bentuk dalam editor tema selepas import, dan jangkakan sejarah klik anda kekal di platform lama.

Adakah artikel ini berguna?

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