Karakeep kwenye VPS: hifadhi yako ya alamisho yenye utafutaji na AI

6/9/2026Kusoma kwa 7 min

Tropic

Karakeep kwenye VPS: hifadhi yako ya alamisho yenye utafutaji na AI

Language: sw

Karakeep: kusakinisha hifadhi binafsi ya alamisho kwenye VPS

Kuhifadhi kiungo ni rahisi. Kukipata baada ya miezi sita ni vigumu zaidi—hasa ikiwa ukurasa umebadilika, umetoweka au umepotea miongoni mwa mamia ya alamisho.

Karakeep huhifadhi si URL pekee, bali pia maudhui ya ukurasa, mwonekano wa awali, madokezo, picha na PDF. Unaweza kutafuta kwenye hifadhi kwa maandishi, kupanga vipengee kwenye orodha na kuvipa lebo kiotomatiki kwa AI. Huendesha kwenye VPS yako mwenyewe, na kuunganisha modeli ya lugha ni hiari.

Hapa tutapitia uwezo wa Karakeep, mahitaji ya seva na usakinishaji kwenye Ubuntu 24.04 kwa Docker Compose, HTTPS na nakala za ziada.

Karakeep kwa hatua saba

Unda VPS ya Linux na uelekeze subdomain kama keep.example.com kwake.
Sakinisha Docker Engine na Docker Compose.
Pakua docker-compose.yml rasmi.
Tengeneza siri na uanzishe Karakeep, Chrome na Meilisearch.
Funga porti ya ndani 3000 na uwashe HTTPS kupitia Caddy.
Unda akaunti ya kwanza, kisha uzime usajili wa wazi.
Sakinisha kiendelezi cha kivinjari au programu ya simu na uingize alamisho.

Huhitaji ufunguo wa AI ili kuanza huduma. Bila huo, kuhifadhi kurasa, orodha, madokezo, OCR na utafutaji wa maandishi kamili vitaendelea kufanya kazi. Lebo na muhtasari wa kiotomatiki hautatengenezwa.

Karakeep ni nini

Karakeep ni programu ya open-source na self-hosted ya kuhifadhi viungo, madokezo ya maandishi, picha na PDF katika maktaba moja. Hapo awali mradi uliitwa Hoarder.

Jina linatokana na neno la Kiarabu karakeeb, linalotumiwa kwa vitu vilivyotawanyika vinavyoonekana kama fujo lakini vinaweza kuwa na thamani iliyofichika. Hii inaeleza vizuri mkusanyiko wa kawaida wa alamisho: kuna nyenzo nyingi muhimu, lakini kupata kipengee sahihi ni vigumu.

Baada ya kuongeza kiungo, Karakeep hupata kichwa na maelezo yake, hutoa maandishi yanayoweza kusomeka, huunda mwonekano wa awali na inaweza kuhifadhi nakala ya ukurasa ndani ya nchi inapohitajika.

Kipengele	Alamisho za kivinjari	Karakeep
Kinachohifadhiwa	URL na kichwa	Maandishi, mwonekano, madokezo na viambatisho
Utafutaji	Kwa kichwa na anwani	Kwa maudhui, lebo na madokezo
Ukurasa ukitoweka	URL iliyovunjika hubaki	Maandishi, picha ya skrini au hifadhi kamili hubaki
Mpangilio	Folda	Lebo, orodha za mikono na orodha mahiri
Ufikiaji	Kwenye kivinjari	Wavuti, viendelezi, iOS na Android
Seva	Wasifu wa kivinjari au huduma yake ya wingu	VPS yako au seva ya nyumbani

Vipengele vikuu vya Karakeep

Viungo, madokezo, picha na PDF

Kila kipengee kinaweza kuwa kiungo, dokezo la maandishi au faili iliyopakiwa. OCR hutoa maandishi kutoka kwenye picha na PDF, hivyo nazo zinakuwa za kutafutwa. Unaweza kuambatisha dokezo, nukuu au faili nyingine kwenye kipengee.

Utafutaji wa maudhui

Meilisearch huweka maandishi yaliyohifadhiwa, madokezo na metadata kwenye index. Huhitaji kukumbuka kichwa kamili: kifungu au mada inatosha. Embeddings zikisanidiwa, utafutaji wa kisemantiki kwa maana pia hupatikana.

Orodha mahiri na za kushirikiana

Kipengee kimoja kinaweza kuwa kwenye orodha kadhaa kwa wakati mmoja bila kurudiwa. Orodha inaweza kuwa ya faragha, kushirikiwa kupitia kiungo au kuhaririwa pamoja na watumiaji wengine.

Orodha mahiri ni hoja ya utafutaji iliyohifadhiwa inayosasishwa kiotomatiki. Kwa mfano, inaweza kuonyesha vipengee vyote vilivyo na lebo ai vilivyoongezwa wiki iliyopita.

Kuhifadhi kurasa

