Linkwarden

קבצים מוכנים להפעלה

רמת תמיכה נתמך

תבנית Compose מהמקורות הרשמיים; עוד לא נבדקה בהרצה.

צור docker-compose

שדרוג וחזרה לאחור

איך עוברים לגרסה חדשה בבטחה, ואיך חוזרים אחורה אם משהו נכשל.

קודם גיבוי

אי אפשר לבטל migrations: קחו קודם pg_dump של מסד linkwarden וארכיון של ה-volume של data (הקבצים השמורים) ושל ה-.env. [17]

שלבי השדרוג

1. קראו את ה-release notes של כל גרסה בין הגרסה שלכם לחדשה: שם מסומנים ה-breaking changes. [17]
2. שנו את ה-tag המוצמד של linkwarden, ואז הריצו docker compose pull ו-docker compose up -d. ה-migrations רצים לבד לפני שהאפליקציה מאזינה; עקבו אחרי docker compose logs -f linkwarden עד שהיא מוכנה. [4][17]
3. שנו את ה-tag של Meilisearch רק לזה שה-docker-compose.yml של הגרסה החדשה מצמיד, והעבירו את מסד הנתונים שלו עם dump או עם dumpless upgrade: מסד נתונים של Meilisearch עובד רק עם הגרסה שיצרה אותו. [24][25][35]נגזרהמדריך של Linkwarden מכסה רק את ה-image שלו; הצעד של Meilisearch נגזר מכך שה-compose של upstream העלה את Meilisearch בתוך 2.16.x, וממדריך השדרוג של Meilisearch.

חזרה לאחור

שחזרו את ה-dump של מסד הנתונים מלפני השדרוג והצמידו את ה-image חזרה ל-tag הקודם. צריך את שניהם: גרסה ישנה לא יכולה לקרוא schema שמיגרציה חדשה יותר שינתה. [17]

שינויים שוברים ידועים

• בגרסה 2.16.1: ה-compose הרשמי העביר את Meilisearch מ-v1.12.8 ל-v1.13.3. מסד נתונים של Meilisearch נפתח רק בגרסה שיצרה אותו, ולכן אינדקס קיים צריך dump או dumpless upgrade. [24][25][35]
• בגרסה 2.15.0: ‏DISABLE_PRESERVATION שונה ל-DISABLE_BROWSER; קובץ ‎.env ישן משאיר את השימור פעיל בלי אזהרה. ה-image נכתב מחדש (כ-1.5 GB במקום 3 GB, כ-350 MB במנוחה). [13][17][26][27]
• בגרסה 2.0.0: ‏NEXTAUTH_URL חייב להסתיים ב-‎/api/v1/auth, ו-instances שמגיעים מ-v1 מריצים סקריפט migration חד-פעמי. [18]

מגבלות

• השימור מריץ Chromium ‏headless בתוך הקונטיינר של האפליקציה, 5 קישורים לאצווה ועד 5 דקות לעמוד. בשרת קטן הגדירו ARCHIVE_TAKE_COUNT=1, כבו את הפורמטים PDF ו-Webpage, או הגדירו DISABLE_BROWSER=true לסימניות בלבד. [12][13]
• השרת ניגש לעמודים כמבקר אנונימי: מסכי התחברות, חומות תשלום וחסימות בוטים נשמרים בעותק, וכתובות ברשת פרטית נחסמות כברירת מחדל. שמרו עמודים כאלה מהדפדפן שלכם עם התוסף או עם SingleFile. [12][19]
• כל בעלים של אוסף יכול לשמור עד 30,000 קישורים (MAX_LINKS_PER_USER), העלאות מוגבלות ל-10 MB וכל פורמט שנוצר ל-100 MB. הקבצים נשארים בדיסק של השרת; אחסון תואם S3 דורש הגדרות SPACES_* שהתבנית לא כותבת. [12][19]

אבטחה

• הגישו את Linkwarden ב-HTTPS דרך reverse proxy והגדירו את NEXTAUTH_URL ל-https://<domain>/api/v1/auth; ההתחברות וה-callbacks של OAuth נבנים ממנו. [12][15]
• ההרשמה פתוחה כברירת מחדל, והחשבון הראשון הופך למנהל. צרו אותו מיד אחרי ההפעלה הראשונה, ואז הגדירו NEXT_PUBLIC_DISABLE_REGISTRATION=true; המנהל עדיין יכול להוסיף משתמשים. [12][20]
• ה-Chromium של השימור פותח עמודים לא מהימנים בלי ה-sandbox שלו (ברירת המחדל של Playwright) וכ-root, כך שהקונטיינר הוא הגבול היחיד. התבנית לא מעניקה הרשאות נוספות; התיעוד מראה איך להריץ כמשתמש 1000:1000. [14][21][32]
• ‏HTML שנשמר מוגש מה-origin של האפליקציה עצמה, אלא אם NEXT_PUBLIC_USER_CONTENT_DOMAIN מפנה לדומיין שני. אם שומרים עמודים לא מהימנים, הוסיפו את הדומיין הזה ב-proxy כפי שהתיעוד מתאר. [16]

