چگونه تنظیمات Metadata را در cPanel & WHM مدیریت کنیم

چگونه تنظیمات Metadata را مدیریت کنیم

معتبر برای نسخه‌های 76 تا آخرین نسخه

نسخه: 76
آخرین ویرایش: 28 ژانویه 2026

Overview

مدیران WHM می‌توانند ساخت Metadata را از طریق رابط Backup Configuration مدیریت کنند:

WHM » Home » Backup » Backup Configuration

به‌صورت پیش‌فرض، هر بار که cPanel & WHM یک بکاپ ایجاد می‌کند، Metadata مربوط به آن بکاپ نیز ساخته می‌شود. ممکن است بخواهید ساخت Metadata را برای تست، قبل از ارتقا یا هنگام مشکلات عملکردی غیرفعال کنید.

نکات:

• اسکریپت backups_create_metadata برای تمام دایرکتوری‌های /home/username Metadata ایجاد می‌کند، به‌جز /mail و /.cpanel.
• برای نمایش رابط‌های زیر، باید حداقل یک بکاپ و Metadata روی دیسک محلی وجود داشته باشد:
• cPanel » Home » Files » File and Directory Restoration
• WHM » Home » Backups » File and Directory Restoration

Metadata Databases

هر بار که بکاپ ایجاد می‌شود، Metadata آن در یک دیتابیس با نام username.db ذخیره می‌شود که username نام کاربر cPanel است.

این دیتابیس در دایرکتوری .meta داخل مسیر بکاپ ذخیره می‌شود. Metadata شامل اطلاعات ایندکس‌شده است که جستجو و بازیابی را بسیار سریع‌تر از فایل‌های بکاپ حجیم انجام می‌دهد.

Metadata Database Tables

Metadata شامل جداول زیر است:

• backup_paths — مسیر فایل‌های بکاپ
• backups — لیست بکاپ‌های موجود روی دیسک
• file_changes — تغییرات فایل‌ها در بکاپ‌ها
• metadata — نسخهٔ Schema و اطلاعات Metadata
• seen_files — مسیر فایل‌های موجود در بکاپ

جدول backup_paths

Field	Type	Description	Example
backup_path	string	مسیر فایل بکاپ	/backup/2018-04-12/accounts
backup_id	integer	شناسه بکاپ	1

جدول backups

Field	Type	Description	Example
backup_id	integer	شناسه یکتا	1
timestamp	timestamp	زمان ایجاد بکاپ (UTC)	1523642274
does_exist	Boolean	وجود فایل بکاپ	1

جدول file_changes

Field	Type	Description	Example
seen_files_id	integer	شناسه فایل	1
backup_id	integer	شناسه بکاپ	1
size	integer	حجم فایل	660
mtime	integer	زمان آخرین تغییر (UTC)	1523642274
operation	integer	نوع تغییر (0=ایجاد، 1=تغییر، 2=حذف)	0
type	integer	نوع فایل (0=فایل، 1=دایرکتوری، 2=Symlink)	0

جدول metadata

Field	Type	Description	Example
key	string	نوع Schema	schema_version
value	string	نسخه Schema	3.1

جدول seen_files

Field	Type	Description	Example
file_id	integer	شناسه فایل	1
path	string	مسیر فایل نسبت به /home/username	/public_html/

The Master Meta File

فایل .master.meta شامل اطلاعات ثابت دربارهٔ بکاپ‌های کاربر است. این فایل در دایرکتوری هر حساب در بکاپ‌های روزانه، هفتگی و ماهانه وجود دارد.

Backup Directory Structure

بکاپ‌ها در مسیر /backup در سه فرمت ذخیره می‌شوند:

Format	Extension	Example
Compressed	.tar.gz	username.tar.gz
Uncompressed	.tar	username.tar
Incremental	None	username

سیستم بکاپ‌ها را با مسیر کامل آن‌ها تشخیص می‌دهد و Metadata مربوطه در جدول backup_paths ذخیره می‌شود.

Disable Metadata Creation

می‌توانید ساخت Metadata را از طریق WHM یا تنظیمات سیستمی غیرفعال کنید.

وقتی Metadata غیرفعال شود:

• رابط File and Directory Restoration در cPanel غیرفعال می‌شود.
• رابط File and Directory Restoration در WHM غیرفعال می‌شود.
• پیامی نمایش داده می‌شود که دلیل غیرفعال بودن را توضیح می‌دهد.

همچنین می‌توانید از WHM API 1 و تابع backup_config_set برای غیرفعال‌سازی Metadata استفاده کنید.

Metadata-Related Settings

Config Setting	Interface Setting	Description	Values
DISABLE_METADATA	None (API only)	فعال/غیرفعال کردن ساخت Metadata	yes / no
BACKUPACCTS	Backup Accounts	شامل کردن حساب‌های cPanel در بکاپ	yes / no
BACKUPENABLE	Backup Status	فعال/غیرفعال کردن بکاپ	yes / no
BACKUPMOUNT	Mount Backup Drive as Needed	Mount کردن مسیر بکاپ قبل از اجرا	1 / 0
KEEPLOCAL	Retain backups in default directory	نگه‌داشتن بکاپ‌های محلی	1 / 0

Conclusion

Metadata نقش مهمی در بازیابی سریع فایل‌ها و مدیریت مؤثر بکاپ‌ها دارد. با درک نحوهٔ ساخت، ذخیره‌سازی و غیرفعال‌سازی Metadata، می‌توانید عملکرد سرور را بهینه کرده و کنترل بیشتری روی فرآیند بکاپ داشته باشید.