استضافة موقع ويب ثابت في Azure Storage

2025-05-09

يمكنك تقديم محتوى ثابت (HTML وCSS وJavaScript وملفات الصور) مباشرة من حاوية في حساب V2 للأغراض العامة أو BlockBlobStorage . لمعرفة المزيد، راجع استضافة موقع ويب ثابت في Azure Storage.

توضح لك هذه المقالة كيفية تمكين استضافة موقع ويب ثابت باستخدام مدخل Azure أو Azure CLI أو PowerShell.

تمكين استضافة موقع ويب ثابت

استضافة موقع الويب الثابت هي ميزة يجب تمكينها على حساب التخزين.

سجل الدخول إلى مدخل Microsoft Azure للبدء.
حدد موقع حساب التخزين الخاص بك وحدده لعرض جزء نظرة عامة على الحساب.
في جزء Overview ، حدد علامة التبويب Capabilities . بعد ذلك، حدد موقع ويب ثابت لعرض صفحة التكوين لموقع الويب الثابت.
حدد Enabled لتمكين استضافة موقع الويب الثابت لحساب التخزين.
في حقل اسم مستند الفهرس ، حدد صفحة فهرس افتراضية (على سبيل المثال: index.html).

يتم عرض صفحة الفهرس الافتراضية عندما ينتقل المستخدم إلى جذر موقع الويب الثابت.
في حقل مسار مستند الخطأ ، حدد صفحة خطأ افتراضية (على سبيل المثال: 404.html).

يتم عرض صفحة الخطأ الافتراضية عندما يحاول مستخدم الانتقال إلى صفحة غير موجودة في موقع ويب الثابت.
انقر فوق حفظ لإنهاء تكوين الموقع الثابت.
يتم عرض رسالة تأكيد. يتم عرض نقاط نهاية موقع الويب الثابت ومعلومات التكوين الأخرى ضمن جزء نظرة عامة .

يمكنك تمكين استضافة موقع ويب ثابت باستخدام Azure CLI.

أولا، افتح Azure Cloud Shell، أو إذا قمت بتثبيت Azure CLI محليًا، افتح تطبيق وحدة تحكم أوامر مثل Windows PowerShell.
إذا كانت هويتك مرتبطة بأكثر من اشتراك واحد، فقم بتعيين اشتراكك النشط على اشتراك حساب التخزين الذي سيستضيف موقعك الثابت على الويب.
```
az account set --subscription <subscription-id>
```
استبدل قيمة <subscription-id>العنصر النائب بمعرف اشتراكك.
تمكين استضافة موقع الويب الثابت.
```
az storage blob service-properties update --account-name <storage-account-name> --static-website --404-document <error-document-name> --index-document <index-document-name>
```
- استبدل <storage-account-name> قيمة العنصر النائب باسم حساب التخزين الخاص بك.
- <error-document-name> استبدل العنصر النائب باسم مستند الخطأ الذي سيظهر للمستخدمين عندما يطلب مستعرض صفحة على موقعك غير موجودة.
- <index-document-name> استبدل العنصر النائب باسم مستند الفهرس. هذا المستند شائع "index.html".

يمكنك تمكين استضافة موقع ويب ثابت باستخدام الوحدة النمطية Azure PowerShell.

افتح نافذة أوامر Windows PowerShell.
تحقق من أن لديك وحدة Azure PowerShell النمطية Az الإصدار 0.7 أو أحدث.
```
Get-InstalledModule -Name Az -AllVersions | select Name,Version
```
إذا كنت بحاجة إلى التثبيت أو الترقية، راجع تثبيت وحدة Azure PowerShell.
سجل الدخول إلى اشتراكك في Azure باستخدام الأمر Connect-AzAccount واتبع الإرشادات التي تظهر على الشاشة.
```
Connect-AzAccount
```
إذا كانت هويتك مرتبطة بأكثر من اشتراك واحد، فقم بتعيين اشتراكك النشط على اشتراك حساب التخزين الذي سيستضيف موقعك الثابت على الويب.
```
$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
```
استبدل قيمة <subscription-id>العنصر النائب بمعرف اشتراكك.
ثم، احصل على سياق حساب التخزين الذي يحدد حساب التخزين الذي تريد استخدامه.
```
$storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
$ctx = $storageAccount.Context
```
- استبدل <resource-group-name> قيمة العنصر النائب باسم مجموعة الموارد.
- استبدل <storage-account-name> قيمة العنصر النائب باسم حساب التخزين الخاص بك.
تمكين استضافة موقع الويب الثابت.
```
Enable-AzStorageStaticWebsite -Context $ctx -IndexDocument <index-document-name> -ErrorDocument404Path <error-document-name>
```
- <error-document-name> استبدل العنصر النائب باسم مستند الخطأ الذي سيظهر للمستخدمين عندما يطلب مستعرض صفحة على موقعك غير موجودة.
- <index-document-name> استبدل العنصر النائب باسم مستند الفهرس. هذا المستند شائع "index.html".

