SSD Nodes Learn Hosting plans →
Hướng dẫn Matt ConnorBởi Matt Connor

Hướng dẫn tự host LinkBreeze trên VPS với Docker

Triển khai LinkBreeze làm trang link-in-bio cá nhân bằng Docker Compose và Caddy. Hướng dẫn cấu hình SQLite, cookieless tracking và cách quản lý volume dữ liệu duy nhất.

LinkBreeze là gì

LinkBreeze là một lựa chọn tự host thay cho Linktree: một Docker container phục vụ trang link-in-bio công khai và admin dashboard, với database nằm trong một file SQLite duy nhất. Dự án được cấp phép theo MIT, viết bằng TypeScript trên Next.js, và được phát hành dưới dạng container image trên Docker Hub với tên omnirise/linkbreeze và trên GHCR với tên ghcr.io/omnirise/linkbreeze; các bản release cũ dùng ghcr.io/manak-hash/linkbreeze. Để chạy, bạn cần một VPS, một domain có bản ghi A trỏ đến VPS đó, mở các cổng 80 và 443, cùng Docker Engine có Compose plugin.

Hướng dẫn này trình bày cách triển khai mà repository thực sự hỗ trợ: Docker Compose chạy phía sau reverse proxy, còn reverse proxy tự lấy certificate. Hướng dẫn cũng nêu các lỗi có thể xảy ra, vì link trong bio là một URL công khai để người khác click, và link bị hỏng sẽ khiến bạn mất lượt click.

Trước hết, cần hiểu rõ dự án này còn mới đến mức nào.

Bản release đầu tiên có tag, v1.0.0, được phát hành vào ngày 1 July 2026. Đây là một project mới vài tháng, không phải vài năm.

Changelog có đề cập đến các vấn đề về visibility của tài khoản GitHub. Vào ngày 2 November 2026, repository GitHub chính thức tại github.com/OmniRise/LinkBreeze là public, cùng với mirror GitLab chính thức của project tại gitlab.com/omnirise00/linkbreeze và image trên Docker Hub.

Biểu đồLinkBreeze tagged releases per week, v1.0.0 to v1.4.1
Dữ liệu đằng sau biểu đồ này
[
  {
    "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
  }
]

Từ v1.0.0, project đã phát hành 22 release có tag trong 13 tuần theo lịch, đến v1.4.1 vào ngày 23 September 2026. Biểu đồ đó kết thúc ở v1.4.1; v1.5.0 được phát hành tiếp vào ngày 24 October và v1.5.1 vào ngày 27 October 2026.

Hãy xem đây là hai sự thật riêng biệt. Maintainer vẫn hoạt động và bug được sửa trong vòng vài ngày. Schema và các giá trị mặc định cũng vẫn đang thay đổi, vì vậy một instance được deploy rồi bỏ quên sẽ ngày càng khác xa code đang được phát triển.

License bảo vệ bạn khỏi kịch bản xấu nhất. MIT, một container image và một file SQLite trên disk của bạn có nghĩa là nếu quá trình phát triển dừng lại, những gì bạn đang có vẫn tiếp tục chạy. Nhưng license không bảo vệ bạn khỏi một web app public-facing không còn nhận được bản sửa bảo mật; theo thời gian, app đó sẽ trở thành một rủi ro. Hãy deploy app này với giả định rằng bạn sẽ tiếp tục update, và bảo đảm routine backup bên dưới hoạt động ngay từ ngày đầu.

Ghim tag image và không chạy latest

Quy trình release hiện tại push hai tag cho mỗi phiên bản lên Docker Hub và GHCR: latest và git tag đúng như lúc được push, bao gồm cả v. Vì vậy, tag được ghim cho release v1.4.1 là docker.io/omnirise/linkbreeze:v1.4.1. Các release trước v1.4.0 được tag theo cách khác: workflow đã loại bỏ v, và các release đó chỉ tồn tại trên GHCR dưới dạng số thuần như ghcr.io/manak-hash/linkbreeze:1.2.7. Nếu ghi tag sai dạng cho release tương ứng, Docker sẽ báo manifest unknown vì tag đó chưa từng được push. Docker Hub, hiện được README dùng làm đường dẫn pull mặc định, cũng có v1.5.1, là tag được package Unraid chính thức của dự án chỉ định.

