Sådan installeres Anchor CMS på en FreeBSD 11 FAMP VPS

Anchor CMS er en supersimpel og ekstremt let, gratis og open source Content Management System (CMS) Blog Engine, der understøtter redigering af indhold i Markdown eller HTML og er fuldt i18n-kompatibel ud af boksen. Oprettelse og ændring af temaer er lige så let som at skrive nogle meget simple PHP og HTML/CSS, så der er ingen nye skabelonsprog at lære. Anchor CMS vejer kun 250KB (komprimeret), så det er den perfekte løsning til webudviklere og bloggere, der er trætte af bloatware og bare vil have en enkel og minimalistisk blogging-motor, der får jobbet gjort uden ekstra komplikationer.

I denne tutorial skal vi installere Anchor CMS på en FreeBSD 11 FAMP VPS ved hjælp af Apache-webserver, PHP 7.1 og en MariaDB-database.

Forudsætninger

• En ren Vultr FreeBSD 11-serverinstans med SSH-adgang

Trin 1: Tilføj en Sudo-bruger

Vi starter med at tilføje en ny sudobruger.

Først skal du logge ind på din server som root:

ssh root@YOUR_VULTR_IP_ADDRESS

Den sudoKommandoen er ikke installeret som standard i Vultr FreeBSD 11 serversubsystem, så vil vi først installere sudo:

pkg install sudo

Tilføj nu en ny bruger kaldet user1(eller dit foretrukne brugernavn):

adduser user1

Den adduserkommando vil bede dig for masser af oplysninger om brugerens konto, så skal du blot vælge standarderne for de fleste af dem, når det giver mening at gøre det. Når du bliver spurgt, om Invite user1 into any other groups?du skal , skal du indtaste for wheelat tilføje user1til wheelgruppen.

Tjek nu /etc/sudoersfilen for at sikre, at sudoersgruppen er aktiveret:

visudo

Se efter et afsnit som dette:

# %wheel        ALL=(ALL)       ALL

Denne linje fortæller os, at brugere, der er medlemmer af wheelgruppen, kan bruge sudokommandoen til at opnå rootprivilegier. Det vil blive kommenteret ud som standard, så du bliver nødt til at fjerne kommentaren og derefter gemme og afslutte filen.

Vi kan bekræfte user1gruppemedlemskabet med groupskommandoen:

groups user1

Hvis du user1ikke er medlem af wheelgruppen, kan du bruge denne kommando til at opdatere user1gruppemedlemskabet:

pw group mod wheel -m user1 

Brug nu sukommandoen til at skifte til den nye sudo-brugerkonto user1:

su - user1

Kommandoprompten opdateres for at angive, at du nu er logget ind på user1kontoen. Du kan bekræfte dette med whoamikommandoen:

whoami

Genstart nu sshdtjenesten, så du kan logge på sshmed den nye ikke-root sudo-brugerkonto, du lige har oprettet:

sudo /etc/rc.d/sshd restart

Afslut user1kontoen:

exit

Afslut rootkontoen (hvilket vil afbryde forbindelsen til din sshsession):

exit

Du kan nu gå sshind i serverforekomsten fra din lokale vært ved at bruge den nye ikke-root sudo-brugerkonto user1:

ssh user1@YOUR_VULTR_IP_ADDRESS

Hvis du vil udføre sudo uden at skulle indtaste en adgangskode hver gang, skal du åbne /etc/sudoersfilen igen ved at bruge visudo:

sudo visudo

Rediger sektionen for wheelgruppen, så den ser sådan ud:

%wheel        ALL=(ALL)       NOPASSWD: ALL

Bemærk venligst: Deaktivering af adgangskodekravet for sudo-brugeren er ikke en anbefalet praksis, men det er inkluderet her, da det kan gøre serverkonfigurationen meget mere bekvem og mindre frustrerende, især under længere systemadministrationssessioner. Hvis du er bekymret over sikkerhedskonsekvenserne, kan du altid gendanne konfigurationsændringen til den oprindelige, når du er færdig med dine administrationsopgaver.

Når du vil logge ind på rootbrugerkontoen fra sudobrugerkontoen, kan du bruge en af ​​følgende kommandoer:

sudo -i
sudo su -

Du kan forlade rootkontoen og vende tilbage til din sudobrugerkonto når som helst ved blot at skrive følgende:

exit

