كيفية تثبيت Selfoss RSS Reader على FreeBSD 11 FAMP VPS

• المتطلبات الأساسية
• الخطوة 1: إضافة مستخدم Sudo
• الخطوة 2: تحديث نظام FreeBSD 11
• الخطوة 3: قم بتثبيت Apache Web Server
• الخطوة 4: تثبيت PHP 7.1
• الخطوة 5: قم بتثبيت خادم MariaDB (MySQL)
• الخطوة 6: إنشاء قاعدة بيانات لـ Selfoss RSS Reader
• الخطوة 7: تثبيت ملفات Selfoss RSS Reader
• الخطوة 8: تثبيت وتشغيل الملحن
• الخطوة 9: أكمل تثبيت Selfoss RSS Reader

Selfoss RSS Reader هو برنامج مجاني ومفتوح المصدر ومفتوح المصدر ومُستضاف ذاتيًا على الويب ، وبث مباشر ، ومزج ، وقارئ موجز الأخبار (RSS / Atom) ومجمع عالمي. يتميز Selfoss RSS Reader باستيراد OPML وواجهة برمجة تطبيقات JSON المريحة ونظام المكونات الإضافية المفتوح الذي يتيح لك توسيع الوظيفة الافتراضية بسهولة عن طريق كتابة موصلات البيانات المخصصة الخاصة بك. يمكنك استخدام Selfoss للبث المباشر وجمع جميع مشاركاتك وتغريداتك وملفات بودكاست وخلاصاتك في مكان مركزي واحد يمكنك الوصول إليه بسهولة من أي جهاز سطح مكتب أو جهاز محمول.

في هذا البرنامج التعليمي ، سنقوم بتثبيت Selfoss RSS Reader 2.17 على FreeBSD 11 FAMP VPS باستخدام خادم الويب Apache و PHP 7.1 وقاعدة بيانات MariaDB.

المتطلبات الأساسية

• نسخة خادم نظيفة Vultr FreeBSD 11 مع وصول SSH

الخطوة 1: إضافة مستخدم Sudo

سنبدأ بإضافة sudoمستخدم جديد .

أولاً ، قم بتسجيل الدخول إلى الخادم الخاص بك على النحو التالي root:

ssh root@YOUR_VULTR_IP_ADDRESS

و sudoلم يتم تثبيت الأوامر الافتراضية في المثال 11 الخادم Vultr فري، لذلك سنقوم أولا تثبيت sudo:

pkg install sudo

أضف الآن مستخدمًا جديدًا يسمى user1(أو اسم المستخدم المفضل لديك):

adduser user1

و adduserسوف قيادة يطالبك الكثير من التفاصيل لحساب المستخدم، وذلك ببساطة اختيار الإعدادات الافتراضية بالنسبة لمعظمهم، عندما كان من المنطقي أن تفعل ذلك. عندما يُطلب منك ما إذا كان Invite user1 into any other groups?يجب عليك الدخول wheelلإضافتها user1إلى wheelالمجموعة.

تحقق الآن من /etc/sudoersالملف للتأكد من sudoersتمكين المجموعة:

visudo

ابحث عن قسم مثل هذا:

# %wheel        ALL=(ALL)       ALL

يخبرنا هذا السطر أن المستخدمين الذين هم أعضاء في wheelالمجموعة يمكنهم استخدام sudoالأمر للحصول على rootالامتيازات. سيتم التعليق عليه افتراضيًا لذا ستحتاج إلى إلغاء تعليقه ثم حفظ الملف والخروج منه.

يمكننا التحقق من user1عضوية المجموعة باستخدام groupsالأمر:

groups user1

إذا user1لم يكن عضوًا في wheelالمجموعة ، يمكنك استخدام هذا الأمر لتحديث user1عضوية المجموعة:

pw group mod wheel -m user1 

الآن استخدم suالأمر للتبديل إلى user1حساب مستخدم sudo الجديد :

su - user1

سيتم تحديث موجه الأوامر للإشارة إلى أنك قمت بتسجيل الدخول الآن إلى user1الحساب. يمكنك التحقق من ذلك باستخدام whoamiالأمر:

