Jak zainstalować czytnik RSS Selfoss na FreeBSD 11 FAMP VPS

• Wymagania wstępne
• Krok 1: Dodaj użytkownika Sudo
• Krok 2: Zaktualizuj system FreeBSD 11
• Krok 3: Zainstaluj serwer WWW Apache
• Krok 4: Zainstaluj PHP 7.1
• Krok 5: Zainstaluj serwer MariaDB (MySQL)
• Krok 6: Utwórz bazę danych dla czytnika RSS Selfoss
• Krok 7: Zainstaluj pliki czytnika RSS Selfoss
• Krok 8: Zainstaluj i uruchom Composer
• Krok 9: Zakończ instalację czytnika RSS Selfoss

Selfoss RSS Reader to darmowy i oparty na otwartych źródłach, wielozadaniowy internetowy serwer wielozadaniowy, streaming na żywo, mashup, czytnik kanałów informacyjnych (RSS / Atom) i uniwersalny agregator. Selfoss RSS Reader oferuje import OPML, spokojny interfejs API JSON, a jego otwarty system wtyczek pozwala łatwo rozszerzyć domyślną funkcjonalność, pisząc własne niestandardowe złącza danych. Za pomocą Selfoss możesz transmitować na żywo i zbierać wszystkie swoje posty, tweety, podcasty i kanały w jednym centralnym miejscu, do którego masz łatwy dostęp z dowolnego komputera lub urządzenia mobilnego.

W tym samouczku zamierzamy zainstalować Selfoss RSS Reader 2.17 na FreeBSD 11 FAMP VPS przy użyciu serwera WWW Apache, PHP 7.1 i bazy danych MariaDB.

Wymagania wstępne

• Czysta instancja serwera Vultr FreeBSD 11 z dostępem SSH

Krok 1: Dodaj użytkownika Sudo

Zaczniemy od dodania nowego sudoużytkownika.

Najpierw zaloguj się do swojego serwera jako root:

ssh root@YOUR_VULTR_IP_ADDRESS

sudoPolecenie nie jest instalowany domyślnie w Vultr FreeBSD przykład 11 serwerów, więc będziemy najpierw zainstalować sudo:

pkg install sudo

Teraz dodaj nowego użytkownika o nazwie user1(lub preferowaną nazwę użytkownika):

adduser user1

adduserPolecenie poprosi o wiele szczegółów dotyczących konta użytkownika, więc po prostu wybrać domyślne dla większości z nich, gdy ma to sens, aby to zrobić. Kiedy pojawi się pytanie, czy chcesz Invite user1 into any other groups?, powinieneś wejść, wheelaby dodać user1do wheelgrupy.

Teraz sprawdź /etc/sudoersplik, aby upewnić się, że sudoersgrupa jest włączona:

visudo

Poszukaj takiej sekcji:

# %wheel        ALL=(ALL)       ALL

Ta linia mówi nam, że użytkownicy będący członkami wheelgrupy mogą użyć sudopolecenia, aby uzyskać rootuprawnienia. Zostanie domyślnie skomentowany, więc będziesz musiał cofnąć komentarz, a następnie zapisać i zamknąć plik.

Możemy zweryfikować user1członkostwo w grupie za pomocą groupspolecenia:

groups user1

Jeśli user1nie należy do wheelgrupy, możesz użyć tego polecenia, aby zaktualizować user1członkostwo w grupie:

pw group mod wheel -m user1 

Teraz użyj supolecenia, aby przełączyć się na nowe user1konto użytkownika sudo :

su - user1

Wiersz polecenia zostanie zaktualizowany, aby wskazać, że jesteś teraz zalogowany na user1konto. Możesz to sprawdzić za pomocą whoamipolecenia:

whoami

Teraz uruchom ponownie sshdusługę, aby móc się zalogować za sshpomocą nowego konta użytkownika sudo, które nie jest rootem:

sudo /etc/rc.d/sshd restart

Wyjdź z user1konta:

exit

Wyjdź z rootkonta (które rozłączy sshsesję):

exit

Możesz teraz sshwejść do instancji serwera z lokalnego hosta, korzystając z nowego user1konta użytkownika sudo innego niż root :

