تخطَّ إلى المحتوى
Octoboard الوثائق

خادم Linux

ثبّت octoboardd، برنامج خادم Octoboard (يسمّيه التطبيق «الخدمة»)، على خادم Linux دون صلاحيات root. يمكنك الوصول إليه من تطبيق macOS أو Windows، أو من متصفح، وكلاهما عبر SSH.

لمعماريتي x86_64 وaarch64، على أي توزيعة.

  • خادم Linux يمكنك تسجيل الدخول إليه عبر SSH. SSH طريقة آمنة لتسجيل الدخول إلى جهاز آخر وكتابة الأوامر عليه. يعطيك مزوّد الخادم عنوانه واسم المستخدم الخاص بك.
  • تطبيق Octoboard على كمبيوترك، لنظام macOS أو Windows، إذا أردت العمل في تطبيق سطح المكتب (موصى به).

لتسجيل الدخول، افتح Terminal (في macOS) أو PowerShell (في Windows) على كمبيوترك وشغّل الأمر أدناه، مع وضع اسم المستخدم الخاص بك مكان <you> وعنوان الخادم مكان <server>. في المرة الأولى، أجب بـ yes عندما يسأل هل تثق بالخادم.

Terminal window
ssh <you>@<server>

تُنفَّذ الخطوتان 1 و2 أدناه على الخادم، في نافذة تسجيل الدخول هذه.

  1. ثبّت octoboardd على الخادم.

    Terminal window
    curl --proto '=https' --tlsv1.2 -fsSL https://octoboard.dev/install.sh | sh

    يطبع سطرًا يبدأ بـ Installed octoboardd.

  2. شغّله على الخادم.

    Terminal window
    octoboardd start

    يطبع سطرًا يبدأ بـ Octoboard started.

  3. اتصل به من كمبيوترك بإحدى طريقتين:

    • من تطبيق سطح المكتب (موصى به): اتبع الاتصال بخادم Linux في دليل SSH.

    • من متصفح: شغّل هذا الأمر على الخادم.

      Terminal window
      octoboardd address

      يطبع شيئين: عنوان متصفح يبدأ بـ http://127.0.0.1:، وأمر ssh. على كمبيوترك، انسخ أمر ssh، واستبدل <server> بعنوان الخادم (عنوان IP أو الاسم الذي تسجّل به الدخول إليه)، ثم شغّله في Terminal أو PowerShell. قد يطلب كلمة المرور، ثم لا يعرض شيئًا بعد ذلك؛ وهذا طبيعي. اترك تلك النافذة مفتوحة: إغلاقها يقطع الاتصال. ثم افتح العنوان المطبوع في متصفحك.

ستعرف أن كل شيء نجح عندما يفتح Octoboard في نافذة جديدة من تطبيق سطح المكتب، أو في تبويب المتصفح.

إذا قال التثبيت إن مجلدًا ينتهي بـ .local/bin (مثل /home/<you>/.local/bin) ليس في PATH، فهذا يعني أن الصدفة (shell) لا تجد octoboardd بالاسم. شغّله بالمسار الكامل الذي طبعه التثبيت، أو أضف ~/.local/bin إلى PATH (مثلًا في ~/.profile) وسجّل الدخول من جديد.

إبقاؤه قيد التشغيل بعد تسجيل الخروج أو إعادة التشغيل

Section titled “إبقاؤه قيد التشغيل بعد تسجيل الخروج أو إعادة التشغيل”

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

لكي يبدأ مع كل تشغيل للخادم ويستمر بعد تسجيل الخروج، ثبّته بدلًا من ذلك كخدمة:

Terminal window
curl --proto '=https' --tlsv1.2 -fsSL https://octoboard.dev/install.sh | sh -s -- --service

يثبّت هذا الأمر البرنامج، ويضبطه كخدمة مستخدم في systemd، ويشغّله. ثم يفعّل خاصية lingering التي تتيح لخدماتك العمل وأنت غير مسجّل الدخول. وإذا قال إنه لم يستطع ذلك، فشغّل هذا الأمر مرة واحدة (وقد يحتاج إلى sudo):

Terminal window
loginctl enable-linger "$USER"

المنفذ الافتراضي هو 3369. لاستخدام منفذ آخر، أضف --port <port> إلى نهاية أمر الخدمة، أو إلى octoboardd start.

لا يرقّي Octoboard نفسه بنفسه أبدًا: عند صدور نسخة جديدة يخبرك المتصفح، وأنت تختار متى تثبّتها. بعد تثبيت النسخة الجديدة، يعيد Octoboard التشغيل إليها من تلقاء نفسه إذا لم تكن هناك جلسة ستنقطع؛ وإن كانت هناك جلسات ستنقطع فإنه يعرضها ويسألك أولًا.

  • في المتصفح: اختر تنزيل وتثبيت حيث تظهر رسالة أن نسخة جديدة متاحة.

  • على الخادم: شغّل هذا الأمر.

    Terminal window
    octoboardd update

    إذا سأل هل تريد إعادة التشغيل الآن، فأجب بـ y لإعادة التشغيل، أو اضغط Enter لإبقاء النسخة القديمة قيد التشغيل في الوقت الحالي. لإعادة التشغيل لاحقًا، شغّل octoboardd restart.

إذا قال octoboardd update إنه لا يستطيع استبدال البرنامج، مثلًا لأنه مثبّت في مكان لا يمكنك الكتابة فيه، فشغّل أمر التثبيت (أو أمر الخدمة) من جديد بدلًا من ذلك. فهو يعيد التشغيل بالطريقة نفسها عندما يكون ذلك آمنًا، وإلا طلب منك تشغيل octoboardd restart.

تنزيل الأرشيف بدلًا من ذلك

Section titled “تنزيل الأرشيف بدلًا من ذلك”
أرشيف x86_64 أرشيف aarch64 كل الإصدارات السابقة