Hãy ghim tag vì latest thay đổi. Với tần suất trong biểu đồ ở trên, một docker compose pull đối với latest là một lần nâng cấp chưa được review cho trang mà người dùng của bạn đang sử dụng. Khi dùng tag được ghim, việc nâng cấp chỉ xảy ra khi bạn sửa file.

Còn một điểm nữa về image. Từ v1.4.0, image là manifest list multi-arch cho linux/amd64 và linux/arm64, mỗi bản được build trên một runner native. Nếu bạn chạy VPS ARM thay vì x86, cùng một tag sẽ pull bản build arm64 và không cần compile gì trên máy. Các release đến v1.3.2 chỉ được publish cho linux/amd64, còn các board arm/v7 32-bit bị loại bỏ có chủ đích, nên pin cũ hoặc board 32-bit vẫn sẽ fail với lỗi no matching manifest.

Triển khai LinkBreeze phía sau Caddy với TLS tự động

Caddy tự yêu cầu và gia hạn chứng chỉ từ Let's Encrypt, nên TLS (transport layer security) không cần bước cấp chứng chỉ riêng. Toàn bộ triển khai gồm 3 file trong cùng một thư mục.

Tạo secret trước:

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

SECRET_KEY dùng để ký session cookie của admin và thêm salt vào visitor hash của analytics. Từ v1.4.0, nó cũng dùng để dẫn xuất key mã hóa các secret two-factor (TOTP) được lưu trữ. File compose được phát hành cùng v1.4.1 mặc định đặt giá trị này thành ${SECRET_KEY:-changeme-in-production}. Vì vậy, instance dùng file đó mà không đặt secret sẽ chạy với session signing key được in trong public repository của dự án. Hãy đặt secret trước lần khởi động đầu tiên, vì thay đổi nó sau đó sẽ đăng xuất bạn và reset analytics salt.

Tạo 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 là tùy chọn nhưng nên đặt. Nó cho app biết địa chỉ public thực tế của mình, nên request chứa header Host giả mạo không thể khiến app tạo link đến domain của người khác.

Tạo Caddyfile cạnh file đó, dùng domain của bạn:

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

Caddy mặc định đặt X-Forwarded-For và X-Forwarded-Proto trên các request được proxy. Hai header này cung cấp địa chỉ client cho analytics và giao thức truyền tải để bảo vệ session cookie. Khởi động các container:

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

docker compose ps phải hiển thị container LinkBreeze ở trạng thái healthy. Image đã có healthcheck riêng là wget --spider -q http://127.0.0.1:3000/api/health, nên bạn không cần thêm healthcheck. Không sao chép healthcheck từ ví dụ Caddy trong repository của dự án. Healthcheck đó gọi curl, trong khi image được build trên node:22-alpine, có busybox wget nhưng không có curl. Container đó báo unhealthy dù vẫn phục vụ trang bình thường.

Mở https://links.example.com trong browser. Lần truy cập đầu tiên sẽ đưa bạn đến setup wizard tại /setup. Wizard này tạo tài khoản admin duy nhất. Sau đó, dashboard nằm tại /dashboard và form đăng nhập nằm tại /login. Trong bản phát hành v1.4.1 được ghim phiên bản, tài khoản này chỉ có hiệu lực trên instance hiện tại và không có hook single sign-on. Vì vậy, nếu muốn bảo vệ dashboard bằng cùng thông tin đăng nhập với các dịch vụ khác đang host, bạn phải dùng forward auth proxy ở phía trước, chẳng hạn như Authentik tự host. Tính đến 2 November 2026, native OIDC single sign-on vẫn được liệt kê trong mục Unreleased.

