Outils pour utilisateurs

Outils du site


peertube_installation_et_configuration

Ceci est une ancienne révision du document !


Peertube - Installation et configuration

Peertube est un logiciel libre pour reprendre le contrôle de vos vidéos en ligne.

PeerTube, développé par Framasoft, est l'alternative libre et décentralisée aux plateformes vidéos, qui vous donne accès à plus de 400 000 vidéos proposées par 60 000 utilisateur⋅ices et visionnées plus de 15 millions de fois

Ce logiciel en ligne permet donc d'héberger toutes sortes de vidéos et de fichiers audio et il permet également de faire de la diffusion en direct - du live streaming

Le site officiel - la page github

Installation sur Debian 10

On utilisera le serveur Apache pour rendre visible Peertube sur les Internets.

Important : ce tutoriel n'aborde pas la configuration d'un Pare-Feu ou la création d'un certificat SSL pour le HTTPS.

On installe au préalable quelques outils :

apt install htop nano nload iotop wget locate tmux net-tools

On commence ensuite en suivant ce beau tuto réalisé par AukFood tout en gardant un oeil sur la documentation officielle.

Il y aura un choix à faire sur le format des vidéos et de la diffusion : WebTorrent transcoding ou HLS transcoding.

Pré-requis

On a besoin de plusieurs programmes, dont yarn (manager de paquets) qui a besoin d'être ajouté aux sources d'APT.

apt install curl
curl -sL https://deb.nodesource.com/setup_10.x | bash -E -
curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | tee /etc/apt/sources.list.d/yarn.list
apt update
apt install unzip xz-utils nodejs yarn ffmpeg postgresql postgresql-contrib postgresql postgresql-client g++ make redis-server

Création d'un user spécifique

On décide d'installer Peertube dans le dossier /var/www/tube.futuretic.fr, qui est attribué comme home d'un nouvel utilisateur nommé peertube. On règle aussi les droits sur ce dossier.

mkdir -p /var/www/tube.futuretic.fr
useradd -s /bin/bash -d /var/www/tube.futuretic.fr peertube
chown -R peertube: /var/www/tube.futuretic.fr
chmod 2770 /var/www/tube.futuretic.fr

Création de la Base de données

Peertube utilise PostgreSQL, on lui crée une base nommée peertube, gérée par un user nommé peertube.

su - postgres
createuser peertube -d -P -R
createdb -O peertube peertube
psql -c "CREATE EXTENSION pg_trgm;" peertube
psql -c "CREATE EXTENSION unaccent;" peertube
exit

Création des répertoires de base

Peertube utilisera ces répertoires pour fonctionner. Toujours dans le dossier /var/www/tube.futuretic.fr, on les crée en tant que l'utilisateur précédemment créé : peertube. Après la création, on entre dans le dossier versions.

su - peertube
mkdir -p config storage versions etc var/log/apache2
cd versions

Téléchargement de la dernière version

On récupère la dernière version, on la décompresse, on supprimé l'archive, et on fait un lien symbolique dans le dossier racine de Peertube pour indiquer quelle est la dernière version. Enfin, on entre dans le dossier de cette version.

