پاسارگارد
پنل

نصب

دستورالعمل‌های نصب PasarGuard.

نیازمندی‌های سیستم

حداقل نیازمندی‌ها

  • RAM: 1 GB
  • CPU: 1 هسته
  • فضای ذخیره‌سازی: 10 GB

مهم: با حداقل منابع، مصرف دیسک را مرتب بررسی کنید؛ مخصوصاً وقتی از دیتابیس‌های خانواده MySQL استفاده می‌کنید. اگر لاگ‌ها یا فایل‌های دیتابیس فضای زیادی مصرف کردند، منابع سرور را ارتقا دهید.

نیازمندی‌های پیشنهادی

  • RAM: 2 GB
  • CPU: 2 هسته
  • فضای ذخیره‌سازی: 20 GB

گزینه‌های نصب

پنل PasarGuard از چندین دیتابیس پشتیبانی می‌کنه:

  • TimescaleDB - برای داده‌های time-series و تحلیل بهینه شده (پیشنهادی)
  • PostgreSQL - قابلیت‌های پیشرفته و مقیاس‌پذیری
  • MariaDB - جایگزین اوپن‌سورس MySQL
  • MySQL - عالی برای محیط‌های production
  • SQLite - مناسب برای دیپلوی‌های کوچک و تست

نصب PasarGuard

curl -fsSL https://github.com/PasarGuard/scripts/raw/main/pasarguard.sh -o /tmp/pg.sh \
  && sudo bash /tmp/pg.sh install --database timescaledb
curl -fsSL https://github.com/PasarGuard/scripts/raw/main/pasarguard.sh -o /tmp/pg.sh \
  && sudo bash /tmp/pg.sh install --database postgresql
curl -fsSL https://github.com/PasarGuard/scripts/raw/main/pasarguard.sh -o /tmp/pg.sh \
  && sudo bash /tmp/pg.sh install --database mysql
curl -fsSL https://github.com/PasarGuard/scripts/raw/main/pasarguard.sh -o /tmp/pg.sh \
  && sudo bash /tmp/pg.sh install --database mariadb
curl -fsSL https://github.com/PasarGuard/scripts/raw/main/pasarguard.sh -o /tmp/pg.sh \
  && sudo bash /tmp/pg.sh install

بعد از نصب

بعد از اینکه نصب تموم شد:

  • لاگ‌ها رو می‌بینید که با بستن ترمینال یا زدن Ctrl+C می‌تونید ازشون خارج بشید
  • فایل‌های PasarGuard تو /opt/pasarguard قرار می‌گیرن
  • فایل تنظیمات رو می‌تونید تو /opt/pasarguard/.env پیدا کنید (برای دیدن متغیرها به بخش پیکربندی مراجعه کنید)
  • فایل‌های دیتا تو /var/lib/pasarguard ذخیره می‌شن
  • برای امنیت، داشبورد PasarGuard با IP قابل دسترسی نیست. پس باید گواهی SSL بگیرید و بعد با مرورگر وب به https://YOUR_DOMAIN:8000/dashboard/ برید (YOUR_DOMAIN رو با دامنه واقعی خودتون جایگزین کنید)
  • می‌تونید از SSH port forwarding هم استفاده کنید تا بدون دامنه به داشبورد دسترسی داشته باشید. user@serverip رو با یوزرنیم SSH و IP سرورتون عوض کنید و این دستور رو بزنید:
ssh -L 8000:localhost:8000 user@serverip

بعدش می‌تونید این لینک رو تو مرورگرتون باز کنید:

http://localhost:8000/dashboard/

وقتی ترمینال SSH رو ببندید دسترسی به داشبورد قطع می‌شه. پس این روش فقط برای تست پیشنهاد می‌شه.

ساخت حساب مالک

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

  1. صفحه ورود پنل را از مرحله قبل باز کنید.
  2. در صفحه ورود، گزینه دسترسی مالک را انتخاب کنید.
  3. گزینه ایجاد مالک را انتخاب کنید.
  4. روی سرور، یک کلید موقت راه‌اندازی بسازید:
pasarguard cli generate-temp-key
  1. کلید را در فرم راه‌اندازی وارد کنید، نام کاربری و رمز عبور مالک را بنویسید و حساب مالک را بسازید.

کلید موقت راه‌اندازی فقط 5 دقیقه معتبر است و فقط یک‌بار قابل استفاده است. اگر منقضی شد، یک کلید جدید بسازید.

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

برای دیدن راهنمای اسکریپت PasarGuard این دستور را اجرا کنید:

pasarguard --help