MasterDnsWeb یک پنل وب برای مدیریت اینستنسهای MasterDnsVPN روی سرور لینوکس شماست. از طریق مرورگر میتوانید اینستنسهای VPN را بسازید، تنظیم کنید، راهاندازی کنید و متوقف کنید.
این پروژه در درجه اول برای استفاده روی سرورهای VPS مستقر در ایران طراحی شده است.
- Ubuntu 20.04 یا جدیدتر (سایر توزیعها فعلاً پشتیبانی نمیشوند)
- فایل فشرده نسخه:
MasterDnsWeb-linux-amd64.tar.gz - دسترسی روت (برای مدیریت سرویسهای سیستم)
tar -xzf MasterDnsWeb-linux-amd64.tar.gz
cd MasterDnsWebپس از استخراج، ساختار پوشه به این شکل است:
MasterDnsWeb/
MasterDnsWeb ← پنل وب (این را اجرا کنید)
MasterDnsVPN ← باینری کلاینت VPN
.env ← تنظیمات شما
فایل .env را با هر ویرایشگری باز کنید:
nano .envتنها مواردی که باید قبل از راهاندازی تغییر دهید:
ADMIN_USERNAME=admin
ADMIN_PASSWORD=changeme ← یک رمز قوی بگذاریدبقیه مقادیر پیشفرض امن هستند. ذخیره کنید و ببندید.
sudo ./MasterDnsWebچرا sudo؟ پنل برای ساختن و کنترل سرویسهای سیستم به دسترسی روت نیاز دارد.
پنل در حال اجراست. مرورگر خود را باز کنید و به آدرس زیر بروید:
http://<آیپی-سرور-شما>:8000
با نام کاربری و رمزی که در .env تنظیم کردید وارد شوید.
اگر میخواهید پنل بعد از ریست شدن سرور بهطور خودکار راهاندازی شود، یک سرویس سیستم بسازید.
این دستور را اجرا کنید (مسیر /root/MasterDnsWeb را با مسیر واقعی پوشه خود جایگزین کنید):
sudo nano /etc/systemd/system/masterdnsweb.serviceمحتوای زیر را داخل آن بگذارید:
[Unit]
Description=MasterDnsWeb Panel
After=network.target
[Service]
WorkingDirectory=/root/MasterDnsWeb
ExecStart=/root/MasterDnsWeb/MasterDnsWeb
Restart=always
RestartSec=5
User=root
[Install]
WantedBy=multi-user.targetسپس اجرا کنید:
sudo systemctl daemon-reload
sudo systemctl enable masterdnsweb
sudo systemctl start masterdnsweb- به صفحه Instances بروید
- روی New Instance کلیک کنید و یک نام بدهید
- روی اینستنس کلیک کنید تا صفحه Configuration آن باز شود
محتوای فایل client_config.toml خود را در کادر Configuration قرار دهید.
تمام فیلدهای فایل کانفیگ پذیرفته میشوند — کل فایل را paste کنید.
آیپیهای resolver را در کادر Resolvers وارد کنید (هر خط یک آیپی)، سپس روی Apply & Restart کلیک کنید.
از دکمههای Start، Stop و Restart در صفحه Instances استفاده کنید. هر اینستنس بهعنوان یک سرویس مستقل در پسزمینه اجرا میشود.
پنل این پوشهها را بهصورت خودکار کنار باینری میسازد:
MasterDnsWeb/
MasterDnsWeb ← باینری پنل وب
MasterDnsVPN ← باینری کلاینت VPN
.env ← تنظیمات شما
data/ ← پروفایل اینستنسها (خودکار ساخته میشود)
runtime/
my-instance/ ← فایلهای کاری هر اینستنس (خودکار ساخته میشود)
client_config.toml
client_resolvers.txt
MasterDnsVPN
تمام تنظیمات در فایل .env کنار باینری قرار دارند.
| تنظیم | پیشفرض | توضیح |
|---|---|---|
ADMIN_USERNAME |
admin |
نام کاربری ورود |
ADMIN_PASSWORD |
changeme |
رمز عبور — حتماً تغییر دهید |
SECRET_KEY |
(تولید شده در زمان بیلد) | امضای جلسه ورود — به اشتراک نگذارید |
HOST |
0.0.0.0 |
آدرسی که پنل روی آن گوش میدهد |
PORT |
8000 |
پورتی که پنل روی آن گوش میدهد |
COOKIE_SECURE |
false |
اگر از HTTPS استفاده میکنید true کنید |
MASTERVPN_SERVICE_USER |
root |
کاربر سیستمی که اینستنسهای VPN را اجرا میکند |
MASTERVPN_SERVICE_EXEC_START |
(خودکار) | مسیر کامل MasterDnsVPN — فقط در صورتی که در همان پوشه نباشد |
flowchart TB
U[شما — مرورگر] --> PANEL[MasterDnsWeb\nپورت ۸۰۰۰]
PANEL --> AUTH[ورود و جلسه]
PANEL --> CFG[پروفایل اینستنسها\nذخیرهشده در data/]
PANEL --> SVC[مدیریت سرویس]
PANEL --> STATS[آمار سرور\nCPU · RAM · Disk]
SVC --> RUNTIME[runtime/instance-name/\nclient_config.toml\nclient_resolvers.txt\nMasterDnsVPN]
SVC --> SYSTEMD[systemd\nmasterdnsvpn-instance.service]
SYSTEMD --> VPN[پروسه MasterDnsVPN]
RUNTIME --> VPN
| مشکل | راهحل |
|---|---|
| پنل راهاندازی نمیشود | مطمئن شوید با sudo اجرا میکنید. دسترسی روت برای مدیریت سرویسها لازم است. |
| در مرورگر باز نمیشود | فایروال را بررسی کنید — پورت 8000 (یا PORT سفارشی شما) باید باز باشد. |
| "MasterDnsVPN binary was not found" | مطمئن شوید MasterDnsVPN در همان پوشه MasterDnsWeb قرار دارد. یا مسیر کامل آن را در .env با MASTERVPN_SERVICE_EXEC_START تنظیم کنید. |
| اینستنس راهاندازی نمیشود | اینستنس را در پنل باز کنید و لاگها را برای جزئیات بررسی کنید. |
تشکر ویژه از @shimafallah برای نوشتن بکاند.