متغيّرات البيئة وإعدادات التطبيق في Azure App Service

إشعار

بدءا من 1 يونيو 2024، سيكون لجميع تطبيقات App Service التي تم إنشاؤها حديثا خيار إنشاء اسم مضيف افتراضي فريد باستخدام اصطلاح <app-name>-<random-hash>.<region>.azurewebsites.netالتسمية . ستظل أسماء التطبيقات الحالية دون تغيير.

مثال: myapp-ds27dh7271aah175.westus-01.azurewebsites.net

لمزيد من التفاصيل، راجع اسم المضيف الافتراضي الفريد لمورد App Service.

في Azure App Service، تتوفر إعدادات معينة لبيئة التوزيع أو وقت التشغيل كمتغيّرات البيئة. يمكن تخصيص بعض هذه الإعدادات عند تعيينها يدويًا كإعدادات للتطبيق. يوضح هذا المرجع المتغيرات التي يمكنك استخدامها أو تخصيصها.

بيئة التطبيق

ترتبط متغيرات البيئة التالية ببيئة التطبيق بشكل عام.

اسم الإعداد ‏‏الوصف مثال
WEBSITE_SITE_NAME قراءة فقط. اسم التطبيق.
WEBSITE_RESOURCE_GROUP قراءة فقط. اسم مجموعة موارد Azure التي تحتوي على مورد التطبيق.
WEBSITE_OWNER_NAME قراءة فقط. يحتوي على معرّف اشتراك Azure الذي يمتلك التطبيق ومجموعة الموارد ومساحة الويب.
REGION_NAME قراءة فقط. اسم المنطقة للتطبيق.
WEBSITE_PLATFORM_VERSION قراءة فقط. إصدار نظام App Service الأساسي.
HOME قراءة فقط. المسار إلى الدليل الرئيسي (على سبيل المثال، D:\home لنظام التشغيل Windows).
SERVER_PORT قراءة فقط. المنفذ الذي يجب أن يتبعه التطبيق.
WEBSITE_WARMUP_PATH مسار نسبي لأداة اختبار الاتصال تعمل على إعداد التطبيق، وهو يبدأ بشرطة مائلة. الافتراضي هو /، والذي يقوم باختبار اتصال مسار الجذر. يمكن اختبار اتصال المسار المحدد بواسطة عميل لم تتم مصادقته، مثل Azure Traffic Manager، حتى إذا تم تعيين مصادقة App Service على رفض العملاء غير المصادق عليهم. (ملاحظة: لا يغير إعداد التطبيق هذا المسار الذي يستخدمه AlwaysOn.)
WEBSITE_COMPUTE_MODE قراءة فقط. يحدد ما إذا كان التطبيق يعمل على جهاز ظاهري/أجهزة مخصصة (Dedicated) أو مشتركة (Shared).
WEBSITE_SKU قراءة فقط. رمز التخزين التعريفي للتطبيق. القيم المُحتملة هي Free، وShared، وBasic وStandard.
SITE_BITNESS قراءة فقط. يوضح ما إذا كان التطبيق 32 بت (x86) أو 64 بت (AMD64).
WEBSITE_HOSTNAME قراءة فقط. اسم المضيف الأساسي للتطبيق. لا يتم حساب أسماء المضيفين المخصصة هنا.
WEBSITE_VOLUME_TYPE قراءة فقط. يعرض نوع حجم التخزين قيد الاستخدام حاليًا.
WEBSITE_NPM_DEFAULT_VERSION إصدار نظام إدارة الحزم الافتراضي الذي يستخدمه التطبيق.
WEBSOCKET_CONCURRENT_REQUEST_LIMIT قراءة فقط. حد لطلبات WebSocket المتزامنة. بالنسبة إلى المستوى القياسي وما فوق، تكون القيمة -1، ولكن لا يزال هناك حد لكل جهاز ظاهري بناءً على حجم جهازك (راجع الحدود الرقمية المتقاطعة للأجهزة الظاهرية).
WEBSITE_PRIVATE_EXTENSIONS قم بالتعيين على 0 لتعطيل استخدام ملحقات المواقع الخاصة.
WEBSITE_TIME_ZONE بشكلٍ افتراضي، تكون المنطقة الزمنية للتطبيق هي دائمًا التوقيت العالمي المتفق عليه (UTC). يمكنك تغييره إلى أي من القيم الصالحة المدرجة في المناطق الزمنية الافتراضية. إذا لم يتم التعرف على القيمة المحددة، فسيتم استخدام التوقيت العالمي المتفق عليه (UTC). Atlantic Standard Time
WEBSITE_ADD_SITENAME_BINDINGS_IN_APPHOST_CONFIG بعد تبديل الفتحات، قد يواجه التطبيق عمليات إعادة تشغيل غير متوقعة. هذا لأنه بعد التبديل، يصبح تكوين ربط اسم المضيف غير متزامن، وهو ما لا يتسبب في حد ذاته في إعادة التشغيل. ومع ذلك، قد تكتشف بعض أحداث التخزين الأساسية (مثل حالات تجاوز فشل وحدات التخزين) هذه التناقضات وتجبر جميع عمليات العاملين على إعادة التشغيل. لتقليل هذه الأنواع من عمليات إعادة التشغيل، اضبط قيمة إعداد التطبيق على 1في جميع الفتحات (القيمة الافتراضية هي 0). ومع ذلك، لا تقم بتعيين هذه القيمة إذا كنت تقوم بتشغيل تطبيق Windows Communication Foundation (WCF). لمزيد من المعلومات، راجع استكشاف الأخطاء في عمليات التبديل وإصلاحها
WEBSITE_PROACTIVE_AUTOHEAL_ENABLED بشكل افتراضي، تتم "المعالجة التلقائية" بشكل استباقي للجهاز الظاهري عند استخدام أكثر من 90% من الذاكرة المخصصة لأكثر من 30 ثانية، أو عندما تستغرق 80% من إجمالي الطلبات في آخر دقيقتين أكثر من 200 ثانية. إذا قام مثيل جهاز ظاهري بتشغيل إحدى هذه القواعد، تصبح عملية الاسترداد عملية إعادة تشغيل متداخلة للمثيل. قم بالتعيين إلى false لتعطيل سلوك الاسترداد هذا. الافتراضي هو true. لمزيد من المعلومات، راجع المعالجة التلقائية الاستباقية.
WEBSITE_PROACTIVE_CRASHMONITORING_ENABLED كلما تعطلت عملية w3wp.exe على مثيل جهاز ظاهري لتطبيقك بسبب استثناء غير معالج لأكثر من ثلاث مرات في 24 ساعة، يتم إرفاق عملية مصحح الأخطاء بالعملية المنفذة الرئيسية في هذا المثيل، وتجمع تفريغ الذاكرة عند تعطل العملية العاملة مرة أخرى. ثم يتم تحليل تفريغ الذاكرة هذا ويتم تسجيل مكدس الاستدعاءات لسلسلة الرسائل التي تسببت في التعطل في سجلات App Service. قم بالتعيين على false لتعطيل سلوك المراقبة التلقائية هذا. الافتراضي هو true. لمزيد من المعلومات، راجع المراقبة الاستباقية للأعطال.
WEBSITE_DAAS_STORAGE_SASURI أثناء مراقبة التعطل (استباقي أو يدوي)، يتم حذف عمليات تفريغ الذاكرة بشكل افتراضي. لحفظ عمليات تفريغ الذاكرة في حاوية تخزين البيانات الثنائية الكبيرة، حدد SAS URI.
WEBSITE_CRASHMONITORING_ENABLED قم بالتعيين على true لتمكين مراقبة الأعطال يدويًا. يجب عليك أيضًا تعيين WEBSITE_DAAS_STORAGE_SASURI وWEBSITE_CRASHMONITORING_SETTINGS. الافتراضي هو false. هذا الإعداد ليس له أي تأثير إذا تم تمكين تصحيح الأخطاء عن بعد. أيضًا، إذا تم تعيين هذا الإعداد على true، فسيتم تعطيل مراقبة الأعطال الاستباقية .
WEBSITE_CRASHMONITORING_SETTINGS JSON بالتنسيق التالي: {"StartTimeUtc": "2020-02-10T08:21","MaxHours": "<elapsed-hours-from-StartTimeUtc>","MaxDumpCount": "<max-number-of-crash-dumps>"}. مطلوب لتهيئة مراقبة الأعطال إذا تم تحديد WEBSITE_CRASHMONITORING_ENABLED. لتسجيل مكدس الاستدعاءات فقط دون حفظ تفريغ الأعطال في حساب التخزين، أضف ,"UseStorageAccount":"false" في JSON.
REMOTEDEBUGGINGVERSION نسخة تصحيح الأخطاء عن بعد.
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING بشكل افتراضي، ينشئ App Service مساحة تخزين مشتركة لك عند إنشاء التطبيق. لاستخدام حساب تخزين مخصص بدلاً من ذلك، قم بتعيين سلسلة الاتصال لحساب التخزين الخاص بك. بالنسبة للوظائف، راجع مرجع إعدادات التطبيق للوظائف. DefaultEndpointsProtocol=https;AccountName=<name>;AccountKey=<key>
WEBSITE_CONTENTSHARE عند استخدام تحديد حساب تخزين مخصص مع WEBSITE_CONTENTAZUREFILECONNECTIONSTRING، ينشئ App Service مشاركة ملف في حساب التخزين هذا لتطبيقك. لاستخدام اسم مخصص، اضبط هذا المتغيّر على الاسم الذي تريده. في حالة عدم وجود مشاركة ملف بالاسم المحدد، يقوم App Service بإنشائه لك. myapp123
WEBSITE_SCM_ALWAYS_ON_ENABLED قراءة فقط. يوضح ما إذا كانت "مجموعات قابلية وصول عالية التوفر AlwaysOn" ممكّنًة (1) أم لا (0).
WEBSITE_SCM_SEPARATE_STATUS قراءة فقط. يوضح ما إذا كان تطبيق Kudu يعمل في عملية منفصلة (1) أم لا (0).
WEBSITE_DNS_ATTEMPTS عدد المرات التي يجب فيها محاولة حل الاسم.
WEBSITE_DNS_TIMEOUT عدد الثوان التي يجب انتظارها لحل الاسم

