Com instal·lar Anchor CMS en un FreeBSD 11 FAMP VPS

Requisits previs

Pas 1: afegiu un usuari de Sudo

Pas 2: actualitzeu el sistema FreeBSD 11

Pas 3: instal·leu el servidor web Apache

Pas 4: instal·leu PHP 7.1

Pas 5: instal·leu el servidor MariaDB (MySQL).

Pas 6: creeu una base de dades per a Anchor CMS

Pas 7: instal·leu els fitxers Anchor CMS

Pas 8: instal·leu i executeu Composer

Pas 9: completeu la instal·lació d'Anchor CMS

Anchor CMS és un motor de blocs del sistema de gestió de continguts (CMS) súper senzill i molt lleuger, gratuït i de codi obert que admet l'edició de contingut en Markdown o HTML, i és totalment compatible amb i18n des de la caixa. Crear i modificar temes és tan fàcil com escriure PHP i HTML/CSS molt senzills, de manera que no hi ha nous llenguatges de plantilla per aprendre. Anchor CMS només pesa 250 KB (comprimit), per la qual cosa és la solució perfecta per a desenvolupadors web i bloggers que estan cansats de bloatware i només volen un motor de blocs senzill i minimalista que faci la feina sense cap complicació addicional.

En aquest tutorial instal·lem Anchor CMS en un VPS FreeBSD 11 FAMP mitjançant el servidor web Apache, PHP 7.1 i una base de dades MariaDB.

Requisits previs

• Una instància neta del servidor Vultr FreeBSD 11 amb accés SSH

Pas 1: afegiu un usuari de Sudo

Començarem afegint un nou sudousuari.

Primer, inicieu sessió al vostre servidor com a root:

ssh root@YOUR_VULTR_IP_ADDRESS

L' sudoordre no s'instal·la per defecte a la instància del servidor Vultr FreeBSD 11, de manera que primer instal·larem sudo:

pkg install sudo