Lưu ý compose file không làm gì: nó không publish port 3000. Chỉ Caddy listen trên public interface. Nếu cú pháp Compose file còn mới với bạn, phần hướng dẫn cơ bản về Docker Compose cho VPS giải thích các thành phần mà file này giả định bạn đã biết. Nếu bạn đã chạy một reverse proxy khác ở phía trước, so sánh Nginx, Caddy và Traefik giải thích những điểm cần thay đổi. Repository có sẵn các ví dụ hoạt động cho Nginx với Certbot, Traefik và Cloudflare tunnel.

Dữ liệu nằm ở đâu và bản backup phải chứa gì

DATABASE_PATH trỏ đến /app/data/linkbreeze.db. Avatar đã upload và thumbnail của link được ghi bên cạnh nó trong /app/data/uploads. Cả hai nằm trong named volume linkbreeze-data, vì vậy đơn vị backup là volume, không phải riêng file database. Nếu restore file mà thiếu thư mục uploads, mọi hình ảnh trên trang sẽ trả về 404.

Mọi thứ khác thực sự nằm trong một database đó: page, link, setting, theme, email subscriber và các dòng analytics.

Hãy tạo bản copy khi container đã dừng:

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

Phải dừng trước vì copy SQLite database trong lúc một process đang ghi có thể lấy phải transaction chưa hoàn tất. Khi đó bản copy sẽ mở dưới dạng file bị corrupt. Page sẽ offline trong lúc tạo bản copy. Restore cũng thực hiện tương tự theo chiều ngược lại:

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

Dashboard cũng cung cấp JSON export, được phục vụ từ /api/backup dưới dạng linkbreeze-backup-YYYY-MM-DD.json. File này chứa profile, các link và section của chúng, setting, theme đã lưu và các entry font tùy chỉnh. File không chứa lịch sử analytics, email subscriber, admin account hoặc file đã upload. Khi restore, nó xóa các row hiện tại trong 6 table mà file chứa trước khi insert các row từ file. Hãy xem đây là config snapshot để chuyển sang host khác hoặc hoàn tác một lỗi chỉnh sửa. Bản copy của volume mới là backup.

Ở đây cũng áp dụng 2 quy tắc lưu trữ như mọi trường hợp khác khi bạn chạy SQLite trên VPS trong môi trường production. Hãy giữ database trên local disk, vì cơ chế locking của SQLite không đáng tin cậy trên network filesystem. Một page bị corrupt sẽ cho bạn thấy hậu quả. Nếu thay named volume bằng host bind mount, trước tiên hãy chown thư mục trên host: container chạy bằng user không phải root node, có uid 1000 trong node:22-alpine. Thư mục do root tạo sẽ không cho user này ghi, nên app không thể mở database và container sẽ thoát khi startup. Bind mount thay named volume trong Compose trình bày đầy đủ sự đánh đổi này.

Đây là tính năng biện minh cho việc tự host một trang mà bạn có thể dùng miễn phí ở nơi khác.

Analytics không dùng cookie. Analytics tích hợp không đặt cookie cho visitor và không tải script tracking của bên thứ ba; analytics bên ngoài và embed là các tính năng tùy chọn. Một visitor được nhận diện bằng hash SHA-256 của địa chỉ IP, chuỗi user agent và một salt, sau đó được cắt còn 16 ký tự hexadecimal. Bản thân salt là hash của ngày UTC hiện tại và SECRET_KEY, nên thay đổi vào nửa đêm UTC. Vì vậy không thể đối chiếu hash của ngày hôm qua với hash của hôm nay. Địa chỉ IP gốc không bao giờ được ghi vào database.

Click được đếm trên server. Mọi liên kết http trên public page đều trỏ đến /go/<id> trên domain của bạn. Endpoint này ghi nhận click rồi trả về redirect 302 đến đích thực. Vì vậy việc đếm vẫn hoạt động với reader đã tắt JavaScript và trong các in-app browser chặn background request. Page view được ghi ở phía server khi public page render; /api/track xử lý các event click và mở popup.

