في PostgreSQL يُحدَّد في pg_hba.conf من يحق له الاتصال بأي قاعدة بيانات ومن أين، بمعزل عن listen_addresses والجدار الناري. ويعني الخطأ «no pg_hba.conf entry» أنه لا يوجد سطر يطابق اتصالكم. يشرح هذا الدليل بنية الملف وإصلاحاً آمناً.
١. أين الملف
sudo -u postgres psql -c "SHOW hba_file;"
في دبيان وأوبونتو يكون عادة تحت /etc/postgresql/<version>/main/. اسألوا قاعدة البيانات عن المسار بدل التخمين.
٢. بنية السطر
# TYPE DATABASE USER ADDRESS METHOD
local all postgres peer
host appdb appuser 10.0.0.5/32 scram-sha-256
تُقرأ الأسطر من الأعلى إلى الأسفل ويفوز أول سطر مطابق، لذا فالترتيب مهم. وpeer للاتصال المحلي باسم مستخدم نظام التشغيل. وللاتصال الشبكي فضّلوا scram-sha-256 على md5 القديم.
٣. طرق خطرة
تسمح الطريقة trust بالوصول دون أي توثيق ولا تقبل إلا في حالات محلية ضيقة جداً. ولا تجمعوا عناوين مثل 0.0.0.0/0 مع وصول واسع. اجعلوا العنوان والمستخدم دقيقين قدر الإمكان.
٤. التطبيق وفحص الأخطاء
sudo systemctl reload postgresql
sudo -u postgres psql -c "SELECT line_number, type, database, user_name, address, auth_method, error FROM pg_hba_file_rules;"
يعرض عمود error أخطاء الصياغة. وتكفي إعادة التحميل ولا تقطع الاتصالات الحالية.
٥. إصلاح «no pg_hba.conf entry»
تذكر الرسالة المستخدم وقاعدة البيانات وعنوان المصدر وحالة SSL؛ أضيفوا سطراً يطابقها تماماً. وإذا كان الخادم لا يستمع على الشبكة أصلاً فافحصوا أيضاً listen_addresses في postgresql.conf وافتحوا الجدار الناري بـ nftables. وللنسخ الاحتياطي استخدموا pg_dump.
٦. مثال توضيحي وليس قياساً حقيقياً
لنفترض أن تطبيقاً على 10.0.0.5 لم يستطع الاتصال وتلقى no pg_hba.conf entry. بعد إضافة سطر host واحد لذلك المستخدم وقاعدة البيانات وعنوان /32 وإعادة التحميل نجح الاتصال. هذا سيناريو مختلق للتوضيح وليس قياساً حقيقياً.
٧. أخطاء شائعة
- استخدام trust للوصول الشبكي.
- كتابة 0.0.0.0/0 مع وصول لكل قواعد البيانات.
- وضع سطر جديد بعد سطر reject عام.
- نسيان إعادة التحميل أو listen_addresses.
٨. أسئلة شائعة
هل يفوز أول سطر مطابق؟ نعم، لذا الترتيب مهم.
md5 أم scram؟ scram-sha-256 أحدث وأأمن وهو الافتراضي في الإصدارات الحديثة.
هل تقطع إعادة التحميل الاتصالات؟ لا؛ فهي تعيد قراءة الإعداد فقط.
٩. قائمة تحقق سريعة
- استُعلم عن مسار hba_file.
- الأسطر دقيقة مع /32 أو المدى اللازم.
- لا يُستخدم trust على الشبكة.
- لا error في pg_hba_file_rules.
- listen_addresses والجدار الناري متوافقان.
إذا احتجتم إلى مساعدة في مراجعة الأداء أو صيانة الخادم، فراجعوا خدمات إدارة الخوادم.
تجدون المزيد من أدلة الخوادم وووردبريس في أرشيف المقالات.
المراجع الرسمية
PostgreSQL: pg_hba.conf · PostgreSQL: pg_hba_file_rules view · PostgreSQL: password authentication
