منوی مدیریت سرور

بعد از نصب، کل مدیریت ربات روی سرور با یک دستور انجام می‌شود:

pasarguardbot

PasarguardBot — manager v1.3.2

Manager script:  v1.3.2
Host OS:         Ubuntu 24.04 LTS
Install mode:    docker
Branch:          main
Bot version:     …
Bot runtime:     running (4/4 services running)
API port:        6160
Config:          /opt/pasarguardbot

● Status: Installed (docker)

┌─────────────────────────────────────────────┐
│   1) Install bot                            │
│   2) Uninstall bot                          │
│   3) Update bot                             │
│   4) View logs                              │
│   5) Edit .env file                         │
│   6) Edit docker-compose.yml                │
│   7) Full restart                           │
│   8) Service status                         │
│   9) Show webhook & URLs                    │
│  10) Update manager script                  │
│  11) Fix Docker network                     │
│  12) Get SSL certificate (AutoSSL)          │
│   0) Exit                                   │
└─────────────────────────────────────────────┘

Select an option: 

بالای منو نسخهٔ اسکریپت، سیستم‌عامل، حالت نصب، برنچ، نسخهٔ ربات، وضعیت کانتینرها و پورت API نمایش داده می‌شود. در همهٔ سؤال‌های (y/N) زدن Enter یعنی خیر و در (Y/n) یعنی بله.

۱) Install bot — نصب

حالت نصب (Docker؛ Native فعلاً غیرفعال است) و برنچ (main یا dev) را می‌پرسد و ربات را نصب می‌کند. اگر قبلاً نصب شده باشد:

Continue (will keep existing .env and data)? (y/N):

با y ادامه می‌دهد؛ .env و دیتای قبلی دست نمی‌خورد. جزئیات کامل: نصب.

۲) Uninstall bot — حذف

⚠  Uninstall PasarguardBot (Docker)

1) Remove containers only (keep .env and data)
2) Remove containers + data (keep .env / config if present)
3) Full remove (/opt/pasarguardbot and /usr/local/bin/pasarguardbot)
0) Cancel
Choice: 

در نصب Native (قدیمی) همین سه سطح با این عنوان‌ها هست: Stop services only (keep .env, app, and data)، Stop services + delete data (keep .env / app / config) و Full remove (/opt/pasarguardbot, systemd units, and /usr/local/bin/pasarguardbot).

۳) Update bot — بروزرسانی

pasarguardbot update

Select update branch

  1) main  (recommended — latest stable)
  2) dev   (testing only — may be unstable)
  0) Cancel

[*] Last used branch: main
Choice [1]:

۴) View logs — لاگ‌ها

  1) Bot logs
2) MariaDB logs
3) Redis logs
4) All services
5) Live bot logs (Ctrl+C to exit)
0) Back
Choice: 

در نصب Native گزینهٔ 4 به‌جای «All services»، phpMyAdmin logs است.

دستور pasarguardbot logs مستقیم لاگ زندهٔ همهٔ سرویس‌های در حال اجرا را با زمان (۲۰۰ خط آخر و ادامه) نشان می‌دهد.

لاگ‌های فایلی ربات هم در /opt/pasarguardbot/logs/ هستند (app.log و error.log).

۵) Edit .env file — ویرایش تنظیمات

pasarguardbot edit-env

فایل /opt/pasarguardbot/.env با nano (یا ادیتور تعریف‌شده در $EDITOR) باز می‌شود. بعد از بستن ادیتور:

Restart the bot? (Y/n):

• Enter یا Y: ری‌استارت کامل (مثل گزینهٔ ۷) تا تغییرات اعمال شوند.
• n: بدون ری‌استارت؛ تغییرات تا ری‌استارت بعدی اعمال نمی‌شوند.

همهٔ متغیرها: پیکربندی (.env).

۶) Edit docker-compose.yml

pasarguardbot edit

فایل /opt/pasarguardbot/docker-compose.yml را باز می‌کند. قبل از باز شدن هشدار می‌دهد:

[!] This is a local edit — the next 'Update bot' will overwrite it with the upstream Compose file.

بعد از ذخیره، فایل اعتبارسنجی می‌شود (باید ایمیج ghcr.io/amirkenzo/pasarguardbot را داشته باشد و build: نداشته باشد) و می‌پرسد:

Apply the changes now (docker compose up -d)? (Y/n):

فقط برای نصب Docker است.

