CustomBuild در DirectAdmin – راهنمای کامل نصب، به‌روزرسانی، پیکربندی و سفارشی‌سازی پیشرفته

CustomBuild ابزار اصلی DirectAdmin برای مدیریت سرویس‌ها و نرم‌افزارهای سرور است. این ابزار وب‌سرور، PHP، دیتابیس، ایمیل، FTP و بسیاری از کامپوننت‌های دیگر را نصب، به‌روزرسانی و پیکربندی می‌کند. به دلیل کامپایل از سورس، CustomBuild انعطاف‌پذیری بسیار بالا، سرعت دسترسی به نسخه‌های جدید و مصرف منابع بهینه را فراهم می‌کند.

Advanced CustomizationCustomBuild

~3 min read • Updated Mar 1, 2026

1. CustomBuild چیست؟


CustomBuild موتور اصلی مدیریت نرم‌افزار در DirectAdmin است. این ابزار تقریباً تمام سرویس‌های مهم سرور را نصب، به‌روزرسانی و پیکربندی می‌کند:

  • وب‌سرورها (Apache، Nginx، OpenLiteSpeed)
  • PHP و نسخه‌های متعدد آن
  • MariaDB / MySQL
  • Exim، Dovecot، SpamAssassin
  • FTP (PureFTPd / ProFTPD)
  • وب‌اپلیکیشن‌ها (phpMyAdmin، RoundCube و ...)

مزیت اصلی CustomBuild این است که بیشتر نرم‌افزارها را از سورس کامپایل می‌کند، بنابراین:

  • کاملاً قابل سفارشی‌سازی است
  • نسخه‌های جدید بلافاصله قابل استفاده‌اند
  • مصرف RAM کمتر است (فقط ماژول‌های لازم کامپایل می‌شوند)
---

2. شروع کار با CustomBuild


رابط گرافیکی:


Admin Level → CustomBuild → Updates

رابط خط فرمان (CLI):

دستور اصلی:


da build

یا مستقیم:


/usr/local/directadmin/custombuild/build

فایل تنظیمات اصلی:


/usr/local/directadmin/custombuild/options.conf
---

3. دستورات مهم CustomBuild



# لیست نسخه‌های نصب‌شده
da build versions

# راهنمای کلی
da build help

# لیست تمام گزینه‌های قابل تنظیم
da build opt_help

# لیست کامل با توضیحات
da build opt_help full

# بازسازی کانفیگ وب‌سرور
da build rewrite_confs
---

4. به‌روزرسانی سرویس‌ها


به‌روزرسانی تک‌سرویس:


da build apache
da build php
da build exim
da build dovecot

به‌روزرسانی همه سرویس‌ها:


da build update_versions

نصب مجدد کامل (فقط برای تعمیرات سنگین):


da build all
---

5. به‌روزرسانی خودکار


حالت توصیه‌شده:


da build set cron yes
da build set cron_frequency weekly
da build set email [email protected]
da build set notifications yes
da build set clean_old_webapps yes
da build cron

به‌روزرسانی کاملاً خودکار (با احتیاط):


da build set updates yes
da build cron
---

6. سفارشی‌سازی پیشرفته CustomBuild


CustomBuild از ساختار custom/ برای override کردن تنظیمات استفاده می‌کند.

ساختار مهم:

  • configure/ → تنظیمات پیش‌فرض
  • custom/ → تغییرات شما (اولویت بالاتر)
---

مثال: افزودن فلگ به Nginx


cd /usr/local/directadmin/custombuild
mkdir -p custom/nginx
cp -fp configure/nginx/configure.nginx custom/nginx/configure.nginx

# ویرایش فایل و افزودن فلگ
da build nginx
---

مثال: تغییر MPM آپاچی


mkdir -p custom/ap2/conf/extra
cp -fp configure/ap2/conf/extra/httpd-mpm.conf custom/ap2/conf/extra/httpd-mpm.conf

# ویرایش فایل
da build rewrite_confs
---

7. Hookهای pre/post در CustomBuild


می‌توانید قبل یا بعد از هر build اسکریپت دلخواه اجرا کنید.

مثال:


mkdir -p custom/hooks/nginx/post
vi custom/hooks/nginx/post/myscript.sh

محتوا:


#!/bin/bash
echo "Nginx ساخته شد! اجرای کارهای سفارشی..."
---

8. انتخاب وب‌سرور مناسب


وب‌سرورمزایامعایبمناسب هاست اشتراکی؟
Apache پشتیبانی کامل .htaccess مصرف RAM بالا بله
Nginx سرعت بالا، مصرف کم بدون .htaccess خیر
Nginx + Apache سرعت + .htaccess مصرف RAM بیشتر بله (۸GB+)
OpenLiteSpeed HTTP/3، کش داخلی، سرعت عالی پشتیبانی محدود .htaccess بله
LiteSpeed بهترین عملکرد، کش قوی نیاز به لایسنس بله
---

تغییر وب‌سرور:


da build set webserver openlitespeed
da build openlitespeed
da build php
da build rewrite_confs
---

9. عیب‌یابی و نکات پیشرفته


اجرای CustomBuild در حالت دیباگ:


da build apache --debug

فایل‌های موقت در /tmp/ باقی می‌مانند.

---

رفع خطاهای g++ یا libexpat:

CentOS/RHEL:


yum -y install gcc-c++

Debian/Ubuntu:


apt-get -y install g++
---

افزودن Alias سفارشی (مثلاً /billing):


cd /usr/local/directadmin/custombuild
echo "billing=billing_system" >> custom/webapps.list
da build rewrite_confs
---

تغییر DocumentRoot ساب‌دامین:


User Level → Sub-Domains Setup → Document Root Override

Written & researched by Dr. Shahin Siami