ssh user1@YOUR_VULTR_IP_ADDRESS

Jeśli chcesz uruchomić sudo bez konieczności wpisywania hasła za każdym razem, otwórz /etc/sudoersplik ponownie, używając visudo:

sudo visudo

Edytuj sekcję dla wheelgrupy, aby wyglądała następująco:

%wheel        ALL=(ALL)       NOPASSWD: ALL

Uwaga: Wyłączenie wymagania hasła dla użytkownika sudo nie jest zalecaną praktyką, ale zostało ono tutaj uwzględnione, ponieważ może znacznie ułatwić konfigurację serwera i zmniejszyć frustrację, szczególnie podczas dłuższych sesji administracji systemem. Jeśli obawiasz się wpływu na bezpieczeństwo, zawsze możesz przywrócić pierwotną zmianę konfiguracji po zakończeniu zadań administracyjnych.

Ilekroć chcesz zalogować się na rootkonto użytkownika z poziomu sudokonta użytkownika, możesz użyć jednego z następujących poleceń:

sudo -i
sudo su -

Możesz wyjść z rootkonta i wrócić do swojego sudokonta użytkownika w dowolnym momencie:

exit

Krok 2: Zaktualizuj system FreeBSD 11

Przed zainstalowaniem jakichkolwiek pakietów na instancji serwera FreeBSD najpierw zaktualizujemy system.

Upewnij się, że jesteś zalogowany na serwerze za pomocą użytkownika sudo innego niż root i uruchom następujące polecenia:

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

Krok 3: Zainstaluj serwer WWW Apache

Zainstaluj serwer WWW Apache:

sudo pkg install apache24

Wprowadź ypo wyświetleniu monitu.

Teraz użyj sysrcpolecenia, aby usługa Apache mogła się uruchamiać automatycznie podczas uruchamiania:

sudo sysrc apache24_enable=yes

sysrcKomenda aktualizuje /etc/rc.confplik konfiguracyjny, więc jeśli chcesz ręcznie sprawdzić aktualizację konfiguracji można po prostu otworzyć /etc/rc.confplik w edytorze terminala:

vi /etc/rc.conf

Teraz uruchom usługę Apache:

sudo service apache24 start

Możesz szybko sprawdzić, czy apache działa, odwiedzając adres IP lub domenę instancji serwera w przeglądarce:

http://YOUR_VULTR_IP_ADDRESS/

Zobaczysz domyślną stronę Apache FreeBSD wyświetlającą tekst:

It works!

Sprawdź domyślny plik konfiguracyjny Apache, aby upewnić się, że DocumentRootdyrektywa wskazuje właściwy katalog:

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

Opcja DocumentRootkonfiguracji będzie wyglądać następująco:

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

Teraz musimy włączyć mod_rewritemoduł Apache. Możemy to zrobić, wyszukując termin w domyślnym pliku konfiguracyjnym Apache mod_rewrite.

Domyślnie mod_rewritemoduł Apache zostanie skomentowany (co oznacza, że ​​jest wyłączony). Linia konfiguracji na czystej instancji Vultr FreeBSD 11 będzie wyglądać następująco:

#LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Wystarczy usunąć symbol skrótu, aby odkomentować linię i załadować moduł. Dotyczy to oczywiście również wszystkich innych wymaganych modułów Apache:

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Musimy także włączyć moduły mod_authz_codei mod_headers, więc upewnij się, że oba nie są również komentowane:

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

Teraz musimy edytować Directorydyrektywę Apache w tym samym pliku konfiguracyjnym, aby mod_rewritedziałał poprawnie z czytnikiem RSS Selfoss.

Znajdź sekcję pliku konfiguracyjnego, która zaczyna się od, <Directory "/usr/local/www/apache24/data">i zmień AllowOverride nonena AllowOverride All. Wynik końcowy (z usuniętymi wszystkimi komentarzami) będzie wyglądał mniej więcej tak:

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

Teraz zapisz i zamknij plik konfiguracyjny Apache.

Zrestartujemy Apache pod koniec tego samouczka, ale regularne restartowanie Apache podczas instalacji i konfiguracji jest z pewnością dobrym nawykiem, więc zróbmy to teraz:

sudo service apache24 restart

Krok 4: Zainstaluj PHP 7.1

Możemy teraz zainstalować PHP 7.1 wraz ze wszystkimi niezbędnymi modułami PHP wymaganymi przez 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 daje nam możliwość wykorzystania rozwoju php.inilub produkcji php.ini. Ponieważ zamierzamy zainstalować Selfoss na publicznym serwerze internetowym, użyjemy wersji produkcyjnej. Najpierw wykonaj kopię zapasową php.ini-production:

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

Następnie miękkie łącze php.ini-productiondo php.ini:

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

Musimy skonfigurować Apache, aby faktycznie używał PHP, więc stwórzmy nowy plik o nazwie php.confw Includeskatalogu Apache :

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

Wprowadź następujący tekst do nowo utworzonego pliku:

<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>

Zapisz i zamknij plik.

Teraz zrestartujmy Apache, aby mógł ponownie załadować zmiany konfiguracji:

sudo service apache24 restart

Krok 5: Zainstaluj serwer MariaDB (MySQL)

FreeBSD 11 domyślnie korzysta z serwera bazy danych MariaDB, który jest ulepszonym, w pełni otwartym, opracowanym przez społeczność, zastępczym zamiennikiem dla serwera MySQL.

Zainstaluj najnowszą wersję serwera bazy danych MariaDB:

sudo pkg install mariadb102-server mariadb102-client

Uruchom i włącz serwer MariaDB, aby uruchamiał się automatycznie podczas uruchamiania:

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

Zabezpiecz instalację serwera MariaDB:

sudo mysql_secure_installation

Po wyświetleniu monitu o utworzenie użytkownika MariaDB / MySQL rootwybierz „Y” (na tak), a następnie wprowadź bezpieczne roothasło. Po prostu odpowiedz „T” na wszystkie pozostałe pytania tak / nie, ponieważ domyślne sugestie są najbezpieczniejszymi opcjami.

Krok 6: Utwórz bazę danych dla czytnika RSS Selfoss

Zaloguj się do powłoki MariaDB jako rootużytkownik MariaDB , uruchamiając następującą komendę:

sudo mysql -u root -p

Aby uzyskać dostęp do wiersza polecenia MariaDB, po prostu wprowadź roothasło MariaDB po wyświetleniu monitu.

Uruchom następujące zapytania, aby utworzyć bazę danych MariaDB i użytkownika bazy danych dla czytnika RSS Selfoss:

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;

Jeśli wolisz, możesz zamienić nazwę bazy danych selfoss_dbi nazwę użytkownika na selfoss_usercoś bardziej według własnych upodobań. Upewnij się również, że zastąpiłeś „UltraSecurePassword” faktycznie bezpiecznym hasłem.

Krok 7: Zainstaluj pliki czytnika RSS Selfoss

Zmień bieżący katalog roboczy na domyślny katalog internetowy:

cd /usr/local/www/apache24/data

Twój bieżący katalog roboczy będzie teraz: /usr/local/www/apache24/data. Możesz to sprawdzić za pomocą polecenia pwd(wydrukuj katalog roboczy):

pwd

Teraz użyj, wgetaby pobrać pakiet instalacyjny czytnika RSS Selfoss:

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

Uwaga: zdecydowanie powinieneś sprawdzić najnowszą wersję, odwiedzając stronę pobierania Selfoss RSS Reader .

Wyświetl bieżący katalog, aby sprawdzić, czy plik został pomyślnie pobrany:

ls -la

Usuń index.html:

sudo rm index.html

Teraz rozpakuj archiwum zip:

sudo unzip selfoss-2.17.zip

Przenieś wszystkie pliki instalacyjne do głównego katalogu internetowego:

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

Zmień własność plików internetowych, aby uniknąć problemów z uprawnieniami:

sudo chown -R www:www * ./

Uruchom ponownie Apache ponownie:

sudo service apache24 restart

Krok 8: Zainstaluj i uruchom Composer

