بکاپ روی موقعیت‌های ریموت (Backup to remote locations)

در حال حاضر تنها گزینه پیش‌فرض برای بکاپ روی سرورهای ریموت، انتقال به سرور FTP است.
این گزینه از طریق رابط گرافیکی Admin Backup/Transfer پیکربندی می‌شود. همچنین می‌توان از FTPS استفاده کرد.

تست دستی اسکریپت ftp_upload.php

اگر در ارسال بکاپ به سرور FTP مشکلی داشتید و می‌خواهید آن را دیباگ کنید، می‌توانید اسکریپت ftp_upload.php را دستی اجرا کنید.

cd /usr/local/directadmin/scripts
ftp_port=21 ftp_local_file=/path/to/a/file.txt ftp_ip=1.2.3.4 ftp_username=fred ftp_password_esc_double_quote=fredspass ftp_path=/remote/path ftp_secure=ftps ./ftp_upload.php

اگر مشکلی وجود داشته باشد، روی صفحه نمایش داده می‌شود.
همچنین باید لاگ‌های FTP روی سرور ریموت را بررسی کنید یا سرور FTP را در حالت دیباگ اجرا کنید.

متغیرهای محیطی برای ftp_upload.php

اگر قصد دارید این اسکریپت را شخصی‌سازی کنید، باید همه متغیرهایی که در دسترس دارید را بشناسید.
مثال زیر لیستی از متغیرها برای یک بکاپ زمان‌بندی‌شده (cron) با ID=1 و برای کاربر تستی testuser است:

action=backup
append_to_path=nothing
database_data_aware=yes
dayofmonth=5
dayofweek=*
email_data_aware=yes
ftp_ip=127.0.0.1
ftp_local_file=/home/tmp/admin/user.admin.testuser.tar.gz
ftp_local_path=/home/tmp/admin
ftp_password=pass"word
ftp_password_esc_double_quote=pass\"word
ftp_path=/admin_backups
ftp_port=21
ftp_remote_file=user.admin.testuser.tar.gz
ftp_username=admin
hour=5
id=1
minute=0
month=1
owner=admin
select0=testuser
type=admin
value=multiple
when=now
where=ftp

برای تست گرفتن لیست کامل متغیرها:

cd /usr/local/directadmin/scripts/custom
cp /var/www/cgi-bin/printenv ftp_upload.php
echo "exit 1;" >> ftp_upload.php
chmod 755 ftp_upload.php
./ftp_upload.php

در صورت نیاز، خط اول فایل را به #!/usr/bin/perl تغییر دهید.

استفاده از ID برای رفتار متفاوت

مثلاً اگر بخواهید بکاپ ID=1 به‌جای FTP از scp آپلود شود:

if [ "$id" = "1" ]; then
   #scp upload code
   exit 0;
fi

تبدیل ftp_upload.php به curl یا ncftpput

به‌صورت پیش‌فرض DirectAdmin از PHP برای آپلود استفاده می‌کند. اما می‌توانید آن را تغییر دهید:

با استفاده از curl

cp -rp /usr/local/directadmin/scripts/ftp_upload.php /usr/local/directadmin/scripts/custom/ftp_upload.php

محتوای فایل جدید:

/bin/sh
ETH=eth0
CURL=/usr/local/bin/curl

result=`$CURL --interface $ETH -T $ftp_local_file -u $ftp_username:$ftp_password_esc_double_quote ftp://$ftp_ip$ftp_path$ftp_remote_file 2>&1`

if grep -q -o -i "curl: (67) Access denied: 530.*$$" <<< "$result"; then
    echo "FTP access denied. Please check your login details."
    exit 1
fi
if grep -q -o -i "curl: (6) Couldn't resolve host.*$$" <<< "$result"; then
    echo "Host could not be resolved. Please check your host details."
    exit 1
fi
if grep -q -o -i "curl: (9) Uploaded unaligned file size.*$$" <<< "$result"; then
    echo "File could not be uploaded. Please check your path."
    exit 1
