لوگو بلوسرور

آموزش نصب pgAdmin4 در اوبونتو



pgAdmin محبوب‌ترین و قدرتمندترین پلتفرم مدیریت و توسعه برای پایگاه داده PostgreSQL است. این ابزار که به صورت متن‌باز ارائه می‌شود، یک رابط کاربری گرافیکی و تحت وب فراهم می‌کند که به شما اجازه می‌دهد به راحتی دیتابیس‌ها، جداول، کاربران و سایر جنبه‌های سرور PostgreSQL خود را مدیریت کنید.

این راهنما به شما روش صحیح و رسمی نصب pgAdmin 4 را در حالت وب (Web Mode) روی سرور اوبونتو آموزش می‌دهد. با نصب در این حالت، شما می‌توانید از طریق مرورگر و از هر سیستمی به پنل مدیریت دیتابیس خود دسترسی داشته باشید. برای این کار، شما به یک خرید vps با سیستم‌عامل اوبونتو نیاز خواهید داشت.

 

پیش‌نیازها

  • یک سرور با سیستم‌عامل اوبونتو (22.04 LTS یا جدیدتر).
  • دسترسی به سرور با یک کاربر دارای دسترسی sudo.
  • یک سرور PostgreSQL فعال. (می‌تواند روی همین سرور یا یک سرور دیگر باشد).

 

قدم اول: اضافه کردن ریپازیتوری رسمی pgAdmin 4

برای اطمینان از نصب آخرین نسخه پایدار، ما از ریپازیتوری رسمی خود pgAdmin استفاده می‌کنیم.

  1. ابتدا کلید GPG ریپازیتوری را برای تایید صحت بسته‌ها اضافه کنید:
    curl -fsS https://www.pgadmin.org/static/packages_pgadmin_org.pub | sudo gpg --dearmor -o /usr/share/keyrings/pgadmin4-archieve-keyring.gpg
  2. حالا ریپازیتوری را به لیست منابع سیستم خود اضافه کنید:
    sudo sh -c 'echo "deb [signed-by=/usr/share/keyrings/pgadmin4-archieve-keyring.gpg] https://ftp.postgresql.org/pub/pgadmin/pgadmin4/apt/$(lsb_release -cs) pgadmin4 main" > /etc/apt/sources.list.d/pgadmin4.list'

 

قدم دوم: نصب pgAdmin 4 (حالت وب)

پس از افزودن ریپازیتوری، لیست بسته‌های خود را به‌روز کرده و پکیج pgadmin4-web را نصب کنید. این پکیج فقط نسخه تحت وب را نصب می‌کند که برای سرورها مناسب است.

sudo apt update
sudo apt install pgadmin4-web

 

قدم سوم: پیکربندی اولیه pgAdmin 4

پس از اتمام نصب، باید یک اسکریپت راه‌اندازی را اجرا کنید تا کاربر ادمین برای ورود به پنل وب ایجاد شود.

sudo /usr/pgadmin4/bin/setup-web.sh

این اسکریپت از شما چند سوال خواهد پرسید:

  • Email address: آدرس ایمیل خود را به عنوان نام کاربری برای ورود وارد کنید.
  • Password: یک رمز عبور قوی برای کاربر ادمین خود وارد کنید.

پس از پاسخ به سوالات، اسکریپت به صورت خودکار سرویس آپاچی را برای میزبانی pgAdmin پیکربندی و ری‌استارت می‌کند.

 

قدم چهارم: دسترسی به پنل وب pgAdmin 4

حالا می‌توانید مرورگر خود را باز کرده و به آدرس زیر بروید. به جای your_server_ip، آدرس IP سرور خود را قرار دهید:

http://your_server_ip/pgadmin4

با استفاده از ایمیل و رمز عبوری که در قدم قبل ایجاد کردید، وارد شوید.

نکته: اگر با خطای 404 مواجه شدید، یک بار سرویس آپاچی را با دستور sudo systemctl restart apache2 ری‌استارت کنید.

 

قدم پنجم: اتصال به سرور PostgreSQL

پس از ورود به داشبورد، برای مدیریت دیتابیس خود باید ابتدا آن را به pgAdmin اضافه کنید.

  1. در صفحه اصلی، روی Add New Server کلیک کنید.
  2. در پنجره‌ای که باز می‌شود و در تب General، یک نام دلخواه برای این اتصال وارد کنید (مثلا “My Local Server”).
  3. به تب Connection بروید:
    • Host name/address: اگر دیتابیس شما روی همین سرور است، localhost را وارد کنید. در غیر این صورت، آدرس IP سرور دیتابیس را وارد نمایید.
    • Port: پورت پیش‌فرض PostgreSQL یعنی 5432 را تغییر ندهید، مگر اینکه آن را عوض کرده باشید.
    • Maintenance database: نام دیتابیس پیش‌فرض معمولا postgres است.
    • Username / Password: نام کاربری و رمز عبور کاربر دیتابیس خود را وارد کنید.
  4. روی دکمه Save کلیک کنید.

 

اگر اطلاعات صحیح باشد، اتصال برقرار شده و شما می‌توانید دیتابیس‌های خود را در منوی سمت چپ مشاهده و مدیریت کنید. برای میزبانی دیتابیس‌های PostgreSQL، سرور مجازی فنلاند به دلیل پایداری بالا، یک گزینه بسیار مناسب است.

نویسنده: | تاریخ انتشار: 2025/08/09