Trin 2: Opdater FreeBSD 11 System

Før vi installerer nogen pakker på FreeBSD-serverinstansen, vil vi først opdatere systemet.

Sørg for, at du er logget ind på serveren med en ikke-root sudo-bruger, og kør følgende kommandoer:

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

Trin 3: Installer Apache Web Server

Installer Apache-webserveren:

sudo pkg install apache24

Indtast, ynår du bliver bedt om det.

Brug nu sysrckommandoen til at aktivere Apache-tjenesten til at køre automatisk ved opstart:

sudo sysrc apache24_enable=yes

Den sysrckommando opdaterer /etc/rc.confkonfigurationsfil, så hvis du ønsker at kontrollere konfigurationen opdateringen manuelt kan du blot åbne /etc/rc.conffilen med din favorit terminal redaktør:

vi /etc/rc.conf

Start nu Apache-tjenesten:

sudo service apache24 start

Du kan hurtigt kontrollere, at apache kører, ved at besøge IP-adressen eller domænet for serverforekomsten i din browser:

http://YOUR_VULTR_IP_ADDRESS/

Du vil se standard FreeBSD Apache-siden, der viser teksten:

It works!

Tjek din Apache-standardkonfigurationsfil for at sikre, at DocumentRootdirektivet peger på den korrekte mappe:

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

Den DocumentRootkonfiguration mulighed vil se sådan ud:

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

Vi skal nu aktivere mod_rewriteApache-modulet. Vi kan gøre dette ved at søge i standard Apache-konfigurationsfilen for udtrykket mod_rewrite.

Som standard vil mod_rewriteApache-modulet blive kommenteret ud (hvilket betyder, at det er deaktiveret). Konfigurationslinjen på en ren Vultr FreeBSD 11-instans vil se sådan ud:

#LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Du skal blot fjerne hash-symbolet for at fjerne kommentarer til linjen og indlæse modulet. Dette gælder selvfølgelig også for alle andre påkrævede Apache-moduler:

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Vi skal nu redigere DirectoryApache-direktivet i den samme konfigurationsfil, så det mod_rewritefungerer korrekt med Anchor CMS.

Find den del af konfigurationsfilen, der starter med, <Directory "/usr/local/www/apache24/data">og skift AllowOverride nonetil AllowOverride All. Slutresultatet (med alle kommentarer fjernet) vil se nogenlunde således ud:

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

Gem og afslut nu Apache-konfigurationsfilen.

Vi genstarter Apache i slutningen af ​​denne vejledning, men at genstarte Apache regelmæssigt under installation og konfiguration er bestemt en god vane, så lad os gøre det nu:

sudo service apache24 restart

Trin 4: Installer PHP 7.1

Vi kan nu installere PHP 7.1 sammen med alle de nødvendige PHP-moduler, der kræves af Anchor CMS:

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 giver os mulighed for at bruge en udvikling php.inieller en produktion php.ini. Da vi skal installere Anchor på en offentlig webserver, bruger vi produktionsversionen. Sikkerhedskopier først php.ini-production:

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

Så soft-link php.ini-productiontil 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 Anchor CMS

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 Anchor CMS:

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

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

Trin 7: Installer Anchor CMS-filer

Skift din nuværende arbejdsmappe til standardwebbiblioteket:

cd /usr/local/www/apache24/data

Din nuværende arbejdsmappe vil nu være: /usr/local/www/apache24/data. Du kan kontrollere dette med pwdkommandoen (udskriv arbejdsmappe):

pwd

Brug nu wgettil at downloade Anchor CMS installationspakken:

sudo wget https://github.com/anchorcms/anchor-cms/archive/0.12.3a.zip

Bemærk venligst: Du bør helt sikkert tjekke efter den seneste version ved at besøge Anchor CMS-downloadsiden .

List den aktuelle mappe for at kontrollere, at du har downloadet filen:

ls -la

Fjern index.html:

sudo rm index.html

Udkomprimer nu zip-arkivet:

sudo unzip 0.12.3a.zip

Flyt alle installationsfilerne til web-rodmappen:

