Stend Docker

Qu’est ce que Stend ?

Créé par Johan, Stend est un projet visant à être l’une des meilleures solutions pour configurer son propre service de partage de fichiers. Il a été conçu pour être aussi complet que la plupart des services propriétaires, mais avec une facilité d’installation et de configuration incomparable aux autres projets open-source.

Le code source des différents projets en lien avec Stend sont accessibles sur sa page GitHub, vous pouvez également avoir des informations sur chacun d’entre eux via la documentation.

Accueil illustration : client web

Pourquoi dockeriser Stend ?

Bien que nous n’en soyons pas les créateurs, Stend est un projet qui entre en accord avec les principes que partagent Make in Lab.

Nous soutenons l’auto-hébergement et la possibilité de garder le contrôle sur nos données personnelles est une liberté que nous défendons avec ferveur, c’est pourquoi nous pensons que Stend est une excellente alternative aux solutions comme Wetransfer ou encore Swisstransfer et nous souhaitons donner la possibilité à tous d’installer ce service le plus facilement possible.

Installation

Stend est installable de deux façons différentes :

Pour installer Stend avec Docker, il vous faut quelques prérequis.

Prérequis

Tout d’abord vous allez avoir besoin d’installer Docker sur votre serveur :

apt install docker.io docker-compose

Puis récuperer le docker-compose.yml :

docker-compose.yml

version: '3'
 
services:
  stend-api:
    image: makeinlab/stend-api:latest
    environment:
      # Chemin où seront stockés les fichiers dans le container
      STORAGE_PATH: /usr/src/app/stend_storage
      # Taille d'un chunk en octets (par défaut: 20000000 / 20 Mo)
      # Note: assurez-vous que votre configuration (nginx, apache, etc.) autorise les requêtes de cette taille
      # Dans le cas contraire, une erreur 413 (Payload Too Large) sera retournée lors de requêtes d'un chunk complet à l'API
      # https://stackoverflow.com/a/37916740/16155654
      CHUNK_SIZE: 20000000
      # Taille maximale autorisée pour un seul fichier en octets
      FILE_MAX_SIZE: 5000000000
      # Mot de passe pour envoyer un fichier dans le cas ou vous souhaitez faire un serveur privé (décommenter si souhaité)
      #API_PASSWORD: password
      # Durée maximale avant expiration d'un fichier en secondes (par défaut: 2592000 / 30 jours)
      # Durées recommendées :
      # 1800 = 30 minutes
      # 21600 = 6 heures
      # 43200 = 12 heures
      # 86400 = 1 jour
      # 345600 = 4 jours
      # 604800 = 1 semaine
      # 1209600 = 2 semaine
      # 2592000 = 1 mois
      # 7776000 = 3 mois
      # 15552000 = 6 mois
      # 0 = Ne jamais expirer
      FILE_MAX_AGE: 2592000
      # Port sur lequel l'API écoutera
      PORT: 3000
      # Le serveur est-il derrrière un reverse proxy ?
      # Si true, l'API utilisera l'header X-Forwarded-For pour récupérer l'adresse IP du client
      # Si "cloudflare", l'API utilisera l'header CF-Connecting-IP pour récupérer l'adresse IP du client
      # Si false, l'API utilisera l'adresse IP du dernier client contacté
      USING_REVERSE_PROXY: true
      # Marge lors de la vérification de l'espace disponible sur le disque en octets (par défaut: 1000000 / 1 Mo)
      # Si l'espace sur le disque est inférieur à la taille du fichier + cette marge, l'API refusera de stocker le fichier
      DISK_SPACE_MARGIN: 1000000
    ports:
      - 3000:3000
    volumes:
      - stend_storage:/usr/src/app/stend_storage
 
  stend-web:
    image: makeinlab/stend-web:latest
    environment:
      # Affichage de la taille maximale pour un seul fichier sur la page d'accueil du site
      FILE_MAX_SIZE: 5 GB
      # URL de l'API, les adresses IP locales (localhost, 127.0.0.1 etc...) ne corresponderaient pas forcément à votre configuration
      API_BASE_URL: http://localhost:3000
      # Port sur lequel le serveur web écoutera
      PORT: 80
      # Afficher ".html" dans le chemin des fichiers ?
      # Exemple - true : https://stend.example.com/d.html?frezazer - Il est préférable d'utiliser cette option
      # Exemple - false : https://stend.example.com/d?frezazer
      # Sur certains hébergeurs comme Vercel, vous pouvez utiliser la propriété "cleanUrls" du vercel.json, puis définir la variable sur false
      SHOW_HTML_EXTENSION: true
    ports:
      - 80:80
    volumes:
      - stend_web:/usr/src/app/build
 
volumes:
  stend_storage:
  stend_web:

Configuration

Nous vous déconseillons de modifier la variable STORAGE_PATH de l’api, si vous souhaitez tout de même changer l’emplacement des fichiers des utilisateurs au sein du container, vous devrez également modifier le répertoire indiqué dans l’encart volumes de stend-api. Nous ne garantissons pas le fonctionnement de Stend lorsque ces variables sont modifiées.

Derrière un reverse proxy

Lorsque vous utilisez un reverse proxy pour mettre en ligne Stend, il est conseillé d’ajouter une ligne dans votre configuration pour limiter la transmission de paquets trop lourds en une seule fois.

Voici un exemple de la ligne à ajouter pour Nginx :

Configuration site nginx

client_max_body_size 30M;

Utilisation

Démarrage

Pour démarrer le serveur, il vous suffit de lancer la commande

docker-compose up -d

Le premier démarrage peut être légerement long, Docker va télécharger l’image de Stend depuis Docker Hub.

Arrêt

Pour arrêter le serveur, vous pouvez lancer la commande

docker-compose down

Mises à jour

Stend est régulièrement maintenu et mis à jour, c’est pourquoi il est possible de récuperer les nouvelles images avec ces commandes :

Bash

docker-compose down     # éteint le serveur si besoin
docker-compose pull     # récupère la dernière image de Stend sur Docker Hub
docker-compose up -d    # allume le serveur

vous pouvez ensuite, supprimer les anciennes version de Stend à l’aide de ces commandes :

Bash

docker image ls     # liste les images Docker installés sur la machine
docker image prune  # supprime toutes les anciennes versions de Stend

Si vous avez d’autres serveur docker sur votre machine, il est préférable d’utiliser cette commande pour supprimer les anciennes images de Stend :

docker image rm <id_de_image>       # supprime une image spécifique, à executer pour chaque image inutilisée

Minp Documentations Orange Pi