Có 2 trường hợp loại trừ cần biết. Request chứa admin session hợp lệ sẽ bị bỏ qua, nên việc chỉnh sửa page của bạn không làm tăng số liệu. User agent của các crawler đã biết cũng bị bỏ qua.

Về consent: analytics tích hợp không dùng tracking cookie, nhưng quy định về cookie cũng áp dụng cho các công nghệ tương tự, bao gồm device fingerprinting. Chỉ dùng cookieless tracking không đủ để kết luận rằng bạn không cần banner consent. Nghĩa vụ của bạn vẫn phụ thuộc vào nơi reader sinh sống, nên hãy kiểm tra các yêu cầu đó, cùng với mọi analytics hoặc embed bên ngoài mà bạn bật.

Có một điểm cần lưu ý thường gây bất ngờ: nếu rotate SECRET_KEY, salt hằng ngày cũng thay đổi theo. Từ thời điểm đó, mọi returning visitor đều được tính là visitor mới.

Cột quốc gia trong analytics bị trống vì sao?

Vì không có thành phần nào trong stack của bạn thiết lập header quốc gia. LinkBreeze lấy quốc gia từ các proxy header như cf-ipcountry và x-vercel-ip-country. Nếu VPS chạy phía sau Caddy hoặc Nginx của bạn, không có header nào trong số đó tồn tại, nên quốc gia được ghi là null và phần phân tích theo quốc gia vẫn trống. Container không có cơ sở dữ liệu GeoIP.

Có 2 cách để điền giá trị này. Đặt Cloudflare phía trước domain và bật Managed Transform Add visitor location headers để cung cấp cf-ipcountry. Hoặc thiết lập một trong các header đó trong reverse proxy của bạn bằng kết quả tra cứu GeoIP cục bộ.

Vấn đề liên quan còn nghiêm trọng hơn, nên hãy kiểm tra. Các handler click và view trước tiên đọc địa chỉ client từ X-Forwarded-For, sau đó đến X-Real-IP, rồi dùng 0.0.0.0 nếu cả hai header đều không tồn tại. Nếu publish port 3000 trực tiếp ra Internet mà không có header địa chỉ, những visitor dùng cùng user agent sẽ dùng chung một hash trong mỗi ngày UTC; các user agent khác nhau vẫn tạo ra hash khác nhau, và hash thay đổi mỗi ngày. Khi đó, rate limit theo IP là 60 event mỗi phút trên /api/track và /go/<id> đều áp dụng cho toàn bộ audience của bạn dưới địa chỉ fallback. Khi chạy phía sau directive reverse_proxy ở trên, Caddy sẽ tự thiết lập header và cả hai vấn đề sẽ biến mất.

Nhập dữ liệu từ Linktree và những gì không được chuyển sang

Trình hướng dẫn migration trong dashboard chấp nhận URL profile public hoặc file đã export. Công cụ nhận diện các trang linktr.ee, bento.me, lnk.bio, tap.link, hopp.bio, beacons.ai, solo.to, linkfly, mssg.me và LittleLink, cùng các file export HTML và JSON thông thường. Với URL Linktree hoặc Bento, công cụ đọc JSON __NEXT_DATA__ mà các trang này nhúng vào. Với trang tĩnh, công cụ đọc các thẻ anchor.

Dữ liệu được chuyển sang gồm title, URL, description và image của từng link, thông tin cho biết link đó có phải social profile hay không, cùng display name, bio và avatar của bạn. Bạn chọn những link cần giữ lại trước khi bất kỳ dữ liệu nào được ghi vào database.

Dữ liệu không được chuyển sang gồm lịch sử analytics, theme và layout, email subscriber, thời điểm publish đã lên lịch, cùng mọi nội dung mà nền tảng cũ yêu cầu đăng nhập riêng. Bạn cần tự dựng lại giao diện và chấp nhận rằng lịch sử click cũ vẫn nằm trên service cũ.