Selfoss RSS Reader wymaga od nas composerpobrania niektórych wtyczek, więc zainstalujmy composer. Niestety, wersja gotowej binarnej wersji kompozytora w repozytoriach pakietów FreeBSD nie jest kompatybilna z PHP 7.1. Zamiast instalować composerza pomocą pkgpolecenia, zamiast tego skompilujemy go ze źródła.

Najpierw skonfigurujmy system FreeBSD 11 do kompilowania oprogramowania PHP przy użyciu PHP w wersji 7.1 zamiast domyślnej 5.6.

Utwórz nowy plik w /etc/katalogu o nazwie make.conf:

sudo vi /etc/make.conf

Wprowadź następujący tekst do pliku:

DEFAULT_VERSIONS+= php=7.1

Teraz zapisz i zamknij plik.

Następnie musimy pobrać kolekcję portów FreeBSD za pomocą portsnappolecenia:

sudo portsnap fetch extract update

Po zakończeniu portsnappolecenia przejdź do php-composerkatalogu kodu źródłowego:

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

Teraz rozpocznij php-composerkompilację i instalację za pomocą makepolecenia:

sudo make install clean BATCH=yes

Po zakończeniu kompilacji przejdź do katalogu webroot:

cd /usr/local/www/apache24/data

Uruchom kompozytora za pomocą wwwużytkownika:

sudo -u www composer install

Zobaczysz kilka komunikatów ostrzegawczych composerprzed niemożnością zapisu do pamięci podręcznej, ale nie przejmuj się tym zbytnio, ponieważ wszystko nadal będzie działać poprawnie.

Jesteśmy teraz gotowi do przejścia do ostatniego kroku.

Krok 9: Zakończ instalację czytnika RSS Selfoss

1. Najpierw musimy zaktualizować plik konfiguracyjny czytnika RSS Selfoss config.iniz poprawnymi ustawieniami bazy danych, więc upewnij się, że nadal jesteś w katalogu głównym i skopiuj defaults.inido config.ini:

   sudo cp -iv defaults.ini config.ini
   

2. Następnie otwórz config.iniplik konfiguracyjny i dodaj następujące wartości bazy danych:

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

3. Musimy teraz dodać skrót do hasła config.ini, ale najpierw musimy go wygenerować, więc odwiedź następujący adres URL w przeglądarce:

   http://YOUR_VULTR_IP_ADDRESS/password
   

   Następnie wprowadź żądane hasło w Passwordpolu i kliknij Generate.

   Po prostu skopiuj wynikową wartość skrótu do opcji hasła w config.inipliku, aby sekcja hasła wyglądała teraz mniej więcej tak:

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

   Uwaga: skrót hash będzie oczywiście różny od skrótu pokazanego powyżej i możesz wybrać inną nazwę użytkownika.

4. Usuń wszystkie inne nieedytowane opcje z config.inipliku, aby pełny plik konfiguracyjny wyglądał podobnie do tego:

   [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>
   

   Uwaga: jeśli chcesz zmienić dowolną z defaults.iniopcji, możesz po prostu dodać je do powyższej listy opcji.

   Po zakończeniu edycji pliku konfiguracyjnego możesz go zapisać i zamknąć.

5. Możesz teraz zalogować się do czytnika RSS Selfoss, odwiedzając stronę główną i wprowadzając swoją nazwę użytkownika i hasło:

    http://YOUR_VULTR_IP_ADDRESS/
   

6. Jeśli chcesz, aby czytnik automatycznie aktualizował twoje kanały (i prawie na pewno tak robisz), będziesz musiał edytować crontab:

   sudo crontab -e
   

   Dodaj następujący wiersz, aby odświeżać kanały co godzinę:

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

Jeśli nie skonfigurowałeś jeszcze ustawień Vultr DNS, możesz to zrobić za pomocą panelu sterowania Vultr DNS.

Wskazane jest również skonfigurowanie witryny do korzystania z protokołu SSL, ponieważ większość nowoczesnych przeglądarek będzie wyświetlać ostrzeżenia, gdy witryny nie mają włączonego protokołu SSL, a certyfikaty SSL są teraz dostępne za darmo.

W każdym razie możesz teraz dodawać kanały i dostosowywać czytnik, jeśli chcesz.