VERSION=$(curl -s https://api.github.com/repos/chocobozzz/peertube/releases/latest | grep tag_name | cut -d '"' -f 4)
wget -q "https://github.com/Chocobozzz/PeerTube/releases/download/${VERSION}/peertube-${VERSION}.tar.xz"
tar -xJf peertube-${VERSION}.tar.xz
rm -f peertube-${VERSION}.tar.xz
cd ../
ln -s versions/peertube-${VERSION} ./peertube-latest
cd ./peertube-latest

Installation

Grâce à Yarn, on récupère Peertube, puis on copie les modèles de config dans notre dossier config précédemment créé. Ce sont ces fichiers que l'on modifie pour la configuration.

yarn install --production --pure-lockfile
cp ./config/production.yaml.example ../../config/production.yaml
cp ./config/local-test.json ../../config/local-production.json

Configuration

On modifie le fichier de config :

nano /var/www/tube.futuretic.fr/config/production.yaml

Le fichier est long, mais une partie de la config pourra se faire directement dans l'interface de Peertube. Modifier le fichier en fonction de vos besoins et en remplaçant l'url de votre instance Peertube partout où il le faudra.

Important : Supprimer le sufixe '_prod' dans la configuration de la base de données.

...
webserver:
  https: true
  hostname: 'tube.futuretic.fr'
  port: 443
...
database:
  hostname: 'localhost'
  port: 5432
  suffix: ''
  username: 'peertube'
  password: 'peertube'
...
storage:
  tmp: '/var/www/tube.futuretic.fr/storage/tmp/' # Used to download data (imports etc), store uploaded files before processing...
  avatars: '/var/www/tube.futuretic.fr/storage/avatars/'
  videos: '/var/www/tube.futuretic.fr/storage/videos/'
  streaming_playlists: '/var/www/tube.futuretic.fr/storage/streaming-playlists/'
  redundancy: '/var/www/tube.futuretic.fr/storage/videos/'
  logs: '/var/www/tube.futuretic.fr/storage/logs/'
  previews: '/var/www/tube.futuretic.fr/storage/previews/'
  thumbnails: '/var/www/tube.futuretic.fr/storage/thumbnails/'
  torrents: '/var/www/tube.futuretic.fr/storage/torrents/'
  captions: '/var/www/tube.futuretic.fr/storage/captions/'
  cache: '/var/www/tube.futuretic.fr/storage/cache/'
  plugins: '/var/www/tube.futuretic.fr/storage/plugins/'
...
instance:
  name: 'PeerTube FuturEtic'
  short_description: 'PeerTube, a federated (ActivityPub) video streaming platform using P2P (BitTorrent) directly in the web browser with WebTorrent and Angular.'
  description: 'Peertube FuturEtic, nos vidéos à nous' # Support markdown

Pour la configuration email, lorsqu'on utilise smtp, il faut ajouter la ligne enabled: true au bloc email :

email:
  enabled: true

Optimisation et démarrage

On copie la config spécifique TCP de Peertube au bon endroit (elle permet de gérer l'envoi des paquets aux clients lents) :

cp /var/www/tube.futuretic.fr/peertube-latest/support/sysctl.d/30-peertube-tcp.conf /etc/sysctl.d/

On démarre Peertube ! On l'ajoute aussi aux daemons du système pour qu'il démarre tout seul au boot de la machine. Puis on regarde les infos sur l'état de Peertube (qui devrait donc être démarré).

cp /var/www/tube.futuretic.fr/peertube-latest/support/systemd/peertube.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable peertube
systemctl start peertube
systemctl status peertube

Compte admin de Peertube

Par défaut, Peertube crée le compte administrateur principal, nommé root, sans mot de passe. Malheureusement on ne peut pas le renommer. On doit donc créé un mot de passe, en tant que l'utilisateur peertube.

su - peertube
cd peertube-latest
NODE_CONFIG_DIR=/var/www/tube.futuretic.fr/config NODE_ENV=production npm run reset-password -- -u root

Installer Apache2 et ses modules

On va utiliser Apache comme Proxy vers le port de Peertube par défaut (9000), il faut installer tout ça :

apt install apache2
a2enmod proxy proxy_http proxy_wstunnel ssl http2 rewrite headers

Générer un certificat ssl après avoir installé snap puis certbot

apt install snapd
snap install core
snap install hello-world
snap refresh core
snap install --classic certbot
ln -s /snap/bin/certbot /usr/bin/certbot

Pour générer ce premier certificat, on va utiliser le vhost par défaut d'apache 000-default.conf en changeant simplement le ServerName pour tube.futuretic.fr

cd /etc/apache2/sites-enabled/
cd ../sites-available/
nano 000-default.conf 
systemctl reload apache2
certbot certonly --apache

On va ensuite pouvoir mettre en place le vhost définitif

vhost apache 

Configurations complémentaires

Installer les outils en ligne de commande

Il faut suivre la procédure décrite ici et s'assurer que l'on a bien suivi les requirements notamment en installant nodejs v12

Install nodejs v12

# Using Debian, as root
curl -fsSL https://deb.nodesource.com/setup_12.x | bash -

apt-get install -y nodejs

Verification de la version de yarn

yarn --version

Ensuite en tant que utilisateur non root

cd ~/
$ git clone https://github.com/Chocobozzz/PeerTube.git
$ CLONE="$(pwd)/PeerTube"
$ cd ${CLONE}

Install dependencies and build CLI tools:

$ NOCLIENT=1 yarn install --pure-lockfile
$ npm run setup:cli

Ensuite possible de faire un CLI wrapper en ajoutant dans le .bashrc de son user favori :

alias peertube="cd /your/peertube/directory/ && node ./dist/server/tools/peertube.js"

Administration de l'instance

Import de toutes les vidéos d'un canal youtube ou vimeo

En ligne de commande depuis le serveur en tant que user non root :

~/PeerTube$ node dist/server/tools/peertube-import-videos.js -u 'tube.futuretic.fr' -U 'PEERTUBE_USER' --password 'PEERTUBE_PASSWORD' --target-url 'TARGET_URL'

voir option -k pour garder la version originale sur le serveur Peertube

peertube_installation_et_configuration.1619308106.txt.gz · Dernière modification : 2021/04/24 23:48 de n1c0