whoami

الآن قم بإعادة تشغيل sshdالخدمة بحيث يمكنك تسجيل الدخول عبر sshحساب مستخدم sudo الجديد غير الجذر الذي أنشأته للتو:

sudo /etc/rc.d/sshd restart

الخروج من user1الحساب:

exit

اخرج من rootالحساب (الذي سيؤدي إلى قطع جلستك ssh):

exit

يمكنك الآن sshالدخول إلى مثيل الخادم من مضيفك المحلي باستخدام user1حساب مستخدم sudo الجديد غير الجذر :

ssh user1@YOUR_VULTR_IP_ADDRESS

إذا كنت تريد تنفيذ sudo دون الحاجة إلى كتابة كلمة مرور في كل مرة ، فافتح /etc/sudoersالملف مرة أخرى باستخدام visudo:

sudo visudo

قم بتحرير قسم wheelالمجموعة بحيث يبدو كالتالي:

%wheel        ALL=(ALL)       NOPASSWD: ALL

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

عندما تريد تسجيل الدخول إلى rootحساب المستخدم من داخل sudoحساب المستخدم ، يمكنك استخدام أحد الأوامر التالية:

sudo -i
sudo su -

يمكنك الخروج من rootالحساب والعودة إلى sudoحساب المستخدم الخاص بك في أي وقت:

exit

الخطوة 2: تحديث نظام FreeBSD 11

قبل تثبيت أي حزم على مثيل خادم FreeBSD ، سنقوم أولاً بتحديث النظام.

تأكد من أنك قمت بتسجيل الدخول إلى الخادم باستخدام مستخدم sudo غير الجذر وتشغيل الأوامر التالية:

sudo freebsd-update fetch
sudo freebsd-update install
sudo pkg update
sudo pkg upgrade

الخطوة 3: قم بتثبيت Apache Web Server

قم بتثبيت خادم الويب Apache:

sudo pkg install apache24

أدخل yعندما يُطلب منك ذلك.

الآن استخدم sysrcالأمر لتمكين خدمة Apache للتنفيذ تلقائيًا في وقت التمهيد:

sudo sysrc apache24_enable=yes

يقوم sysrcالأمر بتحديث /etc/rc.confملف التكوين ، لذلك إذا كنت تريد التحقق من تحديث التكوين يدويًا ، يمكنك ببساطة فتح /etc/rc.confالملف باستخدام محرر المحطة الطرفية المفضل لديك:

vi /etc/rc.conf

ابدأ الآن خدمة Apache:

sudo service apache24 start

يمكنك التحقق بسرعة من تشغيل apache عن طريق زيارة عنوان IP أو مجال مثيل الخادم في المستعرض الخاص بك:

http://YOUR_VULTR_IP_ADDRESS/

سترى صفحة FreeBSD Apache الافتراضية التي تعرض النص:

It works!

تحقق من ملف التكوين الافتراضي لـ Apache للتأكد من أن DocumentRootالتوجيه يشير إلى الدليل الصحيح:

sudo vi /usr/local/etc/apache24/httpd.conf

و DocumentRootسوف خيار التكوين تبدو هذه:

DocumentRoot "/usr/local/www/apache24/data"

نحتاج الآن إلى تمكين mod_rewriteوحدة Apache. يمكننا القيام بذلك من خلال البحث في ملف تكوين Apache الافتراضي عن المصطلح mod_rewrite.

بشكل افتراضي ، mod_rewriteسيتم التعليق على وحدة Apache (مما يعني أنها معطلة). سيبدو خط التكوين في مثيل Vultr FreeBSD 11 نظيفًا كما يلي:

#LoadModule rewrite_module libexec/apache24/mod_rewrite.so

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

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

نحن بحاجة أيضا إلى تمكين mod_authz_codeو mod_headersحدات، وذلك للتأكد من أنهم على حد سواء uncommented أيضا:

LoadModule authz_core_module libexec/apache24/mod_authz_core.so
LoadModule headers_module libexec/apache24/mod_headers.so