Importer fetch URL từ server của bạn thay vì từ browser, nên từ chối các địa chỉ không public. Private/local URLs are not allowed có nghĩa là bạn đã cung cấp một địa chỉ bên trong network của chính mình. Việc từ chối là có chủ ý: nếu không có cơ chế này, bất kỳ ai có quyền truy cập dashboard cũng có thể dùng server của bạn để probe những máy mà chỉ server của bạn mới truy cập được. Các message khác bạn có thể thấy là Only http and https URLs are allowed, Request timed out và Response too large.

Việc scrape phụ thuộc vào markup của bên khác. Trong v1.5.1, importer sửa một bug của Linktree khiến công cụ lấy affiliate link của nền tảng thay vì link riêng của profile. Hãy upgrade trước khi import từ Linktree. Những profile chỉ render link trong browser vẫn cần dùng tab File hoặc nhập thủ công. Nếu wizard không tìm thấy gì trên một trang rõ ràng có link, hãy tự thêm link thay vì chờ bản sửa lỗi. Nếu mục tiêu thực sự của bạn là các short link có thể đo lường thay vì một profile page, một URL shortener tự host như Shlink sẽ phù hợp và có thể chạy ổn định trên cùng máy chủ.

Cập nhật deployment đã pin

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

Schema migration tự động chạy khi container khởi động. Không có cách được tài liệu hóa để chạy migration theo chiều ngược lại, vì vậy hãy sao chép volume trước. Một bản upgrade không thể reverse chỉ an toàn khi bạn có thể restore trạng thái trước đó.

Dashboard được thiết kế để hiển thị banner khi có release mới hơn. Bản v1.4.1 được pin kiểm tra một file version nhỏ trên GitHub; từ v1.5.0, phát hành ngày 24 October 2026, việc kiểm tra của banner sẽ fetch linkbreeze.omnirise.dev/latest-version.json. Kết quả được cache trong 24 giờ, nhưng nút Check now thủ công sẽ bypass cache này, kể cả trong v1.4.1. Các lần kiểm tra này không gửi dữ liệu instance trong request payload. Changelog cho biết từ v1.2.0 đến v1.4.0, ứng dụng poll một địa chỉ trả về 404 nên không bao giờ hiển thị banner. Cho đến khi bạn chạy version có website endpoint, đừng chờ banner: hãy tự theo dõi changelog tại linkbreeze.omnirise.dev/changelog. Trong v1.5.1, Settings cũng có update status card kiểm tra GitHub và website, cùng nút Recheck bypass cache. Hãy đọc release notes trước khi đổi tag, vì ở giai đoạn này của project, một minor version có thể thay đổi các default mà bạn đang phụ thuộc.

Các tình huống lỗi và chuỗi bạn sẽ thấy

manifest unknown khi pull. Tag được ghi sai định dạng cho bản release đó. Từ v1.4.0 trở đi, tag giữ v, nên dùng :v1.4.1. GHCR có các release đến v1.3.2 dùng số thuần như :1.2.7, còn Docker Hub cũng có các tag phiên bản mới hơn như v1.5.1.

no matching manifest for linux/arm64/v8 in the manifest list entries. Bạn đã pin một release trước v1.4.0, vốn chỉ được build cho amd64. Chuyển pin sang v1.4.1, bản này có build arm64. Board arm/v7 32-bit sẽ gặp cùng loại lỗi trong mọi release, vì platform đó không được build có chủ đích.

Container báo unhealthy nhưng trang vẫn tải bình thường. healthcheck trong compose file đang gọi curl, nhưng image không chứa lệnh này. Xóa healthcheck đó để image tự chạy healthcheck wget.

Caddy báo lỗi chứng chỉ hoặc hoàn toàn không phản hồi. Kiểm tra docker compose logs caddy. Đảm bảo A record trỏ đến VPS này và các cổng 80, 443 có thể truy cập được: Caddy có thể xác thực bằng HTTP challenge trên cổng 80 hoặc TLS-ALPN challenge trên cổng 443.

