SSD Nodes Learn Hosting plans →
الأدلة Matt Connorبقلم Matt Connor · آخر تحديث في 2026-11-20

كيف تستضيف Hister كمحرك بحث شخصي؟

ثبّت Hister على VPS وابحث في نص الصفحات التي زرتها وملفاتك، مع تثبيت ثنائي أو Docker، وTLS، وتسجيل دخول، ونقطة نهاية MCP.

ما هو Hister وما ليس عليه

Hister هو محرك بحث شخصي تستضيفه بنفسك. يفهرس النص الكامل للصفحات التي زرتها والملفات التي تحتفظ بها، ثم يتيح لك البحث في هذه المجموعة من خلال واجهة ويب أو عميل طرفية أو HTTP API أو مساعد ذكاء اصطناعي (artificial intelligence). يجيب Hister عن سؤال واحد: أين قرأت ذلك؟

يتعرف معظم القراء إلى هذه الفكرة من خلال SearXNG، لكن الأداتين مختلفتان. إذا كان الاسم الذي تعرفه هو Searx الأقدم، فإن هذا المشروع لم يعد قيد الصيانة، ويشير ملف README الخاص به الآن إلى Hister بوصفه مشروع مؤلفه الجديد. يظل Searx وSearXNG مشروعين منفصلين، وSearXNG هو الـfork الذي تجري صيانته، لذلك فهو الخيار المناسب لإنشاء مثيل metasearch جديد. SearXNG هو proxy للبحث الموحد. يرسل استعلامك إليه، ثم يطلب النتائج من محركات أخرى نيابةً عنك، ويعيدها إليك بعد إزالة التتبع. تعود ملكية الفهرس إلى تلك المحركات. أما Hister فينشئ فهرسه الخاص من المحتوى الذي تزوّده به: صفحات تلتقطها إضافة متصفح، وسجل تصفح مستورد، وعناوين URL يزحف إليها، وملفات في أدلة تحددها له. يوفّر لك مثيل SearXNG مستضاف ذاتياً وصولاً خاصاً إلى الويب العام. أما Hister فيوفّر البحث في ما قرأته أنت. تختلف وظيفتا الأداتين، لذلك من الطبيعي تشغيلهما معاً على خادم واحد. وإذا فعلت ذلك، فمن المفيد أن تعرف مقدار ما يخفيه SearXNG فعلياً من عمليات بحثك، لأنه يستبدل عنوان IP الخاص بك بعنوان خادمك لدى محركات البحث، بدلاً من إخفاء الاستعلامات نفسها.

Hister برنامج حر بموجب AGPLv3 (رخصة GNU Affero العمومية، الإصدار 3) أو أي إصدار أحدث. لا يجمع بيانات القياس عن بُعد ولا يحتاج إلى خدمة سحابية. يثبت هذا الدليل الإصدار v0.17.0، الذي كان الإصدار الحالي في 2026-07-28. وفي 2026-10-12 كان الإصدار الحالي هو v0.20.0. وفي 2026-10-29 كان الإصدار الحالي هو v0.21.0. وفي 2026-11-19 أصبح الإصدار الحالي هو v0.22.0، وهو أول إصدار بالاسم الجديد للمشروع، Nogon. كُتبت الأوامر أدناه للإصدار v0.17.0، وتميّز ميزات قليلة مذكورة هنا وصلت لاحقاً بالإصدار الذي أضافها. راجع صفحة الإصدارات لمعرفة الوسم الحالي قبل نسخ أي شيء، ثم ثبّت الوسم الذي تجده هناك.

يتطلب الترقية إلى v0.22.0 أكثر من استبدال رقم الإصدار أدناه. تستخدم التنزيلات الجديدة اسم الملف التنفيذي nogon، ويحل config create محل create-config، كما يحل user create وuser update محل create-user وupdate-user. أوقف الخادم وأنشئ نسخة احتياطية كاملة قبل الترقية، مع الإبقاء على مسارات البيانات الحالية وvolumes الحاويات. تتلقى عمليات تثبيت إضافة المتصفح الحالية إعادة التسمية عبر تحديثات المتجر، وتحتفظ بإعداداتها.