تحميل الملفات

توضح لك الإرشادات التالية كيفية تحميل الملفات باستخدام مدخل Microsoft Azure. يمكنك أيضا استخدام AzCopy أو PowerShell أو CLI أو أي تطبيق مخصص يمكنه تحميل الملفات إلى حاوية $web لحسابك. للحصول على برنامج تعليمي خطوة بخطوة يقوم بتحميل الملفات باستخدام تعليمة Visual Studio البرمجية، راجع البرنامج التعليمي: استضافة موقع ويب ثابت على Blob Storage.

في مدخل Microsoft Azure، انتقل إلى حساب التخزين الذي يحتوي على موقع الويب الثابت الخاص بك. حدد Containers في جزء التنقل الأيمن لعرض قائمة الحاويات.
في جزء Containers ، حدد حاوية $web لفتح جزء Overview الخاص بالحاوية.
في جزء Overview ، حدد رمز Upload لفتح جزء Upload blob . بعد ذلك، حدد الحقل Files ضمن جزء Upload blob لفتح مستعرض الملفات. انتقل إلى الملف الذي تريد تحميله، وحدده، ثم حدد فتح لملء حقل الملفات . اختياريا، حدد خانة الاختيار الكتابة فوق إذا كانت الملفات موجودة بالفعل .
إذا كنت تنوي أن يعرض المستعرض محتويات الملف، فتأكد من تعيين نوع محتوى هذا الملف إلى text/html. للتحقق من ذلك، حدد اسم الكائن الثنائي كبير الحجم الذي قمت بتحميله في الخطوة السابقة لفتح جزء Overview الخاص به. تأكد من تعيين القيمة داخل حقل الخاصية CONTENT-TYPE .

إشعار

يتم تعيين هذه الخاصية تلقائيا إلى text/html للملحقات المعروفة بشكل شائع مثل .html. ومع ذلك، في بعض الحالات، سيتعين عليك تعيين هذا بنفسك. إذا لم تقم بتعيين هذه الخاصية إلى text/html، فسيطالب المستعرض المستخدمين بتنزيل الملف بدلا من عرض المحتويات. يمكن تعيين هذه الخاصية في الخطوة السابقة.

تحميل الكائنات إلى حاوية $web من دليل مصدر.

يفترض هذا المثال أنك تقوم بتشغيل أوامر من جلسة عمل Azure Cloud Shell.

az storage blob upload-batch -s <source-path> -d '$web' --account-name <storage-account-name>

إشعار

إذا طلب المستعرض من المستخدمين تنزيل الملف بدلا من عرض المحتويات، يمكنك إلحاق --content-type 'text/html; charset=utf-8' الأمر.

استبدل <storage-account-name> قيمة العنصر النائب باسم حساب التخزين الخاص بك.
<source-path> استبدل العنصر النائب بمسار إلى موقع الملفات التي تريد تحميلها.

إشعار

