اگر از آن دسته افرادی هستید که روزانه دهها لینک، مقاله، اسکرینشات و یادداشت مفید را در گوشی و لپتاپ خود ذخیره میکنید، قطعاً میدانید که پیدا کردن یک مطلب خاص در میان این همه محتوای پراکنده چقدر میتواند زمانبر و آزاردهنده باشد. بوکمارکهای ساده مرورگر معمولاً بعد از چند ماه به یک لیست بههمریخته و غیرقابل جستوجو تبدیل میشوند. اینجاست که ابزارهای Self-Hosted مثل Karakeep وارد میدان میشوند تا به شما کمک کنند یک آرشیو شخصی، قابل جستوجو و کاملاً تحت کنترل خودتان داشته باشید.
Karakeep دقیقاً چه کاری انجام میدهد؟
Karakeep (که قبلاً با نام Hoarder شناخته میشد) یک سامانه متنباز برای ذخیرهسازی، آرشیو و مدیریت انواع محتواست. برخلاف بوکمارکهای معمولی، Karakeep فقط لینک را ذخیره نمیکند؛ بلکه محتوای صفحه را کرال میکند، اسکرینشات میگیرد و حتی متن داخل تصاویر را استخراج میکند تا بعداً بتوانید بهراحتی پیدایش کنید.
این ابزار برای نگهداری موارد زیر بسیار کاربردی است:
🔹 لینک مقالات و صفحات وب مفید
🔹 یادداشتهای شخصی و متنهای کوتاه
🔹 تصاویر، اسکرینشاتها و منابع طراحی
🔹 مطالبی که میخواهید بعداً مطالعه کنید
🔹 محتوای ذخیرهشده از مرورگر و موبایل
نکتهای که Karakeep را از رقبایش متمایز میکند، ترکیب جستوجوی تماممتن (با Meilisearch) و برچسبگذاری خودکار با هوش مصنوعی است. یعنی وقتی یک لینک را ذخیره میکنید، سیستم خودش تشخیص میدهد که موضوعش درباره چه چیزی است و برچسبهای مناسب را میچسباند.
چرا Karakeep را روی سرور مجازی خودتان نصب کنید؟
استفاده از نسخه Self-Hosted چند مزیت غیرقابلانکار دارد:
کنترل کامل روی دادهها: تمام آرشیو شما روی سروری قرار میگیرد که خودتان مدیریت میکنید. هیچ شرکتی به اطلاعات شخصی و علاقهمندیهای شما دسترسی ندارد.
دسترسی از هر دستگاهی: بعد از اتصال دامنه و فعالسازی HTTPS، میتوانید از کامپیوتر، لپتاپ یا گوشی موبایل به آرشیو خودتان دسترسی داشته باشید. Karakeep اپلیکیشن موبایل اختصاصی هم دارد.
جستوجوی اختصاصی و سریع: بهجای گشتن در میان صدها بوکمارک مرورگر، از Meilisearch برای پیدا کردن هر چیزی در چند میلیثانیه استفاده میکنید.
قابلیتهای هوش مصنوعی: میتوانید از OpenAI یا Ollama برای برچسبگذاری خودکار، خلاصهسازی و حتی جستوجوی معنایی استفاده کنید.
پیشنیازهای سختافزاری و نرمافزاری
برای یک تجربه روان، پیشنهاد میکنیم حداقل مشخصات زیر را در نظر بگیرید:
🔹 سیستمعامل: Ubuntu 22.04 یا جدیدتر (Debian 12 و 13 هم پشتیبانی میشوند)
🔹 پردازنده: حداقل ۲ هسته CPU
🔹 حافظه رم: ۲ تا ۴ گیگابایت (اگر قصد استفاده از Ollama برای هوش مصنوعی محلی را دارید، به ۸ تا ۱۶ گیگابایت نیاز خواهید داشت)
🔹 فضای دیسک: حداقل ۲۰ گیگابایت (بستگی به حجم تصاویر و صفحات آرشیوشده دارد)
🔹 دسترسی: SSH و یک IP ثابت
🔹 دامنه: برای استفاده دائمی و فعالسازی HTTPS توصیه میشود
اگر قصد دارید حجم زیادی تصویر و صفحه وب آرشیو کنید، فضای دیسک بیشتری در نظر بگیرید. هر ۱۰۰۰ بوکمارک بهطور میانگین بین ۲۰۰ مگابایت تا ۵ گیگابایت فضا اشغال میکند (بسته به نوع آرشیو).
مرحله به مرحله: نصب Karakeep با Docker Compose
روش رسمی و پیشنهادی نصب Karakeep استفاده از Docker Compose است. در این روش، سه سرویس اصلی با هم راهاندازی میشوند:
🔹 Karakeep: اپلیکیشن اصلی وب
🔹 Meilisearch: موتور جستوجوی تماممتن
🔹 Chrome: مرورگر Headless برای کرال و آرشیو صفحات
مرحله اول: اتصال به سرور و بهروزرسانی
با SSH به سرور خود متصل شوید و سیستم را بهروز کنید:
apt update && apt upgrade -y
apt install -y curl wget git nano opensslمرحله دوم: نصب Docker
اگر Docker روی سرور نصب نیست، با اسکریپت رسمی آن را نصب کنید:
curl -fsSL https://get.docker.com | shسپس وضعیت Docker و نسخه Compose را بررسی کنید:
docker --version
docker compose versionمرحله سوم: ساخت پوشه پروژه
mkdir -p /opt/karakeep
cd /opt/karakeepمرحله چهارم: دریافت فایل Docker Compose
فایل رسمی Compose را دانلود کنید:
wget https://raw.githubusercontent.com/karakeep-app/karakeep/main/docker/docker-compose.ymlمرحله پنجم: ساخت فایل تنظیمات .env
فایل .env را ایجاد کنید و مقادیر امنیتی را با رشتههای تصادفی جایگزین نمایید:
nano .envمحتوای حداقلی فایل به این شکل است:
KARAKEEP_VERSION=release
NEXTAUTH_SECRET=YOUR_RANDOM_SECRET
MEILI_MASTER_KEY=YOUR_RANDOM_MEILI_KEY
NEXTAUTH_URL=http://YOUR_SERVER_IP:3000برای تولید رشتههای تصادفی امن، از دستور زیر استفاده کنید:
openssl rand -base64 36⚠️ نکته مهم: هر بار که فایل .env را تغییر میدهید، باید Stack را مجدداً اجرا کنید.
مرحله ششم: اجرای Karakeep
اکنون سرویسها را راهاندازی کنید:
docker compose up -dبرای بررسی وضعیت کانتینرها:
docker compose psمرحله هفتم: ورود به پنل Karakeep
اگر IP سرور شما مثلاً 1.2.3.4 باشد، در مرورگر وارد آدرس زیر شوید:
http://1.2.3.4:3000در صفحه ورود، اولین حساب کاربری خود را ایجاد کنید. بعد از ثبتنام، میتوانید ثبتنامهای بعدی را با تنظیم DISABLE_SIGNUPS=true غیرفعال کنید.
📌 آیا برای ساخت آرشیو شخصی به یک سرور مجازی قدرتمند و پایدار نیاز دارید؟
Karakeep برای عملکرد روان، به منابع پایدار CPU و رم نیاز دارد. اگر قصد دارید آرشیو خود را روی یک سرور مجازی ایران با پینگ پایین و آپتایم بالا راهاندازی کنید، تیم ایرانیکاسرور میتواند به شما کمک کند.
🔹 منابع اختصاصی CPU و RAM برای اجرای همزمان چند سرویس
🔹 دیسک NVMe پرسرعت برای آرشیو تصاویر و صفحات وب
🔹 پشتیبانی فنی ۲۴/۷ برای راهاندازی Docker و رفع خطاها
📞 تماس با پشتیبانی: 021-91302460 | ایرانیکاسرور
اتصال Karakeep به دامنه و فعالسازی HTTPS
استفاده از IP و پورت 3000 برای آزمایش خوب است، اما برای استفاده دائمی باید Karakeep را پشت یک Reverse Proxy مثل Nginx قرار دهید.
نصب و کانفیگ Nginx
apt install nginx -y
nano /etc/nginx/sites-available/karakeepمحتوای کانفیگ:
server {
listen 80;
server_name keep.example.com;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
سپس سایت را فعال کرده و Nginx را ریلود کنید:
ln -s /etc/nginx/sites-available/karakeep /etc/nginx/sites-enabled/karakeep
nginx -t
systemctl reload nginxسپس مقدار NEXTAUTH_URL را در فایل .env به آدرس دامنه خود تغییر دهید و Stack را دوباره اجرا کنید:
NEXTAUTH_URL=https://keep.example.comفعالسازی SSL با Certbot
apt install certbot python3-certbot-nginx -y
certbot --nginx -d keep.example.comبعد از این مرحله، Karakeep شما از طریق https://keep.example.com در دسترس خواهد بود.
فعالسازی هوش مصنوعی برای برچسبگذاری خودکار
Karakeep میتواند از OpenAI یا Ollama برای برچسبگذاری خودکار استفاده کند. برای استفاده از OpenAI، کافیست API Key را در فایل .env قرار دهید:
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxاستفاده از Ollama برای هوش مصنوعی محلی
اگر میخواهید مدل هوش مصنوعی را روی زیرساخت خودتان اجرا کنید، Karakeep از Ollama پشتیبانی میکند:
OLLAMA_BASE_URL=http://ollama:11434
INFERENCE_TEXT_MODEL=llama3.1
INFERENCE_IMAGE_MODEL=llava⚠️ خطای رایج: هرگز از http://localhost:11434 داخل کانتینر Karakeep استفاده نکنید، چون localhost داخل کانتینر به خود همان کانتینر اشاره میکند، نه به سرویس Ollama. باید از آدرس شبکه Docker استفاده کنید.
مقایسه Karakeep با سایر ابزارهای مدیریت بوکمارک
| ویژگی | Karakeep | Linkwarden | Linkding |
|---|---|---|---|
| برچسبگذاری خودکار AI | ✅ دارد | ❌ ندارد | ❌ ندارد |
| جستوجوی تماممتن | ✅ Meilisearch | ✅ PostgreSQL FTS | ✅ ساده |
| آرشیو اسکرینشات + PDF | ✅ دارد | ✅ کامل | ❌ ندارد |
| اپلیکیشن موبایل | ✅ iOS + Android | ❌ PWA | ❌ وب |
| OCR تصاویر | ✅ Tesseract.js | ❌ ندارد | ❌ ندارد |
| پایگاه داده پیشفرض | SQLite (سبک) | PostgreSQL (اجباری) | SQLite |
| مصرف RAM (حداقل) | ~۴۰۰-۶۰۰ MB | ~۲۵۰-۴۰۰ MB | ~۸۰ MB |
جمعبندی مقایسه: اگر به دنبال یک ابزار سبک و ساده هستید، Linkding انتخاب بهتری است. اگر آرشیو کامل (اسکرینشات + PDF) و همکاری تیمی برایتان مهم است، Linkwarden را انتخاب کنید. اما اگر میخواهید هوش مصنوعی کار سازماندهی را برایتان انجام دهد و اپلیکیشن موبایل اختصاصی داشته باشید، Karakeep بهترین گزینه است.
رفع خطاهای رایج Karakeep
مشکل: پنل Karakeep باز نمیشود
ابتدا بررسی کنید که کانتینرها در حال اجرا باشند:
docker compose ps
docker compose logs -f webهمچنین بررسی کنید که پورت 3000 در Firewall مسدود نشده باشد. اگر از Nginx استفاده میکنید، بهتر است پورت 3000 را مستقیم روی اینترنت باز نکنید و دسترسی را از طریق Nginx و HTTPS انجام دهید.
مشکل: جستوجو (Search) کار نمیکند
وضعیت Meilisearch را بررسی کنید:
docker compose logs -f meilisearchمطمئن شوید که آدرس داخلی Meilisearch در Compose بهدرستی تنظیم شده است. مقدار پیشفرض در Docker Compose رسمی http://meilisearch:7700 است.
مشکل: کرال صفحات انجام نمیشود
وضعیت سرویس Chrome را بررسی کنید:
docker compose logs -f chromeمطمئن شوید که مقدار BROWSER_WEB_URL در Compose بهدرستی تنظیم شده باشد. مقدار صحیح http://chrome:9222 است.
مشکل: برچسبگذاری AI انجام نمیشود
لاگ سرویس اصلی را بررسی کنید:
docker compose logs -f webمطمئن شوید که متغیر OPENAI_API_KEY یا OLLAMA_BASE_URL در فایل .env بهدرستی تنظیم شده باشد. فراموش نکنید که بعد از تغییر .env، باید docker compose up -d را دوباره اجرا کنید.
بکاپگیری و بروزرسانی
برای بروزرسانی Karakeep، اگر از KARAKEEP_VERSION=release استفاده میکنید، دستور زیر را اجرا کنید:
docker compose up --pull always -d⚠️ هشدار مهم درباره Meilisearch: نسخه Meilisearch را بدون دلیل تغییر ندهید. تغییر نسخه نامناسب میتواند باعث ناسازگاری دیتابیس و از دست رفتن Index جستوجو شود.
برای بکاپ، ابتدا Volumeها را ببینید:
docker volume lsدادههای اصلی Karakeep در Volume مربوط به /data و دادههای Meilisearch در Volume جداگانه قرار دارند. بهتر است بکاپها را روی یک دیسک یا سرور جداگانه نگهداری کنید.
🛠 در راهاندازی Karakeep به مشکل خوردهاید؟
تیم فنی ایرانیکاسرور آماده است تا در تمام مراحل نصب، کانفیگ Docker، اتصال دامنه، فعالسازی SSL و رفع خطاهای Karakeep در کنار شما باشد. اگر نیاز به راهنمایی دارید یا میخواهید سرور خود را برای اجرای این سرویس بهینه کنید، با ما تماس بگیرید.
📞 تماس با پشتیبانی: 021-91302460 | ایرانیکاسرور
جمعبندی: آیا Karakeep برای شما مناسب است؟
Karakeep یک ابزار قدرتمند برای ساخت آرشیو شخصی است که ترکیبی از ذخیرهسازی لینک، یادداشت، تصویر و قابلیتهای هوش مصنوعی را در یک بسته ارائه میدهد. اگر جزو افرادی هستید که روزانه حجم زیادی محتوا ذخیره میکنید و نمیخواهید وقت خود را صرف برچسبگذاری دستی کنید، Karakeep میتواند یک انتخاب عالی باشد.
مهمترین نکات برای یک تجربه موفق:
🔹 از Meilisearch برای جستوجوی سریع و دقیق استفاده کنید
🔹 اگر به حریم خصوصی اهمیت میدهید، Ollama را برای هوش مصنوعی محلی راهاندازی کنید
🔹 حتماً HTTPS و رمزهای تصادفی قوی را فعال کنید
🔹 بکاپ منظم از Volumeهای Karakeep و Meilisearch تهیه کنید
🔹 فضای دیسک کافی برای آرشیو تصاویر و صفحات وب در نظر بگیرید
Karakeep را میتوانید روی یک سرور مجازی مناسب اجرا کنید و از هر دستگاهی به آرشیو شخصی خود دسترسی داشته باشید. با انتخاب سرور مناسب و منابع کافی، این ابزار میتواند به یک «مغز دوم» واقعی برای شما تبدیل شود.
دیدگاهها
0 دیدگاه برای این مطلب ثبت شده است.