لماذا تستضيف Hister بنفسك على VPS

لا يكون الفهرس مفيداً إلا إذا كان كاملاً، ولا يكون كاملاً إلا إذا كان الخادم يعمل أثناء القراءة. يدخل الحاسوب المحمول في وضع السكون نصف اليوم. لذلك لا تصل إليه الصفحات التي تفتحها على هاتفك خلال تلك الفترة، ولا تبدأ عملية الاستيراد الليلية. يبقى VPS (خادم افتراضي خاص) قيد التشغيل، لذلك يضيف كل جهاز تملكه المحتوى إلى الفهرس نفسه، ويواصل الزاحف عمله أثناء نومك.

السبب الثاني هو الفصل. يؤدي ضبط user_handling: true في قسم app إلى منح كل حساب بيانات اعتماد ومجموعة مستندات خاصة بهما على instance واحدة. ويمكن لخادم واحد عندئذٍ استضافة حسابات أسرة أو فريق صغير، من دون أن يبحث أي شخص في محتوى قراءة شخص آخر.

السبب الثالث هو البنية التشغيلية. لدى VPS اسم مضيف عام وشهادة مسبقاً، وهذا ما تحتاج إليه إضافة المتصفح للوصول إلى الخادم من شبكة لا تتحكم بها. ويُستخدم الزوج نفسه في مواضع أخرى على الخادم، لأن openGym يسجّل مفتاح المرور الأول له مقابل اسم المضيف النشط في ذلك الوقت، ما يعني ضرورة حسم الاسم والشهادة قبل إنشاء الحساب الأول.

مسار التثبيت الأول: الملف الثنائي للإصدار

يوفّر Hister ملفاً ثنائياً واحداً لكل منصة. نزّله مع ملف checksums، وتحقّق منه قبل التثبيت.

cd /tmp
curl -LO https://github.com/asciimoo/hister/releases/download/v0.17.0/hister_0.17.0_linux_amd64
curl -LO https://github.com/asciimoo/hister/releases/download/v0.17.0/hister_0.17.0_checksums.txt
sha256sum --ignore-missing -c hister_0.17.0_checksums.txt

النتيجة السليمة هي السطر الوحيد hister_0.17.0_linux_amd64: OK. ويعني ظهور سطر FAILED أن التنزيل تالف أو عُدّل، لذا نزّله مرة أخرى بدلاً من تثبيته.

ثبّت الملف الثنائي، ثم أنشئ حساب نظام والمجلدات التي سيستخدمها.

sudo install -m 755 /tmp/hister_0.17.0_linux_amd64 /usr/local/bin/hister
sudo useradd --system --home-dir /var/lib/hister --shell /usr/sbin/nologin hister
sudo install -d -o hister -g hister -m 750 /var/lib/hister
sudo install -d -m 755 /etc/hister
sudo hister create-config /etc/hister/config.yml

ينشئ create-config ملف إعدادات افتراضياً، كما يثبت أن الملف الثنائي يعمل على هذا الجهاز. ويفشل التنزيل الخاص بالمعمارية الخاطئة في هذه النقطة تحديداً، مع ظهور cannot execute binary file: Exec format error.

عدّل الإعدادات القليلة المهمة. ويمكنك إبقاء بقية الملف المُنشأ كما هي.

app:
  directory: /var/lib/hister
  access_token: 'paste-a-long-random-string-here'
server:
  address: 127.0.0.1:4433
  base_url: https://hister.example.com

أنشئ الرمز باستخدام openssl rand -hex 32. يحتوي الملف الآن على بيانات اعتماد، لذا قيّد صلاحياته قبل بدء الخدمة.

sudo chown root:hister /etc/hister/config.yml
sudo chmod 640 /etc/hister/config.yml

شغّلها باستخدام systemd

اكتب /etc/systemd/system/hister.service:

[Unit]
Description=Hister personal search engine
After=network-online.target
Wants=network-online.target

