حلّ المجتمع

تثبيت code-server على CasaOS باستخدام BigBearCasaOS: الصورة الحالية، مساحة العمل الدائمة، وPUID/PGID، وأمان الويب

A November 2023 Community post pointing to a BigBearCasaOS tutorial for browser-based VS Code. The forum body does not preserve the installation configuration. BigBearCasaOS still maintains code-server today using the LinuxServer.io image, so the current package and upstream documentation are the durable sources.

منشور المنتدى لعام 2023 هو في الأساس إحالة إلى برنامج تعليمي خارجي من BigBearCasaOS، وليس سجلًا كاملًا للتثبيت. والخبر الجيد هو أن الحزمة الأساسية لا تزال قيد الصيانة: فما زالت BigBearCasaOS تدرج code-server باستخدام صورة LinuxServer.io.

ينبغي أن يركّز النشر الحالي على الإعدادات ومساحة العمل الدائمة، وهوية المستخدم/المجموعة الصحيحة للمجلدات المرتبطة بالمشاريع، والمصادقة. يوفّر code-server وصولًا عبر المتصفح إلى الصدفة البرمجية/المحرر وملفاتك، لذا فإن تعريضه للإنترنت العام بشكل عشوائي ينطوي على مخاطر أعلى بكثير من تعريض لوحة معلومات وسائط للقراءة فقط.

لا تزال BigBearCasaOS تصون code-server

تربط حزمة BigBear الحالية مجلدات الإعدادات والمشاريع الدائمة، وتتيح واجهة الويب الخاصة بـ code-server من LinuxServer عبر منفذ على المضيف.

راجع حزمة code-server الحالية من BigBear.

اجعل ‎/config‎ دائمًا

تخزّن صورة code-server الحالية من LinuxServer الإعدادات ذات الصلة ضمن /config. احتفظ بهذا المجلد في AppData الخاص بـ CasaOS أو في موقع تخزين دائم آخر، حتى تبقى إعدادات المستخدم وتهيئة SSH والإضافات وحالة مساحة العمل بعد إعادة إنشاء الحاوية.

اربط مجلد المشروع الفعلي بشكل مدروس

تتيح BigBear أيضًا وحدة تخزين للمشروع. إذا كانت الشفرة المصدرية موجودة أصلًا على مشاركة NAS أو قرص تخزين، فاربط شجرة المجلدات التي يحتاج إليها code-server فعليًا فقط، بدلًا من منحه صلاحية كتابة واسعة على NAS بالكامل.

استخدم قيمتي PUID وPGID الفعليتين

تدعم صورة LinuxServer الحالية قيمتي PUID وPGID، بحيث يمكن للملفات التي تُنشأ عبر محرر المتصفح أن تتوافق مع نموذج ملكية المضيف.

شغّل id username على مضيف CasaOS عادي يعمل بنظام Linux لتحديد المستخدم/المجموعة، بدلًا من افتراض أن القيمة 1000 صحيحة دائمًا.

فعّل المصادقة قبل الاستخدام العادي

تدعم LinuxServer المتغيرين PASSWORD أو HASHED_PASSWORD. وإذا لم يتم تعيين أيٍّ منهما، فقد تعمل واجهة الويب دون مصادقة.

استخدم إرشادات حاوية code-server الحالية.

تعامل مع SUDO_PASSWORD باعتباره ميزة اختيارية قوية

يمكن للصورة إتاحة sudo داخل الحاوية عند تهيئتها لذلك. لا تفعّله لمجرد أن برنامجًا تعليميًا قديمًا يعرض هذا الحقل. فحاوية تطوير يمكن الوصول إليها عبر المتصفح مع sudo أكثر حساسية من محرر عادي يعمل دون امتيازات.

فضّل الشبكة المحلية أو VPN أو وكيلًا عكسيًا محكم الإعداد

إذا كان لا بد من الوصول إلى code-server عن بُعد، فاستخدم VPN/شبكة تراكبية تتطلب المصادقة أو وكيلًا عكسيًا HTTPS مُعدًا بعناية. احمِ مفاتيح SSH وبيانات اعتماد Git والطرفيات والشفرة المصدرية المخزنة ضمن مساحة العمل.

حدّث بإعادة إنشاء الحاوية، لا بتعديل الصورة من الداخل

توصي LinuxServer بسحب الصورة الأحدث وإعادة إنشاء الحاوية مع الإبقاء على تعيين /config الدائم نفسه. يحافظ ذلك على كون الحاوية قابلة للاستبدال، بينما تظل حالة المستخدم خارجها.

الأسئلة الشائعة حول code-server على CasaOS

هل يُعد منشور المنتدى لعام 2023 نفسه دليل تثبيت كاملًا وحديثًا؟

لا. إنه يحيل إلى برنامج تعليمي خارجي من BigBear.

هل لا تزال BigBearCasaOS تصون code-server؟

نعم. لا يزال الكتالوج الحالي لـ BigBear يتضمن حزمة code-server من LinuxServer.

ما المسار الدائم الأهم؟

/config، بالإضافة إلى أي مجلد منفصل للمشروع/مساحة العمل تختار ربطه بالحاوية عمدًا.