Ara afegiu un usuari nou anomenat user1(o el vostre nom d'usuari preferit):

adduser user1

L' adduserordre us demanarà molts detalls per al compte d'usuari, així que simplement seleccioneu els valors predeterminats per a la majoria d'ells quan tingui sentit fer-ho. Quan se us demani si voleu Invite user1 into any other groups?, heu d'entrar wheelper afegir user1-lo al wheelgrup.

Ara comproveu el /etc/sudoersfitxer per assegurar-vos que el sudoersgrup estigui habilitat:

visudo

Busca una secció com aquesta:

# %wheel        ALL=(ALL)       ALL

Aquesta línia ens indica que els usuaris que són membres del wheelgrup poden utilitzar l' sudoordre per obtenir rootprivilegis. Es comentarà de manera predeterminada, de manera que haureu de deixar-lo de comentar i després desar i sortir del fitxer.

Podem verificar la user1pertinença al grup amb l' groupsordre:

groups user1

Si user1no wheelsou membre del grup, podeu utilitzar aquesta ordre per actualitzar la user1pertinença al grup:

pw group mod wheel -m user1 

Ara utilitzeu l' suordre per canviar al nou user1compte d' usuari sudo :

su - user1

L'indicador d'ordres s'actualitzarà per indicar que ara heu iniciat sessió al user1compte. Podeu comprovar-ho amb l' whoamiordre:

whoami

Ara reinicieu el sshdservei perquè pugueu iniciar sessió sshamb el nou compte d'usuari sudo no root que acabeu de crear:

sudo /etc/rc.d/sshd restart

Sortiu del user1compte:

exit

Sortiu del rootcompte (que desconnectarà la vostra sshsessió):

exit

Ara podeu accedir ssha la instància del servidor des del vostre amfitrió local mitjançant el nou user1compte d' usuari sudo no root :

ssh user1@YOUR_VULTR_IP_ADDRESS

Si voleu executar sudo sense haver d'escriure una contrasenya cada cop, torneu a obrir el /etc/sudoersfitxer amb visudo:

sudo visudo

Editeu la secció del wheelgrup perquè quedi així:

%wheel        ALL=(ALL)       NOPASSWD: ALL

Tingueu en compte: desactivar el requisit de contrasenya per a l'usuari sudo no és una pràctica recomanada, però s'inclou aquí, ja que pot fer que la configuració del servidor sigui molt més còmoda i menys frustrant, especialment durant sessions d'administració de sistemes més llargues. Si us preocupen les implicacions de seguretat, sempre podeu revertir el canvi de configuració a l'original després d'haver acabat les tasques d'administració.

Sempre que vulgueu iniciar sessió al rootcompte d'usuari des del sudocompte d'usuari, podeu utilitzar una de les ordres següents:

sudo -i
sudo su -

Podeu sortir del rootcompte i tornar al vostre sudocompte d'usuari en qualsevol moment simplement escrivint el següent:

exit

Pas 2: actualitzeu el sistema FreeBSD 11

Abans d'instal·lar qualsevol paquet a la instància del servidor FreeBSD, primer actualitzarem el sistema.

Assegureu-vos que heu iniciat sessió al servidor amb un usuari sudo que no sigui root i executeu les ordres següents:

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

Pas 3: instal·leu el servidor web Apache

Instal·leu el servidor web Apache:

sudo pkg install apache24

Introduïu yquan se us demani.

Ara feu servir l' sysrcordre per permetre que el servei Apache s'executi automàticament en el moment de l'arrencada:

sudo sysrc apache24_enable=yes

L' sysrcordre actualitza el /etc/rc.conffitxer de configuració, de manera que si voleu verificar l'actualització de configuració manualment, simplement podeu obrir el /etc/rc.conffitxer amb el vostre editor de terminal preferit:

vi /etc/rc.conf

Ara inicieu el servei Apache:

sudo service apache24 start

Podeu comprovar ràpidament que Apache s'està executant visitant l'adreça IP o el domini de la instància del servidor al vostre navegador:

http://YOUR_VULTR_IP_ADDRESS/

Veureu la pàgina predeterminada de FreeBSD Apache que mostra el text:

It works!

Comproveu el vostre fitxer de configuració predeterminat d'Apache per assegurar-vos que la DocumentRootdirectiva apunta al directori correcte:

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

L' DocumentRootopció de configuració serà així:

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

Ara hem d'habilitar el mod_rewritemòdul Apache. Podem fer-ho cercant al fitxer de configuració d'Apache per defecte el terme mod_rewrite.

De manera predeterminada, el mod_rewritemòdul Apache es comentarà (el que significa que està desactivat). La línia de configuració d'una instància neta de Vultr FreeBSD 11 tindrà aquest aspecte:

#LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Simplement traieu el símbol hash per eliminar el comentari de la línia i carregar el mòdul. Això, per descomptat, també s'aplica a qualsevol altre mòdul d'Apache necessari:

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Ara hem d'editar la Directorydirectiva Apache al mateix fitxer de configuració perquè mod_rewritefuncioni correctament amb Anchor CMS.

Cerqueu la secció del fitxer de configuració que comença amb <Directory "/usr/local/www/apache24/data">i canvieu-la AllowOverride nonea AllowOverride All. El resultat final (amb tots els comentaris eliminats) semblarà a això:

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

Ara deseu i sortiu del fitxer de configuració d'Apache.

Reiniciarem Apache al final d'aquest tutorial, però reiniciar Apache regularment durant la instal·lació i la configuració és sens dubte un bon hàbit, així que fem-ho ara:

sudo service apache24 restart

Pas 4: instal·leu PHP 7.1

Ara podem instal·lar PHP 7.1 juntament amb tots els mòduls PHP necessaris requerits per 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 ens dóna l'opció d'utilitzar un desenvolupament php.inio una producció php.ini. Com que instal·lem Anchor en un servidor web públic, utilitzarem la versió de producció. Primer, fes una còpia de seguretat php.ini-production:

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

A continuació, enllaceu php.ini-productiona 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.

Pas 7: instal·leu els fitxers Anchor CMS

Canvieu el vostre directori de treball actual al directori web predeterminat:

cd /usr/local/www/apache24/data

El vostre directori de treball actual serà ara: /usr/local/www/apache24/data. Podeu comprovar-ho amb l' pwdordre (imprimir el directori de treball):

pwd

Ara feu servir wgetper descarregar el paquet d'instal·lació d'Anchor CMS:

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

Tingueu en compte: definitivament hauríeu de comprovar la versió més recent visitant la pàgina de descàrrega d'Anchor CMS .

Enumereu el directori actual per comprovar que heu descarregat correctament el fitxer:

ls -la

Eliminar index.html:

sudo rm index.html

Ara descomprimiu l'arxiu zip:

sudo unzip 0.12.3a.zip

Mou tots els fitxers d'instal·lació al directori arrel web:

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

Canvieu la propietat dels fitxers web per evitar problemes de permisos:

sudo chown -R www:www * ./

Reinicieu Apache de nou:

sudo service apache24 restart

Pas 8: instal·leu i executeu Composer

Anchor CMS requereix que utilitzem composerper descarregar alguns connectors, de manera que primer hem d'instal·lar composer. Malauradament, la versió de la versió binària preconstruïda de compositor als repositoris de paquets FreeBSD no és compatible amb PHP 7.1. Per tant, en comptes d'instal·lar composeramb l' pkgordre, el compilarem des de la font.

Primer, configurem el sistema FreeBSD 11 per compilar programari PHP utilitzant la versió 7.1 de PHP en comptes de la 5.6 per defecte.

Creeu un fitxer nou al /etc/directori anomenat make.conf:

sudo vi /etc/make.conf

Introduïu el text següent al fitxer:

DEFAULT_VERSIONS+= php=7.1

Ara deseu i tanqueu el fitxer.

A continuació, hem de descarregar la col·lecció de ports de FreeBSD mitjançant l' portsnapordre:

sudo portsnap fetch extract update

Un cop portsnapcompletada l' ordre, canvieu al php-composerdirectori del codi font:

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

Ara inicieu la php-composercompilació i la instal·lació amb l' makeordre:

sudo make install clean

Si no esteu acostumats a compilar programari, la pantalla us pot semblar una mica descoratjadora. Veureu un munt de text que es desplaça i de tant en tant se us demanarà que seleccioneu alguns paràmetres de compilació. Simplement accepteu els valors predeterminats i seleccioneu OKper continuar la compilació.

Nota: La compilació del programari pot trigar una quantitat considerable de temps, però assegureu-vos de vigilar la pantalla, ja que potser haureu de confirmar els detalls durant la compilació.

Quan s'hagi completat la compilació, canvieu al directori arrel web:

cd /usr/local/www/apache24/data

Executeu el compositor amb l' wwwusuari:

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

Hauríeu de veure alguns missatges d'advertència de composerno poder escriure a la memòria cau, però no us preocupeu massa perquè tot s'hauria d'instal·lar bé.

Ara estem preparats per passar al pas final.

Pas 9: completeu la instal·lació d'Anchor CMS

És hora de visitar l'adreça IP de la instància del vostre servidor al vostre navegador, o si ja heu configurat la vostra configuració de Vultr DNS (i li heu donat temps suficient per propagar-se), simplement podeu visitar el vostre domini.

Per accedir a la pàgina d'instal·lació d'Anchor CMS, introduïu l'adreça IP de la vostra instància Vultr a la barra d'adreces del vostre navegador, seguida de /install/:

http://YOUR_VULTR_IP_ADDRESS/install/

La majoria de les opcions d'instal·lació s'expliquen per si mateixes, però aquí teniu alguns consells que us ajudaran:

1. A la pàgina de destinació d'Anchor CMS, feu clic al Run the installerbotó per iniciar el procés d'instal·lació.

2. Seleccioneu el vostre Languagei Timezonei feu clic al Next Stepbotó.

3. A la Database Detailspàgina, introduïu els valors de la base de dades següents:

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

   Feu clic Next Stepper continuar.

4. A la Site metadatapàgina, introduïu les dades següents:

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

   Feu clic Next Stepper continuar.

5. A continuació, introduïu les dades d'inici de sessió de l'administrador corresponents:

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

6. Feu clic al Completebotó per finalitzar la instal·lació.

Veureu una pàgina de color verd brillant amb el missatge Install complete!.

Per accedir a la secció d'administració només cal que feu clic al Visit your admin panelbotó i introduïu el vostre nom d'usuari i contrasenya. Si no se us redirigirà a la pàgina d'inici de sessió de l'administrador, podeu introduir l'adreça de l'administrador manualment:

http://YOUR_VULTR_IP_ADDRESS/admin/panel

Per motius de seguretat, assegureu-vos d'eliminar el /install/directori del directori arrel web:

sudo rm -rf ./install/

Ara ja esteu preparat per començar a afegir el vostre contingut i a configurar l'aspecte del vostre lloc. Assegureu-vos de consultar la documentació d' Anchor CMS per obtenir més informació sobre com crear i configurar el vostre lloc.