بادئات المتغيّر

يعرض الجدول التالي بادئات متغير البيئة التي تستخدمها App Service لأغراض مختلفة.

اسم الإعداد ‏‏الوصف
APPSETTING_ يشير إلى أن متغيرًا تم تعيينه بواسطة العميل كإعداد تطبيق في تكوين التطبيق. يتم إدخاله في تطبيق .NET كإعداد للتطبيق.
MAINSITE_ يشير إلى أن المتغيّر خاص بالتطبيق نفسه.
SCMSITE_ يشير إلى أن المتغيّر خاص بتطبيق Kudu.
SQLCONNSTR_ تشير إلى سلسلة اتصال SQL Server في تكوين التطبيق. يتم إدراجها في تطبيق .NET كسلسلة اتصال.
SQLAZURECONNSTR_ تشير إلى سلسلة اتصال قاعدة بيانات Azure SQL في تكوين التطبيق. يتم إدراجها في تطبيق .NET كسلسلة اتصال.
POSTGRESQLCONNSTR_ تشير إلى سلسلة اتصال PostgreSQL في تكوين التطبيق. يتم إدراجها في تطبيق .NET كسلسلة اتصال.
CUSTOMCONNSTR_ تشير إلى سلسلة اتصال مخصصة في تكوين التطبيق. يتم إدراجها في تطبيق .NET كسلسلة اتصال.
MYSQLCONNSTR_ يشير إلى سلسلة الاتصال قاعدة بيانات MySQL في تكوين التطبيق. يتم إدراجها في تطبيق .NET كسلسلة اتصال.
AZUREFILESSTORAGE_ سلسلة اتصال بمشاركة مخصصة لحاوية مخصصة في ملفات Azure.
AZUREBLOBSTORAGE_ سلسلة اتصال بحساب تخزين مخصص لحاوية مخصصة في Azure Blob Storage.
NOTIFICATIONHUBCONNSTR_ تشير إلى سلسلة اتصال إلى مركز إعلام في Azure Notification Hubs.
SERVICEBUSCONNSTR_ تشير إلى سلسلة اتصال بمثيل Azure Service Bus.
EVENTHUBCONNSTR_ تشير إلى سلسلة اتصال إلى مركز أحداث في Azure Event Hubs.
DOCDBCONNSTR_ تشير إلى سلسلة اتصال بقاعدة بيانات في Azure Cosmos DB.
REDISCACHECONNSTR_ تشير إلى سلسلة اتصال بذاكرة تخزين مؤقت في Azure Cache لـ Redis.
FILESHARESTORAGE_ يشير إلى سلسلة اتصال لمشاركة ملف مخصص.

التوزيع

ترتبط متغيّرات البيئة التالية بتوزيع التطبيق. بالنسبة إلى المتغيّرات المتعلقة بأتمتة إصدار App Service، راجع أتمتة الإنشاء.

اسم الإعداد ‏‏الوصف
DEPLOYMENT_BRANCH بالنسبة لتوزيع Git المحلي أو Cloud Git (مثل GitHub)، قم بتعيين الفرع في Azure الذي تريد التوزيع إليه. بشكل افتراضي، يكون master.
WEBSITE_RUN_FROM_PACKAGE قم بالتعيين على 1 لتشغيل التطبيق من حزمة ZIP محلية، أو قم بتعيين عنوان URL الخاص بعنوان URL خارجي لتشغيل التطبيق من حزمة ZIP بعيدة. لمزيد من المعلومات، راجع تشغيل التطبيق في Azure App Service مباشرة من حزمة ZIP.
WEBSITE_USE_ZIP ‏‏مهمل. استخدم WEBSITE_RUN_FROM_PACKAGE.
WEBSITE_RUN_FROM_ZIP ‏‏مهمل. استخدم WEBSITE_RUN_FROM_PACKAGE.
SCM_MAX_ZIP_PACKAGE_COUNT يحتفظ تطبيقك ب 5 من أحدث ملفات zip المنشورة باستخدام توزيع zip. يمكنك الاحتفاظ بأكثر من ذلك أو أقل عن طريق تعيين إعداد التطبيق إلى رقم مختلف.
WEBSITE_WEBDEPLOY_USE_SCM قم بالتعيين إلى false لكي يتوقف WebDeploy عن استخدام محرك توزيع Kudu. الافتراضي هو true. للتوزيع إلى تطبيقات Linux باستخدام Visual Studio (WebDeploy/MSDeploy)، اضبطه على false.
MSDEPLOY_RENAME_LOCKED_FILES قم بالتعيين إلى 1 لمحاولة إعادة تسمية مكتبات DLL إذا تعذر نسخها في أثناء توزيع WebDeploy. لا ينطبق هذا الإعداد إذا WEBSITE_WEBDEPLOY_USE_SCM تم تعيينه إلى false.
WEBSITE_DISABLE_SCM_SEPARATION بشكل افتراضي، يعمل التطبيق الرئيسي وتطبيق Kudu في صناديق رمل مختلفة. عند إيقاف التطبيق، لا يزال تطبيق Kudu قيد التشغيل، ويمكنك الاستمرار في استخدام Git publish وMSDeploy. يحتوي كل تطبيق على ملفاته المحلية الخاصة به. يعد إيقاف تشغيل هذا الفصل (الإعداد على true) وضعًا قديمًا لم يعد مدعومًا بشكل كامل.
WEBSITE_ENABLE_SYNC_UPDATE_SITE قم بالتعيين إلى 1 تأكد من أن استدعاءات REST API للتحديث site وsiteconfig يتم تطبيقها بالكامل على جميع المثيلات قبل العودة. الإعداد الافتراضي هو 1 في حالة التوزيع باستخدام قالب ARM، لتجنب ظروف السباق مع استدعاءات ARM اللاحقة.
WEBSITE_START_SCM_ON_SITE_CREATION عند توزيع قالب ARM، اضبط على 1 في نموذج ARM لبدء تطبيق Kudu مسبقًا كجزء من إنشاء التطبيق.
WEBSITE_START_SCM_WITH_PRELOAD بالنسبة لتطبيقات Linux، اضبط على true لفرض التحميل في الخلفية على تطبيق Kudu عند تمكين مجموعات قابلية وصول عالية التوفر AlwaysOn عن طريق اختبار اتصال عنوان URL الخاص به. الافتراضي هو false. بالنسبة لتطبيقات Windows، يتم دائمًا تحميل تطبيق Kudu في الخلفية.

