~2 دقیقه مطالعه • بروزرسانی ۱۰ اسفند ۱۴۰۴
1. محل قرارگیری باینری DirectAdmin
فایل اصلی DirectAdmin در مسیر زیر قرار دارد:
/usr/local/directadmin/directadmin
در زمان نصب، یک symlink ایجاد میشود:
/usr/bin/da
بنابراین میتوانید بهجای مسیر کامل، فقط از da استفاده کنید.
این باینری هم وبسرور DirectAdmin را اجرا میکند و هم ابزارهای CLI را فراهم میکند.
2. اجرای سرویس DirectAdmin
روش استاندارد (systemd):
systemctl start directadmin
systemctl stop directadmin
systemctl restart directadmin
اجرای دستی (فقط برای تست و دیباگ):
systemctl stop directadmin
da server --debug=2000
--debug=2000 بالاترین سطح دیباگ را فعال میکند.
سطوح رایج: d80، d400، d800، d2000
هشدار: اجرای دستی در محیط تولید توصیه نمیشود؛ با بسته شدن ترمینال سرویس متوقف میشود.
---3. دستورات رایج da
| دستور | توضیح | مثال |
|---|---|---|
| da version | نمایش نسخه DirectAdmin | da version |
| da admin | نمایش نام ادمین اصلی (معمولاً admin) | da admin |
| da license | نمایش اطلاعات لایسنس | da license |
| da update | بهروزرسانی DirectAdmin به آخرین نسخه | da update |
| da config | نمایش تمام متغیرهای directadmin.conf | da config |
| da config-set key value | تغییر یک متغیر | da config-set letsencrypt 1 |
| da login-url --user=admin | ساخت URL ورود یکبارمصرف | خروجی: لینک ورود موقت |
| da api-url --user=fred | ساخت URL دسترسی API با login key | خروجی: URL شامل کلید |
| da suspend-user --user=fred | سسپند کردن کاربر | da suspend-user --user=fred --reason=abuse |
| da unsuspend-user --user=fred | فعالسازی مجدد کاربر | da unsuspend-user --user=fred |
| da suspend-domain --domain=example.com | سسپند کردن دامنه | da suspend-domain --domain=example.com |
| da docs-root | نمایش DocumentRoot تمام دامنهها (JSON) | da docs-root |
4. ساخت URL ورود یکبارمصرف (login-url)
برای ورود سریع بدون رمز عبور:
da login-url --user=admin
نمونه خروجی:
URL: https://server.example.com:2222/api/login/url?key=VGhpcyBpcyBub3QgYSByZWFsIGtleSEh
گزینههای اضافی:
- --redirect-url=/CMD_PLUGINS_ADMIN/plugin → هدایت به صفحه خاص
- --expiry=1d → انقضا (ثانیه، دقیقه، ساعت، روز، هفته، ماه، سال)
- --ip=1.2.3.4 → محدود به IP خاص
نکته امنیتی: این URL فقط یک بار معتبر است.
---5. ساخت URL دسترسی API
برای اسکریپتها و اتوماسیون:
da api-url --user=admin
نمونه خروجی:
https://admin:[email protected]:2222
استفاده در curl:
curl -k "$(da api-url)/CMD_API_SHOW_ALL_USERS?json=yes"
6. مدیریت Suspend و Unsuspend از CLI
(نسخه 1.595+)
da suspend-user --user=fred --reason=abuse
da unsuspend-user --user=fred
da suspend-domain --domain=example.com
da unsuspend-domain --domain=example.com
7. نمایش DocumentRoot تمام دامنهها
da docs-root
خروجی JSON شامل مسیر public_html و private_html تمام دامنهها و سابدامنهها.
---8. سایر دستورات مفید
- da install → اجرای دوباره installer
- da permissions → تنظیم مجدد پرمیشنهای DirectAdmin
- da taskq → اجرای دستی dataskq
- da doveadm-quota [email protected] → نمایش کووتای Dovecot
نوشته و پژوهش شده توسط دکتر شاهین صیامی