Kako namestiti Selfoss RSS Reader na FreeBSD 11 FAMP VPS

Selfoss RSS Reader je brezplačen in odprtokoden, večnamenski spletno gostovalni, večnamenski pretok v živo, mešanica, bralnik novic (RSS/Atom) in univerzalni agregator. Selfoss RSS Reader vsebuje uvoz OPML, umirjen JSON API, njegov odprt sistem vtičnikov pa vam omogoča enostavno razširitev privzete funkcionalnosti s pisanjem lastnih podatkovnih povezovalnikov po meri. Selfoss lahko uporabite za pretakanje v živo in zbiranje vseh svojih objav, tvitov, podcastov in virov na enem osrednjem mestu, do katerega lahko preprosto dostopate s katerega koli namizja ali mobilne naprave.

V tej vadnici bomo namestili Selfoss RSS Reader 2.17 na FreeBSD 11 FAMP VPS z uporabo spletnega strežnika Apache, PHP 7.1 in baze podatkov MariaDB.

Predpogoji

• Čist primerek strežnika Vultr FreeBSD 11 z dostopom SSH

1. korak: Dodajte uporabnika Sudo

Začeli bomo z dodajanjem novega sudouporabnika.

Najprej se prijavite v svoj strežnik kot root:

ssh root@YOUR_VULTR_IP_ADDRESS

sudoUkaz je privzeto na primer na 11 strežnikov Vultr FreeBSD ni nameščen, zato bomo najprej namestiti sudo:

pkg install sudo

Zdaj dodajte novega uporabnika, imenovanega user1(ali vaše želeno uporabniško ime):

adduser user1

adduserUkaz boste morali vnesti veliko podrobnosti za uporabniški račun, tako da preprosto izberete privzete nastavitve za večino od njih, če je smiselno, da to storijo. Ko vas vpraša, ali želite Invite user1 into any other groups?, morate vnesti, wheelda dodate user1v wheelskupino.

Zdaj preverite /etc/sudoersdatoteko in se prepričajte, da je sudoersskupina omogočena:

visudo

Poiščite razdelek, kot je ta:

# %wheel        ALL=(ALL)       ALL

Ta vrstica nam pove, da lahko uporabniki, ki so člani wheelskupine, z sudoukazom pridobijo rootprivilegije. Privzeto bo komentiran, zato ga boste morali odstraniti iz komentarja in nato shraniti in zapustiti datoteko.

user1Članstvo v skupini lahko preverimo z groupsukazom:

groups user1

Če user1niste član wheelskupine, lahko uporabite ta ukaz za posodobitev user1članstva v skupini:

pw group mod wheel -m user1 

Zdaj uporabite suukaz za preklop na nov uporabniški user1račun sudo :

su - user1

Ukazni poziv se bo posodobil in nakazal, da ste zdaj prijavljeni v user1račun. To lahko preverite z whoamiukazom:

whoami

Zdaj znova zaženite sshdstoritev, da se boste lahko prijavili sshz novim nekorenskim uporabniškim računom sudo, ki ste ga pravkar ustvarili:

sudo /etc/rc.d/sshd restart

Zapustite user1račun:

exit

Zapustite rootračun (kar bo prekinilo vašo sshsejo):

exit

Zdaj lahko vstopite sshv primerek strežnika z vašega lokalnega gostitelja z novim nekorenskim uporabniškim user1računom sudo :

ssh user1@YOUR_VULTR_IP_ADDRESS

Če želite izvesti sudo, ne da bi vam bilo treba vsakič vnašati geslo, nato znova odprite /etc/sudoersdatoteko z uporabo visudo:

sudo visudo

Uredite razdelek za wheelskupino tako, da bo videti tako:

%wheel        ALL=(ALL)       NOPASSWD: ALL

Upoštevajte: onemogočanje zahteve po geslu za uporabnika sudo ni priporočena praksa, vendar je vključena tukaj, saj lahko naredi konfiguracijo strežnika veliko bolj priročno in manj frustrirajoče, zlasti med daljšimi sejami administracije sistema. Če ste zaskrbljeni zaradi varnostnih posledic, lahko spremembo konfiguracije vedno povrnete na izvirno, potem ko končate skrbniška opravila.

Kadar koli se želite prijaviti v rootuporabniški račun iz sudouporabniškega računa, lahko uporabite enega od naslednjih ukazov:

sudo -i
sudo su -

Račun lahko zapustite rootin se vrnete na svoj sudouporabniški račun kadar koli:

exit

2. korak: Posodobite sistem FreeBSD 11

Preden namestimo kakršne koli pakete na primerek strežnika FreeBSD, bomo najprej posodobili sistem.

Prepričajte se, da ste prijavljeni v strežnik z nekorenskim uporabnikom sudo in zaženite naslednje ukaze:

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

3. korak: Namestite spletni strežnik Apache

Namestite spletni strežnik Apache:

sudo pkg install apache24

Vnesite, yko ste pozvani.

Zdaj uporabite sysrcukaz, da omogočite samodejno izvajanje storitve Apache ob zagonu:

sudo sysrc apache24_enable=yes

sysrcUkaz posodobi /etc/rc.confdatoteko konfiguracijo, tako da, če želite ročno preveriti posodobitev konfiguracije si lahko preprosto odprite /etc/rc.confdatoteko z vašo najljubšo terminal urednik:

vi /etc/rc.conf

Zdaj zaženite storitev Apache:

sudo service apache24 start

Hitro lahko preverite, ali se apache izvaja, tako da v brskalniku obiščete naslov IP ali domeno primerka strežnika:

http://YOUR_VULTR_IP_ADDRESS/

Videli boste privzeto stran FreeBSD Apache, ki prikazuje besedilo:

It works!

Preverite privzeto konfiguracijsko datoteko Apache in se prepričajte, da DocumentRootdirektiva kaže na pravilen imenik:

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

Možnost DocumentRootkonfiguracije bo videti takole:

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

Zdaj moramo omogočiti mod_rewritemodul Apache. To lahko storimo tako, da poiščemo izraz v privzeti konfiguracijski datoteki Apache mod_rewrite.

Privzeto bo mod_rewritemodul Apache komentiran (kar pomeni, da je onemogočen). Konfiguracijska vrstica na čistem primerku Vultr FreeBSD 11 bo videti takole:

#LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Preprosto odstranite hash simbol, da razkomentirate vrstico in naložite modul. To seveda velja tudi za vse druge zahtevane module Apache:

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Prav tako moramo omogočiti module mod_authz_codein mod_headers, zato poskrbite, da sta tudi oba brez komentarja:

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

Zdaj moramo urediti Directorydirektivo Apache v isti konfiguracijski datoteki, tako da mod_rewritebo pravilno delovala s Selfoss RSS Reader.

Poiščite razdelek konfiguracijske datoteke, ki se začne z <Directory "/usr/local/www/apache24/data">in spremenite AllowOverride nonev AllowOverride All. Končni rezultat (z odstranjenimi vsemi komentarji) bo videti nekako takole:

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

Zdaj shranite in zaprite konfiguracijsko datoteko Apache.

Apache bomo znova zagnali na koncu te vadnice, vendar je redni vnovični zagon Apache med namestitvijo in konfiguracijo zagotovo dobra navada, zato naredimo to zdaj:

sudo service apache24 restart

4. korak: Namestite PHP 7.1

Zdaj lahko namestimo PHP 7.1 skupaj z vsemi potrebnimi PHP moduli, ki jih zahteva 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 nam daje možnost uporabe razvoja php.iniali produkcije php.ini. Ker bomo Selfoss namestili na javni spletni strežnik, bomo uporabili produkcijsko različico. Najprej varnostno kopirajte php.ini-production:

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

Nato mehka povezava php.ini-productiondo php.ini:

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

Apache moramo konfigurirati tako, da dejansko uporablja PHP, zato ustvarimo novo datoteko, imenovano php.confv imeniku Apache Includes:

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

V novo ustvarjeno datoteko vnesite naslednje besedilo:

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

Shranite in zaprite datoteko.

Zdaj pa znova zaženimo Apache, da lahko znova naloži spremembe konfiguracije:

sudo service apache24 restart

5. korak: Namestite strežnik MariaDB (MySQL).

FreeBSD 11 privzeto uporablja strežnik baz podatkov MariaDB, ki je izboljšan, popolnoma odprtokoden, razvit v skupnosti, nadomestek za strežnik MySQL.

Namestite najnovejšo različico strežnika baz podatkov MariaDB:

sudo pkg install mariadb102-server mariadb102-client

Zaženite in omogočite strežnik MariaDB, da se samodejno izvaja ob zagonu:

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

Zavarujte namestitev strežnika MariaDB:

sudo mysql_secure_installation

Ko ste pozvani, da ustvarite uporabnika MariaDB/MySQL root, izberite "Y" (za da) in nato vnesite varno rootgeslo. Preprosto odgovorite z "Y" na vsa druga vprašanja z da/ne, saj so privzeti predlogi najbolj varne možnosti.

6. korak: Ustvarite bazo podatkov za Selfoss RSS Reader

Prijavite se v lupino MariaDB kot rootuporabnik MariaDB tako, da zaženete naslednji ukaz:

sudo mysql -u root -p

Za dostop do ukaznega poziva MariaDB preprosto vnesite rootgeslo MariaDB, ko ste pozvani.

Zaženite naslednje poizvedbe za ustvarjanje baze podatkov MariaDB in uporabnika baze podatkov za 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;

Ime baze podatkov selfoss_dbin uporabniško ime lahko zamenjate selfoss_userz nečim, ki vam je bolj všeč, če želite. Prav tako poskrbite, da boste "UltraSecurePassword" zamenjali z dejansko varnim geslom.

7. korak: Namestite datoteke Selfoss RSS Reader

Spremenite svoj trenutni delovni imenik v privzeti spletni imenik:

cd /usr/local/www/apache24/data