إذا كنت تستخدم تثبيت موقع ل Azure CLI، فيمكنك استخدام المسار إلى أي موقع على الكمبيوتر المحلي (على سبيل المثال: C:\myFolder.

إذا كنت تستخدم Azure Cloud Shell، يتعين عليك الرجوع إلى مشاركة ملف مرئية ل Cloud Shell. قد يكون هذا الموقع مشاركة ملف لمشاركة السحابة نفسها أو مشاركة ملف موجودة تقوم بتحميلها من Cloud Shell. لمعرفة كيفية القيام بذلك، راجع استمرار الملفات في Azure Cloud Shell.

تحميل الكائنات إلى حاوية $web من دليل مصدر.

# upload a file
set-AzStorageblobcontent -File "<path-to-file>" `
-Container `$web `
-Blob "<blob-name>" `
-Context $ctx

إشعار

إذا طلب المستعرض من المستخدمين تنزيل الملف بدلا من عرض المحتويات، يمكنك إلحاق -Properties @{ ContentType = "text/html; charset=utf-8";} الأمر.

<path-to-file> استبدل قيمة العنصر النائب بالمسار المؤهل بالكامل إلى الملف الذي تريد تحميله (على سبيل المثال: C:\temp\index.html).
<blob-name> استبدل قيمة العنصر النائب بالاسم الذي تريد إعطاء الكائن الثنائي كبير الحجم الناتج (على سبيل المثال: index.html).

البحث عن عنوان URL لموقع الويب

يمكنك عرض صفحات موقعك من مستعرض باستخدام عنوان URL العام لموقع الويب.

في الجزء الذي يظهر بجانب صفحة نظرة عامة على الحساب لحساب التخزين الخاص بك، حدد موقع ويب ثابت. يظهر عنوان URL لموقعك في حقل نقطة النهاية الأساسية .

قياس مقاييس مواقع الويب الثابتة ل Azure Storage

ابحث عن عنوان URL العام لموقع الويب الثابت باستخدام الأمر التالي:

az storage account show -n <storage-account-name> -g <resource-group-name> --query "primaryEndpoints.web" --output tsv

استبدل <storage-account-name> قيمة العنصر النائب باسم حساب التخزين الخاص بك.
استبدل <resource-group-name> قيمة العنصر النائب باسم مجموعة الموارد.

ابحث عن عنوان URL العام لموقع الويب الثابت باستخدام الأمر التالي:

 $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -Name "<storage-account-name>"
Write-Output $storageAccount.PrimaryEndpoints.Web

استبدل <resource-group-name> قيمة العنصر النائب باسم مجموعة الموارد.
استبدل <storage-account-name> قيمة العنصر النائب باسم حساب التخزين الخاص بك.

تمكين المقاييس على صفحات موقع ويب ثابتة

بمجرد تمكين المقاييس، يتم الإبلاغ عن إحصائيات نسبة استخدام الشبكة على الملفات في حاوية $web في لوحة معلومات المقاييس.

انقر فوق Metrics ضمن قسم Monitor من قائمة حساب التخزين.

إشعار

يتم إنشاء بيانات المقاييس عن طريق ربط واجهات برمجة التطبيقات للمقاييس المختلفة. يعرض المدخل فقط أعضاء واجهة برمجة التطبيقات المستخدمة ضمن إطار زمني معين للتركيز فقط على الأعضاء الذين يرجعون البيانات. من أجل التأكد من أنك قادر على تحديد عضو واجهة برمجة التطبيقات الضروري، فإن الخطوة الأولى هي توسيع الإطار الزمني.
انقر فوق زر الإطار الزمني، واختر إطارا زمنيا، ثم انقر فوق تطبيق.
حدد Blob من القائمة المنسدلة Namespace .
ثم حدد مقياس Egress .
حدد Sum من محدد التجميع .
انقر فوق الزر إضافة عامل تصفية واختر اسم واجهة برمجة التطبيقات من محدد الخاصية .
حدد المربع بجوار GetWebContent في محدد القيم لملء تقرير المقاييس.

إشعار

تظهر خانة الاختيار GetWebContent فقط إذا تم استخدام عضو واجهة برمجة التطبيقات هذا ضمن إطار زمني معين. يعرض المدخل فقط أعضاء واجهة برمجة التطبيقات المستخدمة ضمن إطار زمني معين للتركيز فقط على الأعضاء الذين يرجعون البيانات. إذا لم تتمكن من العثور على عضو API معين في هذه القائمة، فقم بتوسيع الإطار الزمني.