גיבוי

• גבו שלושה דברים יחד: ‏pg_dump של מסד הנתונים, ה-volume של data עם הקבצים השמורים, וה-.env ‏(NEXTAUTH_SECRET והסיסמאות). [17]
• שמרו גם את ה-volume של Meilisearch: ‏PostgreSQL רושם אילו קישורים כבר באינדקס, ולכן אינדקס ריק לא מתמלא מעצמו, והחיפוש בטקסט המלא יפספס קישורים ישנים. [8][22]

גרסה אחרונה

הגרסה האחרונה של הפרויקט

Linkwarden 2.16.3 [17][30]

הפרופיל נבדק מול

Linkwarden 2.16.3

הפרופיל נבדק מול הגרסה האחרונה.

נבדק ב-

14 באוק׳ 2026

מצב

נבדק ב-90 הימים האחרונים

איפה הגרסאות מתפרסמות

GitHub Releases

הגרסאות האחרונות של כל האפליקציות

גרסה

סטטוס הפרופיל

פורסם

נבדק מול גרסה

Linkwarden 2.16.3

גרסת הפרופיל

1.0.0

המספרים אומתו

14 באוק׳ 2026

גרסת הקטלוג

2026.10.10

מדיניות sizing

2026.10.0

קובץ Compose

לא אומת

הפרויקט וחלופות

האתר הרשמי

linkwarden.app

קוד מקור

github.com/linkwarden/linkwarden

חלופות

KarakeeplinkdingwallabagArchiveBox

מקורות

