الإعدادات

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

الإعدادات

كل إعداد اختياري: تعمل لوحة التحكم من دونها جميعًا.

المتغير	القيمة الافتراضية	وظيفته
`NEXT_PUBLIC_DEMO_MODE`	`false`	القيمة `true` تُظهر بيانات تسجيل الدخول التجريبية في صفحة تسجيل الدخول، وتعبّئها، وتُظهر مبدّل ألوان عائمًا. اتركها معطّلة لمنتجك الخاص.
`BUILD_STANDALONE`	فارغ	القيمة `true` تبني خادمًا مستقلًا بذاته في `.next/standalone`. يضبطها `Dockerfile` لك. اتركها فارغة عند استخدام `yarn start`.

وضع العرض التجريبي

المنفذ

تستجيب لوحة التحكم على المنفذ 3030. وهو ليس متغيرًا: فسكربتا dev وstart في package.json يمرّران -p 3030، وتضبط صورة Docker القيمة PORT=3030. لاستخدام منفذ آخر في تشغيل واحد:

طريقة التشغيل	على المنفذ 3041
Docker	`docker run -p 3041:3030 financial-dashboard`، مع تغيير الرقم الذي على يسار `-p` فقط
خادم التطوير	`yarn dev -p 3041`
بناء الإنتاج	`yarn start -p 3041`

المنفذ مستخدم بالفعل

من دون Docker

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

الطرفيةفي dashboard-template-1

cp .env.example .env.local

.env.local

NEXT_PUBLIC_DEMO_MODE=true

باستخدام Docker

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

الطرفيةفي dashboard-template-1

docker build -t financial-dashboard --build-arg NEXT_PUBLIC_DEMO_MODE=true .

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

القيم التي تبدأ بـ 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. اترك المتغير فارغًا ما لم تنسخ المجلد المستقل إلى خادم بنفسك.