*تحذير: هذا إصدار مبكر، يُرجى قراءة ملاحظات الإصدار لجميع الإصدارات حتى الآن*

# <img src="https://raw.githubusercontent.com/rubenbe/opensoho/HEAD/logo.svg" alt="شعار OpenSOHO" width="40" /> OpenSOHO

شكرًا لتفكيرك في دعم المشروع!

[التوثيق](https://opensoho.github.io/docs)

صُمم OpenSOHO لإدارة عدد صغير من أجهزة الشبكة القائمة على OpenWRT. ومن هنا جاء اسم SOHO من شبكات المكاتب الصغيرة والمكاتب المنزلية (SOHO).

* من 2 إلى 20 جهازًا (لا يوجد حد أقصى صارم)
* لا تعدد للمستأجرين
* متوافق مع openwisp-config وopenwisp-monitoring.
* سهل النشر

مستوحى من OpenWISP، لكنه يستهدف الشبكات الصغيرة جدًا بحيث لا يمكن صيانتها باستخدام OpenWISP.
كما ذكر OpenWisp:
> ومع ذلك، قد لا يكون OpenWISP الخيار الأنسب للشبكات الصغيرة جدًا (أقل من 20 جهازًا)، أو للمؤسسات التي تفتقر إلى الخبرة في تكنولوجيا المعلومات، أو للمؤسسات التي تبحث عن بدائل مفتوحة المصدر لأغراض توفير التكاليف فقط.

تم اختبار الإصدارات التالية
* OpenWRT 24.10.x DSA (دعم قديم)
* OpenWRT 25.12.x DSA

# البدء مع OpenSOHO
## نظرة عامة
يتطلب إعداد OpenSOHO بضع خطوات بسيطة، كل منها مفصّل في الأقسام أدناه:

* تثبيت OpenSOHO على خادمك.
* تثبيت حزم OpenWisp على أجهزة OpenWRT الخاصة بك.
* تكوين OpenWisp على كل جهاز من أجهزة OpenWRT للاتصال بـ OpenSOHO.
* ابدأ التكوين في OpenSOHO!

## تثبيت OpenSOHO

* نزّل أحدث إصدار من OpenSOHO (أو استخدم حاوية docker)

[الإصدارات](https://github.com/rubenbe/opensoho/releases)

[الإعداد باستخدام Docker أو Podman أو Kubernetes](https://opensoho.github.io/docs/containers/)

* ابدأ OpenSOHO

أولاً، اختر سرًا مشتركًا يسمح لأجهزة OpenWRT (باستخدام openwisp-config) بالتسجيل في OpenSOHO.

اختر سلسلة عشوائية طويلة لأفضل أمان.

يجب أن تتطابق مع ما تقوم بتكوينه في LuCI في الخطوات التالية.

```sh
OPENSOHO_SHARED_SECRET=randompassphrase ./opensoho serve --http 0.0.0.0:8090
```

الآن، يُخرج OpenSOHO عنوان URL على سطر الأوامر يتيح لك إنشاء حساب المسؤول.
ما عليك سوى فتح عنوان URL في متصفحك.

بدلاً من ذلك، أنشئ حساب المسؤول عبر سطر الأوامر:
```sh
./opensoho superuser upsert EMAIL PASS
```

## تهيئة (تبنّي) أجهزة OpenWRT

### تثبيت حزم OpenWISP

```sh
opkg install openwisp-config openwisp-monitoring luci-app-openwisp # OpenWRT 24.10
apk add openwisp-config openwisp-monitoring luci-app-openwisp # OpenWRT 25.12+
```

إذا كنت تريد استخدام توجيه عملاء 802.11v، فإن حزمة wpad-mbedtls الكاملة ضرورية.

على OpenWRT 24.10
```sh
opkg remove wpad-basic-mbedtls && \
opkg install wpad-mbedtls && \
service wpad restart
```

على OpenWRT 25.12+
```sh
apk del wpad-basic-mbedtls && \
apk add wpad-mbedtls && \
service wpad restart
```

بعد تثبيت wpad-mbedtls، جرّب `service restart wpad` أولاً، وإلا فقد يلزم إعادة تشغيل النظام للتبديل إلى ملف wpad الثنائي الجديد. وإلا فقد تحصل على خطأ مثل `daemon.notice netifd: radio1 (28210): WARNING (wireless_add_process): executable path /usr/sbin/wpad does not match process 1842 path (/usr/sbin/wpad (deleted))`.
(يرجى ملاحظة أن توجيه العملاء 802.11v لا يزال قيد التطوير)

### تكوين OpenWISP في LuCI:

* عيّن `Server URL` و`Shared secret` فقط.
* لا تُضِف شرطة مائلة (/) إلى `Server URL`. مثال على URL: `http://192.168.1.1:8090`
* السر المشترك هو القيمة التي اخترتها سابقًا (`OPENSOHO_SHARED_SECRET`).
* اختياريًا، خفّض `Update Interval` إلى 30 ثانية للحصول على تحديثات أسرع. (يقوم OpenSOHO بذلك نيابةً عنك إن لم تفعل)
* يفعّل OpenSOHO أيضًا المراقبة ويخفض فاصل المراقبة إلى 15 ثانية لتحديثات أسرع لحالة الشبكة.

يُوصى بشدة بتفعيل المراقبة، لأن OpenSOHO يستنتج الكثير من إعدادات OpenWRT الحالية ويملؤها لتسهيل التكوين.

## تكوين OpenSOHO

* انتظر حتى تسجّل أجهزة OpenWrt نفسها تلقائيًا باستخدام السر المشترك.
* عيّن علامة `Enabled` الخاصة بالجهاز إلى true.
* عيّن `numradios` إلى القيمة الصحيحة. على سبيل المثال، لجهاز 2.4 + 5GHz تكون هذه القيمة 2.
* أنشئ نقطة وصول Wifi (SSID+KEY). يتيح هذا الإجراء لـ OpenSOHO اكتشاف تكوين الراديو بشكل صحيح عند تسجيل الجهاز.
* اربط نقطة وصول Wifi المُكوَّنة بجهاز ليتم تكوينه.
* حاليًا سيتم تكوين كل شبكة تلقائيًا على جميع أجهزة الراديو (المكوَّنة باستخدام `numradios`).
* اختياريًا يمكن أيضًا تشغيل مصابيح LED أو إطفاؤها (تكوين ثابت فقط في الوقت الحالي).
* أصبح تكوين ترددات الراديو مدعومًا الآن. يقرأ OpenSOHO تكوين الراديو الحالي مرة واحدة ويجعله متاحًا ضمن تكوين أجهزة الراديو. قد يستغرق ظهور تكوين الراديو دقيقة أو دقيقتين (تحتاج خطوات التكوين والمراقبة بعض الوقت لإكمالها).

## لوحة المعلومات

يأتي OpenSOHO بلوحة معلومات أساسية. يمكن الوصول إليها عبر الزر الموجود في الشريط الجانبي الأيسر، أسفل شعار OpenSOHO مباشرةً.

يرجى ملاحظة أن هذا ليس المقصود به أن يكون بديلاً عن أدوات الرسم البياني الأكثر تقدمًا، فهو وسيبقى أساسيًا عن قصد.

## التكوين

يمكن الآن الوصول إلى OpenSoho عبر http://ipaddress:8090/_/

هناك عدة مجموعات تكوين:

### العملاء

هؤلاء هم العملاء المتصلون بـ Wifi. هذا الجدول للقراءة فقط، باستثناء الاسم المستعار.
يمكن استخدامه لإعطاء الأجهزة اسمًا مقروءًا للبشر. يعمل هذا بشكل صحيح فقط عندما لا يقوم العميل بتعشيق عنوان mac الخاص به عشوائيًا.

#### العملاء المتصلون
يحتوي على قائمة العملاء المتصلين حاليًا بشبكة wifi الخاصة بك. لعرض عنوان IP الخاص بالجهاز، يحتاج OpenSOHO إلى الوصول إلى عقود إيجار DHCP الخاصة بك. للقيام بذلك، يجب أن يكون لديك برنامج مراقبة openwisp قيد التشغيل على الجهاز الذي يحتوي على خادم DHCP. الأجهزة ذات عنوان IP الثابت لن تحصل على IP. هذا قيد معروف اعتبارًا من الإصدار 0.12.0.

### الأجهزة

هذه هي الأجهزة المتصلة.
* استخدم enable/disable لتعطيل تحديثات التكوين. هذا مفيد لتجنب تحديث جميع الأجهزة دفعة واحدة. تبقى المراقبة نشطة.
* حالة الصحة حقل للقراءة فقط. تعني `healthy` أن الجهاز قد تواصل خلال الدقيقة الأخيرة. إذا لم يفعل ذلك، تصبح حالة الصحة `unhealthy` وقد يكون هناك خطب ما في الجهاز أو اتصاله.
* تتيح Leds اختيار تكوينات led
* يتيح Numradios تعيين عدد أجهزة الراديو على الجهاز. لا يتم إرسال هذا مبدئيًا بواسطة OpenWisp، لذا يجب على المستخدم تعيينه.
* تتيح Wifis اختيار SSIDs لتطبيقها على هذا الجهاز.

### حجوزات DHCP

أنشئ حجزًا باستخدام اسم مضيف وعنوان MAC وعنوان IPv4 وخادم DHCP واحد أو
أكثر. يضيف OpenSOHO قسم `config host` المُسمّى نفسه إلى
`/etc/config/dhcp` على كل خادم محدد. امسح تحديد خادم DHCP لتعطيل
الحجز دون حذفه. الأسماء وعناوين MAC وعناوين IP فريدة عبر قائمة الحجوزات.

### Leds

* إعداد أساسي لمصابيح LED (أشبه بإثبات مفهوم في الوقت الحالي)

### Radios

* يسمح بتعيين التردد لكل راديو.
* لا ينبغي تعديل النطاق، لأن هذا يسمح لـ OpenSOHO بالتحقق من إعداد التردد. هذا مطلوب بسبب القيود داخل PocketBase.

### Wifi

* يسمح بإعداد شبكات SSID متعددة. اختيار أوضاع التشفير محدود حاليًا. WEP أو Open غير مدعوم بحكم التصميم.

## المراقبة

### مراقبة الجهاز

تحقق مما إذا كانت صحة الجهاز `healthy`.

### العملاء المتصلون

يعرض هذا العرض جميع عملاء wifi الذين لا يزالون متصلين خلال آخر 30 ثانية.

### تكامل Home Assistant

يمكن دمج مراقبة OpenSOHO مع Home Assistant. [(مزيد من المعلومات)](https://opensoho.github.io/docs/home-assistant/)
صُمم واجهة REST API هذه للاستخدام مع Home Assistant، ولكن يمكن دمجها أيضًا مع أدوات أخرى.

## استكشاف الأخطاء وإصلاحها

### إعادة تسجيل جهاز

عند تغيير `Server URL` الخاص بـ OpenWISP في LuCI لا يبدو أنه يُسجّل مع المتحكم الجديد بشكل صحيح.
لإصلاح ذلك:
```sh
uci delete openwisp.http.uuid
uci delete openwisp.http.key
/etc/init.d/openwisp-config restart
```

### لا يتم تفعيل SSID الأول

يبدو أن هناك مشكلة في OpenWRT حيث لا يتم تفعيل SSID الأول المُهيأ على جهاز WiFi تلقائيًا.
حل بديل: انقر على زر التفعيل في LuCI.

# المطورون

* ثبّت التبعيات

```sh
go mod tidy
```

* تشغيل OpenSOHO

يُستخدم السر المشترك بواسطة openwisp-config للتسجيل. اختر سلسلة عشوائية طويلة للحصول على أمان مثالي.

تشغيل اختبارات الوحدة:
```sh
go test -cover -v -coverprofile=coverage.out
go tool cover -html=coverage.out
```

## النطاق

### الميزات

بعض ميزات OpenWISP تُعتبر (حاليًا) خارج نطاق OpenSOHO
* تحديثات البرامج الثابتة: لا يحتاج OpenWRT إلى تحديث متكرر؛ استخدم ميزة الترقية المُشرف عليها (Attended sysupgrade) على كل جهاز يدويًا.
* تعدد المستأجرين
* القوالب: يمتلك OpenWISP آلية قوالب قوية ومتعددة الاستخدامات، ويُستبدل هذا بمجموعة فرعية أكثر تحديدًا من الميزات لتوفير تجربة إعداد أسهل.

### التطوير
الهدف هو الاستفادة القصوى من pocketbase. يمكن إجراء تعديلات صغيرة نظرًا لأن الواجهة الخلفية لـ pocketbase تفتقر حاليًا إلى نظام إضافات. لكن ليس الهدف إنشاء نسخة متفرعة (fork) من pocketbase، بحيث يبقى دمج التغييرات من المصدر الأصلي (upstream) أمرًا مباشرًا.

### الإصدار
```sh
GITHUB_TOKEN=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa goreleaser release
```

تنزيل الأداة

opensoho

الأكثر شعبية