[Service]
User=hister
Group=hister
Environment=HISTER_CONFIG=/etc/hister/config.yml
ExecStart=/usr/local/bin/hister listen
Restart=on-failure
NoNewPrivileges=yes
PrivateTmp=yes
ProtectSystem=strict
ProtectHome=yes
ReadWritePaths=/var/lib/hister

[Install]
WantedBy=multi-user.target

HISTER_CONFIG هو متغير البيئة الموثّق لمسار الإعدادات، لذلك لا تعتمد الوحدة على الدليل الرئيسي لحساب hister. يجعل ProtectSystem=strict نظام الملفات بأكمله للقراءة فقط بالنسبة إلى هذه الخدمة، ولذلك يجب أن يحدد ReadWritePaths دليل البيانات. يحجب ProtectHome=yes ‏/home عن الخدمة، لذلك سيظهر أي دليل تتم مراقبته ضمن /home فارغاً للفهرس. احذف هذا السطر إذا كنت تحتاج إلى فهرسة الملفات الموجودة هناك.

sudo systemctl daemon-reload
sudo systemctl enable --now hister
systemctl status hister --no-pager
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:4433/

أي رمز حالة HTTP يطبعه الأمر الأخير يعني أن العملية تستمع على المنفذ. يعني curl: (7) Failed to connect أنها لا تستمع، وسيبيّن journalctl -u hister -n 50 --no-pager السبب.

مسار التثبيت الثاني: Docker Compose

تُنشر الصورة في سجل الحاويات الخاص بـGitHub، مع وسم واحد لكل إصدار.

services:
  hister:
    image: ghcr.io/asciimoo/hister:v0.17.0
    container_name: hister
    user: '1000:1000'
    restart: unless-stopped
    environment:
      - HISTER__SERVER__ADDRESS=0.0.0.0:4433
      - HISTER__SERVER__BASE_URL=https://hister.example.com
      - HISTER__APP__ACCESS_TOKEN=${HISTER_ACCESS_TOKEN}
    volumes:
      - ./data:/hister/data
    ports:
      - 127.0.0.1:4433:4433

لكل مفتاح إعداد تجاوز بيئي بالصيغة HISTER__<SECTION>__<KEY>، ويُستخدم شرطان سفليان للفصل. لذلك لا يحتاج نشر الحاوية إلى تحميل ملف إعداد. احتفظ بـHISTER_ACCESS_TOKEN في ملف .env بجوار ملف compose. وإذا أردت تعديل ملف بدلاً من ذلك، يطبع docker run --rm ghcr.io/asciimoo/hister:v0.17.0 create-config > config.yml القيم الافتراضية.

من السهل الخطأ في السطرين أعلاه، ويستحق كلاهما الفهم.

يجب أن يكون العنوان داخل الحاوية 0.0.0.0:4433. لكل حاوية مساحة أسماء شبكة خاصة بها، لذلك لا يمكن الوصول إلى عملية مرتبطة بـ127.0.0.1 داخلها إلا من داخل تلك الحاوية، ولا يجد المنفذ المنشور أي خدمة يوجّه إليها الاتصالات.

يُكتب المنفذ المنشور بصيغة 127.0.0.1:4433:4433، وليس 4433:4433. ينشر Docker المنافذ بإضافة قواعد netfilter الخاصة به، وتُقيَّم هذه القواعد قبل قواعد ufw. لذلك يظل 4433:4433 عادي متاحاً من الإنترنت، حتى على خادم يعرض فيه ufw status أن المنفذ مغلق. يؤدي ربط جهة المضيف بـ127.0.0.1 إلى جعل الـreverse proxy وسيلة الدخول الوحيدة. وينطبق الفخ نفسه على كل حاوية على الخادم، بينما يشرح Docker Compose على VPS بقية التفاصيل.