Số unique visitor bị kẹt ở 1. Kiểm tra proxy có đặt X-Forwarded-For hoặc X-Real-IP không. Nếu thiếu cả hai header, các visitor có user agent giống nhau sẽ dùng chung một hash trong từng ngày UTC; hash cũng chứa salt hằng ngày, nên thiếu header không khiến mọi visitor vĩnh viễn có cùng hash.

Container thoát ngay sau khi khởi động, dù hôm qua vẫn chạy. Nếu bạn chuyển từ named volume sang host bind mount, data directory thuộc về root còn app chạy với uid 1000, nên app không thể mở database file. sudo chown -R 1000:1000 host directory.

Tracking request nhận HTTP 429. Đã chạm giới hạn theo IP trên /api/track. Giới hạn riêng trên /go/<id> sẽ bỏ qua việc ghi nhận click nhưng vẫn trả về redirect 302 đến đích.

FAQ

Đây là một dự án còn mới, và bản phát hành đầu tiên có ngày 1 July 2026. Dự án đã phát hành 22 bản có tag từ thời điểm đó đến v1.4.1 vào 23 September 2026, phần lớn trước giữa tháng August, nên hành vi đã thay đổi nhanh. Các bản v1.5.0 và v1.5.1 lần lượt được phát hành vào 24 và 27 October 2026, còn repository GitHub chính thức ở trạng thái public từ 2 November 2026. License MIT và file SQLite cục bộ giúp bạn vẫn giữ được page đang hoạt động ngay cả khi quá trình phát triển dừng lại. Tuy nhiên, một web app public không còn nhận security fix sẽ trở thành rủi ro, nên hãy xem đây là phần mềm cần được cập nhật thường xuyên thay vì cài một lần rồi để đó.

Nên chạy image tag nào của LinkBreeze?

Hãy chạy version tag, ví dụ docker.io/omnirise/linkbreeze:v1.4.1, và chủ động thay đổi tag khi cần. Từ v1.4.0, release workflow đẩy latest và git tag có thêm v ở đầu. Vì vậy, :1.4.1 không có v không tồn tại và Docker sẽ trả về manifest unknown. Các bản phát hành đến v1.3.2 thì ngược lại: trên GHCR chỉ có số phiên bản không có prefix. Từ v1.4.0, image được build cho linux/amd64 và linux/arm64, nên VPS arm64 có thể pull image trực tiếp mà không cần local build.

Vì sao phần phân tích theo quốc gia trong LinkBreeze vẫn trống?

LinkBreeze đọc quốc gia của visitor từ các proxy header như cf-ipcountry hoặc x-vercel-ip-country và không có GeoIP database riêng. VPS đứng sau Caddy hoặc Nginx của bạn sẽ không tự đặt các header này, nên quốc gia được lưu dưới dạng null. Hãy đặt Cloudflare trước domain và bật Managed Transform Add visitor location headers, hoặc cấu hình reverse proxy đặt một trong các header đó dựa trên local GeoIP lookup.

Cần backup chính xác những gì và restore như thế nào?

Hãy backup toàn bộ volume linkbreeze-data, không chỉ file database. /app/data/linkbreeze.db chứa mọi link, page, setting, subscriber và bản ghi analytics. /app/data/uploads chứa các ảnh avatar và thumbnail được page tham chiếu. Hãy stop container, chạy docker compose cp linkbreeze:/app/data ./backup-$(date +%F), rồi start lại. Để restore, copy directory trở lại container đang stopped rồi start container. JSON export từ dashboard chỉ là config snapshot của profile, link, setting, theme và font entry. File này không chứa analytics và cũng không chứa image.

Import từ Linktree có mang theo analytics và theme không?

Không. Migration wizard đọc title, URL, description và image của link từ public profile cũ, cùng display name, bio và avatar của bạn. Lịch sử analytics, theme, email subscriber và scheduled publish date sẽ không được chuyển sang. Sau khi import, hãy dựng lại giao diện trong theme editor. Lịch sử click vẫn nằm trên platform cũ.

Bài viết này có hữu ích không?

#linkbreeze#linktree-alternative#docker-compose#sqlite#tự lưu trữ#analytics