Reader Self 3.5 est un lecteur RSS auto-hébergé simple et flexible, gratuit et open source et une alternative à Google Reader. Reader Self prend en charge les principaux raccourcis clavier de Google Reader, l'importation OPML, l'authentification intégrée, le proxy d'image HTTPS (pour télécharger des images HTTP), la synchronisation des éléments favoris avec Pinboard, la possibilité de partager sur les principaux réseaux sociaux, l'intégration d'Elastic Search, et est magnifiquement réactif sur ordinateur, tablette et mobile.
Dans ce tutoriel, nous allons installer Reader Self 3.5 sur un VPS FBS FreeBSD 11 en utilisant le serveur Web Apache, PHP 7.1 et une base de données MariaDB.
Conditions préalables
- Une instance de serveur Vultr FreeBSD 11 propre avec accès SSH
Étape 1: ajouter un utilisateur Sudo
Nous allons commencer par ajouter un nouvel sudo
utilisateur.
Tout d'abord, connectez-vous à votre serveur en tant que root
:
ssh root@YOUR_VULTR_IP_ADDRESS
La sudo
commande n'est pas installée par défaut dans l'instance de serveur Vultr FreeBSD 11, nous allons donc d'abord installer sudo
:
pkg install sudo
Ajoutez maintenant un nouvel utilisateur appelé user1
(ou votre nom d'utilisateur préféré):
adduser user1
La adduser
commande vous demandera de nombreux détails pour le compte d'utilisateur, il vous suffit donc de sélectionner les paramètres par défaut pour la plupart d'entre eux lorsque cela est logique de le faire. Lorsque vous êtes invité à le faire Invite user1 into any other groups?
, vous devez entrer wheel
pour ajouter user1
au wheel
groupe.
Maintenant, vérifiez le /etc/sudoers
fichier pour vous assurer que le sudoers
groupe est activé:
visudo
Recherchez une section comme celle-ci:
# %wheel ALL=(ALL) ALL
Cette ligne nous indique que les utilisateurs membres du wheel
groupe peuvent utiliser la sudo
commande pour obtenir des root
privilèges. Il sera commenté par défaut, vous devrez donc le décommenter, puis enregistrer et quitter le fichier.
Nous pouvons vérifier l' user1
appartenance au groupe avec la groups
commande:
groups user1
Si user1
n'est pas membre du wheel
groupe, vous pouvez utiliser cette commande pour mettre à jour l' user1
appartenance au groupe:
pw group mod wheel -m user1
Utilisez maintenant la su
commande pour basculer vers le nouveau user1
compte utilisateur sudo :
su - user1
L'invite de commande sera mise à jour pour indiquer que vous êtes maintenant connecté au user1
compte. Vous pouvez le vérifier avec la whoami
commande:
whoami
Redémarrez maintenant le sshd
service pour vous connecter via ssh
le nouveau compte utilisateur sudo non root que vous venez de créer:
sudo /etc/rc.d/sshd restart
Quittez le user1
compte:
exit
Quittez le root
compte (qui déconnectera votre ssh
session):
exit
Vous pouvez maintenant ssh
accéder à l'instance de serveur à partir de votre hôte local en utilisant le nouveau user1
compte utilisateur sudo non root :
ssh user1@YOUR_VULTR_IP_ADDRESS
Si vous souhaitez exécuter sudo sans avoir à taper un mot de passe à chaque fois, ouvrez à /etc/sudoers
nouveau le fichier en utilisant visudo
:
sudo visudo
Modifiez la section du wheel
groupe pour qu'elle ressemble à ceci:
%wheel ALL=(ALL) NOPASSWD: ALL
Remarque: la désactivation de l'exigence de mot de passe pour l'utilisateur sudo n'est pas une pratique recommandée, mais elle est incluse ici car elle peut rendre la configuration du serveur beaucoup plus pratique et moins frustrante, en particulier pendant les sessions d'administration de systèmes plus longues. Si vous êtes préoccupé par les implications de sécurité, vous pouvez toujours rétablir la modification de configuration à l'original après avoir terminé vos tâches d'administration.
Chaque fois que vous souhaitez vous connecter au root
compte d'utilisateur à partir du sudo
compte d'utilisateur, vous pouvez utiliser l'une des commandes suivantes:
sudo -i
sudo su -
Vous pouvez quitter le root
compte et revenir à votre sudo
compte utilisateur à tout moment en tapant simplement ce qui suit:
exit
Étape 2: Mettre à jour le système FreeBSD 11
Avant d'installer des packages sur l'instance du serveur FreeBSD, nous mettrons d'abord à jour le système.
Assurez-vous que vous êtes connecté au serveur à l'aide d'un utilisateur sudo non root et exécutez les commandes suivantes:
sudo freebsd-update fetch
sudo freebsd-update install
sudo pkg update
sudo pkg upgrade
Étape 3: installer Apache Web Server
Installez le serveur Web Apache:
sudo pkg install apache24
Entrez y
lorsque vous y êtes invité.
Utilisez maintenant la sysrc
commande pour permettre au service Apache de s'exécuter automatiquement au démarrage:
sudo sysrc apache24_enable=yes
La sysrc
commande met à jour le /etc/rc.conf
fichier de configuration, donc si vous voulez vérifier manuellement la mise à jour de la configuration, vous pouvez simplement ouvrir le /etc/rc.conf
fichier avec votre éditeur de terminal préféré:
vi /etc/rc.conf
Démarrez maintenant le service Apache:
sudo service apache24 start
Vous pouvez rapidement vérifier que Apache fonctionne en visitant l'adresse IP ou le domaine de l'instance de serveur dans votre navigateur:
http://YOUR_VULTR_IP_ADDRESS/
Vous verrez la page par défaut de FreeBSD Apache affichant le texte:
It works!
Vérifiez votre fichier de configuration par défaut Apache pour vous assurer que la DocumentRoot
directive pointe vers le bon répertoire:
sudo vi /usr/local/etc/apache24/httpd.conf
L' DocumentRoot
option de configuration ressemblera à ceci:
DocumentRoot "/usr/local/www/apache24/data"
Nous devons maintenant activer le mod_rewrite
module Apache. Pour ce faire, recherchez le terme dans le fichier de configuration Apache par défaut mod_rewrite
.
Par défaut, le mod_rewrite
module Apache sera commenté (ce qui signifie qu'il est désactivé). La ligne de configuration sur une instance propre de Vultr FreeBSD 11 ressemblera à ceci:
#LoadModule rewrite_module libexec/apache24/mod_rewrite.so
Retirez simplement le symbole de hachage pour décommenter la ligne et charger le module. Bien entendu, cela s'applique également à tous les autres modules Apache requis:
LoadModule rewrite_module libexec/apache24/mod_rewrite.so
Nous devons maintenant modifier la Directory
directive Apache dans le même fichier de configuration afin que mod_rewrite
cela fonctionne correctement avec Reader Self.
Recherchez la section du fichier de configuration qui commence par <Directory "/usr/local/www/apache24/data">
et passez AllowOverride none
à AllowOverride All
. Le résultat final (avec tous les commentaires supprimés) ressemblera à ceci:
<Directory "/var/www/html">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
Maintenant, enregistrez et quittez le fichier de configuration Apache.
Nous redémarrerons Apache à la fin de ce tutoriel, mais redémarrer régulièrement Apache pendant l'installation et la configuration est certainement une bonne habitude, alors faisons-le maintenant:
sudo service apache24 restart
Étape 4: installez PHP 7.1
Nous pouvons maintenant installer PHP 7.1 avec tous les modules PHP nécessaires requis par Reader Self:
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 nous donne la possibilité d'utiliser un développement php.ini
ou une production php.ini
. Puisque nous allons installer Reader Self sur un serveur Web public, nous utiliserons la version de production. Tout d'abord, sauvegardez php.ini-production
:
sudo cp /usr/local/etc/php.ini-production /usr/local/etc/php.ini-production.backup
Créez ensuite un lien logiciel php.ini-production
vers php.ini
:
sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini
Nous devons configurer Apache pour utiliser réellement PHP, alors créons un nouveau fichier appelé php.conf
dans le Includes
répertoire Apache :
sudo vi /usr/local/etc/apache24/Includes/php.conf
Saisissez le texte suivant dans le fichier nouvellement créé:
<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>
Enregistrez et quittez le fichier.
Redémarrons maintenant Apache pour qu'il puisse recharger les modifications de configuration:
sudo service apache24 restart
Étape 5: installer le serveur MariaDB (MySQL)
Par défaut, FreeBSD 11 utilise le serveur de base de données MariaDB, qui est un remplacement amélioré, entièrement open source, développé par la communauté, pour le serveur MySQL.
Installez la dernière version du serveur de base de données MariaDB:
sudo pkg install mariadb102-server mariadb102-client
Démarrez et activez le serveur MariaDB pour qu'il s'exécute automatiquement au démarrage:
sudo sysrc mysql_enable="yes"
sudo service mysql-server start
Sécurisez l'installation de votre serveur MariaDB:
sudo mysql_secure_installation
Lorsque vous êtes invité à créer un utilisateur MariaDB / MySQL root
, sélectionnez "Y" (pour oui), puis entrez un root
mot de passe sécurisé . Répondez simplement "Y" à toutes les autres questions oui / non car les suggestions par défaut sont les options les plus sûres.
Étape 6: créer une base de données pour Reader Self
Connectez-vous au shell MariaDB en tant root
qu'utilisateur MariaDB en exécutant la commande suivante:
sudo mysql -u root -p
Pour accéder à l'invite de commande MariaDB, entrez simplement le root
mot de passe MariaDB lorsque vous y êtes invité.
Exécutez les requêtes suivantes pour créer une base de données MariaDB et un utilisateur de base de données pour Reader Self:
CREATE DATABASE self_db CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'self_user'@'localhost' IDENTIFIED BY 'UltraSecurePassword';
GRANT ALL PRIVILEGES ON self_db.* TO 'self_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;
Vous pouvez remplacer le nom self_db
et le nom self_user
d' utilisateur de la base de données par quelque chose de plus à votre goût, si vous préférez. Assurez-vous également de remplacer "UltraSecurePassword" par un mot de passe réellement sécurisé.
Étape 7: installer les fichiers Self Reader
Remplacez votre répertoire de travail actuel par le répertoire Web par défaut:
cd /usr/local/www/apache24/data
Votre répertoire de travail sera désormais: /usr/local/www/apache24/data
. Vous pouvez vérifier cela avec la commande pwd
(imprimer le répertoire de travail):
pwd
Utilisez maintenant wget
pour télécharger le package d'installation de Reader Self:
sudo wget --content-disposition https://github.com/readerself/readerself/archive/3.5.6.zip
Remarque: vous devez absolument vérifier la version la plus récente en visitant la page de téléchargement de Reader Self .
Répertoriez le répertoire actuel pour vérifier que vous avez correctement téléchargé le fichier:
ls -la
Supprimer index.html
:
sudo rm index.html
Décompressez maintenant l'archive zip:
sudo unzip readerself-3.5.6.zip
Déplacez tous les fichiers d'installation dans le répertoire racine Web:
sudo mv -v readerself-3.5.6/* readerself-3.5.6/.* /usr/local/www/apache24/data 2>/dev/null
Modifiez la propriété des fichiers Web pour éviter tout problème d'autorisation:
sudo chown -R www:www * ./
Redémarrez Apache à nouveau:
sudo service apache24 restart
Nous sommes maintenant prêts à passer à la dernière étape.
Étape 8: installation complète du Reader
Il est maintenant temps de visiter l'adresse IP de votre instance de serveur dans votre navigateur, ou si vous avez déjà configuré vos paramètres DNS Vultr (et lui avez donné suffisamment de temps pour se propager), vous pouvez simplement visiter votre domaine à la place.
Pour accéder à la page Reader Self installation, entrez votre adresse IP d'instance Vultr dans la barre d'adresse de votre navigateur, puis /setup/
:
http://YOUR_VULTR_IP_ADDRESS/setup/
-
Vous verrez un Pre-Installation Check
en haut de la page alors assurez-vous que tout va bien et passez à l'étape suivante.
-
Entrez les valeurs de base de données suivantes dans la Database
section de la page d'installation:
Database Type: MySQL (improved version)
Hostname: localhost
Username: self_user
Password: UltraSecurePassword
Database Name: self_db
-
Entrez les User
détails suivants :
Email: <your email address>
Password: <a secure password>
-
Une fois que vous avez vérifié que tous les détails ci-dessus sont corrects, cliquez simplement sur l'icône de coche en bas à gauche de la page pour finaliser l'installation.
Vous serez redirigé vers une confirmation qui dit Installation successful
.
Pour configurer davantage Reader Self, cliquez sur le menu dans le coin supérieur droit et sélectionnez settings
.
Si vous voulez que le lecteur mette à jour automatiquement vos flux (et vous le faites presque certainement), vous devrez modifier votre crontab:
sudo crontab -e
Ajoutez la ligne suivante pour actualiser vos flux toutes les heures:
0 * * * * www cd /usr/local/www/apache24/data && php index.php refresh items
Si vous n'avez pas encore configuré vos paramètres DNS Vultr, vous pouvez le faire à l'aide du panneau de configuration DNS Vultr.
Il est également conseillé de configurer votre site pour utiliser SSL car la plupart des navigateurs modernes avertissent lorsque les sites n'ont pas activé SSL et que les certificats SSL sont désormais disponibles gratuitement.
Dans tous les cas, vous êtes maintenant prêt à commencer à ajouter vos flux et à personnaliser davantage l'apparence et les fonctionnalités de votre lecteur.