۷) Full restart — ری‌استارت کامل

pasarguardbot restart

به ترتیب: آخرین ایمیج ربات pull می‌شود (روی همان تگ فعلی)، همهٔ کانتینرها down و دوباره up -d می‌شوند، و لاگ زنده نمایش داده می‌شود.

۸) Service status — وضعیت سرویس‌ها

pasarguardbot status

وضعیت کانتینرها (docker compose ps)، مصرف CPU و RAM هر کانتینر، و در آخر همان خروجی گزینهٔ ۹ را نشان می‌دهد.

۹) Show webhook & URLs — وب‌هوک و آدرس‌ها

pasarguardbot urls

[*] Webhook (set in Pasarguard panel):
URL:     http://SERVER_IP:6160/api/webhook
Header:  x-webhook-secret: <from DB table secrets, name=webhook_secret>
Note:   crypto_key / webhook_secret are stored in DB (not .env)

[*] phpMyAdmin:
URL:  http://SERVER_IP:6163

[!] Replace the IP with your domain if you use one.

• آی‌پی عمومی سرور خودکار تشخیص داده می‌شود و پورت از FASTAPI_PORT خوانده می‌شود.
• آدرس‌ها همیشه با http:// چاپ می‌شوند. اگر SSL دارید، https:// و دامنه را خودتان جایگزین کنید.
• خود مقدار Secret چاپ نمی‌شود. در phpMyAdmin وارد دیتابیس pasarguardbot شوید، جدول secrets را باز کنید و مقدار value ردیف webhook_secret را کپی کنید (یوزر و رمز ورود phpMyAdmin در .env: MARIADB_USER / MARIADB_PASSWORD).

راهنمای ست کردن در پنل: اطلاع‌رسانی حجم و زمان.

۱۰) Update manager script — آپدیت اسکریپت مدیریت

pasarguardbot update-script

فقط خود اسکریپت pasarguardbot را از برنچ ذخیره‌شده (همان برنچی که نصب یا آخرین آپدیت با آن انجام شده) دوباره دانلود و نصب می‌کند. ربات را آپدیت نمی‌کند.

• اگر نسخه یکی باشد: Manager script is already up to date.
• اگر نسخهٔ جدید نصب شد: Run pasarguardbot again to use the new script. یک بار از منو خارج شوید و دوباره pasarguardbot را بزنید.

اگر دستور pasarguardbot به هر دلیلی از سیستم حذف شده، همین گزینه دوباره ثبتش می‌کند.

۱۱) Fix Docker network — رفع مشکل شبکهٔ Docker

برای سرورهایی (به‌خصوص بعضی دیتاسنترها با Ubuntu) که یک فایل Netplan با الگوی wildcard دارند و شبکهٔ bridge داکر را خراب می‌کند. علامتش: کانتینرها به اینترنت یا به هم وصل نمی‌شوند، pull یا اتصال ربات به تلگرام/پنل خطا می‌دهد.

Docker network

1) Check Docker Bridge
2) Repair Docker Bridge
3) Rollback Netplan Repair
0) Back
Choice: 

نکته‌ها:

• فقط روی Ubuntu کار می‌کند؛ روی سیستم‌های دیگر پیام Docker Bridge repair is supported only on Ubuntu. می‌دهد. در نصب Native هم غیرفعال است.
• اگر فایل حاوی تنظیمات حساس شبکه باشد یا اینترفیس اصلی جای دیگری تعریف نشده باشد، تعمیر برای جلوگیری از قطع شدن سرور انجام نمی‌شود (Automatic repair was refused to keep the network safe.).
• بعد از تعمیر یا Rollback ممکن است بپرسد Reboot the server now? [y/N]. اگر نه، بعداً خودتان reboot کنید.
• بکاپ‌ها در /opt/pasarguardbot/backups/netplan/ ذخیره می‌شوند.

۱۲) Get SSL certificate (AutoSSL)

pasarguardbot ssl

ابزار AutoSSL را (اگر نصب نباشد) نصب و autossl issue را اجرا می‌کند تا گواهی Let's Encrypt بگیرید. با انتخاب مقصد PasarguardBot گواهی در /var/lib/pasarguardbot/certs/<دامنه>/ قرار می‌گیرد. راهنمای کامل: دامنه و SSL.

۰) Exit

با 0 یا q از منو خارج می‌شوید.

میانبرهای خط فرمان

بدون باز کردن منو: