الإعدادات

كل إعداد يقرؤه الموقع، وقيمته الافتراضية، وكيف تغيّره مع Docker وبدونه.

الإعدادات

كل إعداد اختياري: يعمل الموقع بدون أي منها.

المتغير	القيمة الافتراضية	وظيفته
`NEXT_PUBLIC_SITE_URL`	`http://localhost:3030`	العنوان العام للموقع، مع `https://` وبدون شرطة مائلة في النهاية. تُبنى منه الروابط الأساسية (canonical)، والروابط بين اللغتين، وخريطة الموقع، و`robots.txt`، وبطاقات المشاركة على الشبكات الاجتماعية. اضبطه على نطاقك قبل النشر.
`NEXT_PUBLIC_BUY_URL`	فارغ	عند ضبطه، يعرض شريط في أسفل التذييل زر «اشترِ هذا القالب» يفتح هذا العنوان في تبويب جديد. اتركه فارغًا.
`BUILD_STANDALONE`	فارغ	القيمة `true` تبني خادمًا مستقلًا بذاته في `.next/standalone`. يضبطها `Dockerfile` لك. اتركها فارغة عند استخدام `yarn start`.

من دون Docker

انسخ .env.example إلى .env.local وعدّل القيم هناك. أبقِ .env.example كما هو، فهو قائمة بما هو موجود.

الطرفيةفي Nextjs-landing-page-template-2

cp .env.example .env.local

.env.local

NEXT_PUBLIC_SITE_URL=https://www.your-domain.com

باستخدام Docker

لا يقرأ بناء الصورة ملفي .env و.env.local. مرّر كل قيمة كمعامل بناء بدلًا من ذلك:

الطرفيةفي Nextjs-landing-page-template-2

docker build -t analytics-landing --build-arg NEXT_PUBLIC_SITE_URL=https://www.your-domain.com .

يستمع الموقع داخل الحاوية دائمًا على المنفذ 3030. لاستخدام منفذ آخر على جهازك، غيّر الرقم الذي على يسار -p عند التشغيل.

متى يسري التغيير

القيم التي تبدأ بـ NEXT_PUBLIC_ تُضمَّن في ملف JavaScript الذي يحمّله المتصفح عند بناء الموقع. تغيير إحداها لا يغيّر شيئًا حتى يُبنى الموقع من جديد:

طريقة التشغيل	بعد تغيير قيمة
`yarn dev`	أوقف الخادم وشغّل `yarn dev` من جديد.
`yarn build` و`yarn start`	شغّل `yarn build` مجددًا، ثم `yarn start`.
Docker	ابنِ الصورة من جديد بالقيمة كـ `--build-arg`، ثم شغّل حاوية جديدة.
Vercel	غيّره في Environment Variables الخاصة بالمشروع وانشر مجددًا.

لا تضع سرًّا في قيمة NEXT_PUBLIC_ أبدًا: يستطيع كل زائر قراءته في كود الصفحة. مفاتيح خدماتك الخاصة مكانها خادمك.

البناء المستقل

مع BUILD_STANDALONE=true، يكتب yarn build خادمًا لا يحتاج إلى node_modules في .next/standalone. يستخدمه Dockerfile ليُبقي الصورة صغيرة. لا يُقصد استخدام yarn start مع هذا النوع من البناء، ويحذّر بالرسالة "next start" does not work with "output: standalone" configuration. اترك المتغير فارغًا ما لم تنسخ المجلد المستقل إلى خادم بنفسك.