3x-uiSubscription
راهاندازی سرور اشتراک 3x-ui — قالبهای base64/JSON/Clash، پورتها و مسیرها، TLS، هدرهای پاسخ و قالبهای سفارشی.
یک اشتراک (subscription) یک URL واحد است که همهی پیکربندیهای یک کلاینت را برمیگرداند. برنامههای کلاینت آن را بهصورت دورهای تازهسازی میکنند، بنابراین وقتی یک ورودی را تغییر میدهید، کلاینتها این تغییر را بهصورت خودکار دریافت میکنند. سرور اشتراک بهعنوان یک سرور جداگانه از پنل اجرا میشود.
فعالسازی و پیکربندی
سرور اشتراک بهصورت پیشفرض روشن است (subEnable). آن را در تنظیمات اشتراک
پنل پیکربندی کنید:
| Setting | Default | Meaning |
|---|---|---|
subPort | 2096 | پورت گوشدادن (جدا از پنل). |
subListen | (همه) | آدرس اتصال (bind). |
subPath | /sub/ | مسیر پایه برای URLهای خام اشتراک. |
subDomain | (هیچ) | میزبان عمومی؛ اگر تنظیم شود، سرور فقط به همان Host پاسخ میدهد. |
subCertFile / subKeyFile | (هیچ) | گواهی و کلید TLS — هنگام تنظیم، سرور HTTPS ارائه میدهد. |
subEncrypt | true | بدنهی خام اشتراک را با base64 رمزگذاری میکند. |
subUpdates | 12 | بازهی پیشنهادی تازهسازی (ساعت) که به کلاینتها ارسال میشود. |
یک URL اشتراک به این شکل است:
https://<sub-host>:<sub-port>/sub/<sub-id>که در آن <sub-id> همان Sub ID کلاینت است.
قالبهای خروجی
قالب بر اساس مسیر انتخاب میشود و هرکدام کلید فعالسازی مخصوص خود را دارند:
| Format | Path | Enabled by | Output |
|---|---|---|---|
| لینکهای خام | /sub/ | همیشه (اگر روشن باشد) | فهرستی از لینکهای vless://، vmess://، … (هنگام فعالبودن subEncrypt با base64 رمزگذاری میشود). |
| JSON | /json/ | subJsonEnable | پیکربندی(های) کامل کلاینت Xray. |
| Clash / Mihomo | /clash/ | subClashEnable | پروفایل YAML. |
فقط ورودیهای فعالی که از VLESS، VMess، Trojan، Shadowsocks یا Hysteria2
استفاده میکنند در یک اشتراک ظاهر میشوند و بر اساس شاخص sub-sort آنها مرتب میشوند.
درخواست /sub/ همراه با هدر Accept: text/html (یا ?html=1) بهجای بدنهی خام،
یک صفحهی اطلاعات خوانا برای انسان برمیگرداند.
هدرهای پاسخ
اشتراکها هدرهای استانداردی برمیگردانند که برنامههای سازگار آنها را میخوانند:
Subscription-Userinfo—upload،download،total(بایت؛total=0یعنی نامحدود) وexpire(ثانیههای Unix).Profile-Update-Interval— بازهی تازهسازی برحسب ساعت (subUpdates).Profile-Title،Support-Url،Profile-Web-Page-Url،Announce— برندینگ اختیاری که برخی کلاینتها نمایش میدهند.
قالبهای سفارشی صفحه
برای برندینگ صفحهی HTML اشتراک، subThemeDir را به یک پوشهی حاوی قالب سفارشیِ
صفحهی اطلاعات اشاره دهید. توضیح (remark) هر کلاینت روی هر لینک کاملاً قابل
قالببندی است — به لینکهای اشتراکگذاری ← متغیرهای remark مراجعه کنید.
سرور اشتراک را پشت TLS قرار دهید (با تنظیم subCertFile/subKeyFile، یا یک
پروکسی معکوس) تا محتوای اشتراک در حین انتقال
افشا نشود.