SYSTEMD-FIRSTBOOT(1)

الاسم
systemd-firstboot, systemd-firstboot.service - تهيئة إعدادات النظام الأساسية عند أو قبل أول إقلاع للنظام

موجز

systemd-firstboot [خيارات...]

systemd-firstboot.service

الوصف

وحدة systemd-firstboot.service هي إحدى الوحدات المستخدمة لتهيئة تكوين الجهاز أثناء "الإقلاع الأول"، أي عندما يكون النظام مثبتًا حديثًا أو بعد إعادة ضبط المصنع. يقوم مدير systemd(1) نفسه بتهيئة machine-id(5) وضبط جميع الوحدات مسبقًا، مع تمكينها أو تعطيلها وفقًا لإعدادات systemd.preset(5). يتم تشغيل systemd-firstboot.service لاحقًا لتهيئة تكوين النظام الأساسي بشكل تفاعلي. يتم تشغيله فقط إذا تحقق الشرط ConditionFirstBoot=yes، مما يعني أساسًا أن /etc/ غير مملوءة، انظر systemd.unit(5) للتفاصيل. يمكن استخدام بيانات اعتماد النظام لحقن التكوين؛ لا يتم الاستعلام عن تلك الإعدادات بشكل تفاعلي.

يمكن أيضًا استخدام أمر systemd-firstboot لتهيئة صورة نظام غير متصلة بشكل غير تفاعلي.

يمكن تكوين الإعدادات التالية:

    • معرف الجهاز للنظام

    • الإعدادات المحلية للنظام، وبشكل أكثر تحديدًا متغيري الإعدادات المحلية LANG= و LC_MESSAGES

    • خريطة لوحة المفاتيح للنظام

    • المنطقة الزمنية للنظام

    • اسم المضيف للنظام

    • وسوم الجهاز

    • سطر أوامر النواة المستخدم عند تثبيت صور النواة

    • كلمة السر والقشرة للمستخدم الجذر

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

إذا كان الإعداد قد تمت تهيئته بالفعل، فلن يتم استبداله ولن يُطلب من المستخدم الإعداد.

لاحظ أن هذه الأداة تعمل مباشرة على نظام الملفات ولا تتضمن أي خدمات نظام قيد التشغيل، على عكس localectl(1) أو timedatectl(1) أو hostnamectl(1). يسمح هذا لـ systemd-firstboot بالعمل على صور أقراص موصولة ولكن غير مقلعة وفي مرحلة الإقلاع المبكر. لا يُوصى باستخدام systemd-firstboot على النظام قيد التشغيل بعد إعداده.

الخيارات

الخيارات التالية مفهومة:

--root=جذر
    يأخذ مسار دليل كوسيط. سَتُلْحَقُ بادئة مسار root البديلة المعطاة لجميع المسارات، بما في ذلك مسارات البحث عن الضبط. هذا مفيد للعمل على صورة نظام موصولة بالدليل المحدد بدلاً من نظام المضيف نفسه.

    أُضيف في الإصدارة 216.

--image=مسار
    يأخذ مسارًا لملف صورة قرص أو عقدة جهاز كتلي. إذا حُدد، ستُطبق جميع العمليات على نظام الملفات في صورة القرص المشار إليها. هذا مشابه لـ --root= ولكنه يعمل على أنظمة الملفات المخزنة في صور الأقراص أو الأجهزة الكتلية. يجب أن تحتوي صورة القرص إما على نظام ملفات واحد أو مجموعة من أنظمة الملفات ضمن جدول أقسام GPT، وفقًا لـ UAPI.2 مواصفات الأقسام القابلة للاكتشاف[1]. لمزيد من المعلومات حول صور الأقراص المدعومة، انظر مفتاح systemd-nspawn(1) الذي يحمل الاسم نفسه.

    أُضيف في الإصدار 246.

--locale=LOCALE, --locale-messages=LOCALE
    يضبط الإعدادات المحلية للنظام، وبشكل أكثر تحديدًا إعدادات LANG= و LC_MESSAGES. يجب أن تكون الوسيطة معرفًا محليًا صالحًا، مثل "de_DE.UTF-8". يتحكم هذا في ملف التكوين locale.conf(5).

    أُضيف في الإصدارة 216.

--keymap=KEYMAP
    يضبط تخطيط لوحة المفاتيح للنظام. يجب أن تكون الوسيطة خريطة لوحة مفاتيح صالحة، مثل "de-latin1". يتحكم هذا في إدخال "KEYMAP" في ملف التكوين vconsole.conf(5).

    أُضيف في الإصدارة 236.

--timezone=منطقة_زمنية
    يضبط المنطقة الزمنية للنظام. يجب أن تكون الوسيطة معرف منطقة زمنية صالحًا، مثل "Europe/Berlin". يتحكم هذا في الرابط الرمزي localtime(5).

    أُضيف في الإصدارة 216.

--hostname=HOSTNAME
    يضبط اسم المضيف للنظام. يجب أن تكون الوسيطة اسم مضيف متوافقًا مع DNS. يتحكم هذا في ملف التكوين hostname(5).

    أُضيف في الإصدارة 216.

--setup-machine-id
    يهيئ معرف جهاز النظام إلى معرف عشوائي. يتحكم هذا في ملف machine-id(5).

    يعمل هذا الخيار فقط مع --root= أو --image=. على نظام قيد التشغيل، يُكتب machine-id بواسطة المدير بمساعدة systemd-machine-id-commit.service(8).

    أُضيف في الإصدارة 216.

--machine-id=ID
    يضبط معرف جهاز النظام على القيمة المحددة. تنطبق نفس القيود كما في --setup-machine-id.

    أُضيف في الإصدارة 216.

--machine-tags=وسم[:وسم...]
    اضبط وسوم الآلة على القائمة المحددة المفصولة بنقطتين. وسوم الآلة هي تسميات قصيرة قد تُستخدم لتصنيف وتجميع الآلات لأغراض إدارية، على سبيل المثال لتحديد الدور الذي تلعبه آلة في نشر، أو الأسطول أو الوحدة التنظيمية التي تنتمي إليها، أو أي سمة أخرى يعرفها المسؤول. يجب أن يكون طول كل وسم فردي 1...255 حرفًا ويتكون فقط من محارف ASCII أبجدية رقمية، "-" و".". يتحكم هذا في حقل TAGS= من machine-info(5). قد تُستعلم الوسوم لاحقًا وتُغير بأمر tags من hostnamectl(1)، وتُطابق مع إعدادات الوحدة ConditionMachineTag=/AssertMachineTag=، انظر systemd.unit(5).

    على عكس معظم الإعدادات الأخرى، لا يُطلب إدخال وسوم الآلة تفاعليًا.

    أُضيف في الإصدار 261.

--root-password=PASSWORD, --root-password-file=PATH, --root-password-hashed=HASHED_PASSWORD
    يضبط كلمة السر للمستخدم الجذر للنظام. ينشئ/يعدل هذا ملفي passwd(5) و shadow(5). يوجد هذا الإعداد في ثلاثة أشكال: يقبل --root-password= كلمة السر لضبطها مباشرة على سطر الأوامر، ويقرأها --root-password-file= من ملف، ويقبل --root-password-hashed= كلمة سر معمّاة بالفعل على سطر الأوامر. انظر shadow(5) لمزيد من المعلومات حول تنسيق كلمة السر المعمّاة. لاحظ أنه لا يُوصى بتحديد كلمات سر نصية عادية على سطر الأوامر، حيث قد يتمكن مستخدمون آخرون من رؤيتها بمجرد استدعاء ps(1).

    أُضيف في الإصدارة 216.

--root-shell=SHELL
    يضبط شل المستخدم الجذر للنظام. ينشئ/يعدل ملف passwd(5).

    أُضيف في الإصدار 246.

--kernel-command-line=CMDLINE
    يضبط سطر أوامر النواة للنظام. يتحكم هذا في ملف /etc/kernel/cmdline الذي يستخدمه kernel-install(8).

    أُضيف في الإصدار 246.

--prompt-locale، --prompt-keymap، --prompt-timezone، --prompt-hostname، --prompt-root-password، --prompt-root-shell
    يطلب من المستخدم تفاعليًا إعدادًا أساسيًا محددًا. لاحظ أن أي إعدادات تكوين صريحة محددة في سطر الأوامر لها الأولوية، ولا يُطلب من المستخدم إدخالها.

    أُضيف في الإصدارة 216.

--prompt
    يستعلم المستخدم عن الإعدادات المحلية، وخريطة المفاتيح، والمنطقة الزمنية، واسم المضيف، وكلمة سر الجذر، وشل الجذر. هذا يعادل تحديد --prompt-locale، --prompt-keymap، --prompt-timezone، --prompt-hostname، --prompt-root-password، --prompt-root-shell معًا.

    أُضيف في الإصدارة 216.

--prompt-keymap-auto
    إذا تم استدعاؤه من طرفية افتراضية TTY، يعادل --prompt-keymap، وإلا فلا تأثير له. أو بعبارة أخرى، يطلب تفاعليًا خريطة مفاتيح فقط إذا تم استخدام لوحة مفاتيح محلية للتفاعل الذي يتطلب ذلك.

    أُضيف في الإصدار 259.

--copy-locale، --copy-keymap، --copy-timezone، --copy-root-password، --copy-root-shell
    ينسخ إعدادًا أساسيًا محددًا من المضيف. يعمل هذا فقط مع --root= أو --image=.

    أُضيف في الإصدارة 216.

--copy
    ينسخ الإعدادات المحلية، وخريطة المفاتيح، والمنطقة الزمنية، وكلمة سر الجذر، والشل من المضيف. هذا يعادل تحديد --copy-locale، --copy-keymap، --copy-timezone، --copy-root-password، --copy-root-shell معًا.

    أُضيف في الإصدارة 216.

--force
    يكتب التهيئة حتى لو كانت الملفات ذات الصلة موجودة بالفعل. بدون هذا الخيار، لا يعدل systemd-firstboot أو يستبدل الملفات الموجودة. لاحظ أنه عند تهيئة حساب الجذر، حتى مع هذا الخيار، يعدل systemd-firstboot فقط إدخال المستخدم "root"، تاركًا الإدخالات الأخرى في /etc/passwd و /etc/shadow كما هي.

    أُضيف في الإصدار 246.

--reset
    إذا تم تحديده، تُحذف جميع الملفات الموجودة التي يهيئها systemd-firstboot. لاحظ أن الملفات تُحذف بغض النظر عما إذا كانت ستهيأ بقيمة جديدة أم لا. يضمن هذا الإجراء أن الإقلاع التالي للصورة سيعتبر إقلاعًا أوليًا، وسيطلب systemd-firstboot مرة أخرى تهيئة كل ملف من الملفات المحذوفة.

    أُضيف في الإصدار 254.

--delete-root-password
    يزيل كلمة سر المستخدم الجذر للنظام، مما يتيح تسجيل الدخول كجذر بدون كلمة سر ما لم يكن حساب الجذر مقفلاً. لاحظ أن هذا غير آمن للغاية، وبالتالي لا ينبغي استخدام هذا الخيار باستخفاف.

    أُضيف في الإصدار 246.

--welcome=
    يأخذ وسيطًا منطقيًا. افتراضيًا، عند طلب خيارات التهيئة من المستخدم، يُعرض نص ترحيب مختصر قبل طرح السؤال الأول. مرر false لهذا الخيار لإيقاف تشغيل نص الترحيب.

    أُضيف في الإصدار 246.

--chrome=
    يأخذ وسيطًا منطقيًا. افتراضيًا، تعرض شاشة الإعداد الأولي أشرطة "كروم" ملونة معكوسة في أعلى وأسفل شاشة الطرفية، والتي يمكن تعطيلها بتعيين هذا الخيار إلى false.

    أُضيف في الإصدار 259.

--mute-console=
    يأخذ وسيطًا منطقيًا. إذا كان true، يُعطل مؤقتًا إخراج سجل النواة وإخراج حالة مدير الخدمة إلى وحدة تحكم النظام أثناء تشغيل systemd-firstboot، بحيث لا ينقطع إخراجه الخاص. المبدئي هو false.

    أُضيف في الإصدار 259.

-h، --help
    اطبع نص مساعدة قصير واخرج.

--version
    اطبع سلسلة إصدار قصيرة واخرج.

بيانات الاستيثاق

يدعم systemd-firstboot منطق بيانات اعتماد الخدمة كما هو مطبق بواسطة ImportCredential=/LoadCredential=/SetCredential= (انظر systemd.exec(5) للتفاصيل). تُستخدم بيانات الاعتماد التالية عند تمريرها:

passwd.hashed-password.root، passwd.plaintext-password.root
    نسخة مشفرة أو نصية واضحة من كلمة سر الجذر لاستخدامها، بدلاً من مطالبة المستخدم. بيانات الاعتماد هذه مكافئة لتلك المحددة لخدمة systemd-sysusers.service(8).

    أُضيف في الإصدار 249.

passwd.shell.root
    يحدد ملف الشل الثنائي لاستخدامه للحساب المحدد. مكافئ لبيانات الاعتماد التي تحمل الاسم نفسه والمحددة لخدمة systemd-sysusers.service(8).

    أُضيف في الإصدار 249.

firstboot.locale، firstboot.locale-messages
    تحدد بيانات الاعتماد هذه إعدادات الإعدادات المحلية لتعيينها أثناء الإقلاع الأول، بدلاً من مطالبة المستخدم.

    أُضيف في الإصدار 249.

firstboot.keymap
    تحدد بيانات الاعتماد هذه إعداد لوحة المفاتيح لتعيينه أثناء الإقلاع الأول، بدلاً من مطالبة المستخدم.

    لاحظ العلاقة مع بيانات الاعتماد vconsole.keymap التي تفهمها systemd-vconsole-setup.service(8): كلاهما يؤثر في النهاية على نفس الإعداد، لكن firstboot.keymap يُكتب في /etc/vconsole.conf عند الإقلاع الأول (إذا لم يكن مهيئًا بالفعل)، ثم يُقرأ من هناك بواسطة systemd-vconsole-setup، بينما يُقرأ vconsole.keymap في كل إقلاع، ولا يُحفظ على القرص (لكن أي تهيئة في vconsole.conf ستكون لها الأولوية إذا كانت موجودة).

    أُضيف في الإصدار 249.

firstboot.timezone
    تحدد بيانات الاعتماد هذه إعداد المنطقة الزمنية للنظام لتعيينه أثناء الإقلاع الأول، بدلاً من مطالبة المستخدم.

    أُضيف في الإصدار 249.

firstboot.hostname
    تحدد هذه الصلاحية اسم المضيف الثابت للنظام ليُضبط أثناء الإقلاع الأول. لن يُطلب من المستخدم إدخال اسم المضيف. لاحظ أن هذا يتحكم في اسم المضيف الثابت، وليس اسم المضيف المؤقت، وله تأثير فقط على الإقلاع الأول، على عكس system.hostname.

    أُضيف في الإصدار 261.

firstboot.machine-tags
    تحدد هذه الصلاحية وسوم الآلة ليُضبط أثناء الإقلاع الأول، كقائمة مفصولة بنقطتين، مكافئة للمفتاح --machine-tags= الموصوف أعلاه. تُكتب الوسوم في حقل TAGS= من /etc/machine-info (إذا لم يكن هذا الملف موجودًا بالفعل)، ولها تأثير فقط على الإقلاع الأول. إذا احتوت القائمة على وسوم غير صالحة، تُتجاهل بالكامل.

    أُضيف في الإصدار 261.

لاحظ أن ملف وحدة systemd-firstboot.service مهيأ افتراضيًا لوراثة بيانات الاعتماد المدرجة من مدير الخدمة. وبالتالي، عند استدعاء حاوية بدليل /etc/ غير مملوء لأول مرة، يمكن تهيئة كلمة سر المستخدم الجذر لتكون "systemd" هكذا:

    # systemd-nspawn --image=... --set-credential=firstboot.locale:de_DE.UTF-8 ...

لاحظ أن بيانات الاعتماد هذه تُقرأ وتُطبق فقط أثناء الإقلاع الأول. بمجرد تطبيقها، تبقى مطبقة للإقلاعات اللاحقة، ولا تُعتبر بيانات الاعتماد بعد الآن.

حالة الخروج

عند النجاح، يُعاد الرقم 0، وإلا فيُعاد رمز فشل غير صفري.

سطر أوامر النواة

systemd.firstboot=
    يأخذ وسيطًا منطقيًا، المبدئي هو on. إذا كان off، لن يستعلم systemd-firstboot.service المستخدم تفاعليًا عن الإعدادات الأساسية عند الإقلاع الأول، حتى لو لم تكن تلك الإعدادات مهيأة بعد.

    أُضيف في الإصدار 233.

انظر أيضًا

systemd(1)، locale.conf(5)، vconsole.conf(5)، localtime(5)، hostname(5)، machine-id(5)، shadow(5)، systemd-machine-id-setup(1)، localectl(1)، timedatectl(1)، hostnamectl(1)

ملاحظات

1.  UAPI.2 مواصفات الأقسام القابلة للاكتشاف
    https://uapi-group.org/specifications/specs/discoverable_partitions_specification

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.