Language: he

Karakeep: התקנת ארכיון סימניות אישי ב-VPS

שמירת קישור היא פעולה פשוטה. למצוא אותו כעבור שישה חודשים קשה יותר — במיוחד אם הדף השתנה, נעלם או אבד בין מאות סימניות.

Karakeep שומר לא רק את ה-URL, אלא גם את תוכן הדף, התצוגה המקדימה, ההערות, התמונות וקובצי ה-PDF. אפשר לחפש בארכיון לפי טקסט, לארגן פריטים ברשימות ולתייג אותם אוטומטית בעזרת AI. הוא פועל ב-VPS שלכם, וחיבור מודל שפה הוא אפשרות בלבד.

להלן נסקור את היכולות של Karakeep, את דרישות השרת ואת ההתקנה ב-Ubuntu 24.04 באמצעות Docker Compose, HTTPS וגיבויים.

Karakeep בשבעה שלבים

1. צרו VPS של Linux והפנו אליו תת-דומיין כמו keep.example.com.
2. התקינו Docker Engine ו-Docker Compose.
3. הורידו את docker-compose.yml הרשמי.
4. צרו סודות והפעילו את Karakeep, את Chrome ואת Meilisearch.
5. סגרו את הפורט הפנימי 3000 והפעילו HTTPS דרך Caddy.
6. צרו את החשבון הראשון ולאחר מכן סגרו את הרישום הפתוח.
7. התקינו תוסף דפדפן או אפליקציה לנייד וייבאו את הסימניות שלכם.

אין צורך במפתח AI כדי להפעיל את השירות. גם בלעדיו שמירת דפים, רשימות, הערות, OCR וחיפוש טקסט מלא ימשיכו לעבוד. תגיות וסיכומים אוטומטיים לא ייווצרו.

מהו Karakeep?

Karakeep הוא יישום בקוד פתוח ובאירוח עצמי לשמירת קישורים, הערות טקסט, תמונות וקובצי PDF בספרייה אחת. שם הפרויקט בעבר היה Hoarder.

השם מגיע מהמילה הערבית karakeeb, המשמשת לדברים מפוזרים שנראים כמו בלגן אך עשויים להכיל ערך נסתר. זהו תיאור מדויק של אוסף סימניות טיפוסי: יש בו הרבה חומר שימושי, אך קשה למצוא את הפריט הנכון.

לאחר הוספת קישור, Karakeep מוריד את הכותרת והתיאור שלו, מחלץ טקסט קריא, יוצר תצוגה מקדימה ויכול לשמור עותק מקומי של הדף לפי הצורך.

תכונה	סימניות דפדפן	Karakeep
מה נשמר	URL וכותרת	טקסט, תצוגה מקדימה, הערות וקבצים מצורפים
חיפוש	לפי כותרת וכתובת	לפי תוכן, תגיות והערות
אם הדף נעלם	נשאר URL שבור	נשארים טקסט, צילום מסך או ארכיון מלא
ארגון	תיקיות	תגיות, רשימות ידניות ורשימות חכמות
גישה	בדפדפן	Web, תוספים, iOS ו-Android
שרת	פרופיל הדפדפן או שירות הענן שלו	ה-VPS או השרת הביתי שלכם

היכולות העיקריות של Karakeep

קישורים, הערות, תמונות וקובצי PDF

כל פריט יכול להיות קישור, הערת טקסט או קובץ שהועלה. OCR מחלץ טקסט מתמונות ומקובצי PDF, ולכן גם אותם אפשר לחפש. ניתן לצרף לפריט הערה, ציטוט או קובץ נוסף.

חיפוש בתוכן

Meilisearch מאנדקס טקסט שמור, הערות ומטא-נתונים. אין צורך לזכור את הכותרת המדויקת: מספיק ביטוי או נושא. כאשר מגדירים embeddings, זמין גם חיפוש סמנטי לפי משמעות.

רשימות חכמות ומשותפות