Vaš trenutni delovni imenik bo zdaj: /usr/local/www/apache24/data. To lahko preverite z pwdukazom (natisni delovni imenik):

pwd

Zdaj uporabite wgetza prenos namestitvenega paketa Selfoss RSS Reader:

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

Opomba: Vsekakor morate preveriti najnovejšo različico tako, da obiščete stran za prenos Selfoss RSS Reader .

Navedite trenutni imenik, da preverite, ali ste datoteko uspešno prenesli:

ls -la

Odstrani index.html:

sudo rm index.html

Zdaj razpakirajte zip arhiv:

sudo unzip selfoss-2.17.zip

Premaknite vse namestitvene datoteke v spletni korenski imenik:

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

Spremenite lastništvo spletnih datotek, da se izognete težavam z dovoljenji:

sudo chown -R www:www * ./

Znova zaženite Apache:

sudo service apache24 restart

8. korak: Namestite in zaženite Composer

Selfoss RSS Reader zahteva, da uporabimo composerza prenos nekaterih vtičnikov, zato namestimo composer. Na žalost različica vnaprej vgrajene binarne različice composer v repozitorijih paketov FreeBSD ni združljiva s PHP 7.1. Torej, namesto da bi ga namestili composerz pkgukazom, ga bomo prevedli iz vira.

Najprej konfigurirajmo sistem FreeBSD 11 za prevajanje programske opreme PHP z uporabo PHP različice 7.1 namesto privzete 5.6.

Ustvarite novo datoteko v /etc/imeniku z imenom make.conf:

sudo vi /etc/make.conf

V datoteko vnesite naslednje besedilo:

DEFAULT_VERSIONS+= php=7.1

Zdaj shranite in zaprite datoteko.

Nato moramo prenesti zbirko vrat FreeBSD z portsnapukazom:

sudo portsnap fetch extract update

Ko je portsnapukaz končan, preklopite v php-composerimenik izvorne kode:

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

Zdaj začnite php-composerprevajanje in namestitev z makeukazom:

sudo make install clean BATCH=yes

Ko je kompilacija končana, preklopite v imenik webroot:

cd /usr/local/www/apache24/data

Zaženite composer z uporabo wwwuporabnika:

sudo -u www composer install

Videli boste nekaj opozorilnih sporočil composero tem, da ne morete pisati v predpomnilnik, vendar naj vas to ne skrbi preveč, saj se bo vse še vedno v redu namestilo.

Zdaj smo pripravljeni na zadnji korak.

9. korak: Dokončajte namestitev bralnika Selfoss RSS

1. Najprej moramo posodobiti konfiguracijsko datoteko Selfoss RSS Reader config.inis pravilnimi nastavitvami baze podatkov, zato se prepričajte, da ste še vedno v imeniku webroot in kopirajte defaults.inina config.ini:

   sudo cp -iv defaults.ini config.ini
   

2. Nato odprite config.inikonfiguracijsko datoteko in dodajte naslednje vrednosti baze podatkov:

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

3. Zdaj moramo dodati hash gesla v config.ini, vendar ga moramo najprej ustvariti, zato v brskalniku obiščite naslednji URL:

   http://YOUR_VULTR_IP_ADDRESS/password
   

   Nato v polje vnesite želeno geslo Passwordin kliknite na Generate.

   Preprosto kopirajte nastalo zgoščeno vrednost v možnost gesla v config.inidatoteki, tako da bo razdelek z geslom zdaj videti nekako takole:

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

   Opomba: vaše zgoščevanje gesla se bo očitno razlikovalo od zgoščenega gesla, prikazanega zgoraj, in lahko izberete drugo uporabniško ime.

4. Odstranite vse druge neurejene možnosti iz config.inidatoteke, tako da bo vaša celotna konfiguracijska datoteka videti podobna tej:

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

   Opomba: Če želite spremeniti katero od defaults.inimožnosti, jo lahko preprosto dodate na zgornji seznam možnosti.

   Ko končate z urejanjem konfiguracijske datoteke, jo lahko shranite in zaprete.

5. Sedaj se lahko prijavite v Selfoss RSS Reader tako, da obiščete domačo stran in vnesete svoje uporabniško ime in geslo:

    http://YOUR_VULTR_IP_ADDRESS/
   

6. Če želite, da bralnik samodejno posodablja vaše vire (in skoraj zagotovo to storite), boste morali urediti svoj crontab:

   sudo crontab -e
   

   Dodajte naslednjo vrstico, da vsako uro osvežite svoje vire:

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

Če še niste konfigurirali nastavitev Vultr DNS, lahko to storite z nadzorno ploščo Vultr DNS.

Priporočljivo je tudi, da svoje spletno mesto konfigurirate za uporabo SSL, saj bo večina sodobnih brskalnikov opozorila, če spletna mesta nimajo omogočenega SSL in so potrdila SSL zdaj na voljo brezplačno.

V vsakem primeru lahko zdaj začnete dodajati svoje vire in nadalje prilagajati bralnik, če želite.