Hvernig á að setja upp Selfoss RSS Reader á FreeBSD 11 FAMP VPS

Selfoss RSS Reader er ókeypis og opinn uppspretta sjálf-hýstur, fjölnota, lifandi streymi, mashup, fréttastraum (RSS/Atom) lesandi og alhliða safnriti. Selfoss RSS Reader býður upp á OPML innflutning, rólegt JSON API og opið viðbætur kerfi hans gerir þér kleift að auka sjálfgefna virkni auðveldlega með því að skrifa þín eigin sérsniðnu gagnatengi. Þú getur notað Selfoss til að streyma í beinni og safna öllum færslum þínum, tístum, hlaðvörpum og straumum á einn miðlægan stað sem þú getur auðveldlega nálgast frá hvaða tölvu eða farsímum sem er.

Í þessari kennslu ætlum við að setja upp Selfoss RSS Reader 2.17 á FreeBSD 11 FAMP VPS með Apache vefþjóni, PHP 7.1 og MariaDB gagnagrunni.

Forkröfur

• Hreint Vultr FreeBSD 11 netþjónstilvik með SSH aðgangi

Skref 1: Bættu við Sudo notanda

Við byrjum á því að bæta við nýjum sudonotanda.

Fyrst skaltu skrá þig inn á netþjóninn þinn sem root:

ssh root@YOUR_VULTR_IP_ADDRESS

The sudostjórn er ekki sett sjálfgefið í Vultr FreeBSD 11 miðlara dæmis, þannig að við munum fyrst að setja upp sudo:

pkg install sudo

Bættu nú við nýjum notanda sem heitir user1(eða valinn notandanafn):

adduser user1

The adduserstjórn mun hvetja þig til fullt af upplýsingum um notanda, þannig að einfaldlega velja sjálfgefnar stillingar fyrir flest af þeim þegar það er vit í að gera það. Þegar þú ert spurður hvort Invite user1 into any other groups?þú eigir ættirðu að slá inn wheeltil að bæta user1við wheelhópinn.

Athugaðu nú /etc/sudoersskrána til að ganga úr skugga um að sudoershópurinn sé virkur:

visudo

Leitaðu að hluta eins og þessum:

# %wheel        ALL=(ALL)       ALL

Þessi lína segir okkur að notendur sem eru meðlimir wheelhópsins geta notað sudoskipunina til að öðlast rootforréttindi. Það verður sjálfgefið skrifað út ummæli svo þú þarft að afskrifa það og vista og hætta skránni.

Við getum staðfest user1hópaðildina með groupsskipuninni:

groups user1

Ef þú user1ert ekki meðlimur wheelhópsins geturðu notað þessa skipun til að uppfæra user1hópaðildina:

pw group mod wheel -m user1 

Notaðu nú suskipunina til að skipta yfir í nýja sudo notendareikninginn user1:

su - user1

Skipunarlínan mun uppfæra til að gefa til kynna að þú sért nú skráður inn á user1reikninginn. Þú getur staðfest þetta með whoamiskipuninni:

whoami

Endurræstu nú sshdþjónustuna svo þú getir skráð þig inn sshmeð nýja notandareikningnum sem ekki er rótarnotandi sem þú varst að búa til:

sudo /etc/rc.d/sshd restart

Lokaðu user1reikningnum:

exit

Lokaðu rootreikningnum (sem mun aftengja sshlotuna þína):

exit

Þú getur nú farið sshinn á netþjónstilvikið frá staðbundnum gestgjafa þínum með því að nota nýja sudo notandareikninginn sem ekki er rót user1:

ssh user1@YOUR_VULTR_IP_ADDRESS

Ef þú vilt keyra sudo án þess að þurfa að slá inn lykilorð í hvert skipti, opnaðu þá /etc/sudoersskrána aftur með því að nota visudo:

sudo visudo

Breyttu hlutanum fyrir wheelhópinn þannig að hann líti svona út:

%wheel        ALL=(ALL)       NOPASSWD: ALL

Vinsamlega athugið: Það er ekki mælt með því að slökkva á lykilorðskröfunni fyrir sudo notandann, en það er innifalið hér þar sem það getur gert uppsetningu netþjónsins miklu þægilegri og minna pirrandi, sérstaklega í lengri kerfisstjórnunartímum. Ef þú hefur áhyggjur af öryggisáhrifunum geturðu alltaf snúið stillingarbreytingunni aftur í upprunalegt horf eftir að þú hefur lokið stjórnunarverkefnum þínum.

Alltaf þegar þú vilt skrá þig inn á rootnotandareikninginn innan úr sudonotandareikningnum geturðu notað eina af eftirfarandi skipunum:

sudo -i
sudo su -

Þú getur lokað rootreikningnum og farið aftur á sudonotandareikninginn þinn hvenær sem er:

exit

Skref 2: Uppfærðu FreeBSD 11 kerfið