يشغّل السطر user: '1000:1000' الحاوية بالمعرّف UID 1000 والمعرّف GID 1000، متجاوزاً القيم الافتراضية للصورة الرسمية v0.17.0، وهي UID وGID بالقيمة 65532. لذلك يجب أن يكون ./data قابلاً للكتابة بواسطة UID 1000 وGID 1000. إذا لم يكن الدليل موجوداً، فأنشئه باستخدام mkdir -p ./data؛ ويمنح sudo chown -R 1000:1000 ./data ذلك الحساب ملكية الدليل. على مضيف مفعّل فيه SELinux، استخدم ./data:/hister/data:Z كي يعيّن Docker تصنيفاً مناسباً. إذا لم تكن هذه الأرقام مألوفة، فاقرأ أولاً المعرّف UID وGID اللذان تكتب بهما الحاوية الملفات.

لماذا يُعدّ كشف فهرس البحث الشخصي أسوأ ما يمكنك فعله

يستمع Hister إلى 127.0.0.1:4433 افتراضياً، وهذا الإعداد الافتراضي مقصود. فكّر في محتوى الفهرس بعد شهر من الاستخدام: صفحات wiki الداخلية، والفواتير، وتذاكر الدعم التي فتحتها أثناء تسجيل الدخول، وصفحات إعادة تعيين كلمات المرور، والنص الكامل لكل ما قرأته أيضاً. توضّح وثائق المشروع ذلك مباشرة: "ينقل Hister سجل التصفح بالكامل، مع محتوى الصفحات، من الخادم وإليه."

لا تزال قاعدة بيانات كلمات المرور المسرّبة تحتاج إلى فكّ التجزئة. أما الفهرس الشخصي المسرّب فهو نص عادي وقابل للبحث مباشرة، ولذلك يتطلب عناية أكبر من التطبيق الصغير المستضاف ذاتياً الذي يشبهه.

تترتب على ذلك حقيقتان. لا يتطلب Hister مصادقة افتراضياً، ولذلك فإن Reverse Proxy وحده ينشر نسخة قابلة للبحث من ما قرأته لكل من يعرف اسم المضيف. كما تُخدَّم نقطة نهاية MCP افتراضياً على `/mcp`، ومن دون token يمكن لأي عميل يصل إليها إجراء بحث في الفهرس.

اضبط المصادقة قبل أن تغادر الخدمة localhost للمرة الأولى. يحتاج المستخدم الواحد إلى `app.access_token فقط، وهو secret مشترك ترسله إضافة المتصفح والعميل الطرفي وأي عميل MCP. ولعدة مستخدمين، اضبط user_handling: true` وأنشئ الحسابات:

sudo -u hister hister create-user alice --admin --config /etc/hister/config.yml

يطلب الأمر كلمة مرور يتراوح طولها بين 8 و72 بايتاً بترميز UTF-8. قد يشغل الحرف Unicode عدة بايتات، لذلك يمكن لأقل من ثمانية أحرف أن يستوفي الشرط. يحصل كل حساب على مستنداته الخاصة وعلى API token شخصي، ويمكن لمالكه إعادة إنشائه من صفحة الملف الشخصي أو باستخدام الخيار `--regen-token مع hister update-user`. يؤدي إنشاء token جديد إلى إبطال token السابق فوراً، لذلك يجب تحديث كل جهاز يستخدمه ذلك الحساب بعد ذلك.

اترك `app.public` دون تغيير إلا إذا كنت تقصد تفعيله. يتيح الوضع العام البحث دون مصادقة، ومعاينات الملفات، وخدمة الملفات، والبحث عبر MCP، مع استمرار حظر عمليات الكتابة والوصول إلى السجل والعمليات الإدارية.

Reverse proxy وTLS وجدار الحماية

لا يقدّم Hister خدمة HTTPS بنفسه، لذلك أنهِ TLS (أمان طبقة النقل) أمامه. يُعد Caddy أقصر مسار، لأنه يطلب الشهادات ويجددها تلقائياً عبر ACME (بيئة إدارة الشهادات تلقائياً).

hister.example.com {
    reverse_proxy 127.0.0.1:4433
}

أعِد تحميله باستخدام sudo systemctl reload caddy. في هذا الإعداد، يجب أن تشير سجلات DNS الخاصة بـ hister.example.com إلى هذا الخادم، سواء كانت سجل A لـIPv4 أو سجل AAAA لـIPv6 أو كليهما. يفعّل Caddy افتراضياً التحقق HTTP-01 على المنفذ 80 والتحقق TLS-ALPN-01 على المنفذ 443، لذلك لا يكون المنفذ 80 مطلوباً عندما ينجح التحقق عبر المنفذ 443. تتحقق Let's Encrypt عبر IPv6 وكذلك IPv4، وتحاول استخدام عنوان AAAA أولاً، لذلك قد يؤدي سجل AAAA قديم متبقٍ من خادم سابق إلى فشل التحقق حتى عندما يكون سجل A صحيحاً. عندما تكون إعدادات DNS خاطئة أو لا ينجح أي من التحديين، يعرض المتصفح خطأ TLS بدلاً من الصفحة، ويكرر سجل Caddy التحدي الفاشل.

ثم أغلق كل شيء آخر.

sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status

يُستبعد المنفذ 4433 من تلك القائمة عمداً. لا يُعد اسم المضيف العام الطريقة الوحيدة للدخول، إذ إن خدمة onion موجّهة إلى منفذ loopback نفسه تصل إلى فهرسك من أجهزتك أنت من دون سجل DNS أو فتح أي منفذ وارد على الإطلاق.

يجب أن يطابق server.base_url العنوان الذي تكتبه في المتصفح، بما في ذلك المخطط. يؤدي وجود بادئة مسار غير صحيحة في base_url إلى تعطيل روابط الأصول، فتظهر الواجهة بنص غير منسق وصور مفقودة. ويُستخدم عنوان URL نفسه في إضافة المتصفح.

ملء الفهرس

إضافة المتصفح هي أداة الجمع الرئيسية. ثبّتها من Mozilla Add-ons أو Chrome Web Store، وافتح صفحة خياراتها، واضبط عنوان الخادم على https://hister.example.com، ثم الصق رمز الوصول. أُضيف دعم الرموز إلى الإضافة في v0.18.0؛ أما إضافة v0.17.0 فتستخدم جلسة تسجيل الدخول إلى واجهة الويب بدلاً من ذلك. بعد ذلك تلتقط عنوان كل صفحة تزورها ونصها الكامل وHTML وfavicon، وترسلها إلى خادمك. يحدث الاستخراج من جهة العميل داخل المتصفح. لا تتصل الإضافة بأي جهة خارجية، والطلب الخارجي الوحيد الذي تجريه هو طلب favicon الخاص بالصفحة.

الاستخراج من جهة العميل هو ما يجعل الفهرس الخاص ممكناً. ترى الإضافة الصفحة كما تراها تماماً، بعد تسجيل الدخول وبعد اكتمال العرض، لذلك تُفهرس صفحة من wiki داخلي أو مقال مدفوع بطريقة صحيحة، ولا يحتاج خادمك إلى بيانات الاعتماد. ويعني ذلك أيضاً أن كل ما تعرضه يمكن أن يصبح مرشحاً للفهرسة، ولهذا تأتي قواعد التخطي قبل إضافة مزيد من المحتوى.

توجد قواعد التخطي في rules.json عند التثبيت لمستخدم واحد، أو لكل مستخدم في قاعدة البيانات. وتُعد علامة Rules في واجهة الويب أسهل طريقة لتعديلها. وهي تعبيرات نمطية بصيغة Go تُطابق عنوان URL الكامل:

^https://mail\.example\.com
^https://bank\.example\.com

نمط مثل ^mail.example.com لا يطابق أي شيء، لأن السلسلة التي يجري اختبارها تبدأ بـhttps://. ويفشل $ في النهاية عندما يبقى query string بعد التطبيع. لا تُزال إلا معاملات utm_*، لذلك يمكن لـ/login$ مطابقة https://example.com/login?utm_source=email، لكن ليس https://example.com/login?auth=1.

يُستورد السجل الموجود بقراءة قاعدة بيانات المتصفح نفسه، لذلك يجب تشغيل هذا الأمر على الجهاز الذي يحتوي على ملف تعريف المتصفح، أي على حاسوبك المحمول وليس على VPS. ثبّت الملف الثنائي نفسه هناك، ووجّهه إلى الخادم:

export HISTER_TOKEN='your-access-token'
hister import browser firefox -u https://hister.example.com -t "$HISTER_TOKEN"

تُنفّذ عملية الاستيراد كمهمة قابلة للاستئناف باسم browser-import-YYYY-MM-DD، لذلك يمكنك إيقافها وتشغيلها مرة أخرى لاحقاً. وتُستورد خدمات الإشارات المرجعية بالطريقة نفسها. يدعم v0.17.0 خدمات Linkwarden وKarakeep وShaarli، وأضاف v0.18.0 خدمات Linkding وReadeck وWallabag، وأضاف v0.20.0 خدمة Raindrop.io. وعند تكرار الاستيراد من Linkwarden أو Karakeep أو Shaarli أو Linkding أو Readeck أو Wallabag، تُجلب العناصر الأحدث من عملية الاستيراد السابقة فقط.

تُفهرس الملفات الموجودة على الخادم عبر تسمية الأدلة في الإعدادات:

indexer:
  directories:
    - path: '/var/lib/hister/documents'
      filetypes: ['pdf', 'docx', 'md', 'txt']

تُقرأ ملفات PDF وDOCX وMarkdown وOrg mode وملفات النص الصالحة بترميز UTF-8 كنص كامل. ولا تظهر الصور والفيديو في تلك القائمة، لذلك تحتاج مكتبة الصور إلى خادم يفهرس الوجوه والأماكن والتواريخ بدلاً من النص، ويُعد PhotoPrism وImmich الخيارين اللذين تجري مقارنتهما عادةً لهذه المهمة. تُضاف صفحة واحدة باستخدام hister index https://example.com. أما تحويل المواقع كاملة إلى نص منسق لأدوات أخرى فهو مهمة منفصلة، تتولاها أدوات زحف مستضافة ذاتياً تحوّل الصفحات إلى نص منسق.

يعتمد البحث على الحقول، لذلك يستحق بناء جملة الاستعلام عشر دقائق من القراءة:

"connection reset" domain:github.com added:<30d
title:(wireguard|nftables) -tutorial sort:-visits

أُضيف الحقل sort: في v0.18.0، لذلك احذفه من الاستعلام الثاني عند استخدام v0.17.0.

وجّه وكيل برمجة إلى فهرسك الخاص عبر MCP

‏MCP (بروتوكول سياق النموذج) هو الواجهة التي يستخدمها المساعد لاستدعاء الأدوات على الخادم. يوفّره Hister على POST /mcp ضمن عنوان URL الأساسي نفسه، باستخدام بروتوكول نقل HTTP القابل للبث، ويعرض search وget_preview وget_history. المصادقة هي رمز bearer نفسه المستخدم في بقية واجهة API. إذا كان استدعاء الأدوات جديداً عليك، فإن كتابة حلقة وكيل صغيرة بنفسك هي أسرع طريقة لمعرفة ما يقدّمه endpoint مثل هذا فعلياً إلى المساعد.

{
  "mcpServers": {
    "hister": {
      "url": "https://hister.example.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
      }
    }
  }
}

يعمل ترويس X-Access-Token كبديل عن Authorization.

تكمن الفائدة هنا في المحتوى الذي يبحث فيه الوكيل. يعرض البحث المفتوح على الويب النتائج التي تتصدر الترتيب اليوم، وغالباً ما تكون في البرمجيات سريعة التغيّر وثائق لإصدار لا تشغّله. أما فهرك الخاص فيُرجع الصفحة التي قرأتها واخترت الاحتفاظ بها، ويقدّم get_preview النسخة المخزّنة، لذلك تبقى الإجابة متاحة حتى إذا أصبحت الصفحة الأصلية غير متصلة. امنح الوكيل المصدرين معاً إذا أردت النتائج العامة أيضاً: تضيف مهارة بحث في المتصفح مدعومة بواسطة SearXNG الويب المفتوح كأداة منفصلة. وعندما تشغّل أكثر من نقطة نهاية واحدة من هذه النقاط، يجدر بك قراءة استضافة خوادم MCP على VPS، لأن كل واحدة منها تشترك في مشكلة التعرض هذه.

القرص والنسخ الاحتياطية والصيانة

تقدّر الوثائق حجم الصفحة المفهرسة الواحدة بنحو 100 KB، بما في ذلك المعاينة المضغوطة، ولذلك يبلغ حجم مئة ألف صفحة تقريباً 10 GB. لا يوجد نظام حصص. يُخلط بين إعدادين مختلفين: indexer.max_file_size_mb، وقيمته الافتراضية 1 MiB، يحدّ حجم ملف واحد تجري مراقبته، بينما server.max_batch_body_size، وقيمته الافتراضية 40 MiB، يحدّ طلباً واحداً إلى batch API. أُضيف الإعداد الثاني بعد v0.17.0، الذي يفرض حداً ثابتاً قدره 5 MiB على طلبات batch.

يحتوي الدليل الذي يحدده app.directory على index.db، الذي يضم ملفات الفهارس الخاصة بكل لغة، وعلى db.sqlite3 للحسابات والمهام، وdata/html/ للمعاينات، وrules.json. تتطلب النسخة الاحتياطية إيقاف الخدمة، ثم نسخ هذا الدليل بأكمله وملف الإعداد. يكتب hister export backup.json المستندات بتنسيق JSON لأغراض الترحيل، ولا يمثّل نسخة احتياطية للخادم.

توجد أوامر صيانة مهمة ينبغي معرفتها. يعيد hister reindex إنشاء فهارس البحث، وهو مطلوب بعد تغيير إعدادات الفهرسة. إذا ارتفع استهلاك الذاكرة أثناء استيراد كبير، فاضبط detect_languages: false في القسم indexer، ثم أعد الفهرسة. يزيل hister cleanup ملفات المعاينات وfavicon اليتيمة التي خلّفتها عمليات الحذف.

الحذف عبارة عن استعلام، لذلك شغّله أولاً في الوضع التجريبي:

hister delete 'domain:example.com' --dry --verbose

تعود الصفحة المحذوفة إذا استمر أحد الجامعين في إرسالها، لذلك أضف قاعدة التخطي قبل حذفها.

لا يترتب على تشغيل نسخة غير معدّلة من Hister لاستخدامك الخاص أي التزام، لأن AGPLv3 تمنح إذناً غير محدود لتشغيل البرنامج غير المعدّل. أما تمرير النسخ إلى أشخاص آخرين، سواء كانت معدّلة أم لا، فيخضع لشروط، مثل الإبقاء على إشعارات حقوق النشر والترخيص كما هي، وتزويد المستلمين بنسخة من الترخيص. إذا عدّلت Hister وسمحت لأشخاص آخرين باستخدام نسختك عبر شبكة، فيلزمك الترخيص أيضاً أن تعرض عليهم الشيفرة المصدرية المعدّلة.

أنماط الفشل والنصوص التي ستراها

لا يبدأ الخادم. يُعدّ المنفذ 4433 المشغول أو خطأ في صياغة YAML من سببين محتملين؛ كما قد تمنع عملية بدء التشغيلَ عمليةُ التحقق من الإعدادات أو الوصول إلى دليل البيانات. يؤدي الربط بـ 0.0.0.0 من دون server.base_url إلى base_url must be specified when listening on، ويؤدي الفشل في كتابة المفتاح السري إلى failed to create secret key file. يعرض sudo ss -lntp | grep 4433 الجهة التي تشغل المنفذ، بينما يطبع journalctl -u hister -n 50 --no-pager خطأ بدء التشغيل.

تُحمّل الواجهة، لكنها تبدو معطّلة. عند ظهور نص غير مرتب أو صور مفقودة، تحقق من بادئة المسار في server.base_url. يزيل Hister الشرطة المائلة اللاحقة من هذا الإعداد.