نحتاج الآن إلى تحرير Directoryتوجيه Apache في نفس ملف التكوين بحيث mod_rewriteيعمل بشكل صحيح مع Selfoss RSS Reader.

ابحث عن قسم ملف التكوين الذي يبدأ بـ <Directory "/usr/local/www/apache24/data">ويتغير AllowOverride noneإلى AllowOverride All. ستبدو النتيجة النهائية (مع إزالة جميع التعليقات) كما يلي:

<Directory "/var/www/html">
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

الآن قم بحفظ ملف تكوين Apache والخروج منه.

سنقوم بإعادة تشغيل Apache في نهاية هذا البرنامج التعليمي ، ولكن إعادة تشغيل Apache بانتظام أثناء التثبيت والتكوين هي بالتأكيد عادة جيدة ، لذلك دعونا نفعل ذلك الآن:

sudo service apache24 restart

الخطوة 4: تثبيت PHP 7.1

يمكننا الآن تثبيت PHP 7.1 مع جميع وحدات PHP اللازمة التي يتطلبها Selfoss RSS Reader:

sudo pkg install php71 mod_php71 php71-gd php71-mbstring php71-mysqli php71-xml php71-curl php71-ctype php71-tokenizer php71-simplexml php71-dom php71-session php71-iconv php71-hash php71-json php71-fileinfo php71-pdo php71-pdo_mysql php71-zlib php71-openssl php71-zip php71-phar

FreeBSD 11 يمنحنا خيار استخدام تطوير php.iniأو إنتاج php.ini. نظرًا لأننا سنقوم بتثبيت Selfoss على خادم ويب عام ، فسنستخدم إصدار الإنتاج. أولاً ، النسخ الاحتياطي php.ini-production:

sudo cp /usr/local/etc/php.ini-production /usr/local/etc/php.ini-production.backup

ثم رابط ناعم php.ini-productionإلى php.ini:

sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini

نحتاج إلى تكوين Apache لاستخدام PHP بالفعل ، لذلك دعونا ننشئ ملفًا جديدًا يسمى php.confفي Includesدليل Apache :

sudo vi /usr/local/etc/apache24/Includes/php.conf

أدخل النص التالي في الملف الذي تم إنشاؤه حديثًا:

<IfModule dir_module>
    DirectoryIndex index.php index.html
    <FilesMatch "\.php$">
        SetHandler application/x-httpd-php
    </FilesMatch>
    <FilesMatch "\.phps$">
        SetHandler application/x-httpd-php-source
    </FilesMatch>
</IfModule>

حفظ وإنهاء الملف.

الآن دعونا نعيد تشغيل Apache حتى يتمكن من إعادة تحميل تغييرات التكوين:

sudo service apache24 restart

الخطوة 5: قم بتثبيت خادم MariaDB (MySQL)

يقوم FreeBSD 11 افتراضيًا باستخدام خادم قاعدة بيانات MariaDB ، وهو مصدر محسّن ومفتوح المصدر بالكامل ، تم تطويره من قبل المجتمع ، واستبدال بديل لخادم MySQL.

قم بتثبيت أحدث إصدار من خادم قاعدة بيانات MariaDB:

sudo pkg install mariadb102-server mariadb102-client

ابدأ وتمكين خادم MariaDB من التنفيذ تلقائيًا في وقت التمهيد:

sudo sysrc mysql_enable="yes"
sudo service mysql-server start

تأمين تثبيت خادم MariaDB الخاص بك:

sudo mysql_secure_installation

عندما يُطلب منك إنشاء rootمستخدم MariaDB / MySQL ، حدد "ص" (نعم) ثم أدخل rootكلمة مرور آمنة . ما عليك سوى الإجابة بـ "Y" على جميع الأسئلة الأخرى بنعم / لا لأن الاقتراحات الافتراضية هي الخيارات الأكثر أمانًا.

الخطوة 6: إنشاء قاعدة بيانات لـ Selfoss RSS Reader

قم بتسجيل الدخول إلى shell MariaDB rootكمستخدم MariaDB عن طريق تشغيل الأمر التالي:

sudo mysql -u root -p

للوصول إلى موجه أوامر MariaDB ، ما عليك سوى إدخال rootكلمة مرور MariaDB عند مطالبتك بذلك.