Áður en pakka er sett upp á FreeBSD netþjónstilvikinu munum við fyrst uppfæra kerfið.

Gakktu úr skugga um að þú sért skráður inn á netþjóninn með því að nota sudo notanda sem ekki er rót og keyrðu eftirfarandi skipanir:

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

Skref 3: Settu upp Apache vefþjón

Settu upp Apache vefþjóninn:

sudo pkg install apache24

Sláðu inn yþegar beðið er um það.

Notaðu nú sysrcskipunina til að gera Apache þjónustuna kleift að keyra sjálfkrafa við ræsingu:

sudo sysrc apache24_enable=yes

Í sysrcstjórn uppfærir /etc/rc.confstillingaskránni, þannig að ef þú vilt sannreyna stillingar uppfærslu handvirkt getur þú einfaldlega að opna /etc/rc.confskrána með uppáhalds flugstöðinni ritstjóri:

vi /etc/rc.conf

Ræstu nú Apache þjónustuna:

sudo service apache24 start

Þú getur fljótt athugað hvort apache sé í gangi með því að fara á IP tölu eða lén þjónsins í vafranum þínum:

http://YOUR_VULTR_IP_ADDRESS/

Þú munt sjá sjálfgefna FreeBSD Apache síðuna sem sýnir textann:

It works!

Athugaðu Apache sjálfgefna stillingarskrána þína til að tryggja að DocumentRoottilskipunin bendi í rétta möppu:

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

The DocumentRootstillingar möguleiki mun líta svona út:

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

Við þurfum nú að virkja mod_rewriteApache eininguna. Við getum gert þetta með því að leita í sjálfgefna Apache stillingarskránni fyrir hugtakið mod_rewrite.

Sjálfgefið er að mod_rewriteApache einingin verði skrifuð út (sem þýðir að hún er óvirk). Stillingarlínan á hreinu Vultr FreeBSD 11 tilviki mun líta svona út:

#LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Fjarlægðu einfaldlega kjötkássamerkið til að afskrifa línuna og hlaða einingunni. Þetta á auðvitað líka við um allar aðrar nauðsynlegar Apache einingar:

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Við þurfum líka að gera þær mod_authz_codeog mod_headersmát, svo vertu viss um að þeir eru báðir uncommented líka:

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

We now need to edit the Directory Apache directive in the same configuration file so that mod_rewrite will work correctly with Selfoss RSS Reader.

Find the section of the configuration file that starts with <Directory "/usr/local/www/apache24/data"> and change AllowOverride none to AllowOverride All. The end result (with all comments removed) will look something like this:

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

Now save and exit the Apache configuration file.

We will restart Apache at the end of this tutorial, but restarting Apache regularly during installation and configuration is certainly a good habit, so let's do it now:

sudo service apache24 restart

Step 4: Install PHP 7.1

We can now install PHP 7.1 along with all of the necessary PHP modules required by 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 gives us the option to use a development php.ini or a production php.ini. Since we are going to install Selfoss on a public web server, we'll use the production version. First, back up php.ini-production:

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

Then soft-link php.ini-production to php.ini:

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

We need to configure Apache to actually use PHP, so let's create a new file called php.conf in the Apache Includes directory:

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

Enter the following text into the newly created file:

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

Save and exit the file.

Now let's restart Apache so that it can reload the configuration changes:

sudo service apache24 restart

Step 5: Install MariaDB (MySQL) Server

FreeBSD 11 defaults to using MariaDB database server, which is an enhanced, fully open source, community developed, drop-in replacement for MySQL server.

Install the latest version of MariaDB database server:

sudo pkg install mariadb102-server mariadb102-client

Start and enable MariaDB server to execute automatically at boot time:

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

Secure your MariaDB server installation:

sudo mysql_secure_installation

When prompted to create a MariaDB/MySQL root user, select "Y" (for yes) and then enter a secure root password. Simply answer "Y" to all of the other yes/no questions as the default suggestions are the most secure options.

Step 6: Create Database for Selfoss RSS Reader

Log into the MariaDB shell as the MariaDB root user by running the following command:

sudo mysql -u root -p

To access the MariaDB command prompt, simply enter the MariaDB root password when prompted.

Run the following queries to create a MariaDB database and database user for 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;

You can replace the database name selfoss_db and username selfoss_user with something more to your liking, if you prefer. Also, make sure that you replace "UltraSecurePassword" with an actually secure password.

Step 7: Install Selfoss RSS Reader Files

Change your current working directory to the default web directory:

cd /usr/local/www/apache24/data

Your current working directory will now be: /usr/local/www/apache24/data. You can check this with the pwd (print working directory) command:

pwd

Now use wget to download the Selfoss RSS Reader installation package:

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

Please note: You should definitely check for the most recent version by visiting the Selfoss RSS Reader download page.

List the current directory to check that you have successfully downloaded the file:

ls -la

Remove index.html:

