Since Russian community asked for it, we activate the donation for HWID. To ensure your payment is counted for this goal, create an invoice with the "Donate to this Goal" button; otherwise, it will be counted for admin permission management.

https://donate.pasarguard.org

نتیجه دونیت نکردن

🔧 Bug Fix: User Disconnection via gRPC API — PasarGuard Patch

A known bug in Xray-core allows users removed via the gRPC API to keep their active connections alive and continue sending traffic — even after being deleted. This has caused serious issues for many operators whose customers exploited this loophole, leading to unexpected data overages and inflated bills.

The PasarGuard team has identified and fixed this issue, and submitted a pull request to the upstream Xray\-core repository:
🔗 https://github.com/XTLS/Xray-core/pull/5844

We have also compiled patched builds for Alpine Linux (amd64 / arm64) that have been running on production environments for nearly a month with no reported issues.

---

⚙️ Setup Guide

Step 1 — Upload the zip file to your server, navigate to the directory where you uploaded it, then run:

mkdir -p /var/lib/pg-node/xray-core/
cp xray-amd64.zip /var/lib/pg-node/xray-core/
cd /var/lib/pg-node/xray-core/
unzip xray-amd64.zip
mv xray-amd64 xray
chmod +x xray

⚠️ Make sure you are in the same directory as the zip file before running the commands above\.

Step 2 — Edit your node env file:

pg-node edit-env

Find the line below (or add it if missing) and remove the # comment:

XRAY_EXECUTABLE_PATH = /var/lib/pg-node/xray-core/xray

Step 3 — Restart the node:

pg-node restart

✅ Done! This process is the same as setting a custom Xray-core version and works with any panel that uses the Xray API.

---

💬 How you can help

— Test the builds on your own production setup
— Don't trust pre-built binaries? Build it yourself from our branch:
🔗 https://github.com/ImMohammad20000/Xray-core/tree/UserConnTracker
— Found an issue? Report it on the PR with logs and proof
— Everything working fine? Leave a comment on the PR to help get it merged faster
— Support the team's continued work:
💙 https://donate.pasarguard.org

🔧 رفع باگ: قطع نشدن کاربر پس از حذف از طریق gRPC — پچ تیم PasarGuard

یک باگ شناخته‌شده در Xray-core باعث می‌شه که کاربرانی که از طریق gRPC API حذف می‌شن، کانکشن فعال‌شون قطع نشه و بتونن به ارسال ترافیک ادامه بدن. این مشکل برای خیلی از اقراد دردسرساز شده — مشترکانی که از این باگ سوءاستفاده کردن و مصرف داده غیرمنتظره و قبض‌های سنگین به بار آوردن.

تیم PasarGuard این مشکل رو شناسایی و برطرف کرده و یه Pull Request به ریپوی اصلی Xray-core ارسال کرده:
🔗 https://github.com/XTLS/Xray-core/pull/5844

علاوه بر این، نسخه‌های کامپایل‌شده برای Alpine Linux (amd64 / arm64) آماده شده که نزدیک به یک ماهه روی محیط‌های پروداکشن تست شدن و هیچ مشکلی گزارش نشده\.

---

⚙️ راهنمای نصب

مرحله ۱ — فایل زیپ رو آپلود کن، بعد دستورات زیر رو اجرا کن:

mkdir -p /var/lib/pg-node/xray-core/
cp xray-amd64.zip /var/lib/pg-node/xray-core/
cd /var/lib/pg-node/xray-core/
unzip xray-amd64.zip
mv xray-amd64 xray
chmod +x xray

⚠️ قبل از اجرای دستورات بالا مطمئن شو که توی همون دایرکتوری‌ای هستی که فایل زیپ رو آپلود کردی.

مرحله ۲ — فایل env نود رو ویرایش کن:

pg-node edit-env

خط زیر رو پیدا کن (یا اگه نبود اضافه کن) و علامت # رو از ابتدای اون حذف کن:

XRAY_EXECUTABLE_PATH = /var/lib/pg-node/xray-core/xray

مرحله ۳ — نود رو ریستارت کن:

pg-node restart

✅ تموم شد! این فرآیند دقیقاً مثل استفاده از نسخه دلخواه Xray-core هست و روی هر پنلی که با Xray API کار می‌کنه قابل اجراست.

---

💬 چطور می‌تونی کمک کنی

— بیلدها رو روی سرور پروداکشن خودت تست کن
— به باینری‌های آماده اعتماد نداری؟ از روی برنچ ما خودت بیلد بگیر:
🔗 https://github.com/ImMohammad20000/Xray-core/tree/UserConnTracker
— مشکلی پیدا شد؟ با لاگ و مدرک روی PR گزارش بده
— همه چیز درست کار کرد؟ با یه کامنت روی PR از مرج‌شدنش حمایت کن
— از تیم با دونیشن حمایت کن:
💙 https://donate.pasarguard.org