بناء الأتمتة

ينطبق تكوين بناء Kudu على تطبيقات Windows الأصلية ويستخدم للتحكم في سلوك عمليات التوزيع المستندة إلى Git (أو المستندة إلى ZIP).

اسم الإعداد ‏‏الوصف مثال
SCM_BUILD_ARGS أضف أشياء في نهاية سطر أوامر msbuild، بحيث يتجاوز أي أجزاء سابقة من سطر الأوامر الافتراضي. لإنشاء بنية نظيفة: -t:Clean;Compile
SCM_SCRIPT_GENERATOR_ARGS يستخدم Kudu الأمر azure site deploymentscript الموضح هنا لإنشاء برنامج نصي للتوزيع. يكتشف تلقائيًا نوع إطار عمل اللغة ويحدد المعلمات لتمريرها إلى الأمر. يتجاوز هذا الإعداد المعلمات التي تم إنشاؤها تلقائيًا. لمعاملة مستودعك كملفات محتوى عادي: --basic -p <folder-to-deploy>
SCM_TRACE_LEVEL بناء مستوى التتبع. الافتراضي هو 1. اضبط على قيم أعلى، حتى 4، لمزيد من التتبع. 4
SCM_COMMAND_IDLE_TIMEOUT مهلة بالثوان لكل أمر تقوم عملية الإنشاء بتشغيله للانتظار من قبل دون إنتاج أي إخراج. بعد ذلك، يعتبر الأمر خاملاً ومعطلاً. الافتراضي هو 60 (دقيقة واحدة). في Azure، هناك أيضًا مهلة عامة لطلب الخمول الذي يفصل العملاء بعد 230 ثانية. ومع ذلك، سيستمر الأمر في تشغيل جانب الخادم بعد ذلك.
SCM_LOGSTREAM_TIMEOUT انقضاء مهلة عدم النشاط بالثواني قبل إيقاف تدفق السجل. الافتراضي هو 1800 (30 دقيقة).
SCM_SITEEXTENSIONS_FEED_URL عنوان URL لمعرض ملحقات الموقع. الافتراضي هو https://www.nuget.org/api/v2/. عنوان URL للخلاصة القديمة هو http://www.siteextensions.net/api/v2/.
SCM_USE_LIBGIT2SHARP_REPOSITORY اضبط على 0 لاستخدام git.exe بدلاً من libgit2sharp لعمليات Git.
WEBSITE_LOAD_USER_PROFILE في حالة الخطأ The specified user does not have a valid profile. أثناء أتمتة إنشاء ASP.NET (مثل أثناء توزيع Git)، قم بتعيين هذا المتغير على 1 لتحميل ملف تعريف مستخدم كامل في بيئة الإنشاء. هذا الإعداد قابل للتطبيق فقط عندما يكون WEBSITE_COMPUTE_MODE هو Dedicated.
WEBSITE_SCM_IDLE_TIMEOUT_IN_MINUTES مهلة بالدقائق لموقع SCM (Kudu). الافتراضي هو 20.
SCM_DO_BUILD_DURING_DEPLOYMENT باستخدام توزيع ZIP، يفترض محرك التوزيع أن ملف ZIP جاهز للتشغيل كما هو ولا يقوم بتشغيل أي أتمتة بناء. لتمكين نفس أتمتة الإنشاء كما في توزيع Git، اضبط على true.

الإعدادات الخاصة باللغة

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