لا يتصل الامتداد. يجب أن يطابق عنوان URL للخادم في الامتداد القيمة base_url، ويجب أن يكون الخادم قيد التشغيل ومحدّثاً. وقد يحظر جدار ناري بينهما الاتصال من دون ظهور رسالة في الصفحة. يحتفظ Firefox بسجلات الامتدادات خارج وحدة التحكم المعتادة؛ افتح about:debugging#/runtime/this-firefox وافحص امتداد Hister.

تخرج الحاوية عند بدء التشغيل. يتطلب خطأ الصلاحيات على ./data التحقق من الملكية، وصلاحيات الكتابة، وتسميات SELinux. يشغّل ملف Compose هذا العملية صراحةً بالمعرّف UID 1000 والمعرّف GID 1000، متجاوزاً قيمتي UID وGID الافتراضيتين للصورة، وهما 65532. امنح ذلك الحساب صلاحية الكتابة إلى ./data؛ وعلى مضيف يستخدم SELinux، أضف :Z إلى عملية الربط.

ظهور 403 Forbidden من مسار إداري. لا يمكن استخدام POST /api/reindex وPOST /api/cleanup إلا من جانب المسؤول عند تفعيل معالجة المستخدمين، ولذلك يُرفض الحساب العادي هناك.

تزداد الذاكرة أثناء الاستيراد. يكون اكتشاف اللغة على سجل تاريخي كبير هو السبب المعتاد. اضبط detect_languages: false، ثم شغّل hister reindex بعد ذلك.

FAQ

ما الفرق بين Hister وSearXNG؟

SearXNG هو وكيل بحث شامل: يمرر استعلامك إلى محركات البحث العامة ويعرض نتائجها بعد إزالة التتبع منها، لذلك يظل الفهرس تابعاً لتلك المحركات. يحتفظ Hister بفهرس نص كامل خاص به للصفحات التي زرتها والملفات التي تحتفظ بها، لذلك يجيب عن سؤال «أين قرأت ذلك؟»، بينما يجيب SearXNG عن سؤال «ماذا يقول الويب؟». يحل كل منهما مشكلة مختلفة، ويشغّل كثير من المستخدمين كليهما على خادم واحد.

هل من الآمن وضع سجل التصفح بالكامل على VPS؟

يكون ذلك آمناً فقط بعد تنفيذ إجراءات الحماية من التعرض أولاً. يرتبط Hister افتراضياً بالعنوان 127.0.0.1:4433 ولا يتطلب مصادقة. عيّن app.access_token أو user_handling: true، وضع reverse proxy مع TLS أمامه، وأبقِ المنفذ 4433 مغلقاً في جدار الحماية. فهرس النص الكامل لما قرأته هو نص عادي، لذلك يستطيع أي شخص يصل إلى المنفذ قراءة كل شيء من دون كسر أي تشفير.

هل أحتاج إلى إضافة المتصفح، أم يمكنني استيراد السجل فقط؟

الاستيراد هو عملية ملء تاريخية تُجرى مرة واحدة. يقرأ قاعدة بيانات سجل المتصفح نفسه، لذلك يُشغَّل على الكمبيوتر الذي يحتوي على ملف تعريف المتصفح، وليس على الخادم. تحافظ الإضافة على تحديث الفهرس بعد ذلك، كما تلتقط الصفحات المحمية بتسجيل الدخول لأنها تستخرج المحتوى في المتصفح بعد عرض الصفحة. الإعداد الشائع هو إجراء استيراد واحد، ثم استخدام الإضافة.

هل يستطيع وكيل برمجي البحث في فهرس Hister؟

نعم. Hister هو خادم MCP (بروتوكول سياق النموذج) على POST /mcp في عنوان URL الأساسي لديك، ويعرض search وget_preview وget_history. وجّه العميل إلى https://your-host/mcp مع رأس Authorization: Bearer يحتوي على رمز الوصول الخاص بك. بعد ذلك يبحث الوكيل في الوثائق التي قرأتها فعلياً، وبالإصدار الذي قرأتها فيه، بدلاً من البحث في النتائج التي يحتل فيها المحتوى ترتيباً متقدماً في محرك بحث عام اليوم.

هل كان هذا المقال مفيدًا؟