🛠️ تثبيت Atuin — مزامنة تاريخ الطرفية ذاتية الاستضافة
انشر Atuin على Ubuntu بـ Docker وPostgreSQL — سيرفر مزامنة لتاريخ طرفيتك يخزنه في قاعدة بيانات قابلة للبحث، مشفّرة ومُزامَنة عبر أجهزتك، على المنفذ 8888.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/dev/atuin/atuin-ubuntu.sh
chmod +x atuin-ubuntu.sh
sudo bash atuin-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/dev/atuin/atuin-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x atuin-ubuntu.sh
3 تشغيل المثبت
يثبّت السكريبت Docker إن لزم، يولّد كلمة مرور قاعدة بيانات، ويشغّل سيرفر Atuin مع PostgreSQL 16 على المنفذ 8888، مع تفعيل التسجيل المفتوح حتى تستطيع أجهزتك إنشاء حساب.
sudo bash atuin-ubuntu.sh
4 توجيه واجهة Atuin سطر الأوامر لسيرفرك
لا توجد واجهة ويب — ثبّت واجهة Atuin سطر الأوامر على كل جهاز، اضبط عنوان المزامنة لسيرفرك، ثم سجّل وزامن:
atuin register -u <you> -e <email>
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8888 | Sync API (host → container 8888) — CLI-driven, no web UI |
| internal | PostgreSQL 16 (atuin-db, not published) |
| ./db | Synced (end-to-end encrypted) history |
نظرة عامة
يستبدل Atuin ملف تاريخ طرفيتك العادي بقاعدة بيانات SQLite تسجل كل أمر مع رمز خروجه ومدته ودليل العمل والطابع الزمني، ثم يمنحك بحثاً ضبابياً بملء الشاشة عبر Ctrl-R بدلاً من التمرير عبر آلاف الأسطر. يتيح سيرفر المزامنة ذاتي الاستضافة، المُشغَّل هنا مع PostgreSQL 16 على المنفذ 8888، لذلك التاريخ الغني أن يتبعك عبر كل جهاز تعمل عليه — حاسوبك المحمول، سيرفراتك، أجهزتك الافتراضية — مع تشفير التاريخ من طرف لطرف بحيث يخزن السيرفر نفسه دائماً نصاً مشفراً لا يستطيع قراءته.
لماذا تستخدمه
تاريخ الطرفية الافتراضي ملف نصي مسطح غير قابل للبحث، محلي لجهاز واحد، يُقتطع، ويفقد سياق متى نُفذ الأمر أو نجاحه أو الدليل الذي عمل فيه. يحوّل Atuin ذلك إلى قاعدة بيانات قابلة للاستعلام ببحث ضبابي فوري، ثم يزامنها عبر كل جهاز تستخدمه بحيث يصبح أمر نفّذته على سيرفر الأسبوع الماضي قابلاً للبحث من حاسوبك المحمول اليوم. ولأن التشفير يحدث من جانب العميل بمفتاح لا يصل للسيرفر أبداً، تحصل على راحة المزامنة المركزية دون الوثوق بالسيرفر بمحتوى تاريخ طرفيتك الحساس غالباً.
متى تحتاجه
- تعمل بانتظام عبر أجهزة متعددة (حاسوب محمول، حاسوب مكتبي، عدة سيرفرات) وتريد نفس تاريخ الأوامر القابل للبحث في كل مكان
- تُعيد كتابة أو تبحث باستمرار في سجل التمرير عن أمر معقد تعرف أنك نفّذته من قبل
- تريد تاريخ طرفية ينجو من إعادة تثبيت جهاز أو حاسوب محمول جديد بدلاً من البدء بملف تاريخ فارغ
- تريد البحث في التاريخ برمز الخروج أو الدليل أو المدة، وليس فقط مطابقة نص جزئي عادية
- أنت مهتم بالخصوصية وتريد راحة المزامنة السحابية دون الوثوق بطرف ثالث بتاريخ أوامرك
- تدير أسطولاً من السيرفرات وتريد تاريخ أوامر متسقاً ومُزامَناً عند الاتصال بـ SSH بينها
من يحتاجه
- المطورون ومديرو الأنظمة الذين يعملون عبر أجهزة متعددة ويريدون تاريخ طرفية واحداً مُزامَناً وقابلاً للبحث
- مهندسو DevOps وSRE الذين يتصلون بـ SSH لسيرفرات كثيرة يومياً ويريدون بحث تاريخ متسقاً في كل مكان
- مستخدمو سطر الأوامر المهتمون بالخصوصية الذين يريدون المزامنة دون تسليم تاريخ غير مشفر لخدمة طرف ثالث
- عشاق المختبرات المنزلية والاستضافة الذاتية الذين يشغّلون بنيتهم التحتية بالفعل ويفضلون سيرفر مزامنة ذاتي الاستضافة
- الفرق التي توحّد أدوات المطورين وتريد بديلاً مشتركاً وذاتي الاستضافة لسحابة Atuin العامة
- المستخدمون المتقدمون الذين ينفذون آلاف أوامر الطرفية أسبوعياً وسئموا فقدان تتبع الأوامر السابقة
حالات الاستخدام الشائعة
- البحث في تاريخ الطرفية فوراً عبر كل جهاز تستخدمه ببحث Ctrl-R الضبابي بدلاً من التمرير عبر سجل التمرير
- استرجاع أمر معقد نفّذته على سيرفر مختلف الشهر الماضي بالبحث من جهازك الحالي
- تصفية التاريخ برمز الخروج للعثور بسرعة على الأوامر التي فشلت مقابل التي نجحت لتصحيح جلسات سابقة
- مزامنة التاريخ تلقائياً في الخلفية كل مرة تفتح جلسة طرفية جديدة على أي جهاز مسجّل
- الاحتفاظ بتاريخ طرفية دائم ومحمول ينجو من إعادة تثبيت حاسوب محمول أو تجهيز سيرفر جديد
- مراجعة إحصاءات الأوامر (الأوامر الأكثر استخداماً، الوقت المستغرق) التي يمكن لعميل Atuin عرضها من التاريخ المُزامَن
الميزات الرئيسية
- تاريخ محلي مدعوم بـ SQLite مع بيانات وصفية غنية — رمز الخروج والمدة ودليل العمل واسم المضيف والطابع الزمني لكل أمر
- واجهة بحث ضبابي بملء الشاشة مرتبطة بـ Ctrl-R افتراضياً، تستبدل البحث العكسي المدمج في الطرفية
- تشفير من طرف لطرف — يُشفَّر التاريخ من جانب العميل بمفتاح لا يغادر أجهزتك أبداً، بحيث يخزن السيرفر نصاً مشفراً فقط
- سيرفر مزامنة ذاتي الاستضافة (هذا النشر) كبديل لسحابة Atuin العامة، مع إبقاء تاريخ أوامرك تحت سيطرتك بالكامل
- دعم عبر الطرفيات المختلفة لـ bash وzsh وfish وnushell بسلوك تاريخ وبحث متسق عبرها جميعاً
- إحصاءات وتصفية حسب رمز الخروج أو الدليل أو الجلسة أو المضيف لتحليل أنماط استخدامك لسطر الأوامر
- استيراد تاريخ الطرفية الموجود من bash أو zsh أو fish حتى لا تفقد التاريخ السابق لـ Atuin عند التبديل
- تسجيل وتسجيل دخول قائم على سطر الأوامر — لا توجد لوحة ويب، كل شيء يحدث عبر أمر atuin
كيفية الاستخدام بعد التثبيت
- ثبّت واجهة Atuin سطر الأوامر على كل جهاز تريد مزامنته باستخدام سكريبت التثبيت الرسمي أو مدير الحزم لديك
- اضبط sync_address في ~/.config/atuin/config.toml على كل جهاز ليشير إلى http://your-server-ip:8888
- سجّل حسابك من سطر الأوامر بـ atuin register -u <username> -e <email>، لأن التسجيل مفتوح على سيرفر ذاتي الاستضافة افتراضياً
- سجّل الدخول على أجهزة إضافية بـ atuin login لربطها بنفس التاريخ المُزامَن
- شغّل atuin sync يدوياً أول مرة، أو دعه يزامن تلقائياً في الخلفية عند جلسات الطرفية الجديدة
- استورد تاريخ طرفيتك الموجود بـ atuin import auto حتى تصبح الأوامر القديمة قابلة للبحث إلى جانب الجديدة
- اربط Ctrl-R (افتراضي بالفعل في معظم الطرفيات بعد التثبيت) لتشغيل واجهة بحث Atuin الضبابية
- خزّن مفتاح تشفير Atuin الخاص بك (atuin key) في مكان آمن، لأنه مطلوب لفك تشفير التاريخ على أي جهاز جديد
أفضل ممارسات الأمان
- لا تكشف المنفذ 8888 مباشرة للإنترنت العام أبداً دون وكيل عكسي وTLS، لأن واجهة سطر الأوامر تحتاج اتصالاً موثوقاً للمزامنة
- حافظ على سرية مفتاح تشفير Atuin ونسخه احتياطياً — أي شخص يملكه يمكنه فك تشفير تاريخ طرفيتك المُزامَن، وفقدانه يقفلك خارجاً بشكل دائم
- عطّل التسجيل المفتوح بعد إنشاء حساباتك إذا كان السيرفر متاحاً لأي شخص آخر، لمنع تسجيلات غير مصرح بها
- تذكر أن السيرفر يخزن دائماً نصاً مشفراً فقط، لكن طبقة الحساب/تسجيل الدخول نفسها يجب أن تبقى محمية خلف جدار ناري أو VPN
- استخدم كلمة مرور قوية وفريدة لحساب Atuin منفصلة عن مفتاح التشفير، لأن كلاً منهما يحمي شيئاً مختلفاً
- قيّد PostgreSQL على شبكة Docker الداخلية فقط — يجب ألا يكون متاحاً أبداً من خارج المضيف
- حافظ على تحديث صورة سيرفر Atuin Docker لتلقي تصحيحات الأمان لكل من سيرفر المزامنة وPostgreSQL
- راجع الأجهزة المسجّلة لحسابك دورياً وألغِ الوصول من أي جهاز لم تعد تستخدمه
المنافذ وإعدادات جدار الحماية
ينشر هذا النشر منفذاً مضيفاً واحداً، 8888، مربوطاً واحداً لواحد بالمنفذ الداخلي 8888 للحاوية، الذي يقدم واجهة مزامنة Atuin التي تتحدث معها واجهة سطر الأوامر على كل جهاز من أجهزتك. لا توجد لوحة ويب على هذا المنفذ — تصفحه مباشرة لن يُظهر لك شيئاً مفيداً، لأنه موجود فقط كنقطة نهاية API لواجهة سطر الأوامر. يعمل PostgreSQL 16 على شبكة Docker الداخلية ولا يُنشر للمضيف، لذا فهو غير قابل للوصول من خارج شبكة الحاوية افتراضياً. إذا كانت أجهزتك تُزامن من خارج شبكتك المحلية، ضع المنفذ 8888 خلف وكيل عكسي منهٍ لـ TLS بدلاً من كشفه مباشرة، لأن حركة المزامنة يجب أن تنتقل مشفرة أثناء النقل رغم أن محتوى التاريخ نفسه مشفر بالفعل من طرف لطرف.
النسخ الاحتياطي والصيانة
- انسخ حجم بيانات PostgreSQL احتياطياً (./db أو ما شابه)، الذي يخزن تاريخ كل مستخدم مُزامَن المشفر وبيانات الحساب
- استخدم pg_dump على حاوية atuin-db لنسخة احتياطية منطقية متسقة بدلاً من نسخ ملفات من قاعدة بيانات تعمل
- انسخ مفتاح تشفير Atuin احتياطياً بشكل منفصل وآمن — مطلوب لفك تشفير التاريخ وغير مخزن على السيرفر إطلاقاً
- انسخ docker-compose.yml أو أمر التشغيل احتياطياً حتى يمكن إعادة إنشاء سيرفر المزامنة وPostgreSQL بشكل مطابق على مضيف جديد
- خزّن كلمة مرور قاعدة البيانات المولّدة أثناء التثبيت في مدير كلمات مرور في حال احتجت إعادة الاتصال بـ PostgreSQL يدوياً
- اختبر استعادة كاملة دورياً على مضيف منفصل، وتأكد أن عميل سطر الأوامر لا يزال يستطيع المزامنة وفك تشفير التاريخ بعد استعادة قاعدة البيانات
الأخطاء الشائعة
- فقدان مفتاح تشفير Atuin دون نسخة احتياطية، مما يقفلك بشكل دائم عن فك تشفير تاريخك المُزامَن على أي جهاز جديد
- كشف المنفذ 8888 مباشرة للإنترنت دون TLS، مما يرسل حركة المزامنة عبر اتصال غير مشفر
- ترك التسجيل المفتوح مفعّلاً إلى أجل غير مسمى على سيرفر متاح للآخرين، مما يسمح بإنشاء حسابات غير مصرح بها
- افتراض أن السيرفر يستطيع قراءة تاريخك لأنه ذاتي الاستضافة — لا يستطيع، لأن التشفير يحدث من جانب العميل قبل المزامنة
- عدم نسخ حجم PostgreSQL احتياطياً، مما ينتج فقداناً كاملاً لكل التاريخ المُزامَن إذا فشل قرص المضيف
- نسيان تشغيل atuin login على جهاز جديد قبل توقع ظهور التاريخ، لأن كل جهاز يجب ربطه صراحة
- الخلط بين كلمة مرور حساب Atuin ومفتاح التشفير — كل منهما يحمي شيئاً مختلفاً وفقدان أي منهما يسبب مشكلة مختلفة
استكشاف الأخطاء وإصلاحها
- واجهة سطر الأوامر لا تتصل بالسيرفر — تحقق أن sync_address في config.toml يطابق عنوان سيرفرك الفعلي والمنفذ 8888، وأن المنفذ غير محظور بجدار ناري
- التسجيل يفشل بـ 'registration is closed' — قد يكون التسجيل المفتوح عُطّل بعد الإعداد الأولي؛ أعد تفعيله مؤقتاً أو أنشئ الحسابات بطريقة مختلفة
- التاريخ لا يُزامن بين الأجهزة — شغّل atuin sync يدوياً وتحقق من الأخطاء، وتأكد أن الجهازين مسجَّلا الدخول لنفس الحساب
- Ctrl-R لا يفتح بحث Atuin — تأكد أن تكامل الطرفية ثُبّت بشكل صحيح بواسطة سكريبت تثبيت Atuin لطرفيتك المحددة (bash/zsh/fish)
- نسيت مفتاح التشفير ولا يمكنك فك تشفير التاريخ على جهاز جديد — لا توجد استعادة؛ ستحتاج بدء مزامنة جديدة من ذلك الجهاز
- حاوية PostgreSQL تفشل في البدء — تحقق من docker logs لحاوية atuin-db، غالباً بسبب حجم تالف أو عدم تطابق كلمة مرور بعد تعديل يدوي
- تاريخ الطرفية القديم قبل Atuin غير قابل للبحث — شغّل atuin import auto لسحب ملف تاريخ طرفيتك الموجود
البدائل
يمنحك fzf مع بحث التاريخ المدمج في الطرفية بحثاً ضبابياً دون أي سيرفر أو مزامنة، خيار جيد إذا كنت تعمل على جهاز واحد فقط. McFly أداة تاريخ طرفية ذكية مشابهة بترتيب سياقي لكن دون مزامنة متعددة الأجهزة مدمجة. Resh (Rich Enhanced Shell History) يقدم نهج قاعدة بيانات وبحث محلي مشابهاً دون طبقة مزامنة مشفرة من طرف لطرف مثل Atuin. سحابة Atuin المُستضافة الخاصة بها هي الخيار عديم الصيانة إذا لم ترد تشغيل وصيانة هذا السيرفر بنفسك، مقايضاً تحكم الاستضافة الذاتية بالراحة. للفرق والأفراد الذين يريدون تاريخ طرفية مُزامَناً وقابلاً للبحث عبر أجهزة كثيرة مع إبقاء البيانات مشفرة من طرف لطرف وذاتية الاستضافة بالكامل، يبقى Atuin الخيار الأكمل.
متى لا تستخدمه
إذا كنت تعمل دائماً على جهاز واحد فقط، فسيرفر مزامنة Atuin يضيف عبئاً تشغيلياً لفائدة لن تستخدمها — أداة محلية فقط مثل بحث تاريخ قائم على fzf تغطي نفس قابلية البحث دون سيرفر. إذا لم تكن مرتاحاً لحماية مفتاح تشفير بشكل دائم، فقدانه يعني فقدان الوصول الدائم لفك تشفير تاريخك المُزامَن، وهو خطر حقيقي لعادات النسخ الاحتياطي الأقل انضباطاً. الفرق التي تحتاج رؤية مركزية لما نُفذ من أوامر (للتدقيق أو الامتثال) يجب أن تلاحظ أن تشفير Atuin من طرف لطرف يمنع تحديداً مشغّل السيرفر من قراءة محتوى التاريخ، وهو عكس ما يتطلبه أثر التدقيق عادة.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ماذا يفعل Atuin فعلياً؟
تستبدل واجهة سطر الأوامر تاريخ طرفيتك بقاعدة بيانات SQLite قابلة للبحث وبحث ضبابي بملء الشاشة عبر Ctrl-R، مسجلة رمز خروج كل أمر ومدته ودليله.
هل توجد واجهة ويب؟
لا — يُدار سيرفر Atuin بالكامل عبر واجهة Atuin سطر الأوامر. تثبّت الواجهة على كل جهاز، تضبط sync_address لسيرفرك، ثم تسجّل وتدخل وتزامن من الطرفية. تصفح المنفذ 8888 لن يمنحك لوحة تحكم؛ إنه API لواجهة سطر الأوامر.
ما المنفذ الذي يستخدمه؟
المنفذ المضيف 8888، مربوط واحداً لواحد بمنفذ الحاوية 8888، مع PostgreSQL على الشبكة الداخلية. وجّه sync_address لواجهة سطر الأوامر إلى http://your-server-ip:8888. إذا كانت أجهزتك تُزامن من خارج شبكتك، ضعه خلف وكيل عكسي TLS.
هل يستطيع السيرفر قراءة تاريخ أوامري؟
لا. يشفّر Atuin تاريخك من طرف لطرف بمفتاح يبقى على أجهزتك، بحيث يخزن السيرفر دائماً نصاً مشفراً فقط. هذا مهم لأن تاريخ الطرفية غالباً ما يحتوي أسراراً كُتبت مباشرة.
ماذا يحدث إذا فقدت مفتاح Atuin؟
تفقد القدرة على فك تشفير تاريخك المُزامَن على أي جهاز جديد، لأن السيرفر يحتفظ فقط ببيانات مشفرة ولا يستطيع استعادة أوامرك لك.