اسم الإعداد ‏‏الوصف
PORT قراءة فقط. بالنسبة لتطبيقات Linux، المنفذ الذي يستمع إليه وقت تشغيل .NET في الحاوية.
WEBSITE_ROLE_INSTANCE_ID قراءة فقط. معرّف المثيل الحالي.
HOME قراءة فقط. الدليل الذي يشير إلى التخزين المشترك (/home).
DUMP_DIR قراءة فقط. دليل لتفريغ الأعطال (/home/logs/dumps).
APP_SVC_RUN_FROM_COPY تطبيقات Linux فقط. بشكل افتراضي، يتم تشغيل التطبيق من /home/site/wwwroot، وهو دليل مشترك لجميع الحالات التي تم تغيير حجمها. اضبط هذا المتغيّر على true لنسخ التطبيق إلى دليل محلي في الحاوية الخاصة بك وتشغيله من هناك. عند استخدام هذا الخيار، تأكد من عدم ترميز أي مرجع إلى /home/site/wwwroot. بدلاً من ذلك، استخدم مسارًا متعلقًا بـ /home/site/wwwroot.
MACHINEKEY_Decryption بالنسبة لتطبيقات Windows الأصلية أو تطبيقات Windows الواردة في الحاوية، يتم إدخال هذا المتغير في بيئة التطبيق أو الحاوية لتمكين إجراءات تشفير ASP.NET (راجع machineKey Element. لتجاوز القيمة الافتراضية decryption، قم بتكوينها كإعداد لتطبيق خدمة التطبيقات، أو قم بتعيينها مباشرة في عنصر machineKey من ملف Web.config.
MACHINEKEY_DecryptionKey بالنسبة لتطبيقات Windows الأصلية أو تطبيقات Windows في الحاوية، يتم إدخال هذا المتغير في بيئة التطبيق أو الحاوية لتمكين إجراءات تشفير ASP.NET (راجع machineKey Element. لتجاوز قيمة decryptionKey التي تم إنشاؤها تلقائيًا، قم بتكوينها كإعداد لتطبيق خدمة التطبيقات، أو قم بتعيينها مباشرة في عنصر machineKey من ملف Web.config.
MACHINEKEY_Validation بالنسبة لتطبيقات Windows الأصلية أو تطبيقات Windows في الحاوية، يتم إدخال هذا المتغير في بيئة التطبيق أو الحاوية لتمكين إجراءات تشفير ASP.NET (راجع machineKey Element. لتجاوز القيمة الافتراضية validation، قم بتكوينها كإعداد لتطبيق خدمة التطبيقات، أو قم بتعيينها مباشرة في عنصر machineKey من ملف Web.config.
MACHINEKEY_ValidationKey بالنسبة لتطبيقات Windows الأصلية أو تطبيقات Windows في الحاوية، يتم إدخال هذا المتغير في بيئة التطبيق أو الحاوية لتمكين إجراءات تشفير ASP.NET (راجع machineKey Element. لتجاوز قيمة validationKey التي تم إنشاؤها تلقائيًا، قم بتكوينها كإعداد لتطبيق خدمة التطبيقات، أو قم بتعيينها مباشرة في عنصر machineKey من ملف Web.config.

WordPress

إعداد التطبيق النطاق القيمة‬ الحد الأقصى ‏‏الوصف
WEBSITES_ENABLE_APP_SERVICE_STORAGE تطبيق الويب صحيح - عند التعيين على TRUE، يتم الاحتفاظ بمحتويات الملف أثناء إعادة التشغيل.
WP_MEMORY_LIMIT WordPress 128 م 512 م حد ذاكرة PHP للواجهة الأمامية أو العامة (لكل برنامج نصي). لا يمكن أن يكون أكثر من PHP_MEMORY_LIMIT
WP_MAX_MEMORY_LIMIT WordPress 256 م 512 م حد ذاكرة PHP للوحة تحكم المشرف (لكل برنامج نصي). بشكل عام، تستهلك النصوص البرمجية للوحة القيادة/الواجهة الخلفية قدرًا كبيرًا من الذاكرة مقارنة بالنصوص البرمجية للواجهة الأمامية. لا يمكن أن يكون أكثر من PHP_MEMORY_LIMIT.
PHP_MEMORY_LIMIT PHP 512 م 512 م حدود الذاكرة لنص PHP العام. يمكن فقط إنقاصها.
FILE_UPLOADS PHP تشغيل - يمكن أن يكون إما تشغيل أو إيقاف تشغيل. لاحظ أن القيم حساسة لحالة الأحرف. لتمكين أو تعطيل تحميلات الملفات.
UPLOAD_MAX_FILESIZE PHP 50 م 256 م كحد أقصى لحجم تحميل الملف. يمكن زيادتها حتى 256 م.
POST_MAX_SIZE PHP 128 م 256 م يمكن زيادتها حتى 256 م. بشكل عام يجب أن يكون أكثر من UPLOAD_MAX_FILESIZE.
MAX_EXECUTION_TIME PHP 120 120 يمكن التقليل فقط. يرجى تقسيم البرامج النصية إذا استغرق الأمر أكثر من 120 ثانية. تمت إضافته لتجنب البرامج النصية السيئة من إبطاء النظام.
MAX_INPUT_TIME PHP 120 120 أقصى حد زمني لتحليل طلبات الإدخال. يمكن التقليل فقط.
MAX_INPUT_VARS PHP 10000 10000 -
DATABASE_HOST قاعدة البيانات - - يستخدم مضيف قاعدة البيانات للاتصال بـ WordPress.
DATABASE_NAME قاعدة البيانات - - اسم قاعدة البيانات المستخدم للاتصال بـ WordPress.
DATABASE_USERNAME قاعدة البيانات - - اسم مستخدم قاعدة البيانات المستخدم للاتصال بـ WordPress.
DATABASE_PASSWORD قاعدة البيانات - - كلمة مرور قاعدة البيانات المستخدمة للاتصال بقاعدة بيانات MySQL. لتغيير كلمة مرور قاعدة بيانات MySQL، راجع update admin password. كلما تم تغيير كلمة مرور قاعدة بيانات MySQL، تحتاج إعدادات التطبيق أيضا إلى التحديث.
WORDPRESS_ADMIN_EMAIL النشر فقط - - البريد الإلكتروني لمسؤول WordPress.
WORDPRESS_ADMIN_PASSWORD النشر فقط - - كلمة مرور مسؤول WordPress. هذا فقط لأغراض النشر. لا يؤثر تعديل هذه القيمة على تثبيت WordPress. لتغيير كلمة مرور مسؤول WordPress، راجع resetting your password.
WORDPRESS_ADMIN_USER النشر فقط - - اسم مستخدم مسؤول WordPress
WORDPRESS_ADMIN_LOCALE_CODE النشر فقط - - اسم مستخدم قاعدة البيانات المستخدم للاتصال بـ WordPress.

المجال ونظام أسماء المجالات

اسم الإعداد ‏‏الوصف مثال
WEBSITE_DNS_SERVER عنوان IP لخادم نظام أسماء المجالات الأساسي للاتصالات الصادرة (مثل خدمة خلفية). خادم نظام أسماء المجالات الافتراضي لخدمة التطبيقات هو نظام أسماء المجالات في Azure، وعنوان IP الخاص به هو 168.63.129.16. إذا كان تطبيقك يستخدم تكامل VNet أو كان في بيئة خدمة التطبيقات، فإنه يرث تكوين خادم نظام أسماء المجالات من VNet افتراضيًا. 10.0.0.1
WEBSITE_DNS_ALT_SERVER عنوان IP لخادم نظام أسماء المجالات الاحتياطي للاتصالات الصادرة. راجع WEBSITE_DNS_SERVER.
WEBSITE_ENABLE_DNS_CACHE يسمح بتخزين قرارات نظام أسماء المجالات الناجحة مؤقتًا. بشكل افتراضي، سيتم مسح إدخالات ذاكرة التخزين المؤقت DNS منتهية الصلاحية بالإضافة إلى ذاكرة التخزين المؤقت الموجودة التي سيتم مسحها كل 4.5 دقائق.

TLS/SSL

لمزيد من المعلومات، راجع استخدام شهادة TLS/SSL في التعليمات البرمجية في Azure App Service .

اسم الإعداد ‏‏الوصف
WEBSITE_LOAD_CERTIFICATES قيِّم بصمة الإبهام مفصولة بفواصل للشهادة التي تريد تحميلها في التعليمات البرمجية الخاصة بك، أو * للسماح بتحميل جميع الشهادات في التعليمات البرمجية. لا يمكن تحميل سوى من الشهادات المضافة إلى تطبيقك .
WEBSITE_PRIVATE_CERTS_PATH قراءة فقط. المسار في حاوية Windows إلى الشهادات الخاصة المحملة.
WEBSITE_PUBLIC_CERTS_PATH قراءة فقط. المسار في حاوية Windows إلى الشهادات العامة المحملة.
WEBSITE_INTERMEDIATE_CERTS_PATH قراءة فقط. المسار في حاوية Windows إلى الشهادات الوسيطة المحملة.
WEBSITE_ROOT_CERTS_PATH قراءة فقط. المسار في حاوية Windows إلى شهادات الجذر المحملة.

الفتحات الخاصة بالنشر

لمزيد من المعلومات حول استخدام فتحات التوزيع، راجع إعداد بيئات التدريج في Azure App Service.

اسم الإعداد ‏‏الوصف مثال
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS بشكل افتراضي، تكون إصدارات ملحقات الموقع خاصة بكل خانة. هذا يمنع سلوك التطبيق غير المتوقع بسبب تغيير إصدارات الامتداد بعد المبادلة. إذا كنت تريد تبديل إصدارات الامتداد أيضًا، فاضبط على 0 على جميع الفتحات.
WEBSITE_OVERRIDE_PRESERVE_DEFAULT_STICKY_SLOT_SETTINGS يعيّن إعدادات معينة على أنها ثابتة أو غير قابلة للتبديل افتراضيًا. القيمة الافتراضية هي true. عيّن هذا الإعداد على false أو 0لجميع فتحات التوزيع لجعلها قابلة للتبديل بدلاً من ذلك. لا يوجد تحكم دقيق في أنواع الإعدادات المحددة.
WEBSITE_SWAP_WARMUP_PING_PATH مسار ping لتسخين الفتحة المستهدفة في المبادلة، بدءًا بشرطة مائلة. الافتراضي هو /، والذي يقوم باختبار اتصال المسار الجذر عبر HTTP. /statuscheck
WEBSITE_SWAP_WARMUP_PING_STATUSES أكواد استجابة HTTP صالحة لعملية الإحماء أثناء المبادلة. إذا لم تكن تعليمات الحالة البرمجية التي تم إرجاعها موجودة في القائمة، فسيتم إيقاف عمليات التجهيز والتبديل. وتعد جميع تعليمات الاستجابة البرمجية صالحة بشكل افتراضي. 200,202
WEBSITE_SLOT_NUMBER_OF_TIMEOUTS_BEFORE_RESTART أثناء تبديل الفتحة، أقصى عدد من المهلات التي نفرض بعدها إعادة تشغيل الموقع على مثيل جهاز ظاهري محدد. الافتراضي هو 3.
WEBSITE_SLOT_MAX_NUMBER_OF_TIMEOUTS أثناء تبديل الفتحة، يجب تقديم أقصى عدد من طلبات المهلة لعنوان URL واحد قبل الاستسلام. الافتراضي هو 5.
WEBSITE_SKIP_ALL_BINDINGS_IN_APPHOST_CONFIG قم بالتعيين على true أو 1 لتخطي كافة الارتباطات في applicationHost.config. الافتراضي هو false. إذا أدى تطبيقك إلى إعادة التشغيل نظرًا لأنه تم تحديث applicationHost.config بأسماء المضيف التي تم تبديلها في الفتحات، فاضبط هذا المتغير على true لتجنب إعادة تشغيل من هذا النوع. إذا كنت تقوم بتشغيل تطبيق Windows Communication Foundation (WCF)، فلا تقم بتعيين هذا المتغير.

حاويات مخصصة

لمزيد من المعلومات حول الحاويات المخصصة، راجع تشغيل حاوية مخصصة في Azure.

اسم الإعداد ‏‏الوصف مثال
WEBSITES_ENABLE_APP_SERVICE_STORAGE بالنسبة إلى حاويات Linux المخصصة: قم بتعيين إلى true لتمكين /home الدليل ليتم مشاركته عبر مثيلات موسعة. الإعداد الافتراضي هو false لحاويات Linux المخصصة.

بالنسبة لحاويات Windows: قم بتعيين إلى true لتمكين c:\home الدليل الذي سيتم مشاركته عبر مثيلات ذات مقياس. الإعداد الافتراضي هو true لحاويات Windows.
WEBSITES_CONTAINER_START_TIME_LIMIT مقدار الوقت بالثواني لانتظار الحاوية لإكمال بدء التشغيل قبل إعادة تشغيل الحاوية. القيمة الافتراضية هي 230. يمكنك زيادته حتى الحد الأقصى 1800.
WEBSITES_CONTAINER_STOP_TIME_LIMIT مقدار الوقت بالثوان لانتظار إنهاء الحاوية بأمان. القيمة الافتراضية هي 5. يمكنك الزيادة إلى الحد الأقصى 120
DOCKER_REGISTRY_SERVER_URL عنوان URL لخادم التسجيل، عند تشغيل حاوية مخصصة في خدمة التطبيقات. للأمان، لا يتم تمرير هذا المتغير إلى الحاوية. https://<server-name>.azurecr.io
DOCKER_REGISTRY_SERVER_USERNAME اسم المستخدم للمصادقة مع خادم التسجيل في DOCKER_REGISTRY_SERVER_URL. للأمان، لا يتم تمرير هذا المتغير إلى الحاوية.
DOCKER_REGISTRY_SERVER_PASSWORD كلمة مرور للمصادقة مع خادم التسجيل في DOCKER_REGISTRY_SERVER_URL. للأمان، لا يتم تمرير هذا المتغير إلى الحاوية.
DOCKER_ENABLE_CI قم بالتعيين على true لتمكين التوزيع المستمر للحاويات المخصصة. الافتراضي هو false للحاويات المخصصة.
WEBSITE_PULL_IMAGE_OVER_VNET اتصل وقم بالسحب من سجل داخل شبكة ظاهرية أو محلية. سيحتاج تطبيقك إلى الاتصال بشبكة افتراضية باستخدام ميزة تكامل VNet. هذا الإعداد مطلوب أيضًا لـ Azure Container Registry مع نقطة نهاية خاصة.
WEBSITES_WEB_CONTAINER_NAME في تطبيق Docker Compose، يمكن الوصول إلى الإنترنت في إحدى الحاويات فقط. اضبط على اسم الحاوية المحددة في ملف التكوين لتجاوز اختيار الحاوية الافتراضية. بشكل افتراضي، تكون الحاوية التي يمكن الوصول إليها عبر الإنترنت هي أول حاوية تحدد المنفذ 80 أو 8080، أو عندما لا يتم العثور على مثل هذه الحاوية، تكون الحاوية الأولى المحددة في ملف التكوين.
WEBSITES_PORT بالنسبة للحاوية المخصصة، رقم المنفذ المخصص في الحاوية لخدمة التطبيقات لتوجيه الطلبات إليها. بشكل افتراضي، تحاول خدمة التطبيقات الكشف التلقائي عن المنفذ في المنفذين 80 و8080. لا يتم إدخال هذا الإعداد في الحاوية كمتغير بيئة.
WEBSITE_CPU_CORES_LIMIT بشكل افتراضي، يتم تشغيل حاوية Windows بجميع النوى المتاحة لطبقة التسعير التي اخترتها. لتقليل عدد النوى، اضبط عدد النوى المطلوب. لمزيد من المعلومات، راجع تخصيص عدد مراكز الحوسبة .
WEBSITE_MEMORY_LIMIT_MB بشكل افتراضي، تحتوي جميع حاويات Windows المنشورة في Azure App Service على حد ذاكرة تم تكوينه اعتمادا على خطة خدمة التطبيقات SKU. اضبط على حد الذاكرة المطلوب بالميغابايت. يجب ألا يتجاوز الإجمالي التراكمي لهذا الإعداد عبر التطبيقات في نفس الخطة المبلغ المسموح به بواسطة طبقة التسعير المختارة. لمزيد من المعلومات، راجع تخصيص ذاكرة الحاوية.

تغير الحجم

اسم الإعداد ‏‏الوصف
WEBSITE_INSTANCE_ID قراءة فقط. معرّف فريد لمثيل جهاز ظاهري الحالي، عندما يتم تحجيم التطبيق إلى مثيلات متعددة.
WEBSITE_IIS_SITE_NAME ‏‏مهمل. استخدم WEBSITE_INSTANCE_ID.
WEBSITE_DISABLE_OVERLAPPED_RECYCLING إعادة التدوير المتراكب تجعله قبل إيقاف تشغيل مثيل جهاز ظاهري الحالي للتطبيق، يبدأ مثيل جهاز ظاهري جديد. في بعض الحالات، يمكن أن يتسبب ذلك في حدوث مشكلات في قفل الملفات. يمكنك محاولة إيقاف تشغيله عن طريق التعيين على 1.
WEBSITE_DISABLE_CROSS_STAMP_SCALE بشكل افتراضي، يُسمح للتطبيقات بالتوسع عبر الطوابع إذا كانت تستخدم ملفات Azure أو حاوية Docker. قم بالتعيين على 1 أو true لتعطيل التحجيم عبر الطوابع داخل منطقة التطبيق. الافتراضي هو 0. حاويات Docker المخصصة التي تم تعيينها WEBSITES_ENABLE_APP_SERVICE_STORAGE إلى true أو 1 لا يمكنها تغيير حجم الطوابع المتقاطعة لأن محتواها غير مغلف بالكامل في حاوية Docker.

تسجيل الدخول

اسم الإعداد ‏‏الوصف مثال
WEBSITE_HTTPLOGGING_ENABLED قراءة فقط. يوضح ما إذا كان تسجيل خادم الويب لتطبيقات Windows الأصلية ممكّنًا (1) أم لا (0).
WEBSITE_HTTPLOGGING_RETENTION_DAYS فترة الاحتفاظ بالأيام الخاصة بسجلات خادم الويب لتطبيقات Windows الأصلية، إذا تم تمكين سجلات خادم الويب. 10
WEBSITE_HTTPLOGGING_CONTAINER_URL SAS URL لحاوية تخزين البيانات الثنائية الكبيرة لتخزين سجلات خادم الويب لتطبيقات Windows الأصلية، إذا تم تمكين سجلات خادم الويب. في حالة عدم التعيين، يتم تخزين سجلات خادم الويب في نظام ملفات التطبيق (التخزين الافتراضي المشترك).
DIAGNOSTICS_AZUREBLOBRETENTIONINDAYS فترة الاحتفاظ بالأيام الخاصة بسجلات التطبيق لتطبيقات Windows الأصلية، إذا تم تمكين سجلات التطبيق. 10
DIAGNOSTICS_AZUREBLOBCONTAINERSASURL SAS URL لحاوية تخزين البيانات الثنائية الكبيرة لتخزين سجلات التطبيقات لتطبيقات Windows الأصلية، إذا تم تمكين سجلات التطبيق.
APPSERVICEAPPLOGS_TRACE_LEVEL الحد الأدنى لمستوى السجل للشحن إلى Log Analytics لنوع سجل AppServiceAppLogs.
DIAGNOSTICS_LASTRESORTFILE اسم الملف المراد إنشاؤه، أو مسار نسبي إلى دليل السجل، لتسجيل الأخطاء الداخلية لاستكشاف أخطاء المستمع وإصلاحها. الافتراضي هو logging-errors.txt.
DIAGNOSTICS_LOGGINGSETTINGSFILE المسار إلى ملف إعدادات السجل، ذات الصلة بـ D:\home أو /home. الافتراضي هو site\diagnostics\settings.json.
DIAGNOSTICS_TEXTTRACELOGDIRECTORY المسار إلى ملف إعدادات السجل، ذات الصلة بـ D:\home\site\wwwroot أو /home/site/wwwroot. ..\..\LogFiles\Application
DIAGNOSTICS_TEXTTRACEMAXLOGFILESIZEBYTES الحد الأقصى لحجم ملف السجل بالبايت. الإعداد الافتراضي هو 131072 (128 كيلو بايت).
DIAGNOSTICS_TEXTTRACEMAXLOGFOLDERSIZEBYTES الحجم الأقصى لمجلد السجل بالبايت. القيمة الافتراضية هي 1048576 (1 ميغابايت).
DIAGNOSTICS_TEXTTRACEMAXNUMLOGFILES الحد الأقصى لعدد ملفات السجل المطلوب الاحتفاظ بها. الافتراضي هو 20.
DIAGNOSTICS_TEXTTRACETURNOFFPERIOD مهلة بالمللي ثانية للحفاظ على تمكين تسجيل التطبيق. الافتراضي هو 43200000 (12 ساعة).
WEBSITE_LOG_BUFFERING بشكل افتراضي، يتم تمكين التخزين المؤقت للسجل. قم بالتعيين على 0 لتعطيله.
WEBSITE_ENABLE_PERF_MODE بالنسبة لتطبيقات Windows الأصلية، اضبط على TRUE لإيقاف تشغيل إدخالات سجل IIS للطلبات الناجحة التي تم إرجاعها في غضون 10 ثوانٍ. هذه طريقة سريعة لإجراء قياس الأداء عن طريق إزالة التسجيل الممتد.

عدادات الأداء

فيما يلي متغيرات البيئة "الزائفة" التي لا وجود لها إذا عدّتها، لكنها تعيد قيمتها إذا بحثت عنها بشكل فردي. القيمة ديناميكية ويمكن أن تتغير في كل عملية بحث.

اسم الإعداد ‏‏الوصف
WEBSITE_COUNTERS_ASPNET كائن JSON يحتوي على عدادات أداء ASP.NET.
WEBSITE_COUNTERS_APP كائن JSON يحتوي على عدادات وضع الحماية.
WEBSITE_COUNTERS_CLR كائن JSON يحتوي على عدادات CLR.
WEBSITE_COUNTERS_ALL عنصر JSON يحتوي على مجموعة من المتغيرات الثلاثة الأخرى.

التخزين المؤقت

اسم الإعداد ‏‏الوصف
WEBSITE_LOCAL_CACHE_OPTION ما إذا تم تمكين ذاكرة التخزين المؤقت المحلية. الخيارات المتوفرة هي:
- Default: ترث الإعداد العام على مستوى الطوابع.
- Always: تمكين للتطبيق.
- OnStorageUnavailability
- Disabled: معطل للتطبيق.
WEBSITE_LOCAL_CACHE_READWRITE_OPTION خيارات القراءة والكتابة لذاكرة التخزين المؤقت المحلية. الخيارات المتوفرة هي:
- ReadOnly: ذاكرة التخزين المؤقت للقراءة فقط.
- WriteButDiscardChanges: السماح بالكتابة إلى ذاكرة التخزين المؤقت المحلية ولكن تجاهل التغييرات التي تم إجراؤها محليًا.
WEBSITE_LOCAL_CACHE_SIZEINMB حجم ذاكرة التخزين المؤقت المحلية بالميغابايت. الافتراضي هو 1000 (1 جيجابايت).
WEBSITE_LOCALCACHE_READY علامة للقراءة فقط تشير إلى ما إذا كان التطبيق يستخدم ذاكرة التخزين المؤقت المحلية.
WEBSITE_DYNAMIC_CACHE نظرًا لطبيعة ملف الشبكة المشتركة للسماح بالوصول إلى مثيلات متعددة، تعمل ذاكرة التخزين المؤقت الديناميكية على تحسين الأداء عن طريق التخزين المؤقت للملفات التي تم الوصول إليها مؤخرًا محليًا على مثيل. يتم إبطال ذاكرة التخزين المؤقت عند تعديل الملف. موقع ذاكرة التخزين المؤقت هو %SYSTEMDRIVE%\local\DynamicCache (يتم تطبيق نفس الحصة %SYSTEMDRIVE%\local). لتمكين التخزين المؤقت للمحتوى الكامل، اضبط على 1، الذي يتضمن كل من محتوى الملف وبيانات تعريف الدليل/الملف (الطوابع الزمنية والحجم ومحتوى الدليل). للحفاظ على استخدام القرص المحلي، اضبط على 2 لتخزين بيانات التعريف للدليل/الملف فقط مؤقتًا (الطوابع الزمنية والحجم ومحتوى الدليل). لإيقاف التخزين المؤقت، اضبط على 0. بالنسبة لتطبيقات Windows وتطبيقات Linux التي تم إنشاؤها باستخدام قالب WordPress، الافتراضي هو 1. بالنسبة لجميع تطبيقات Linux الأخرى، الافتراضي هو 0.
WEBSITE_READONLY_APP عند استخدام ذاكرة التخزين المؤقت الديناميكية، يمكنك تعطيل الوصول للكتابة إلى جذر التطبيق (D:\home\site\wwwroot أو /home/site/wwwroot) عن طريق تعيين هذا المتغير على 1. باستثناء الدليل App_Data، لا يُسمح بأقفال خاصة، بحيث لا يتم حظر عمليات التوزيع بواسطة الملفات المؤمنة.

الشبكات

ترتبط متغيرات البيئة التالية بـ التوصيلات المختلطة وتكامل VNET.

اسم الإعداد ‏‏الوصف
WEBSITE_RELAYS قراءة فقط. البيانات اللازمة لتكوين الاتصال الهجين، بما في ذلك نقاط النهاية وبيانات ناقل الخدمة.
WEBSITE_REWRITE_TABLE قراءة فقط. تستخدم في وقت التشغيل لإجراء عمليات البحث وإعادة كتابة الاتصالات بشكل مناسب.
WEBSITE_VNET_ROUTE_ALL بشكل افتراضي، إذا كنت تستخدم تكامل VNet الإقليمي، فإن تطبيقك يوجه حركة مرور RFC1918 فقط إلى VNet الخاص بك. قم بالتعيين على 1 لتوجيه كل حركة المرور الصادرة إلى شبكة VNet الخاصة بك وتخضع لنفس مجموعات NSG وUDRs. يتيح لك الإعداد الوصول إلى نقاط النهاية غير RFC1918 من خلال شبكة VNet الخاصة بك، وتأمين كل حركة المرور الصادرة التي تغادر تطبيقك، وفرض كل حركة المرور الصادرة عبر نفق إلى جهاز شبكة من اختيارك.
WEBSITE_PRIVATE_IP قراءة فقط. عنوان IP المرتبط بالتطبيق عند دمجه مع شبكة VNet. بالنسبة إلى تكامل VNet الإقليمي، تكون القيمة عبارة عن عنوان IP من نطاق عناوين الشبكة الفرعية المفوضة، وبالنسبة لتكامل VNet المطلوب للبوابة، تكون القيمة عبارة عن عنوان IP من نطاق عناوين مجموعة عناوين من نقطة إلى موقع تم تكوينها على الشبكة الافتراضية بوابة. يستخدم التطبيق عنوان IP هذا للاتصال بالموارد من خلال VNet. أيضًا، يمكن أن يتغير داخل نطاق العنوان الموصوف.
WEBSITE_PRIVATE_PORTS قراءة فقط. في تكامل VNet، يُظهر المنافذ التي يمكن للتطبيق استخدامها للتواصل مع العقد الأخرى.
WEBSITE_CONTENTOVERVNET إذا كنت تقوم بتحميل Azure File Share على App Service وكان حساب التخزين مقيدا ب VNET، فتأكد من تمكين هذا الإعداد بقيمة 1.

مراجع الخزنة الرئيسية

ترتبط متغيرات البيئة التالية بـ مراجع خزنة المفاتيح.

اسم الإعداد ‏‏الوصف
WEBSITE_KEYVAULT_REFERENCES قراءة فقط. يحتوي على معلومات (بما في ذلك الحالات) لجميع مراجع Key Vault التي تم تكوينها حاليًا في التطبيق.
WEBSITE_SKIP_CONTENTSHARE_VALIDATION إذا قمت بتعيين اتصال التخزين المشترك لتطبيقك (باستخدام WEBSITE_CONTENTAZUREFILECONNECTIONSTRING) إلى مرجع Key Vault، فلن يتمكن التطبيق من حل مرجع key vault عند إنشاء التطبيق أو تحديثه إذا كان أحد الشروط التالية صحيحا:
- يصل التطبيق إلى خزنة المفاتيح بهوية مخصصة للنظام.
- يصل التطبيق إلى خزينة المفاتيح بهوية يحددها المستخدم، وخزينة المفاتيح مؤمنة بـ VNet.
لتجنب الأخطاء في وقت الإنشاء أو التحديث، اضبط هذا المتغير على 1.
WEBSITE_DELAY_CERT_DELETION يمكن تعيين هذا var env إلى 1 من قبل المستخدمين للتأكد من عدم حذف شهادة تعتمد عليها عملية العامل حتى يتم الخروج منها.

CORS

ترتبط متغيرات البيئة التالية بتكوين مشاركة الموارد عبر المنشأ (CORS).

اسم الإعداد ‏‏الوصف
WEBSITE_CORS_ALLOWED_ORIGINS قراءة فقط. يُظهر الأصول المسموح بها لـ CORS.
WEBSITE_CORS_SUPPORT_CREDENTIALS قراءة فقط. يوضح ما إذا كان تعيين العنوان Access-Control-Allow-Credentials على true ممكّنًا (True) أم لا (False).

المصادقة والتخويل

ترتبط متغيرات البيئة التالية بـ مصادقة خدمة التطبيق.

اسم الإعداد ‏‏الوصف
WEBSITE_AUTH_DISABLE_IDENTITY_FLOW عند التعيين على true، يتم تعطيل تعيين الهوية الأساسية لمؤشر الترابط في تطبيقات الويب المستندة إلى ASP.NET (بما في ذلك v1 Function Apps). تم تصميم هذا للسماح للمطورين بحماية الوصول إلى موقعهم باستخدام المصادقة، ولكن لا يزال يستخدم آلية تسجيل دخول منفصلة ضمن منطق التطبيق الخاص بهم. الافتراضي هو false.
WEBSITE_AUTH_HIDE_DEPRECATED_SID true أو false. القيمة الافتراضية هي false. هذا إعداد لتكامل Azure Mobile Apps القديم لخدمة Azure App Service. يؤدي تعيين هذا إلى true إلى حل مشكلة حيث قد يتغير SID (معرف الأمان) الذي تم إنشاؤه للمستخدمين المصادق عليهم إذا قام المستخدم بتغيير معلومات ملف التعريف الخاص به. قد يؤدي تغيير هذه القيمة إلى تغيير معرفات مستخدم Azure Mobile Apps الحالية. لا تحتاج معظم التطبيقات إلى استخدام هذا الإعداد.
WEBSITE_AUTH_NONCE_DURATION قيمة النطاق الزمني بالشكل _hours_:_minutes_:_seconds_. القيمة الافتراضية هي 00:05:00، أو 5 دقائق. يتحكم هذا الإعداد في عمر التشفير غير المشفر الذي تم إنشاؤه لجميع عمليات تسجيل الدخول التي تعتمد على المتصفح. إذا فشل إكمال تسجيل الدخول في الوقت المحدد، فستتم إعادة محاولة تدفق تسجيل الدخول تلقائيا. إعداد التطبيق هذا مخصص للاستخدام مع تجربة تكوين V1 (الكلاسيكية). إذا كنت تستخدم مخطط تكوين مصادقة V2، فيجب عليك بدلاً من ذلك استخدام قيمة التكوين login.nonce.nonceExpirationInterval.
WEBSITE_AUTH_PRESERVE_URL_FRAGMENT عند التعيين إلى true وتحديد المستخدمين على ارتباطات التطبيق التي تحتوي على أجزاء عنوان URL، ستضمن عملية تسجيل الدخول عدم فقدان جزء جزء URL من عنوان URL الخاص بك في عملية إعادة توجيه تسجيل الدخول. لمزيد من المعلومات، راجع تخصيص تسجيل الدخول وتسجيل الخروج في مصادقة Azure App Service.
WEBSITE_AUTH_USE_LEGACY_CLAIMS للحفاظ على التوافق مع الإصدارات السابقة عبر الترقيات، تستخدم وحدة المصادقة تعيين المطالبات القديمة للأسماء القصيرة إلى الطويلة في واجهة برمجة التطبيقات /.auth/me، لذلك يتم استبعاد تعيينات معينة (مثل "الأدوار"). للحصول على إصدار أحدث من تعيينات المطالبات، قم بتعيين هذا المتغير على False. في مثال "الأدوار"، سيتم تعيينها إلى اسم المطالبة الطويل "http://schemas.microsoft.com/ws/2008/06/identity/claims/role"؛.
WEBSITE_AUTH_DISABLE_WWWAUTHENTICATE true أو false. القيمة الافتراضية هي false. عند التعيين على true، يزيل WWW-Authenticate رأس استجابة HTTP من استجابات HTTP 401 التي تم إنشاؤها بواسطة الوحدة النمطية. إعداد التطبيق هذا مخصص للاستخدام مع تجربة تكوين V1 (الكلاسيكية). إذا كنت تستخدم مخطط تكوين مصادقة V2، فيجب عليك بدلاً من ذلك استخدام قيمة التكوين identityProviders.azureActiveDirectory.login.disableWwwAuthenticate.
WEBSITE_AUTH_STATE_DIRECTORY مسار دليل نظام الملفات المحلي حيث يتم تخزين الرموز المميزة عند تمكين مخزن الرموز المستند إلى الملف. القيمة الافتراضية هي %HOME%\Data\.auth. إعداد التطبيق هذا مخصص للاستخدام مع تجربة تكوين V1 (الكلاسيكية). إذا كنت تستخدم مخطط تكوين مصادقة V2، فيجب عليك بدلاً من ذلك استخدام قيمة التكوين login.tokenStore.fileSystem.directory.
WEBSITE_AUTH_TOKEN_CONTAINER_SASURL عنوان URL مؤهل بالكامل لحاوية البيانات الثنائية الكبيرة. يوجه وحدة المصادقة لتخزين وتحميل جميع الرموز المميزة المشفرة إلى حاوية تخزين blob المحددة بدلاً من استخدام نظام الملفات المحلي الافتراضي.
WEBSITE_AUTH_TOKEN_REFRESH_HOURS أي رقم عشري موجب. القيمة الافتراضية هي 72 (ساعات). يتحكم هذا الإعداد في مقدار الوقت بعد انتهاء صلاحية الرمز المميز للجلسة والذي يمكن استخدام واجهة برمجة التطبيقات /.auth/refresh لتحديثه. ستفشل محاولات التحديث بعد هذه الفترة وسيُطلب من المستخدمين تسجيل الدخول مرة أخرى. إعداد التطبيق هذا مخصص للاستخدام مع تجربة تكوين V1 (الكلاسيكية). إذا كنت تستخدم مخطط تكوين مصادقة V2، فيجب عليك بدلاً من ذلك استخدام قيمة التكوين login.tokenStore.tokenRefreshExtensionHours.
WEBSITE_AUTH_TRACE_LEVEL يتحكم في إسهاب تتبعات المصادقة المكتوبة إلى تسجيل التطبيق . القيم الصالحة هي Off وError وWarning وInformation وVerbose. القيمة الافتراضية هي Verbose.
WEBSITE_AUTH_VALIDATE_NONCE true أو false. القيمة الافتراضية هي true. لا يجب أبدًا تعيين هذه القيمة على false إلا عند التصحيح المؤقت لحالات فشل التحقق من صحة التشفير غير المشفر التي تحدث أثناء عمليات تسجيل الدخول التفاعلية. إعداد التطبيق هذا مخصص للاستخدام مع تجربة تكوين V1 (الكلاسيكية). إذا كنت تستخدم مخطط تكوين مصادقة V2، فيجب عليك بدلاً من ذلك استخدام قيمة التكوين login.nonce.validateNonce.
WEBSITE_AUTH_V2_CONFIG_JSON يتم ملء متغير البيئة هذا تلقائيًا بواسطة النظام الأساسي Azure App Service ويستخدم لتكوين وحدة المصادقة المتكاملة. تتوافق قيمة متغير البيئة هذا مع تكوين مصادقة V2 (غير كلاسيكي) للتطبيق الحالي في Azure Resource Manager. ليس المقصود أن يتم تكوينه بشكل صريح.
WEBSITE_AUTH_ENABLED قراءة فقط. تم إدخاله في تطبيق Windows أو Linux للإشارة إلى ما إذا تم تمكين مصادقة خدمة التطبيق.
WEBSITE_AUTH_ENCRYPTION_KEY بشكل افتراضي، يتم استخدام المفتاح الذي تم إنشاؤه تلقائيًا كمفتاح تشفير. للتخطي، اضبط على المفتاح المطلوب. يوصى بهذا إذا كنت ترغب في مشاركة الرموز المميزة أو الجلسات عبر تطبيقات متعددة. إذا تم تحديده، فإنه يحل محل MACHINEKEY_DecryptionKey الإعداد.
WEBSITE_AUTH_SIGNING_KEY بشكل افتراضي، يتم استخدام المفتاح الذي تم إنشاؤه تلقائيًا كمفتاح التوقيع. للتخطي، اضبط على المفتاح المطلوب. يوصى بهذا إذا كنت ترغب في مشاركة الرموز المميزة أو الجلسات عبر تطبيقات متعددة. إذا تم تحديده، فإنه يحل محل MACHINEKEY_ValidationKey الإعداد.

الهوية المُدارة

ترتبط متغيرات البيئة التالية بـ الهويات المُدارة.

اسم الإعداد ‏‏الوصف
IDENTITY_ENDPOINT قراءة فقط. عنوان URL لاسترداد الرمز المميز للهوية المُدارة للتطبيق.
MSI_ENDPOINT ‏‏مهمل. استخدم IDENTITY_ENDPOINT.
IDENTITY_HEADER قراءة فقط. القيمة التي يجب إضافتها إلى رأس X-IDENTITY-HEADERعند إجراء طلب HTTP GET إلىIDENTITY_ENDPOINT. يدير النظام الأساسي القيمة.
MSI_SECRET ‏‏مهمل. استخدم IDENTITY_HEADER.

فحص الصحة

ترتبط متغيرات البيئة التالية بالفحوصات الصحية.

اسم الإعداد ‏‏الوصف
WEBSITE_HEALTHCHECK_MAXPINGFAILURES الحد الأقصى لعدد مرات الاتصال الفاشلة قبل إزالة المثيل. تعيين إلى قيمة بين 2 و100. عند التحجيم أو التصغير، تقوم App Service ب ping مسار التحقق من الصحة للتأكد من أن المثيلات الجديدة جاهزة. لمزيد من المعلومات، راجع فحص السلامة.
WEBSITE_HEALTHCHECK_MAXUNHEALTHYWORKERPERCENT لتجنب الحالات الصحية الساحقة، لن يتم استبعاد أكثر من نصف الحالات. على سبيل المثال، إذا تم تحجيم خطة خدمة التطبيق إلى أربع حالات وكانت ثلاث حالات غير صحية، فسيتم استبعاد اثنين على الأكثر. أما المثيلان الآخران (أحدهما صحي والآخر غير صحي) فسيستمران في تلقي الطلبات. وفي أسوأ السيناريوهات حيث تكون جميع الحالات غير صحية، لن يستبعد أي منها. لتجاوز هذا السلوك، عيّن إلى قيمة بين 1 و100. تعني القيمة الأعلى إزالة المزيد من الحالات غير الصحية. القيمة الافتراضية هي 50 (50%).

الإعلامات

ترتبط متغيرات البيئة التالية بميزة دفع الإخطارات .

اسم الإعداد ‏‏الوصف
WEBSITE_PUSH_ENABLED قراءة فقط. تتم إضافته عند تمكين دفع الإخطارات.
WEBSITE_PUSH_TAG_WHITELIST قراءة فقط. يحتوي على العلامات في تسجيل الإخطار.
WEBSITE_PUSH_TAGS_REQUIRING_AUTH قراءة فقط. يحتوي على قائمة بالعلامات في تسجيل الإشعارات التي تتطلب مصادقة المستخدم.
WEBSITE_PUSH_TAGS_DYNAMIC قراءة فقط. يحتوي على قائمة بالعلامات في تسجيل الإخطار التي تمت إضافتها تلقائيًا.

إشعار

تحتوي هذه المقالة على مراجع لمصطلح لم تعد Microsoft تستخدمه. عند إزالة المصطلح من البرنامج، بالتالي سنزيله من هذه المقالة.

Webjobs

ترتبط متغيرات البيئة التالية بـ Webjobs.

اسم الإعداد ‏‏الوصف
WEBJOBS_RESTART_TIME بالنسبة للوظائف المستمرة، قم بالتأخير بالثواني عندما تتعطل عملية المهمة لأي سبب قبل إعادة تشغيلها.
WEBJOBS_IDLE_TIMEOUT بالنسبة إلى المهام التي تم تشغيلها، المهلة بالثواني، وبعد ذلك يتم إلغاء المهمة إذا كانت في وضع الخمول، أو ليس لها وقت أو إخراج لوحدة المعالجة المركزية.
WEBJOBS_HISTORY_SIZE بالنسبة للمهام التي تم تشغيلها، يتم الاحتفاظ بأقصى عدد من عمليات التشغيل في دليل المحفوظات لكل وظيفة. الافتراضي هو 50.
WEBJOBS_STOPPED قم بالتعيين على 1 لتعطيل تشغيل أي وظيفة وإيقاف جميع المهام قيد التشغيل حاليًا.
WEBJOBS_DISABLE_SCHEDULE قم بالتعيين إلى 1 لإيقاف تشغيل كل عمليات التشغيل المجدولة. لا يزال من الممكن استدعاء المهام يدويًا.
WEBJOBS_ROOT_PATH المسار المطلق أو النسبي لملفات webjob. بالنسبة للمسار النسبي، يتم دمج القيمة مع مسار الجذر الافتراضي (D:/home/site/wwwroot/ أو /home/site/wwwroot/).
WEBJOBS_LOG_TRIGGERED_JOBS_TO_APP_LOGS قم بالتعيين على صواب لإرسال الإخراج من WebJobs الذي تم تشغيله إلى مسار سجلات التطبيق (الذي يدعم نظام الملفات والنقاط الكبيرة والجداول).
WEBJOBS_SHUTDOWN_FILE الملف الذي تنشئه خدمة التطبيقات عند اكتشاف طلب إيقاف التشغيل. تقع على عاتق عملية وظيفة الويب مسؤولية اكتشاف وجود هذا الملف وبدء إيقاف التشغيل. عند استخدام WebJobs SDK، يتم التعامل مع هذا الجزء تلقائيًا.
WEBJOBS_PATH قراءة فقط. مسار الجذر للوظيفة قيد التشغيل حاليًا (سيكون ضمن دليل مؤقت).
WEBJOBS_NAME قراءة فقط. اسم الوظيفة الحالية.
WEBJOBS_TYPE قراءة فقط. نوع الوظيفة الحالية (triggered أو continuous).
WEBJOBS_DATA_PATH قراءة فقط. مسار بيانات التعريف للوظيفة الحالي لاحتواء سجلات الوظيفة والمحفوظات وأي عنصر من عناصر الوظيفة.
WEBJOBS_RUN_ID قراءة فقط. بالنسبة إلى الوظائف التي تم تشغيلها، معرف التشغيل الحالي للوظيفة.

الوظائف

اسم الإعداد ‏‏الوصف
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED قم بالتعيين على 0 لتعطيل ذاكرة التخزين المؤقت للوظائف.
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT مرجع إعدادات التطبيق لوظائف Azure
AzureWebJobsSecretStorageType مرجع إعدادات التطبيق لوظائف Azure
FUNCTIONS_EXTENSION_VERSION مرجع إعدادات التطبيق لوظائف Azure
FUNCTIONS_WORKER_RUNTIME مرجع إعدادات التطبيق لوظائف Azure
AzureWebJobsStorage مرجع إعدادات التطبيق لوظائف Azure
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING مرجع إعدادات التطبيق لوظائف Azure
WEBSITE_CONTENTSHARE مرجع إعدادات التطبيق لوظائف Azure
WEBSITE_CONTENTOVERVNET مرجع إعدادات التطبيق لوظائف Azure
WEBSITE_ENABLE_BROTLI_ENCODING مرجع إعدادات التطبيق لوظائف Azure
WEBSITE_USE_PLACEHOLDER مرجع إعدادات التطبيق لوظائف Azure
WEBSITE_PLACEHOLDER_MODE قراءة فقط. يوضح ما إذا كان تطبيق الوظيفة يعمل على مضيف عنصر نائب (generalized) أو مضيفه الخاص (specialized).
WEBSITE_DISABLE_ZIP_CACHE عند تشغيل تطبيقك من حزمة ZIP (WEBSITE_RUN_FROM_PACKAGE=1)، يتم تخزين أحدث خمس حزم ZIP تم توزيعها مؤقتًا في نظام ملفات التطبيق (D:\home\data\SitePackages). اضبط هذا المتغير على 1 لتعطيل ذاكرة التخزين المؤقت هذه. بالنسبة لتطبيقات استهلاك Linux، يتم تعطيل ذاكرة التخزين المؤقت لحزمة ZIP افتراضيًا.