08 Troubleshooting

عیب‌یابی

نصب: cannot create regular file '/opt/.../...': No such file or directory

باگ نسخه‌ی قدیمی اسکریپت بود (پوشه‌ی نصب قبل از کپی باینری ساخته نمی‌شد). در v0.2.2 رفع شد. کافی است دوباره همان دستور install را اجرا کنی (اسکریپت از main گرفته می‌شود).

لاگ Failed to load API Key یا Failed to load env file

بی‌خطر است. این پیام از کد پایه‌ی upstream می‌آید؛ اسکریپت یک API_KEY ساختگی می‌نویسد تا ساکت شود. عملکرد چند-مستأجری مستقل از آن است.

نود در پنل اصلی offline است

• sudo pg-node-agent status و logs را چک کن.
• آدرس را درست وارد کرده‌ای؟ باید https://NODE_IP:8090 باشد (نه gRPC).
• فایروال پورت‌های 8090 (کنترل) و 62050 (gRPC) را باز کرده؟
• گواهی pin‌شده با گواهی فعلی نود می‌خورد؟ اگر renew-cert زده‌ای، دوباره pin کن.

پنل گواهی را نمی‌گیرد / خطای TLS موقع افزودن نود

• cert_pem را کامل (با خطوط BEGIN/END) بچسبان.
• یا فیلد گواهی را خالی بگذار تا TOFU خودکار انجام شود.
• اگر گواهی نود عوض شده، نود را حذف و دوباره اضافه کن.

مشتری در پنل PasarGuard وصل شد ولی لینک کاربر کار نمی‌کند

• inbound پنل مشتری باید با inbound واقعی نود یکی باشد: پورت، پروتکل، شبکه، SNI/host، TLS. (نگاه کنید: اتصال مشتری).
• --force-inbounds نود باید تگ inbound واقعی را داشته باشد (پیش‌فرض vless-in).
• کانفیگ نود را با sudo pg-node-agent edit ببین و پارامترهای دقیق را به مشتری بده.

کاربرهای مشتری قطع شده‌اند

• احتمالاً حجم/انقضای اشتراک تمام شده. مصرف: GET /api/v1/customers/{id}/usage.
• با topup-quota یا renew در پنل برگردان. داده‌ها با تمدید برمی‌گردند (suspend ≠ delete).

مصرف اضافه (overage)

چون Xray مشترک است، ممکن است کمی مصرف بعد از اتمام حجم تا لحظه‌ی enforce ثبت شود. این overage در GET /customers/{id}/usage (overage_bytes) گزارش می‌شود تا ربات فروش کیف‌پول را تنظیم کند. بازه‌ی enforce پیش‌فرض ۱۰ ثانیه است (PG_AGENT_ENFORCE_INTERVAL).