قم بتشغيل الاستعلامات التالية لإنشاء قاعدة بيانات ومستخدم قاعدة بيانات MariaDB لـ Selfoss RSS Reader:

CREATE DATABASE selfoss_db CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'selfoss_user'@'localhost' IDENTIFIED BY 'UltraSecurePassword';
GRANT ALL PRIVILEGES ON selfoss_db.* TO 'selfoss_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

يمكنك استبدال اسم قاعدة البيانات واسم selfoss_dbالمستخدم selfoss_userبشيء أكثر ترضيك ، إذا كنت تفضل ذلك. تأكد أيضًا من استبدال "UltraSecurePassword" بكلمة مرور آمنة بالفعل.

الخطوة 7: تثبيت ملفات Selfoss RSS Reader

تغيير دليل العمل الحالي إلى دليل الويب الافتراضي:

cd /usr/local/www/apache24/data

ودليل العمل الحالي الخاص بك سيكون الآن: /usr/local/www/apache24/data. يمكنك التحقق من ذلك باستخدام الأمر pwd(طباعة دليل العمل):

pwd

استخدم الآن wgetلتنزيل حزمة تثبيت Selfoss RSS Reader:

sudo wget --content-disposition https://github.com/SSilence/selfoss/archive/2.17.zip

يرجى ملاحظة ما يلي: يجب عليك بالتأكيد التحقق من أحدث إصدار من خلال زيارة صفحة تنزيل Selfoss RSS Reader .

قم بإدراج الدليل الحالي للتأكد من أنك قمت بتنزيل الملف بنجاح:

ls -la

إزالة index.html:

sudo rm index.html

الآن قم بفك ضغط الأرشيف المضغوط:

sudo unzip selfoss-2.17.zip

انقل جميع ملفات التثبيت إلى دليل جذر الويب:

