Com instal·lar Pagekit 1.0 CMS en un VPS FreeBSD 11 FAMP

Pagekit 1.0 CMS és un sistema de gestió de continguts (CMS) bonic, modular, extensible i lleuger, gratuït i de codi obert amb una interfície d'usuari neta i intuïtiva impulsada per Vue.js. Pagekit 1.0 CMS inclou una arquitectura modular basada en components Symfony amb un ORM senzill, un editor HTML i Markdown amb vista prèvia en temps real, un potent sistema d'usuaris i permisos i un gestor de fitxers flexible que permet als desenvolupadors web editar pàgines i gestionar ginys amb funcionalitat senzilla d'arrossegar i deixar anar.

En aquest tutorial, instal·larem Pagekit 1.0 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:

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/

Hauríeu de veure 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ó hauria de 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 Pagekit 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 que requereix Pagekit 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 Pagekit 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

Hem de configurar Apache perquè realment utilitzi PHP, així que creem un fitxer nou anomenat php.confal Includesdirectori Apache :

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

Introduïu el text següent al fitxer creat recentment:

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

Desa i surt del fitxer.

Ara reiniciem Apache perquè pugui tornar a carregar els canvis de configuració:

sudo service apache24 restart

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

FreeBSD 11 fa servir per defecte el servidor de bases de dades MariaDB, que és un reemplaçament integral millorat, totalment obert, desenvolupat per la comunitat, per al servidor MySQL.

Instal·leu la darrera versió del servidor de bases de dades MariaDB:

sudo pkg install mariadb102-server mariadb102-client

Inicieu i activeu el servidor MariaDB perquè s'executi automàticament en el moment de l'arrencada:

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

Assegureu la instal·lació del vostre servidor MariaDB:

sudo mysql_secure_installation

Quan se us demani que creeu un rootusuari MariaDB/MySQL , seleccioneu "Y" (per a sí) i després introduïu una rootcontrasenya segura . Simplement responeu "Y" a totes les altres preguntes sí/no, ja que els suggeriments predeterminats són les opcions més segures.

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

Inicieu sessió al shell de MariaDB com a rootusuari de MariaDB executant l'ordre següent:

sudo mysql -u root -p

Per accedir a l'indicador d'ordres de MariaDB, només cal que introduïu la rootcontrasenya de MariaDB quan se us demani.

Executeu les consultes següents per crear una base de dades MariaDB i un usuari de base de dades per a Pagekit CMS:

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

Podeu substituir el nom de la base de dades pagekit_dbi el nom pagekit_userd' usuari per alguna cosa més al vostre gust, si ho preferiu. A més, assegureu-vos que substituïu "UltraSecurePassword" per una contrasenya realment segura.

Pas 7: instal·leu els fitxers CMS de Pagekit

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ó de Pagekit CMS:

sudo wget http://pagekit.com/api/download/latest

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 latest

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

sudo chown -R www:www * ./

Reinicieu Apache de nou:

sudo service apache24 restart

Ara estem preparats per passar al pas final.

Pas 8: completeu la instal·lació de Pagekit 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ó de Pagekit CMS, introduïu l'adreça IP de la vostra instància Vultr a la barra d'adreces del vostre navegador, seguida de /index.php:

http://YOUR_VULTR_IP_ADDRESS/index.php

La majoria de les opcions d'instal·lació de Pagekit CMS s'expliquen per si mateixes, però aquí teniu alguns consells per ajudar-vos:

1. Feu clic a la fletxa per iniciar el procés d'instal·lació.

2. Seleccioneu el vostre idioma i feu clic al NEXTbotó.

3. Seleccioneu MySQLcom a vostre Database Driveri, a continuació, introduïu els detalls de la base de dades següents:

   Hostname:           localhost
   User:               pagekit_user
   Password:           UltraSecurePassword
   Database Name:      pagekit_db
   Table Prefix:       pk_
   

   Feu clic NEXTper continuar.

4. Introduïu el vostre Site Titlei Administrator Detailsde la següent manera:

   Site Title:         <your site title>
   Username:           <your admin username>
   Password:           <your admin password>
   Email:              <your admin email address>
   

5. Feu clic INSTALLper executar l'instal·lador de Pagekit CMS.

Se us redirigirà a la pàgina d'inici de sessió de l'administrador. 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/login

Simplement introduïu el vostre nom d'usuari i contrasenya d'administrador a la pàgina d'inici de sessió.

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