Kwa chaguo-msingi, Karakeep huhifadhi maandishi yaliyotolewa na picha ya skrini ya sehemu inayoonekana ya ukurasa. Unaweza pia kuwasha picha ya ukurasa mzima, PDF au hifadhi ya HTML inayojitosheleza. Hii hulinda maktaba dhidi ya viungo vilivyokufa, lakini huongeza matumizi ya diski.

Kurasa zilizo nyuma ya uthibitishaji, ulinzi mkali wa anti-bot na programu shirikishi huenda zisihifadhiwe kikamilifu. Nyenzo muhimu ni bora zipakiwe kando kama PDF au faili.

Kuweka lebo kwa AI kwa hiari

Karakeep inaweza kutengeneza lebo na muhtasari mfupi kupitia API ya nje inayoendana na OpenAI au modeli ya ndani ya Ollama. Bila AI, programu hubaki meneja wa alamisho anayefanya kazi kikamilifu.

Modeli ya ndani haitumi nyenzo kwa mtoa huduma wa nje, lakini huhitaji RAM zaidi kwa kiasi kikubwa. Kwa sababu hii, Ollama mara nyingi huwekwa kwenye seva tofauti na instance kuu ya Karakeep.

Mahitaji ya seva ya Karakeep

Nyaraka rasmi hazitaja kiwango cha chini maalum cha CPU na RAM. Usakinishaji kamili una kontena tatu:

Karakeep huhifadhi database na kutoa interface;
Chrome isiyo na kichwa hufungua kurasa, huendesha JavaScript na kuchukua picha za skrini;
Meilisearch huweka maktaba kwenye index.

Usanidi wa vitendo kwa mtumiaji mmoja bila LLM ya ndani ni:

2 vCPU;
2 GB RAM;
20–30 GB SSD au NVMe;
Ubuntu 24.04 LTS;
anwani ya IP ya umma na domeni.

Kwa watumiaji kadhaa, import kubwa, milisho mingi ya RSS na PDF, 4 GB RAM huwa rahisi zaidi. Mahitaji ya diski hutegemea hali ya kuhifadhi: maandishi hutumia nafasi kidogo, huku picha kamili za skrini, PDF na video zikiongeza maktaba haraka.

Jinsi ya kusakinisha Karakeep kwenye VPS

Mfano huu unatumia Ubuntu 24.04 na subdomain keep.example.com.

1. Sanidi DNS na firewall

Unda rekodi ya DNS ya A inayoelekeza kwenye anwani ya IP ya seva, kisha unganisha kwa SSH:

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

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

Usifunge kikao cha sasa cha SSH hadi uthibitishe kuwa muunganisho mpya unafanya kazi.

2. Sakinisha 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. Pakua configuration ya 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

Tengeneza siri mbili tofauti:

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

Unda /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

Usichapishe .env: siri ya kwanza husaini tokeni za uthibitishaji, na ya pili hulinda Meilisearch.

4. Funga porti ya ndani

Kwenye docker-compose.yml, badilisha:

ports:
  - 3000:3000

kuwa:

ports:
  - 127.0.0.1:3000:3000

Hii huzuia porti 3000 kufikika moja kwa moja kutoka internet.

5. Anzisha kontena

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

Huduma za web, chrome na meilisearch zinapaswa kuwa zinafanya kazi. Tazama logi kwa:

docker compose logs --tail=200

6. Washa 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 ikiwa imesanidiwa na porti 80 na 443 ziko wazi, Caddy itapata cheti cha TLS kiotomatiki. Kisha fungua https://keep.example.com.

7. Unda msimamizi na funga usajili

Mtumiaji wa kwanza aliyesajiliwa huwa msimamizi kiotomatiki. Baada ya kuunda akaunti, weka yafuatayo kwenye .env:

DISABLE_SIGNUPS=true

Tumia mabadiliko:

cd /opt/karakeep
docker compose up -d

Msimamizi bado ataweza kuunda akaunti nyingine mwenyewe.

Kuingiza data, viendelezi na programu za simu

Karakeep ina viendelezi vya Chrome, Firefox na Safari, pamoja na programu za iOS na Android. Kwenye simu, kiungo kinaweza kutumwa kwenye hifadhi kupitia menyu ya mfumo ya Share.

Alamisho zilizopo zinaweza kuingizwa kutoka faili ya kawaida ya HTML ya kivinjari, Pocket, Omnivore na huduma nyingine zinazotumika. Ni bora kuongeza archive kubwa kwa mafungu: seva lazima ifungue kurasa, itoe maandishi, itengeneze picha za skrini na ijenge index ya utafutaji.

Jinsi ya kuwasha AI na hifadhi ya ukurasa mzima

Kwa OpenAI, ongeza yafuatayo kwenye .env:

OPENAI_API_KEY=YOUR_API_KEY

