نصب
دستورالعملهای نصب 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 timescaledbcurl -fsSL https://github.com/PasarGuard/scripts/raw/main/pasarguard.sh -o /tmp/pg.sh \
&& sudo bash /tmp/pg.sh install --database postgresqlcurl -fsSL https://github.com/PasarGuard/scripts/raw/main/pasarguard.sh -o /tmp/pg.sh \
&& sudo bash /tmp/pg.sh install --database mysqlcurl -fsSL https://github.com/PasarGuard/scripts/raw/main/pasarguard.sh -o /tmp/pg.sh \
&& sudo bash /tmp/pg.sh install --database mariadbcurl -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 رو ببندید دسترسی به داشبورد قطع میشه. پس این روش فقط برای تست پیشنهاد میشه.
ساخت حساب مالک
برای ساخت اولین حساب مالک، از فرم راهاندازی در صفحه ورود پنل و یک کلید موقت یکبارمصرف استفاده کنید.
- صفحه ورود پنل را از مرحله قبل باز کنید.
- در صفحه ورود، گزینه دسترسی مالک را انتخاب کنید.
- گزینه ایجاد مالک را انتخاب کنید.
- روی سرور، یک کلید موقت راهاندازی بسازید:
pasarguard cli generate-temp-key- کلید را در فرم راهاندازی وارد کنید، نام کاربری و رمز عبور مالک را بنویسید و حساب مالک را بسازید.
کلید موقت راهاندازی فقط 5 دقیقه معتبر است و فقط یکبار قابل استفاده است. اگر منقضی شد، یک کلید جدید بسازید.
برای تبدیل یک ادمین موجود به مالک، به صفحه ورود پنل برگردید، دسترسی مالک را انتخاب کنید، گزینه مالک کردن مدیر را بزنید، یک کلید موقت جدید بسازید و سپس نام کاربری ادمین موجود و کلید را وارد کنید. این کار فقط وقتی ممکن است که هنوز حساب مالک وجود نداشته باشد.
برای دیدن راهنمای اسکریپت PasarGuard این دستور را اجرا کنید:
pasarguard --help