شروع سریع
XLADA — پنل مدیریت پروکسی بر پایه Xray-core. این پنل رابط وب و REST API برای کاربران، نودها، اشتراکها و پیکربندیهای Xray فراهم میکند. XLADA یک فورک از Remnawave تحت مجوز AGPL-3.0 با حریم خصوصی و کنترل بیشتر بر دادهها است.
سیستم از چه اجزایی تشکیل شده است
| مؤلفه | کجا اجرا میشود | برای چه |
|---|---|---|
| پنل | سرور مدیریت | رابط وب و REST API |
| نود | هر سرور پروکسی | Xray-core را اجرا میکند و توسط پنل مدیریت میشود |
| صفحه اشتراک | سرور مدیریت | صفحه آراسته با کلیدهای کاربر |
حداقل به پنل و حداقل یک نود نیاز است. صفحه اشتراک اختیاری است: بدون آن کاربر لینک را مستقیماً دریافت میکند.
مرورگر مدیر
│ HTTPS
▼
┌──────────────────┐ HTTPS + mTLS + JWT ┌──────────────┐
│ پنل (xpanel) │ ───────────────────────────────▶ │ نود (Xray) │
│ PostgreSQL │ ◀─────────────────────────────── │ سرور پروکسی │
│ Valkey │ فقط ورودی └──────────────┘
└──────────────────┘
▲
│ HTTPS
صفحه اشتراک (xpanel-subpage)
نصب پنل
به سروری با Docker و دامنهای که به آن اشاره میکند نیاز دارید.
git clone https://github.com/xray-panel/deploy.git /opt/xlada
cd /opt/xlada
cp panel.env.sample .env
chmod 600 .env
# فایل .env را پر کنید:
# APP_SECRET — openssl rand -hex 32، پس از راهاندازی قابل تغییر نیست
# POSTGRES_PASSWORD — openssl rand -hex 16
# PANEL_DOMAIN, FRONT_END_DOMAIN, SUB_PUBLIC_DOMAIN
# METRICS_USER, METRICS_PASS — الزامی هستند، بدون آنها کانتینر بالا نمیآید
docker compose up -d
پنل روی 127.0.0.1:3000 بالا میآید. nginx آن را به بیرون ارائه میدهد:
cp nginx/panel.conf /etc/nginx/sites-available/xlada-panel
ln -sf /etc/nginx/sites-available/xlada-panel /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d panel.example.com
در کد پنل میانافزاری وجود دارد که اگر درخواست بدون هدرهای
X-Forwarded-For و X-Forwarded-Proto: https برسد، اتصال را قطع میکند. بدون
پروکسی معکوس با TLS پنل کار نمیکند.
https://panel.example.com را باز کنید — پنل پیشنهاد ساخت یک مدیر را میدهد.
رمز عبور: حداقل 24 کاراکتر، و حتماً شامل حروف کوچک، حروف بزرگ و رقم باشد.
اتصال نود
- در پنل: Nodes → ایجاد نود — پنل مقدار
SECRET_KEYرا نشان میدهد. - روی سرور پروکسی:
docker run -d \
--name xpanel-node \
--restart unless-stopped \
--network host \
--cap-add NET_ADMIN \
--ulimit nofile=1048576:1048576 \
-e NODE_PORT=2222 \
-e SECRET_KEY="<SECRET_KEY از پنل>" \
ghcr.io/xray-panel/node:latest
پس از یک دقیقه نود در پنل بهصورت متصل ظاهر میشود.
گامهای بعدی
- اجزای سیستم — همهچیز چگونه چیده شده و چه چیزی به چه چیزی متصل میشود.
- نیازمندیها — سختافزار، پورتها، دامنهها.
- نصب پنل — راهنمای گامبهگام همراه با بررسی
.env. - نصب نود — حالتهای کاری، پلاگینها، لاگها.
- متغیرهای محیطی — همه کلیدهای تنظیم.
- API Specification — 162 اندپوینت در OpenAPI.