פריט יחיד יכול להשתייך לכמה רשימות בו-זמנית בלי ליצור כפילויות. רשימה יכולה להישאר פרטית, להיות משותפת דרך קישור או להיערך יחד עם משתמשים אחרים.

רשימה חכמה היא שאילתת חיפוש שמורה ומתעדכנת אוטומטית. לדוגמה, היא יכולה להציג את כל הפריטים שתויגו ב-ai ונוספו במהלך השבוע האחרון.

ארכוב דפים

כברירת מחדל, Karakeep שומר את הטקסט שחולץ ואת צילום המסך של החלק הנראה בדף. אפשר להפעיל בנוסף צילום של הדף המלא, PDF או ארכיון HTML עצמאי. כך הספרייה מוגנת מקישורים מתים, אך השימוש בדיסק גדל.

דפים שמאחורי אימות, הגנה מתקדמת נגד בוטים ויישומים אינטראקטיביים עלולים שלא להישמר במלואם. חומרים חשובים עדיף להעלות בנפרד כקובץ PDF או כקובץ אחר.

תיוג AI אופציונלי

Karakeep יכול ליצור תגיות וסיכומים קצרים באמצעות API חיצוני תואם OpenAI או מודל Ollama מקומי. גם בלי AI, היישום נשאר מנהל סימניות מלא.

מודל מקומי אינו שולח חומרים לספק חיצוני, אך הוא דורש הרבה יותר RAM. לכן Ollama מתארח לעיתים בנפרד ממופע Karakeep הראשי.

דרישות השרת של Karakeep

התיעוד הרשמי אינו מציין מינימום קבוע ל-CPU ול-RAM. התקנה מלאה כוללת שלושה קונטיינרים:

• Karakeep שומר את מסד הנתונים ומגיש את הממשק;
• Chrome ללא ממשק פותח דפים, מריץ JavaScript ומצלם צילומי מסך;
• Meilisearch מאנדקס את הספרייה.

תצורה מעשית למשתמש אחד ללא LLM מקומי:

• 2 vCPU;
• 2 GB RAM;
• SSD או NVMe בנפח 20–30 GB;
• Ubuntu 24.04 LTS;
• כתובת IP ציבורית ודומיין.

לכמה משתמשים, ייבוא גדול, הזנות RSS רבות וקובצי PDF, 4 GB RAM נוחים יותר. דרישות הדיסק תלויות במצב הארכוב: טקסט תופס מעט מקום, ואילו צילומי מסך מלאים, קובצי PDF וסרטונים יכולים להגדיל במהירות את הספרייה.

איך להתקין Karakeep ב-VPS

בדוגמה זו נעשה שימוש ב-Ubuntu 24.04 ובתת-הדומיין keep.example.com.

1. הגדירו DNS וחומת אש

צרו רשומת DNS מסוג A שמצביעה לכתובת ה-IP של השרת, ואז התחברו באמצעות SSH:

ssh root@SERVER_IP
apt update && apt upgrade -y

ufw allow OpenSSH
ufw allow 80/tcp
ufw allow 443/tcp
ufw --force enable

אל תסגרו את סשן ה-SSH הנוכחי עד שתוודאו שחיבור חדש עובד.

2. התקינו Docker

apt install -y ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
  -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc

tee /etc/apt/sources.list.d/docker.sources > /dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

apt update
apt install -y docker-ce docker-ce-cli containerd.io \
  docker-buildx-plugin docker-compose-plugin
docker compose version

3. הורידו את תצורת Karakeep

mkdir -p /opt/karakeep
cd /opt/karakeep

curl -fsSLo docker-compose.yml \
  https://raw.githubusercontent.com/karakeep-app/karakeep/main/docker/docker-compose.yml

צרו שני סודות שונים:

openssl rand -base64 36
openssl rand -base64 36 | tr -dc 'A-Za-z0-9'

צרו את /opt/karakeep/.env:

KARAKEEP_VERSION=release
NEXTAUTH_SECRET=INSERT_THE_FIRST_SECRET
MEILI_MASTER_KEY=INSERT_THE_SECOND_SECRET
NEXTAUTH_URL=https://keep.example.com
DISABLE_SIGNUPS=false
DB_WAL_MODE=true
RATE_LIMITING_ENABLED=true

אל תפרסמו את .env: הסוד הראשון חותם על אסימוני האימות, והשני מגן על Meilisearch.

4. סגרו את הפורט הפנימי

ב-docker-compose.yml, החליפו:

ports:
  - 3000:3000

ב:

ports:
  - 127.0.0.1:3000:3000

כך פורט 3000 לא יהיה נגיש ישירות מהאינטרנט.

5. הפעילו את הקונטיינרים

cd /opt/karakeep
docker compose up -d
docker compose ps

השירותים web, chrome ו-meilisearch אמורים לפעול. הציגו את הלוגים באמצעות:

docker compose logs --tail=200

6. הפעילו HTTPS

apt install -y caddy

cat > /etc/caddy/Caddyfile <<'EOF'
keep.example.com {
    reverse_proxy 127.0.0.1:3000
}
EOF

caddy validate --config /etc/caddy/Caddyfile
systemctl reload caddy

אם DNS מוגדר והפורטים 80 ו-443 פתוחים, Caddy יקבל תעודת TLS באופן אוטומטי. לאחר מכן פתחו את https://keep.example.com.

7. צרו מנהל וסגרו את הרישום

המשתמש הראשון שנרשם הופך אוטומטית למנהל. לאחר יצירת החשבון הגדירו את השורה הבאה ב-.env:

DISABLE_SIGNUPS=true

החילו את השינוי:

cd /opt/karakeep
docker compose up -d

המנהל עדיין יוכל ליצור חשבונות אחרים באופן ידני.

ייבוא נתונים, תוספים ואפליקציות לנייד

Karakeep מציע תוספים ל-Chrome, Firefox ו-Safari, וכן אפליקציות ל-iOS ול-Android. בטלפון אפשר לשלוח קישור לארכיון דרך תפריט השיתוף של המערכת.

אפשר לייבא סימניות קיימות מקובץ HTML רגיל של דפדפן, מ-Pocket, מ-Omnivore ומשירותים נתמכים אחרים. עדיף להוסיף ארכיון גדול במנות: השרת צריך לפתוח את הדפים, לחלץ טקסט, ליצור צילומי מסך ולבנות את אינדקס החיפוש.

איך להפעיל AI וארכוב של דפים מלאים

עבור OpenAI הוסיפו ל-.env:

OPENAI_API_KEY=YOUR_API_KEY

שירות תואם OpenAI אחר עשוי לדרוש גם OPENAI_BASE_URL. עבור מודל מקומי השתמשו ב-OLLAMA_BASE_URL עם כתובת נגישה מהקונטיינר.

הפעילו בנפרד עותק מקומי מלא של דף:

CRAWLER_FULL_PAGE_ARCHIVE=true

גם האפשרויות CRAWLER_FULL_PAGE_SCREENSHOT=true ו-CRAWLER_STORE_PDF=true זמינות. אל תפעילו כל מצב ללא צורך: הם מגדילים באופן ניכר את השימוש בדיסק. לאחר שינוי .env, הריצו docker compose up -d.

אבטחה, עדכונים וגיבויים

הסורק של Karakeep פותח כתובות שנשמרו על ידי המשתמש מתוך רשת השרת שלכם. לכן אל תשאירו את הרישום פתוח והעניקו גישה רק לאנשים מהימנים. הגנת SSRF בסיסית קיימת, אך עבור שירות ציבורי הפרויקט הרשמי ממליץ לבודד את הדפדפן או לנתב אותו דרך proxy מוגבל.

השתמשו גם ב-HTTPS ובסיסמאות חזקות, אל תחשפו את פורט 3000 ועדכנו את הקונטיינרים באופן קבוע:

