VPS-тегі Karakeep: іздеу және AI бар жеке бетбелгі мұрағаты

06.09.20266 мин оқу

Tropic

VPS-тегі Karakeep: іздеу және AI бар жеке бетбелгі мұрағаты

Language: kk

Karakeep: VPS-те жеке бетбелгі мұрағатын орнату

Сілтемені сақтау оңай. Бірақ алты айдан кейін оны табу қиынырақ — әсіресе бет өзгерсе, жоғалса немесе жүздеген бетбелгінің арасында көміліп қалса.

Karakeep тек URL-ді ғана емес, бет мазмұнын, алдын ала көріністі, жазбаларды, суреттер мен PDF файлдарын да сақтайды. Мұрағаттан мәтін бойынша іздеуге, элементтерді тізімдерге бөлуге және оларды AI көмегімен автоматты түрде белгілеуге болады. Ол жеке VPS-те жұмыс істейді, ал тіл моделін қосу міндетті емес.

Төменде Karakeep мүмкіндіктерін, сервер талаптарын және Ubuntu 24.04 жүйесіне Docker Compose, HTTPS және сақтық көшірмелер арқылы орнатуды қарастырамыз.

Karakeep жеті қадамда

Linux VPS жасап, keep.example.com сияқты ішкі доменді оған бағыттаңыз.
Docker Engine және Docker Compose орнатыңыз.
Ресми docker-compose.yml файлын жүктеңіз.
Құпия мәндерді жасап, Karakeep, Chrome және Meilisearch қызметтерін іске қосыңыз.
Ішкі 3000 портын жауып, Caddy арқылы HTTPS қосыңыз.
Бірінші есептік жазбаны жасаңыз да, ашық тіркелуді өшіріңіз.
Браузер кеңейтімін немесе мобильді қолданбаны орнатып, бетбелгілерді импорттаңыз.

Қызметті бастау үшін AI кілті қажет емес. Онсыз беттерді сақтау, тізімдер, жазбалар, OCR және толық мәтінді іздеу жұмыс істей береді. Автоматты тегтер мен қысқаша мазмұндар жасалмайды.

Karakeep деген не

Karakeep — сілтемелерді, мәтіндік жазбаларды, суреттер мен PDF файлдарын бір кітапханада сақтауға арналған ашық кодты, өзіңіз орналастыратын қолданба. Бұған дейін жоба Hoarder деп аталған.

Атауы шашылған, ретсіз көрінетін, бірақ жасырын құндылығы болуы мүмкін заттарды білдіретін арабтың karakeeb сөзінен шыққан. Бұл әдеттегі бетбелгі жинағын дәл сипаттайды: пайдалы материал көп, алайда керегін табу қиын.

Сілтеме қосылғаннан кейін Karakeep оның атауы мен сипаттамасын алады, оқылатын мәтінді шығарады, алдын ала көрініс жасайды және қажет болса беттің жергілікті көшірмесін сақтай алады.

Мүмкіндік	Браузер бетбелгілері	Karakeep
Не сақталады	URL және атау	Мәтін, алдын ала көрініс, жазбалар және тіркемелер
Іздеу	Атауы мен мекенжайы бойынша	Мазмұн, тегтер және жазбалар бойынша
Бет жоғалса	Бұзылған URL қалады	Мәтін, скриншот немесе толық мұрағат қалады
Ұйымдастыру	Қалталар	Тегтер, қолмен жасалған және ақылды тізімдер
Қолжетімділік	Браузерде	Веб, кеңейтімдер, iOS және Android
Сервер	Браузер профилі немесе оның бұлттық қызметі	Сіздің VPS немесе үй серверіңіз

Karakeep-тің негізгі мүмкіндіктері

Сілтемелер, жазбалар, суреттер және PDF

Әр элемент сілтеме, мәтіндік жазба немесе жүктелген файл болуы мүмкін. OCR суреттер мен PDF файлдарынан мәтін шығарады, сондықтан оларды да іздеуге болады. Элементке жазба, дәйексөз немесе қосымша файл тіркей аласыз.

Мазмұн бойынша іздеу

Meilisearch сақталған мәтінді, жазбаларды және метадеректерді индекстейді. Нақты атауды есте сақтаудың қажеті жоқ: тіркес немесе тақырыптың өзі жеткілікті. Embedding бапталған кезде мағына бойынша семантикалық іздеу де қолжетімді.

Ақылды және бірлескен тізімдер

Бір элементті қайталамай бірден бірнеше тізімге қосуға болады. Тізім жеке болып қала алады, сілтеме арқылы бөлісіледі немесе басқа пайдаланушылармен бірге өңделеді.

Ақылды тізім — автоматты түрде жаңаратын сақталған іздеу сұрауы. Мысалы, ол өткен аптада қосылған және ai тегі бар барлық элементті көрсете алады.

Беттерді мұрағаттау

Әдепкі бойынша Karakeep алынған мәтінді және беттің көрінетін бөлігінің скриншотын сақтайды. Қосымша түрде толық бет суретін, PDF немесе өзін-өзі қамтитын HTML мұрағатын қосуға болады. Бұл кітапхананы өлі сілтемелерден қорғайды, бірақ дискідегі қолданысты арттырады.

Аутентификациядан кейінгі беттер, күрделі ботқа қарсы қорғаныс және интерактивті қолданбалар толық сақталмауы мүмкін. Маңызды материалдарды PDF немесе файл ретінде бөлек жүктеген дұрыс.

Қосымша AI тегтері

Karakeep сыртқы OpenAI-үйлесімді API немесе жергілікті Ollama моделі арқылы тегтер мен қысқа мазмұндар жасай алады. AI болмаса да, қолданба толық функционалды бетбелгі менеджері болып қала береді.