fi
if grep -q -o -i "curl: Can't open.*$$" <<< "$result"; then
    echo "Can't open $ftp_local_file"
    exit 1
fi

با استفاده از ncftpput

/bin/sh
/usr/bin/ncftpput -t 25 -m -u "$ftp_username" -p "$ftp_password_esc_double_quote" "$ftp_ip" "$ftp_path" "$ftp_local_file" 2>&1
RET=$?
exit $RET

روش اصلی با PHP

<?php
$ftp_server = getenv("ftp_ip");
$ftp_user_name = getenv("ftp_username");
$ftp_user_pass = getenv("ftp_password");
$ftp_remote_path = getenv("ftp_path");
$ftp_remote_file = getenv("ftp_remote_file");
$ftp_local_file = getenv("ftp_local_file");

$conn_id = ftp_connect($ftp_server);
$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);
ftp_pasv($conn_id, true);
ftp_mkdir($conn_id, $ftp_remote_path);
ftp_chdir($conn_id, $ftp_remote_path);

if (ftp_put($conn_id, $ftp_remote_file, $ftp_local_file, FTP_BINARY)) {
    ftp_close($conn_id);
    exit(0);
} else {
    echo "Error while uploading $ftp_remote_file";
    ftp_close($conn_id);
    exit(4);
}
?>

تبدیل ftp_download.php به ncftpget

اگر می‌خواهید برای دانلود بکاپ‌ها به‌جای PHP از ncftpget استفاده کنید:

/bin/sh
FTPGET=/usr/bin/ncftpget
TOUCH=/bin/touch
PORT=${ftp_port}

CFG=${ftp_local_file}.cfg
/bin/rm -f $CFG
$TOUCH $CFG
/bin/chmod 600 $CFG
/bin/echo "host $ftp_ip" >> $CFG
/bin/echo "user $ftp_username" >> $CFG
/bin/echo "pass $ftp_password_esc_double_quote" >> $CFG

$FTPGET -C -f $CFG -V -t 25 -P $PORT "$ftp_ip" "$ftp_path/$ftp_remote_file" "$ftp_local_file" 2>&1
RET=$?

/bin/rm -f $CFG
exit $RET

قابل اجرا با:

chmod 755 /usr/local/directadmin/scripts/custom/ftp_download.php

کاهش سرعت بکاپ برای جلوگیری از فشار روی FTP

اگر کاربران زیادی دارید، می‌توانید بعد از هر بکاپ مکث اضافه کنید:

/usr/local/directadmin/scripts/custom/user_backup_post.sh

#!/bin/sh
sleep 20
exit 0;

و قابل اجرا کردن:

chmod 755 /usr/local/directadmin/scripts/custom/user_backup_post.sh

این کار باعث می‌شود بعد از هر بکاپ ۲۰ ثانیه مکث شود.

ساخت سرور بکاپ افزونه (Redundant Backup Server)

به‌طور پیش‌فرض DirectAdmin برای یک سرور طراحی شده. اما می‌توانید:

• بکاپ‌های شبانه را به یک سرور DirectAdmin دیگر منتقل کرده و به‌صورت خودکار ریستور کنید.
• یا از rsync برای همگام‌سازی فایل‌ها استفاده کنید. این روش پهنای‌باند کمتری مصرف می‌کند و فقط تغییرات را منتقل می‌کند.

افزودن تاریخ به نام بکاپ

پیش‌فرض DirectAdmin تاریخ را به اسم فایل بکاپ اضافه نمی‌کند. برای این کار:

cd /usr/local/directadmin/scripts/custom
cp ../ftp_upload.php .
chmod 755 ./ftp_upload.php

داخل فایل:

ftp_remote_file="`echo $ftp_remote_file | awk -F. '{for (i=1; i<NF-1; i++) printf("%s.", $i)}'``date +%F`.tar.zst"

این باعث می‌شود تاریخ (مثلاً 2025-09-17) به نام فایل بکاپ اضافه شود.