sudo rm index.html

Taktu nú niður zip skjalasafnið:

sudo unzip selfoss-2.17.zip

Færðu allar uppsetningarskrárnar í rótarskrána á vefnum:

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

Breyttu eignarhaldi á vefskrám til að forðast vandamál með heimildir:

sudo chown -R www:www * ./

Endurræstu Apache aftur:

sudo service apache24 restart

Skref 8: Settu upp og keyrðu Composer

Selfoss RSS Reader krefst þess að við notum composertil að hlaða niður nokkrum viðbótum svo við skulum setja upp composer. Því miður er útgáfan af forbyggðu tvíundarútgáfunni af tónskáldi í FreeBSD pakkageymslunum ekki samhæfð við PHP 7.1. Svo í stað þess að setja upp composermeð pkgskipuninni munum við í staðinn setja hana saman frá uppruna.

Fyrst skulum við stilla FreeBSD 11 kerfið til að setja saman PHP hugbúnað með því að nota PHP útgáfu 7.1 í stað sjálfgefna 5.6.

Búðu til nýja skrá í /etc/möppunni sem heitir make.conf:

sudo vi /etc/make.conf

Sláðu inn eftirfarandi texta í skrána:

DEFAULT_VERSIONS+= php=7.1

Vistaðu nú og lokaðu skránni.

Næst þurfum við að hlaða niður FreeBSD tengisafninu með því að nota portsnapskipunina:

sudo portsnap fetch extract update

Þegar portsnapskipuninni er lokið skaltu breyta í php-composerfrumkóðaskrána:

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

Byrjaðu nú php-composersamantektina og uppsetninguna með því að nota makeskipunina:

sudo make install clean BATCH=yes

Þegar samantektinni er lokið skaltu breyta í vefrótarskrána:

cd /usr/local/www/apache24/data

Keyra tónskáld með því að nota wwwnotandann:

sudo -u www composer install

Þú munt sjá nokkur viðvörunarskilaboð frá því composerað þú getir ekki skrifað í skyndiminni, en ekki hafa miklar áhyggjur af því þar sem allt mun samt setja upp í lagi.

Við erum nú tilbúin að fara á síðasta skrefið.

Skref 9: Ljúktu við uppsetningu Selfoss RSS Reader

1. Við þurfum fyrst að uppfæra Selfoss RSS Reader stillingarskrána config.inimeð réttum gagnagrunnsstillingum svo vertu viss um að þú sért enn í vefrótarskránni og afritaðu defaults.initil config.ini:

   sudo cp -iv defaults.ini config.ini
   

2. Næst skaltu opna config.inistillingarskrána og bæta við eftirfarandi gagnagrunnsgildum:

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

3. Við þurfum nú að bæta lykilorðahash við config.ini, en fyrst þurfum við að búa það til, svo farðu á eftirfarandi vefslóð í vafranum þínum:

   http://YOUR_VULTR_IP_ADDRESS/password
   

   Sláðu síðan inn lykilorðið sem þú vilt í Passwordreitinn og smelltu á Generate.

   Afritaðu einfaldlega kjötkássagildið sem myndast í lykilorðsvalkostinn í config.iniskránni svo lykilorðshlutinn lítur nú eitthvað svona út:

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

   Athugið: Hash lykilorðsins þíns mun augljóslega vera öðruvísi en kjötkássa sem sýnd er hér að ofan og þér er frjálst að velja annað notendanafn.

4. Fjarlægðu alla hina óbreyttu valkostina úr config.iniskránni svo heildar stillingarskráin þín líti svipað út:

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

   Athugið: Ef þú vilt breyta einhverjum af defaults.inivalkostunum geturðu einfaldlega bætt þeim við listann yfir valmöguleikana hér að ofan.

   Þegar þú hefur lokið við að breyta stillingarskránni geturðu vistað hana og hætt henni.

5. Þú getur nú skráð þig inn á Selfoss RSS Reader með því að fara á heimasíðuna og slá inn notandanafn og lykilorð:

    http://YOUR_VULTR_IP_ADDRESS/
   

6. Ef þú vilt að lesandinn uppfæri straumana þína sjálfkrafa (og þú gerir það næstum örugglega), þá þarftu að breyta crontab þinni:

   sudo crontab -e
   

   Bættu við eftirfarandi línu til að endurnýja strauma þína á klukkutíma fresti:

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

Ef þú hefur ekki enn stillt Vultr DNS stillingarnar þínar geturðu gert það með Vultr DNS stjórnborðinu.

Það er líka ráðlegt að stilla síðuna þína til að nota SSL þar sem flestir nútíma vafrar gefa viðvaranir þegar síður eru ekki með SSL virkt og SSL vottorð eru nú fáanleg ókeypis.

Í öllum tilvikum er þér nú frjálst að byrja að bæta við straumum þínum og sérsníða lesandann þinn frekar, ef þú vilt.