Huduma nyingine inayoendana na OpenAI inaweza kuhitaji pia OPENAI_BASE_URL. Kwa modeli ya ndani, tumia OLLAMA_BASE_URL yenye anwani inayofikika kutoka kwenye kontena.

Washa nakala kamili ya ndani ya ukurasa kando:

CRAWLER_FULL_PAGE_ARCHIVE=true

Chaguo CRAWLER_FULL_PAGE_SCREENSHOT=true na CRAWLER_STORE_PDF=true pia yanapatikana. Usiwashe kila hali bila sababu: zitaongeza sana matumizi ya diski. Baada ya kubadilisha .env, endesha docker compose up -d.

Usalama, masasisho na nakala za ziada

Crawler wa Karakeep hufungua anwani zilizohifadhiwa na mtumiaji kutoka kwenye mtandao wa seva yako. Kwa hiyo, usiache usajili wazi na wape watu unaowaamini pekee ufikiaji. Ulinzi wa msingi wa SSRF upo, lakini kwa huduma ya umma mradi rasmi unapendekeza kutenga kivinjari au kukipitisha kwenye proxy yenye vikwazo.

Tumia pia HTTPS na manenosiri thabiti, usifichue porti 3000, na sasisha kontena mara kwa mara:

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

Database kuu na nyenzo zilizohifadhiwa ziko kwenye Docker volume yenye jina data. Simamisha kontena kabla ya kuinakili:

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

Jina karakeep_data linadhani kuwa saraka ya mradi ni /opt/karakeep; unaweza kulithibitisha kwa docker volume ls. Index ya Meilisearch inaweza kujengwa upya, lakini kwa maktaba kubwa ni muhimu pia kuhifadhi volume ya karakeep_meilisearch.

Tuma archive kutoka /var/backups/karakeep kwenye seva nyingine, NAS au object storage. Nakala iliyo kwenye VPS hiyo hiyo hailindi dhidi ya kuharibika kwa diski au kufutwa kwa mashine pepe.

Uchague VPS gani kwa Karakeep

Kwa maktaba binafsi bila Ollama, Linux VPS yenye 2 vCPU, 2 GB RAM na 20–30 GB NVMe inafaa. Kwa import kubwa, watumiaji kadhaa na hifadhi kamili, chagua 4 GB RAM na diski kubwa zaidi.

Karakeep inaweza kuendeshwa kwenye VPS ya tropic.host: IP ya kudumu hurahisisha usanidi wa domeni, huku hifadhi ya NVMe ikiwa muhimu kwa SQLite, index ya utafutaji na faili nyingi ndogo. Rasilimali zinaweza kuongezwa archive inapokua.

Panga rasilimali za Ollama ya ndani kando: hata modeli ndogo ya lugha inaweza kuhitaji kumbukumbu zaidi kuliko stack nzima kuu ya Karakeep.

Hitimisho

Karakeep hugeuza viungo vilivyotawanyika kuwa maktaba binafsi inayoweza kutafutwa. Huhifadhi kurasa, madokezo, picha na PDF, na inasaidia OCR, orodha, viendelezi, programu za simu na uwekaji lebo wa AI kwa hiari.

VPS ndogo, Docker Compose, domeni na HTTPS vinatosha kuanza. Baada ya usakinishaji, funga usajili, fuatilia matumizi ya diski na weka nakala ya nje.

FAQ

Je, Karakeep ni bure?

Toleo la self-hosted ni open source na halihitaji subscription ya lazima. Unalipia VPS, domeni, hifadhi ya backup na, ikihitajika, API ya nje ya AI.

Je, ufunguo wa API unahitajika ili Karakeep ifanye kazi?

Hapana. Kuhifadhi na kuweka index ya nyenzo, orodha, madokezo, OCR na utafutaji wa maandishi kamili hufanya kazi bila AI. Modeli inahitajika kwa lebo, muhtasari na vipengele vinavyohusiana vya kiotomatiki.

Karakeep inahitaji RAM kiasi gani?

Kwa mtumiaji mmoja bila Ollama, 2 GB RAM ni mwanzo unaofaa. Kwa import kubwa, watumiaji kadhaa na uchakataji hai, 4 GB ni rahisi zaidi.

Je, naweza kuingiza alamisho kutoka kivinjari au Pocket?

Ndiyo. Karakeep inasaidia faili ya kawaida ya HTML ya alamisho, Pocket, Omnivore na miundo mingine kadhaa. Baada ya import, Karakeep huchakata kurasa na kuziongeza kwenye utafutaji.

Je, makala itabaki ikiwa tovuti ya awali itatoweka?

Karakeep huhifadhi maandishi yaliyotolewa na picha ya skrini, na hifadhi kamili ikiwa imewashwa huhifadhi nakala ya ndani au PDF. Kurasa zilizo nyuma ya uthibitishaji na programu changamano za wavuti zinaweza kuhifadhiwa kwa sehemu tu.

Rudi kwenye Blogu