sudo mv -v selfoss-2.17/* selfoss-2.17/.* /usr/local/www/apache24/data 2>/dev/null

قم بتغيير ملكية ملفات الويب لتجنب أي مشاكل في الأذونات:

sudo chown -R www:www * ./

أعد تشغيل Apache مرة أخرى:

sudo service apache24 restart

الخطوة 8: تثبيت وتشغيل الملحن

يتطلب منا Selfoss RSS Reader أن نستخدم composerلتنزيل بعض الإضافات ، لذا دعنا نثبت composer. لسوء الحظ ، فإن إصدار النسخة الثنائية المعدة مسبقًا من الملحن في مستودعات حزمة FreeBSD غير متوافق مع PHP 7.1. وذلك بدلا من تركيب composerمع pkgالأوامر، ونحن بدلا ترجمة عليه من المصدر.

أولاً ، لنقم بتكوين نظام FreeBSD 11 لتجميع برنامج PHP باستخدام الإصدار 7.1 من PHP بدلاً من 5.6 الافتراضي.

قم بإنشاء ملف جديد في /etc/الدليل يسمى make.conf:

sudo vi /etc/make.conf

أدخل النص التالي في الملف:

DEFAULT_VERSIONS+= php=7.1

الآن احفظ وأغلق الملف.

بعد ذلك ، نحتاج إلى تنزيل مجموعة منافذ FreeBSD باستخدام portsnapالأمر:

sudo portsnap fetch extract update

بمجرد portsnapاكتمال الأمر ، قم بالتغيير إلى php-composerدليل التعليمات البرمجية المصدر:

cd /usr/ports/devel/php-composer/

الآن ابدأ php-composerالتجميع والتثبيت باستخدام makeالأمر:

sudo make install clean BATCH=yes

عند اكتمال التجميع ، قم بالتغيير إلى دليل webroot:

cd /usr/local/www/apache24/data

قم بتشغيل الملحن باستخدام wwwالمستخدم:

sudo -u www composer install

سترى بعض الرسائل التحذيرية من composerعدم القدرة على الكتابة إلى ذاكرة التخزين المؤقت ، ولكن لا تقلق كثيرًا بشأن ذلك لأن كل شيء سيظل مثبتًا على ما يرام.

نحن الآن على استعداد للانتقال إلى الخطوة الأخيرة.

الخطوة 9: أكمل تثبيت Selfoss RSS Reader

1. نحتاج أولاً إلى تحديث ملف تكوين Selfoss RSS Reader config.iniبإعدادات قاعدة البيانات الصحيحة ، لذا تأكد من أنك لا تزال في دليل webroot وانسخ defaults.iniإلى config.ini:

   sudo cp -iv defaults.ini config.ini
   

2. بعد ذلك ، افتح config.iniملف التكوين وأضف قيم قاعدة البيانات التالية:

   [globals]
   db_type=mysql
   db_host=localhost
   db_database=selfoss_db
   db_username=selfoss_user
   db_password=UltraSecurePassword
   db_port=3306
   

3. نحتاج الآن إلى إضافة تجزئة كلمة المرور config.ini، ولكننا نحتاج أولاً إلى إنشائها ، لذا قم بزيارة عنوان URL التالي في متصفحك:

   http://YOUR_VULTR_IP_ADDRESS/password
   

   ثم أدخل كلمة المرور المطلوبة في Passwordالحقل وانقر فوق Generate.

   ما عليك سوى نسخ قيمة التجزئة الناتجة إلى خيار كلمة المرور في config.iniالملف بحيث يبدو قسم كلمة المرور الآن على النحو التالي:

   username=admin
   password=b729a37c34ff9648c33d67de3b289b58b7486dd71236343a6c2c275c2cc0477bd1d254eb92248bfa753169547d4bd2e81c2c9e460ba5bba822af1e87722dd12a
   salt=<long string of random chracters>
   

   ملاحظة: من الواضح أن تجزئة كلمة المرور ستكون مختلفة عن التجزئة الموضحة أعلاه ولديك مطلق الحرية في اختيار اسم مستخدم مختلف.

4. قم بإزالة كافة الخيارات الأخرى غير المعدلة من config.iniالملف بحيث يبدو ملف التكوين الكامل مشابهًا لما يلي:

   [globals]
   db_type=mysql
   db_host=localhost
   db_database=db1
   db_username=u1
   db_password=usecpass1
   db_port=3306
   username=admin
   password=b729a37c34ff9648c33d67de3b289b58b7486dd71236343a6c2c275c2cc0477bd1d254eb92248bfa753169547d4bd2e81c2c9e460ba5bba822af1e87722dd12a
   salt=<long string of random chracters>
   

   ملاحظة: إذا كنت ترغب في تغيير أي من defaults.iniالخيارات ، يمكنك ببساطة إضافتها إلى قائمة الخيارات أعلاه.

   عند الانتهاء من تحرير ملف التكوين ، يمكنك حفظ الملف والخروج منه.

5. يمكنك الآن تسجيل الدخول إلى Selfoss RSS Reader من خلال زيارة الصفحة الرئيسية وإدخال اسم المستخدم وكلمة المرور:

    http://YOUR_VULTR_IP_ADDRESS/
   

6. إذا كنت تريد أن يقوم القارئ بتحديث خلاصاتك تلقائيًا (ومن المؤكد أنك تفعل ذلك) ، فستحتاج إلى تعديل ملف crontab الخاص بك:

   sudo crontab -e
   

   أضف السطر التالي لتحديث خلاصاتك كل ساعة:

   0 * * * * www cd /usr/local/www/apache24/data && php cliupdate.php
   

إذا لم تقم بتكوين إعدادات Vultr DNS الخاصة بك حتى الآن ، فيمكنك القيام بذلك باستخدام لوحة تحكم Vultr DNS.

يُنصح أيضًا بتكوين موقعك لاستخدام طبقة المقابس الآمنة لأن معظم المتصفحات الحديثة ستقدم تحذيرات عندما لا يتم تمكين طبقة المقابس الآمنة في المواقع وتكون شهادات طبقة المقابس الآمنة متاحة الآن مجانًا.

على أي حال ، أنت حر الآن في البدء في إضافة خلاصاتك وتخصيص القارئ الخاص بك ، إذا كنت ترغب في ذلك.