cd /opt/karakeep
docker compose up --pull always -d

מסד הנתונים הראשי והחומרים השמורים נמצאים ב-volume של Docker בשם data. עצרו את הקונטיינרים לפני העתקתו:

mkdir -p /var/backups/karakeep
cd /opt/karakeep
docker compose stop

docker run --rm \
  -v karakeep_data:/source:ro \
  -v /var/backups/karakeep:/backup \
  alpine sh -c 'tar czf /backup/data-$(date +%F).tar.gz -C /source .'

cp .env docker-compose.yml /var/backups/karakeep/
docker compose start

השם karakeep_data מניח שתיקיית הפרויקט היא /opt/karakeep; אפשר לאמת זאת באמצעות docker volume ls. ניתן לבנות מחדש את אינדקס Meilisearch, אך בספרייה גדולה כדאי גם לגבות את ה-volume בשם karakeep_meilisearch.

שלחו את הארכיון מתוך /var/backups/karakeep לשרת אחר, NAS או אחסון אובייקטים. עותק באותו VPS אינו מגן מפני תקלה בדיסק או מחיקת המכונה הווירטואלית.

באיזה VPS לבחור עבור Karakeep

לספרייה אישית ללא Ollama מתאים Linux VPS עם 2 vCPU, 2 GB RAM ו-20–30 GB NVMe. לייבוא גדול, כמה משתמשים וארכוב מלא בחרו 4 GB RAM ודיסק גדול יותר.

אפשר להפעיל את Karakeep ב-VPS של tropic.host: כתובת IP קבועה מפשטת את הגדרת הדומיין, ואחסון NVMe שימושי עבור SQLite, אינדקס החיפוש וקבצים קטנים רבים. ניתן להגדיל את המשאבים כשהארכיון גדל.

תכננו את משאבי Ollama המקומי בנפרד: אפילו מודל שפה קטן עשוי לדרוש יותר זיכרון מכל מחסנית Karakeep הראשית.

סיכום

Karakeep הופך קישורים מפוזרים לספרייה אישית שאפשר לחפש בה. הוא שומר דפים, הערות, תמונות וקובצי PDF ותומך ב-OCR, רשימות, תוספים, אפליקציות לנייד ותיוג AI אופציונלי.

VPS קטן, Docker Compose, דומיין ו-HTTPS מספיקים כדי להתחיל. לאחר ההתקנה סגרו את הרישום, עקבו אחר השימוש בדיסק ושמרו גיבוי חיצוני.

FAQ

האם Karakeep חינמי?

הגרסה באירוח עצמי היא בקוד פתוח ואינה דורשת מנוי חובה. משלמים על ה-VPS, הדומיין, אחסון הגיבויים ו-API חיצוני של AI במקרה הצורך.

האם נדרש API key כדי ש-Karakeep יעבוד?

לא. שמירה ואינדוקס של חומרים, רשימות, הערות, OCR וחיפוש טקסט מלא עובדים גם בלי AI. מודל נדרש עבור תגיות אוטומטיות, סיכומים ופונקציות קשורות.

כמה RAM צריך Karakeep?

נקודת התחלה מעשית למשתמש אחד ללא Ollama היא 2 GB RAM. לייבואים גדולים, כמה משתמשים ועיבוד פעיל, 4 GB נוחים יותר.

האם אפשר לייבא סימניות מדפדפן או מ-Pocket?

כן. Karakeep תומך בקובץ HTML רגיל של סימניות דפדפן, ב-Pocket, ב-Omnivore ובכמה פורמטים נוספים. לאחר הייבוא Karakeep מעבד את הדפים ומוסיף אותם לחיפוש.

האם מאמר יישאר זמין אם האתר המקורי ייעלם?

Karakeep שומר טקסט שחולץ וצילום מסך, וכאשר הארכוב המלא מופעל גם עותק מקומי או PDF. דפים שמאחורי אימות ויישומי אינטרנט מורכבים עלולים להישמר רק באופן חלקי.