English installation guide · راهنمای فارسی
لاگ تخصصی و دستیار چندارائهدهندهای: عیبیابی اتصال و موتور، چت با گزارش پالایششده و تغییر تنظیمات با پیشنمایش، تأیید و بازگردانی.
دامنههای جایگزین تونل و پنل: حداکثر ۸ دامنه برای هر بخش، بدون ساخت دوبارهٔ حسابها یا تغییر سهمیه. نصب اولیه همچنان فقط یک دامنه میخواهد.
پراکسی خروجی، پورتهای Upstream و گزارش ترافیک — فارسی · English: راهنمای قدمبهقدم هر سه موتور، ورودی لوکال Xray/sing-box، فیلتر زمانی و دانلود CSV/JSON.
پنل مدیریت سرور WhiteDNS 0.15.0 با موتورهای Soar، Cotten و MasterDNS برای Ubuntu 22.04/24.04/26.04 یا Debian 12/13، معماری amd64/x86_64 یا arm64/aarch64.
CottenDNS نیز از فورک سازگار WhiteDNS و با حفظ نام و مجوز نویسندگان اصلی اضافه شده است.
موتور اصلی Soar توسط Lantern / GetLantern توسعه یافته است. WhiteDNS پنل، نصبکننده و یکپارچهسازی کلاینت را توسعه میدهد.
برای نصب معمول، دستور زیر کافی است. اگر فایل نصب را از قبل دانلود کردهاید، نصب از فایل بسته را ببینید.
با SSH وارد سرور شوید و اجرا کنید:
bash <(curl -fsSL https://raw.githubusercontent.com/WhiteDNS/Soar-Server/main/panel-setup.sh)نصبکننده در هر اجرا آخرین نسخهٔ پایدار معرفیشده در Releases را پیدا میکند و بستهٔ سازگار با معماری سرور و checksum آن را دریافت و بررسی میکند؛ سپس هفت مرحلهٔ نصب را با توضیح هر مرحله پیش میبرد. دسترسی root یا sudo و systemd لازم است؛ Go، Docker، Node یا پایگاه دادهٔ جدا روی سرور لازم نیست. متن ترمینال انگلیسی و ASCII است تا در SSH درست نمایش داده شود.
در ۰.۳.۱، رکوردهای A/NS پیش از تغییر سرویس بررسی میشوند؛ SOA و اتصال واقعی HTTPS از داخل تونل پس از شروع سرویس آزموده میشوند. خطای DNS جزئیات و امکان تلاش دوباره دارد. حساب آزمایش موقت و محدود است و در پایان حذف میشود. اگر آزمون اتصال نگذرد، میتوانید مشکل را رفع و دوباره تست کنید، به وضعیت قبلی برگردید یا صریحاً نصب «تأییدنشده» را نگه دارید؛ در حالت آخر دستور با وضعیت غیرصفر پایان مییابد.
اگر UFW فعال باشد، نصبکننده پس از تأیید نصب UDP/53 و TCP/53 و در حالت مستقیم پورت مدیریت TCP را باز میکند. فایروال ارائهدهنده و NAT همچنان باید در پنل ارائهدهنده تنظیم شوند. سرویس نگهداری نیز هنگام شروع، بازبودن UDP/TCP 53 در UFW فعال را بررسی میکند. برای اجرای مجدد بررسی DNS و آزمونهای کامل نصب روی سرور موجود، نصبکننده را دوباره اجرا کنید؛ بهروزرسانی باینری بهتنهایی این آزمونها را اجرا نمیکند.
اگر curl نصب نیست، ابتدا اجرا کنید:
sudo apt-get update
sudo apt-get install -y curlراهنمای قدمبهقدم فارسی: DNS، نصب، ورود، ساخت حساب و اتصال گوشی
به دامنه و دسترسی پنل DNS آن نیاز دارید. رکورد A برای nameserver و رکورد NS برای زیردامنهٔ جدا بسازید؛ نمونهٔ دقیق در راهنماست. پورت UDP/53 و TCP/53 باید در دسترس باشد. رکوردهای MasterDNS یا CottenDNS فعال را تغییر ندهید. نصبکننده پیش از جایگزینی سرور مستقل قبلی، تأیید صریح مهاجرت میگیرد.
آدرس کامل پنل در پایان نصب نمایش داده میشود؛ مسیر تصادفی انتهای آدرس را ذخیره کنید. بازکردن IP یا دامنه بدون آن مسیر، صفحهٔ ورود را نشان نمیدهد.
- با حساب مدیر وارد شوید و در «دامنه و امنیت»، دامنه و HTTPS را تنظیم کنید. این کار با
sudo soar-panel-securityدر ترمینال هم قابل انجام است. - در «حسابهای کاربری»، حساب بسازید و حجم، تاریخ انقضا، سرعت و سقف جریان همزمان را تعیین کنید.
- از «لینک / QR»، «لینک ساب» را انتخاب و آدرس یا QR آن را در بخش Import اپ WhiteDNS وارد کنید. لینک مستقیم هم همچنان در دسترس است.
برای ساب کامل از WhiteDNS 1.6.8 یا جدیدتر استفاده کنید. پس از تغییر تنظیمات تونل، ساب را در اپ تازهسازی کنید؛ برای لینک مستقیم، پروفایل را دوباره Import کنید. راهنمای ساب، حجم، انقضا و تعویض لینک · گزارش آزمون پنل و اپ.
در فرم حساب میتوانید Soar، Cotten، MasterDNS یا هر ترکیب از آنها را انتخاب کنید. «هر سه موتور» یک ساب با سه روش اتصال میدهد؛ حجم، انقضا و سرعت مشترکاند و رکورد DNS دیگری لازم نیست. حسابهای موجود انتخاب قبلی خود را حفظ میکنند؛ برای افزودن MasterDNS، حساب را ویرایش و سپس ساب را تازهسازی کنید. راهنمای MasterDNS.
لینک نصب ثابت است و با انتشار نسخهٔ پایدار جدید به تغییر دستور یا شمارهٔ نسخه نیاز ندارد. نسخههای آزمایشی نصب نمیشوند؛ اگر یافتن نسخه، دریافت بستهٔ معماری سرور یا بررسی checksum شکست بخورد، نصب پیش از تغییر سرویس متوقف میشود و نسخهٔ قدیمی جایگزین نمیشود.
مدیریت با تلگرام / Telegram management: اتصال با توکن ربات و لینک یکبارمصرف، مدیریت حسابها، راهاندازی مجدد و ارتقای پنل، هشدار و گزارش روزانه.
-
تغییر نام کاربری و رمز ورود از «حساب مدیر»، با تأیید رمز فعلی و خروج همهٔ نشستهای قبلی.
-
انتخاب چند حساب یا همهٔ نتایج جستوجو و حذف گروهی با تأیید نهایی.
-
داشبورد واقعی منابع سرور، مصرف و جریانها؛ رابط فارسی/انگلیسی با چیدمان مناسب هر زبان، روشن/تیره و سازگار با موبایل.
-
حساب مستقل با لینک و QR، حجم مشترک آپلود/دانلود، انقضا، سرعت و سقف جریان TCP؛ قطع اتصال، تعویض کلید و خروجی CSV.
-
ساب مستقل هر حساب با لینک و QR، حجم و انقضا، تازهسازی تنظیمات و تعویض آدرس بدون تغییر کلید تونل.
-
تنظیمات پیشرفته با توضیح روی علامت سؤال؛ حالت خودکار، مسیر محدود، متعادل و کارایی بیشتر.
-
پشتیبان، بازیابی و بهروزرسانی از خود پنل با تأیید رمز مدیر و بازگشت در صورت شکست فعالسازی. از نسخهٔ 0.14.2 پنل فقط آپدیت دارای امضای آفلاین را نشان میدهد و نصب میکند؛ نصب اولیه فقط SHA-256 را بررسی میکند.
-
دامنه، HTTPS با تمدید خودکار گواهی و مسیر ورود تصادفی؛ تنظیم از پنل یا ترمینال.
-
مسیر مستقل مستقیم، SOCKS5 یا HTTP/HTTPS CONNECT برای هر موتور؛ فهرست/بازه یا پورت آزاد مخصوص مسیر پراکسی، بدون بازکردن پورتهای مستقیم.
-
اتصال تونل به IP خود سرور بهطور پیشفرض بسته است و از نسخهٔ 0.14.3 میتوان پورتهای مشخصی از آن را با آگاهی از ریسک باز کرد. راهنما
-
ثبت اختیاری مقصدهای خروجی با نگهداری محدود، فیلتر تاریخ و ساعت دلخواه و دانلود کامل CSV/JSON؛ پیشفرض خاموش. فارسی · English.
نسخهٔ پایدار فقط بهروزرسانیهای پایدار را پیشنهاد میدهد. کاربران beta8 و جدیدتر میتوانند از خود پنل به آخرین نسخهٔ پایدار ارتقا دهند؛ نسخههای قدیمیتر باید یکبار نصبکنندهٔ بالا را اجرا کنند تا سرویس نگهداری نصب شود. حسابها، کلیدها، مصرف، تنظیمات ذخیرهشده و مسیر ورود موجود حفظ میشوند. پیش از ارتقا پشتیبان بگیرید.
کنترل نرخ شروع اتصال، IP و شبکهٔ مقصد، تشخیص اسکن، سقف آپلود خروجی و قرنطینهٔ موقت بین Soar، Cotten و MasterDNS مشترک است. تنظیمات و گزارش در صفحهٔ «ضدفلاد و کنترل سوءاستفاده» قرار دارند. پیشفرض فعال است؛ این سقفها مستقل از سقف جریان حساب هستند. راهنما، پیشفرضها و محدودیتهای حفاظت.
این انتشار پایدارِ پنل مدیریت است. پورتهای مقصد پیشفرض 80/443 هستند؛ در مسیر پراکسی میتوان سیاست پورت جدا تعیین کرد. نام دامنه روی مسیر پراکسی از DNS همان پراکسی میگذرد، پس پراکسی باید پورت 53 را به Resolverها اجازه دهد. HTTP/HTTPS CONNECT فقط TCP دارد؛ SOCKS5 به پشتیبانی UDP ASSOCIATE در پراکسی نیاز دارد و قابلیت انتقال UDP دلخواه را به موتور یا کلاینت فاقد آن اضافه نمیکند. همهٔ بازیها، تماسها و QUIC پوشش داده نمیشوند. شمارش جریان TCP معادل شمارش دستگاه نیست و لینک مشترک، هویت مشترک حساب دارد.
انتشار فقط با اجرای دستی Build and release WhiteDNS انجام میشود: تستهای Go، race، نصبکننده، بازیابی/ارتقا و مرورگر، بیلد و سپس انتشار همان فایلها در یک اجرا. PR فقط تست خودکار فقطخواندنی اجرا میکند و push و تگ بیلد خودکار راه نمیاندازند. راهنمای انتشار را ببینید. آزمون گوشی فیزیکی، شبکههای ایران و بار تولیدی گسترده هنوز کامل نیست. گزارش اختلال مرورگر نتایج و توقف مقطعی مشاهدهشده را ثبت کرده است؛ پاسخ بررسی ربات آمازون معادل بازشدن کامل فروشگاه نیست.
دانلود نسخهٔ پایدار · معماری · راهنمای کامل
- سورس اصلی Lantern Soar · وبسایت رسمی.
- موتور سمت سرور: Soar v0.2.4، تحت Apache-2.0.
- مجوز این مخزن · اعتبار وابستگیها.
ظاهر و گردش کار از پنل سنایی / 3x-ui الهام گرفتهاند؛ کد و داراییهای آن وارد این پروژه نشدهاند. پنل توسط WhiteDNS مستقل از Lantern و 3x-ui نگهداری میشود.
راهنمای SERVER-GUIDE.fa.md و دستور زیر برای سرور مستقل قدیمی باقی میمانند:
bash <(curl -fsSL https://raw.githubusercontent.com/WhiteDNS/Soar-Server/main/setup.sh)این دستور پنل نصب نمیکند؛ مدیریت آن با sudo soar-manager است. مهاجرت از پروفایل مشترک سرور مستقل به حسابهای پنل، به تأیید مهاجرت و لینکهای تازهٔ حسابها نیاز دارد.
Go 1.26.1، Python 3 و Bash در محیط توسعه لازماند:
python3 scripts/prepare_panel_engines.py --workspace .engine-source/patched.go.work
export GOWORK="$PWD/.engine-source/patched.go.work"
go build -o .engine-source/cotten-client ./.engine-source/CottenDNS/cmd/client
bash tests/panel_installer_test.sh
bash tests/panel_bootstrap_test.sh
PANEL_COTTEN_CLIENT="$PWD/.engine-source/cotten-client" go test ./... -count=1 -timeout 240s
go test -race ./internal/panel ./internal/panelops -count=1 -timeout 300s
go vet ./...
python3 scripts/build_panel_bundle.py --arch amd64
python3 scripts/build_panel_bundle.py --arch arm64
bash dist/soar-panel-0.8.0-linux-amd64/panel-install.sh --check-bundleنسخهٔ پایه، پچ و هش تمام فایلهای موتور Cotten در patches/cotten-engine.json و patches/masterdns-engine.json
ثبت شدهاند. ابزار آمادهسازی، پچ را روی همان commit اعمال و نتیجه را بررسی میکند؛
ساخت بسته نیز سورس متفاوت یا فایل کد اضافه را رد میکند. این مرحله تنظیمات،
کاربران یا پایگاه دادهٔ سرویس در حال اجرا را تغییر نمیدهد.
