همه مقالات تخصصی

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/<نسخه>/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 خطاهای نحوی را نشان می‌دهد. reload کافی است و اتصال‌های فعلی را قطع نمی‌کند.

۵. رفع «no pg_hba.conf entry»

پیام نام کاربر، دیتابیس، آدرس مبدأ و وضعیت SSL را می‌گوید؛ خط متناسب با همان را اضافه کنید. اگر سرور اصلاً به شبکه گوش نمی‌دهد باید listen_addresses را هم در postgresql.conf بررسی کنید و فایروال را با nftables باز کنید. برای بکاپ از pg_dump استفاده کنید.

۶. مثال توضیحی، نه اندازه‌گیری واقعی

فرض کنید برنامه‌ای از آدرس 10.0.0.5 به دیتابیس وصل نمی‌شد و پیام no pg_hba.conf entry می‌داد. پس از افزودن یک خط host برای همان کاربر و دیتابیس و آدرس /32 و reload، اتصال برقرار شد. این سناریو فقط برای توضیح است، نه اندازه‌گیری واقعی.

۷. اشتباه‌های رایج

  • استفاده از trust برای اتصال شبکه.
  • نوشتن 0.0.0.0/0 با دسترسی به همهٔ دیتابیس‌ها.
  • نگذاشتن خط جدید قبل از یک خط reject عمومی.
  • فراموش‌کردن reload یا listen_addresses.

۸. پرسش‌های متداول

اولین خط منطبق برنده است؟ بله؛ بنابراین ترتیب خط‌ها اهمیت دارد.

md5 یا scram؟ scram-sha-256 جدیدتر و امن‌تر است و در نسخه‌های جدید پیش‌فرض.

reload اتصال‌ها را قطع می‌کند؟ نه؛ فقط تنظیمات را دوباره می‌خواند.

۹. چک‌لیست سریع

  1. مسیر hba_file پرسیده شد.
  2. خط‌ها دقیق و با /32 یا محدودهٔ لازم نوشته شد.
  3. trust در شبکه استفاده نشده است.
  4. pg_hba_file_rules بدون error است.
  5. listen_addresses و فایروال هم‌خوان‌اند.

اگر برای بررسی عملکرد یا نگهداری سرور به همکاری نیاز دارید، محدودهٔ خدمات مدیریت سرور را ببینید.

راهنماهای بیشتر سرور و وردپرس در آرشیو مقالات جمع شده‌اند.

منابع رسمی

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