1. Docker Docs: Control startup order in Compose (pg_isready healthcheck, service_healthy) (תיעוד רשמי · נקרא 11 באוק׳ 2026)
2. linkwarden repository: docker-compose.yml at v2.16.3 (postgres:16-alpine, linkwarden:latest on 3000 with ./data:/data/data, getmeili/meilisearch:v1.13.3; env_file .env for all three) (Compose רשמי · נקרא 14 באוק׳ 2026)
3. linkwarden repository: .env.sample at v2.16.3 (NEXTAUTH_URL, NEXTAUTH_SECRET, POSTGRES_PASSWORD, MEILI_HOST, MEILI_MASTER_KEY, NEXT_PUBLIC_DISABLE_REGISTRATION) (Compose רשמי · נקרא 14 באוק׳ 2026)
4. linkwarden repository: Dockerfile at v2.16.3 (node:22.23-bookworm-slim, no USER, Chromium headless shell, prisma migrate deploy at start, HEALTHCHECK curl http://127.0.0.1:3000/, EXPOSE 3000) (מאגר רשמי · נקרא 14 באוק׳ 2026)
5. linkwarden repository: packages/filesystem/createFolder.ts at v2.16.3 (files under STORAGE_FOLDER, default 'data', two levels above apps/web: /data/data) (מאגר רשמי · נקרא 14 באוק׳ 2026)
6. linkwarden repository: packages/lib/meilisearchClient.ts at v2.16.3 (client only when MEILI_MASTER_KEY is set; MEILI_HOST default http://meilisearch:7700) (מאגר רשמי · נקרא 14 באוק׳ 2026)
7. meilisearch repository: Dockerfile at v1.13.3 (alpine:3.20 with curl, no USER, WORKDIR /meili_data, EXPOSE 7700, no HEALTHCHECK) (מאגר רשמי · נקרא 14 באוק׳ 2026)
8. Meilisearch Docs: Docker (data in /meili_data, MEILI_MASTER_KEY, dumps in /meili_data/dumps) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
9. Meilisearch Docs: Health (GET /health returns {"status": "available"}) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
10. Meilisearch Docs: Basic security (the master key must be at least 16 bytes) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
11. Linkwarden Docs: Setup (4 GB memory comfortable, any 2-core machine, ~1.5 GB image plus data; required NEXTAUTH_SECRET, POSTGRES_PASSWORD, MEILI_MASTER_KEY; Postgres 16 and up) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
12. Linkwarden Docs: Environment variables (ARCHIVE_TAKE_COUNT 5, BROWSER_TIMEOUT 5 min, *_MAX_BUFFER 100 MB, MAX_LINKS_PER_USER 30000, ALLOW_PRIVATE_NETWORK_ACCESS false) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
13. Linkwarden Docs: Running a lighter setup (idle ~350 MB since 2.15, image ~1.5 GB, Meilisearch optional, DISABLE_BROWSER, ARCHIVE_TAKE_COUNT=1, textContent is the main DB growth) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
14. Linkwarden Docs: Running as a non-root user (containers run as root by default; user: 1000:1000 with pre-owned data folders) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
15. Linkwarden Docs: Reverse proxy (NGINX with TLS, WebSocket upgrade headers, NEXTAUTH_URL=https://<host>/api/v1/auth) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
16. Linkwarden Docs: User content domain (serve preserved HTML from a separate origin via NEXT_PUBLIC_USER_CONTENT_DOMAIN) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
17. Linkwarden Docs: How to upgrade (back up with pg_dump and tar of data and .env, pull and up -d, migrations at start, pin a tag to roll back; DISABLE_PRESERVATION is now DISABLE_BROWSER) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
18. Linkwarden Docs: Upgrading to Linkwarden v2 (NEXTAUTH_URL must end in /api/v1/auth; migration script) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
19. Linkwarden Docs: Preservation (readable, webpage, screenshot and PDF formats on by default; queued worker; files stored per collection on disk or S3) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
20. linkwarden repository: postUser.ts at v2.16.3 (with NEXT_PUBLIC_DISABLE_REGISTRATION=true only the admin, user NEXT_PUBLIC_ADMIN or 1, can create users) (מאגר רשמי · נקרא 14 באוק׳ 2026)
21. linkwarden repository: apps/worker/lib/browser.ts at v2.16.3 (chromium.launch with Playwright's default options, or connectOverCDP with PLAYWRIGHT_WS_URL) (מאגר רשמי · נקרא 14 באוק׳ 2026)
22. linkwarden repository: apps/worker/workers/linkIndexing.ts at v2.16.3 (whole link rows sent to the Meilisearch index 'links' in batches; indexVersion kept in PostgreSQL) (מאגר רשמי · נקרא 14 באוק׳ 2026)
23. linkwarden repository: packages/prisma/package.json at v2.16.3 (Prisma 6) (מאגר רשמי · נקרא 14 באוק׳ 2026)
24. linkwarden repository: docker-compose.yml at v2.16.0 (getmeili/meilisearch:v1.12.8) (Compose רשמי · נקרא 14 באוק׳ 2026)
25. linkwarden repository: docker-compose.yml at v2.16.1 (getmeili/meilisearch:v1.13.3) (Compose רשמי · נקרא 14 באוק׳ 2026)
26. linkwarden repository: .env.sample at v2.14.0 (DISABLE_PRESERVATION) (מאגר רשמי · נקרא 14 באוק׳ 2026)
27. linkwarden repository: .env.sample at v2.15.0 (DISABLE_BROWSER replaces it) (מאגר רשמי · נקרא 14 באוק׳ 2026)
28. linkwarden repository: LICENSE.md at v2.16.3 (GNU AGPL v3) (מאגר רשמי · נקרא 14 באוק׳ 2026)
29. GHCR manifest of ghcr.io/linkwarden/linkwarden:v2.16.3 (linux/amd64): 567,246,590 B compressed; layers decompressed and counted: 1,713,869,312 B (מדידה · נקרא 14 באוק׳ 2026)
30. GHCR tags of ghcr.io/linkwarden/linkwarden (newest release v2.16.3, built 2026-09-09 from git tag v2.16.3 = 474dd11) (מאגר רשמי · נקרא 14 באוק׳ 2026)
31. Linkwarden: Pricing (Linkwarden Cloud, hosted by the Linkwarden team; per-user plan) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
32. Playwright Docs: BrowserType.launch (chromiumSandbox defaults to false) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
33. Prisma Docs: Connection pool (Prisma 6 default pool size: physical CPUs × 2 + 1 per client) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
34. Meilisearch Docs: Storage (LMDB; 9.1 MB of raw JSON measured at 224 MB on disk and ~305 MB RAM; RAM-to-disk ~1/3 fine; disk use never shrinks) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
35. Meilisearch Docs: Update to the latest version (a database only works with the version that created it; dump or dumpless upgrade) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
36. Docker Hub: getmeili/meilisearch tag v1.13.3 (linux/amd64 95,776,018 B compressed) (מאגר רשמי · נקרא 14 באוק׳ 2026)
37. docker-library/postgres: 18/trixie Dockerfile (postgres uid/gid 999, VOLUME /var/lib/postgresql) (מאגר רשמי · נקרא 14 באוק׳ 2026)
38. docker-library/postgres: 18/trixie docker-entrypoint.sh (chown PGDATA, then gosu postgres) (מאגר רשמי · נקרא 14 באוק׳ 2026)
39. PostgreSQL 18 documentation: 19.4 Resource Consumption (תיעוד רשמי · נקרא 10 באוק׳ 2026)
40. PostgreSQL 18 documentation: 19.3 Connections and Authentication (תיעוד רשמי · נקרא 10 באוק׳ 2026)
41. PostgreSQL 18 documentation: 19.10 Vacuuming (autovacuum settings) (תיעוד רשמי · נקרא 10 באוק׳ 2026)
42. PostgreSQL 18 documentation: 19.5 Write Ahead Log (max_wal_size) (תיעוד רשמי · נקרא 10 באוק׳ 2026)
43. PostgreSQL 18 documentation: 51.2 How Connections Are Established (תיעוד רשמי · נקרא 10 באוק׳ 2026)
44. Docker Official Image postgres: documentation (docker-library/docs) (תיעוד רשמי · נקרא 10 באוק׳ 2026)
45. Docker Hub: library/postgres tag 18.6 (compressed image sizes) (מאגר רשמי · נקרא 10 באוק׳ 2026)