sudo mv anchor-cms-0.12.3a/* /usr/local/www/apache24/data

Skift ejerskab af webfilerne for at undgå problemer med tilladelser:

sudo chown -R www:www * ./

Genstart Apache igen:

sudo service apache24 restart

Trin 8: Installer og kør Composer

Anchor CMS kræver, at vi bruger composertil at downloade nogle plugins, så vi først skal installere composer. Desværre er versionen af ​​den forudbyggede binære version af composer i FreeBSD-pakkedepoterne ikke kompatibel med PHP 7.1. Så i stedet for at installere composermed pkgkommandoen, kompilerer vi den fra kilden.

Lad os først konfigurere FreeBSD 11-systemet til at kompilere PHP-software ved hjælp af PHP version 7.1 i stedet for standard 5.6.

Opret en ny fil i /etc/mappen kaldet make.conf:

sudo vi /etc/make.conf

Indtast følgende tekst i filen:

DEFAULT_VERSIONS+= php=7.1

Gem og luk nu filen.

Dernæst skal vi downloade FreeBSD-portsamlingen ved hjælp af portsnapkommandoen:

sudo portsnap fetch extract update

Når portsnapkommandoen er fuldført, skal du skifte til php-composerkildekodemappen:

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

Start nu php-composerkompileringen og installationen ved hjælp af makekommandoen:

sudo make install clean

Hvis du ikke er vant til at kompilere software, kan skærmen se lidt skræmmende ud for dig. Du vil se masser af tekst, der ruller forbi og vil lejlighedsvis blive bedt om at vælge nogle kompileringsindstillinger. Du skal blot acceptere standardværdierne og vælge OKat fortsætte med at kompilere.

Bemærk: Det kan tage lang tid at kompilere software, men sørg for at holde øje med skærmen, da du muligvis skal bekræfte detaljerne under kompileringen.

Når kompileringen er færdig, skal du skifte til webroot-mappen:

cd /usr/local/www/apache24/data

Kør komponist ved hjælp af wwwbrugeren:

sudo -u www composer install -d /usr/local/www/apache24/data

Du bør se nogle advarselsmeddelelser fra composerom ikke at kunne skrive til cachen, men det skal du ikke bekymre dig for meget om, da alt stadig skal installeres fint.

Vi er nu klar til at gå videre til det sidste trin.

Trin 9: Fuldfør installationen af ​​Anchor CMS

Det er tid til at besøge IP-adressen på din serverforekomst i din browser, eller hvis du allerede har konfigureret dine Vultr DNS-indstillinger (og givet den tid nok til at sprede sig), kan du blot besøge dit domæne i stedet for.

For at få adgang til Anchor CMS installationssiden skal du indtaste din Vultr-instans IP-adresse i din browsers adresselinje efterfulgt af /install/:

http://YOUR_VULTR_IP_ADDRESS/install/

De fleste af installationsmulighederne er selvforklarende, men her er et par tips til at hjælpe dig på vej:

1. På Anchor CMS-landingssiden skal du blot klikke på Run the installerknappen for at starte installationsprocessen.

2. Vælg dit Languageog Timezoneog klik på Next Stepknappen.

3. På Database Detailsside, indtaste følgende database værdier:

   Database Host:          localhost
   Port:                   3306
   Username:               anchor_user
   Password:               UltraSecurePassword
   Database Name:          anchor_db
   Table Prefix:           anchor_
   Collation:              utf8_unicode_ci
   

   Klik for Next Stepat fortsætte.

4. På Site metadataside, indtast følgende oplysninger:

   Site Name:              <your site name>
   Site Description:       <a site description>
   Site Path:              /
   

   Klik for Next Stepat fortsætte.

5. Indtast derefter passende admin-loginoplysninger:

   Username:               admin   
   Email Address:          <admin email address>
   Password:               <admin password>
   

6. Klik på Completeknappen for at afslutte installationen.

Du vil se en lysegrøn side med beskeden Install complete!.

For at få adgang til admin-sektionen skal du blot klikke på Visit your admin panelknappen og indtaste dit brugernavn og adgangskode. Hvis du ikke bliver omdirigeret til admin login-siden, kan du indtaste admin-adressen manuelt:

http://YOUR_VULTR_IP_ADDRESS/admin/panel

Af sikkerhedsmæssige årsager skal du sørge for at slette /install/mappen fra webroot-mappen:

sudo rm -rf ./install/

Du er nu klar til at begynde at tilføje dit indhold og konfigurere udseendet og følelsen af ​​dit websted. Sørg for at tjekke Anchor CMS-dokumentationen for mere information om, hvordan du opbygger og konfigurerer dit websted.