كل المقالات التقنية

ملف pg_hba.conf في PostgreSQL: التحكم بالوصول وطرق التوثيق وخطأ no pg_hba.conf entry

اقرأوا pg_hba.conf واكتبوه بشكل صحيح وانظروا الأخطاء عبر pg_hba_file_rules وفضّلوا scram-sha-256 وعالجوا خطأ no pg_hba.conf entry.

ملف pg_hba.conf في PostgreSQL: التحكم بالوصول وطرق التوثيق وخطأ no pg_hba.conf entry

في 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 أحدث وأأمن وهو الافتراضي في الإصدارات الحديثة.

هل تقطع إعادة التحميل الاتصالات؟ لا؛ فهي تعيد قراءة الإعداد فقط.

٩. قائمة تحقق سريعة

  1. استُعلم عن مسار hba_file.
  2. الأسطر دقيقة مع /32 أو المدى اللازم.
  3. لا يُستخدم trust على الشبكة.
  4. لا error في pg_hba_file_rules.
  5. listen_addresses والجدار الناري متوافقان.

إذا احتجتم إلى مساعدة في مراجعة الأداء أو صيانة الخادم، فراجعوا خدمات إدارة الخوادم.

تجدون المزيد من أدلة الخوادم وووردبريس في أرشيف المقالات.

المراجع الرسمية

PostgreSQL: pg_hba.conf · PostgreSQL: pg_hba_file_rules view · PostgreSQL: password authentication