Жергілікті модель материалдарды сыртқы провайдерге жібермейді, бірақ едәуір көп RAM талап етеді. Сондықтан Ollama негізгі Karakeep инстанциясынан бөлек орналастырылады.

Karakeep серверіне қойылатын талаптар

Ресми құжаттама CPU мен RAM үшін бекітілген минимумды көрсетпейді. Толық орнату үш контейнерден тұрады:

Karakeep дерекқорды сақтап, интерфейсті ұсынады;
бассыз Chrome беттерді ашады, JavaScript іске қосады және скриншоттар жасайды;
Meilisearch кітапхананы индекстейді.

Жергілікті LLM қолданбайтын бір пайдаланушыға арналған практикалық конфигурация:

2 vCPU;
2 GB RAM;
20–30 GB SSD немесе NVMe;
Ubuntu 24.04 LTS;
жария IP мекенжайы және домен.

Бірнеше пайдаланушы, үлкен импорт, көп RSS таспасы және PDF болғанда 4 GB RAM ыңғайлырақ. Диск талабы мұрағаттау режиміне байланысты: мәтін аз орын алады, ал толық скриншоттар, PDF және бейнелер кітапхананы тез үлкейтуі мүмкін.

Karakeep-ті VPS-ке қалай орнатуға болады

Бұл мысалда Ubuntu 24.04 және keep.example.com ішкі домені пайдаланылады.

1. DNS пен firewall-ды баптау

Сервердің IP мекенжайына бағытталған A DNS жазбасын жасаңыз, содан кейін 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 қолданбаларын ұсынады. Телефонда сілтемені жүйелік Share мәзірі арқылы мұрағатқа жіберуге болады.

Қолданыстағы бетбелгілерді стандартты браузердің 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 қорғанысы бар, бірақ жария қызмет үшін жоба браузерді оқшаулауды немесе шектеулі прокси арқылы бағыттауды ұсынады.

HTTPS қолданыңыз, мықты парольдер қойыңыз, 3000 портын ашпаңыз және контейнерлерді тұрақты жаңартыңыз:

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

Негізгі дерекқор мен сақталған материалдар data атты Docker volume ішінде орналасады. Оны көшіруден бұрын контейнерлерді тоқтатыңыз:

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 индексін қайта құруға болады, бірақ үлкен кітапхана үшін karakeep_meilisearch volume-інің сақтық көшірмесін жасау да пайдалы.

/var/backups/karakeep ішіндегі архивті басқа серверге, NAS-қа немесе объектілік сақтауға жіберіңіз. Бір VPS-тегі көшірме диск ақауынан немесе виртуалды машинаның жойылуынан қорғамайды.

Karakeep үшін қандай VPS таңдау керек

Ollama жоқ жеке кітапханаға 2 vCPU, 2 GB RAM және 20–30 GB NVMe бар Linux VPS жеткілікті. Үлкен импорт, бірнеше пайдаланушы және толық мұрағаттау үшін 4 GB RAM және үлкенірек диск таңдаңыз.

Karakeep-ті tropic.host VPS-інде іске қосуға болады: тұрақты IP мекенжайы домен баптауды жеңілдетеді, ал NVMe SQLite, іздеу индексі және көптеген шағын файлдар үшін пайдалы. Мұрағат өскенде ресурстарды көбейтуге болады.

Жергілікті Ollama ресурстарын бөлек жоспарлаңыз: тіпті шағын тіл моделі де негізгі Karakeep стегінің бәрінен көп жад қажет етуі мүмкін.

Қорытынды

Karakeep шашылған сілтемелерді іздеуге болатын жеке кітапханаға айналдырады. Ол беттерді, жазбаларды, суреттер мен PDF файлдарын сақтайды, OCR, тізімдер, кеңейтімдер, мобильді қолданбалар және қосымша AI тегтерін қолдайды.

Бастау үшін шағын VPS, Docker Compose, домен және HTTPS жеткілікті. Орнатқаннан кейін тіркелуді жабыңыз, дискі қолданысын бақылаңыз және сыртқы сақтық көшірмесін сақтаңыз.

FAQ

Karakeep тегін бе?

Өзіңіз орналастыратын нұсқасы ашық кодты және міндетті жазылымды қажет етпейді. VPS, домен, сақтық көшірме сақтау орны және қажет болса сыртқы AI API үшін төлейсіз.

Karakeep жұмыс істеуі үшін API кілті керек пе?

Жоқ. Материалдарды сақтау және индекстеу, тізімдер, жазбалар, OCR және толық мәтінді іздеу AI-сыз жұмыс істейді. Автоматты тегтер, қысқаша мазмұндар және байланысты мүмкіндіктер үшін модель қажет.

Karakeep-ке қанша RAM керек?

Ollama қолданбайтын бір пайдаланушы үшін практикалық бастама — 2 GB RAM. Үлкен импорт, бірнеше пайдаланушы және белсенді өңдеу үшін 4 GB ыңғайлырақ.

Браузерден немесе Pocket-тен бетбелгілерді импорттай аламын ба?

Иә. Karakeep стандартты браузер бетбелгілерінің HTML файлын, Pocket, Omnivore және тағы бірнеше форматты қолдайды. Импорттан кейін Karakeep беттерді өңдеп, оларды іздеуге қосады.

Түпнұсқа сайт жоғалса, мақала қолжетімді болып қала ма?

Karakeep алынған мәтін мен скриншотты, ал толық мұрағаттау қосылған кезде жергілікті көшірмені немесе PDF-ті сақтайды. Аутентификациясы бар беттер мен күрделі веб-қолданбалар тек ішінара сақталуы мүмкін.

Блогқа оралу