Guide de configuration
Erugo est configuré entièrement via le panneau d'administration — aucune variable d'environnement n'est requise. Ce guide couvre tous les paramètres disponibles et comment les utiliser.
Consultez d'abord le guide de démarrage rapide pour apprendre comment installer et déployer Erugo.
Accéder aux paramètres
Pour accéder aux paramètres de configuration, connectez-vous à Erugo en tant qu'administrateur et cliquez sur l'icône d'engrenage dans la barre d'outils en bas à droite.
L'engrenage des paramètres dans la barre d'outils en bas à droite
Le panneau des paramètres est organisé en plusieurs sections :
- Marque & Interface — Personnalisation visuelle, thèmes, logos et arrière-plans
- Paramètres système — Comportement de l'application, partages, SMTP et authentification
- Modèles d'e-mail — Personnaliser les e-mails de notification
- Utilisateurs — Gérer les comptes utilisateurs
Marque & Interface
Images d'arrière-plan
Personnalisez les images d'arrière-plan affichées dans Erugo. Par défaut, Erugo utilise des images d'Unsplash, mais vous pouvez télécharger les vôtres.
| Paramètre | Description | Défaut |
|---|---|---|
Utiliser mes arrière-plans | Lorsque activé, utilise vos images d'arrière-plan téléchargées au lieu d'Unsplash. Vous devez télécharger au moins une image pour activer ceci. | Désactivé |
Intervalle de changement d'image | Fréquence de changement aléatoire de l'image d'arrière-plan. Options : 3 minutes, 5 minutes, 1 heure, 2 heures, 1 jour, ou désactivé. Réglez sur 0 pour afficher une image aléatoire à chaque chargement de page. | 3 minutes |
Formats pris en charge : PNG, JPEG, GIF, images WebP, et vidéos MP4/WebM.
Logo & Favicon
Affichez le logo de votre entreprise ou organisation dans le coin supérieur gauche de l'interface, et personnalisez le favicon affiché dans les onglets du navigateur.
| Paramètre | Description | Défaut |
|---|---|---|
Image du logo | Téléchargez une image PNG ou SVG à utiliser comme logo. Pour de meilleurs résultats, utilisez une image avec un fond transparent. | Logo Erugo |
Largeur du logo | Définissez la largeur d'affichage en pixels. La hauteur s'ajuste automatiquement pour maintenir le ratio. Utilisez une image source au moins aussi large que votre largeur d'affichage pour la qualité. | 100px |
Favicon | Téléchargez un favicon personnalisé (format PNG ou SVG, SVG recommandé) pour remplacer l'icône Erugo par défaut affichée dans les onglets du navigateur. Taille maximale : 1 Mo. | Favicon Erugo |
Thèmes
Erugo inclut une variété de thèmes prédéfinis et prend en charge les thèmes personnalisés. Les thèmes contrôlent les couleurs, les polices et autres aspects visuels de l'interface.
Sélectionner un thème
Choisissez parmi les thèmes disponibles dans le menu déroulant. Les modifications sont prévisualisées immédiatement, mais vous devez enregistrer pour les appliquer définitivement.
Thèmes personnalisés
Vous pouvez créer et installer des thèmes personnalisés :
- Téléchargez un thème existant comme point de départ
- Modifiez le fichier JSON pour personnaliser les couleurs et les styles
- Installez votre thème personnalisé en téléchargeant le fichier JSON et en lui donnant un nom
N'installez que des thèmes provenant de sources de confiance. Vérifiez les fichiers de thème avant l'installation pour vous assurer qu'ils ne contiennent pas de code malveillant.
Supprimer des thèmes
Vous pouvez supprimer les thèmes personnalisés que vous avez installés. Les thèmes fournis et le thème actuellement actif ne peuvent pas être supprimés.
Autres options d'interface
| Paramètre | Description | Défaut |
|---|---|---|
Afficher Propulsé par Erugo | Afficher ou masquer le texte « Propulsé par Erugo » en bas de page. Cela aide Erugo à être découvert par de nouveaux utilisateurs et soutient le projet, mais vous pouvez le masquer si vous préférez. | Activé |
Paramètres système
Général
Paramètres de base de l'application qui contrôlent comment Erugo s'identifie et se comporte.
| Paramètre | Description | Défaut |
|---|---|---|
Nom de l'application | Le nom affiché dans les barres de titre, les dialogues et dans toute l'interface. Aide à maintenir une image de marque cohérente. | Erugo File Sharing |
URL de l'application | L'URL de base de votre instance Erugo. Utilisée pour créer des liens cliquables dans les e-mails de notification. Ne pas inclure de barre oblique finale. | — |
Message de connexion | Un message personnalisé affiché sur l'écran de connexion. Utilisez-le pour des messages de bienvenue, des annonces ou des notifications importantes. | Connectez-vous à votre compte pour commencer. |
Langue par défaut | La langue principale de l'interface. Les utilisateurs peuvent remplacer cela avec leurs préférences personnelles. Disponibles : anglais, allemand, français, italien, néerlandais, portugais. | Anglais |
Afficher le sélecteur de langue | Lorsque activé, affiche un menu déroulant de langue dans le coin supérieur droit permettant aux utilisateurs de changer de langue. | Activé |
Partages
Contrôlez le comportement des partages de fichiers, y compris les limites de taille, l'expiration et les politiques de nettoyage.
| Paramètre | Description | Défaut |
|---|---|---|
Durée d'expiration par défaut | Le nombre de jours par défaut avant qu'un partage n'expire. Les utilisateurs peuvent modifier cela lors de la création d'un partage (dans la limite maximale). | 7 jours |
Durée d'expiration maximale | Le nombre maximum de jours qu'un utilisateur peut définir pour l'expiration d'un partage. Laissez vide pour permettre une durée d'expiration illimitée. | 10 jours |
Taille maximale du partage | La taille totale maximale des fichiers pouvant être inclus dans un seul partage. Peut être définie en Mo ou Go. | 2 Go |
Nettoyer les fichiers après | Nombre de jours après l'expiration d'un partage avant que ses fichiers ne soient définitivement supprimés du système. Cela donne aux utilisateurs le temps de prolonger les partages si nécessaire. | 30 jours |
Autoriser les partages inversés | Lorsque activé, les utilisateurs enregistrés peuvent envoyer des demandes de partage inversé. Celles-ci fournissent aux personnes externes un pass de téléchargement unique pour livrer des fichiers directement à l'utilisateur demandeur. | Activé |
Génération d'URL de partage
Contrôlez comment les URL de partage sont générées. Choisissez entre des combinaisons de mots mémorables ou des modèles personnalisés pour une flexibilité maximale.
| Paramètre | Description | Défaut |
|---|---|---|
Mode de génération d'URL |
Choisissez comment les URL de partage sont créées :
| Haiku |
Mode modèle
Le mode modèle vous permet de définir un format personnalisé pour les URL de partage en utilisant la syntaxe de modèle Erugo. Cela vous donne un contrôle total sur la structure et les caractères utilisés dans vos liens de partage.
| Paramètre | Description | Défaut |
|---|---|---|
Modèle | Définissez un modèle utilisant des jetons spéciaux pour les caractères aléatoires, ou incluez des caractères littéraux pour les préfixes et séparateurs (ex : ES-####-AAA ou [A-Z][0-9]***). | — |
Référence de la syntaxe de modèle
Utilisez ces jetons dans votre modèle pour générer des caractères aléatoires :
| Jeton | Description | Exemple de sortie |
|---|---|---|
# | Chiffre (0-9) | 7 |
A | Lettre majuscule (A-Z) | K |
a | Lettre minuscule (a-z) | m |
* | Alphanumérique (0-9, A-Z, a-z) | X |
X | Hexadécimal (0-9, A-F) | E |
[...] | Plage/classe de caractères | [A-Z] → M |
\ | Échappement (utiliser le caractère suivant littéralement) | \A → A |
Exemples de modèles :
ES-####-AAA→ES-4821-KMTshare-****→share-X7mKXXXX-XXXX→A3F2-9C1E
Notifications par e-mail
Contrôlez quelles notifications par e-mail sont envoyées aux utilisateurs. Toutes les notifications nécessitent que SMTP soit configuré.
| Notification | Description | Défaut |
|---|---|---|
Partage téléchargé | Notifier les propriétaires de partages lorsque leur contenu partagé est téléchargé pour la première fois. Aide les utilisateurs à suivre quand les destinataires accèdent à leurs fichiers. | Activé |
Avertissement d'expiration de partage | Envoyer des notifications proactives lorsque les partages approchent de leur expiration. Donne aux utilisateurs la possibilité de prolonger l'accès si nécessaire. | Activé |
Partage expiré | Alerter les utilisateurs lorsque leurs partages ont atteint leur date d'expiration et ne sont plus accessibles aux destinataires. | Activé |
Avertissement de suppression de partage | Fournir un préavis lorsque les partages expirés sont programmés pour une suppression définitive. Donne aux utilisateurs une dernière opportunité de sauvegarder le contenu important. | Activé |
Partage supprimé | Notifier les utilisateurs lorsque leurs partages ont été définitivement supprimés du système. Confirme l'achèvement du cycle de vie du contenu. | Activé |
Configuration SMTP / E-mail
Configurez les paramètres de votre serveur de messagerie pour activer les notifications et les e-mails de réinitialisation de mot de passe.
| Paramètre | Description | Défaut |
|---|---|---|
Hôte SMTP | L'adresse du serveur pour votre service de messagerie sortant (ex : smtp.gmail.com, smtp.mailgun.org). | — |
Port SMTP | Le numéro de port de votre serveur SMTP. Ports courants : 25 (standard), 465 (SSL), 587 (TLS). | 587 |
Chiffrement SMTP | La méthode de chiffrement pour votre connexion SMTP. Choisissez TLS (recommandé), SSL ou Aucun selon les exigences de votre fournisseur de messagerie. | TLS |
Nom d'utilisateur SMTP | Le nom d'utilisateur pour s'authentifier avec votre serveur SMTP. Généralement votre adresse e-mail ou nom de compte. | — |
Mot de passe SMTP | Le mot de passe pour l'authentification SMTP. Pour Gmail, utilisez un mot de passe d'application au lieu de votre mot de passe habituel. | — |
Nom de l'expéditeur | Le nom d'affichage qui apparaît comme expéditeur (ex : « Partage de fichiers Erugo » ou « Nom de votre entreprise »). | — |
Adresse de l'expéditeur | L'adresse e-mail utilisée comme expéditeur pour tous les e-mails système. Doit être valide et configurée avec votre service SMTP. | — |
Si vous utilisez Gmail, vous devrez créer un mot de passe d'application dans les paramètres de votre compte Google. Les mots de passe réguliers ne fonctionneront pas en raison des politiques de sécurité de Google. Consultez le guide de configuration e-mail pour plus de détails.
Auto-inscription
Permettez aux utilisateurs de créer leurs propres comptes sans intervention de l'administrateur. Lorsque activé, une option « Créer un compte » apparaît sur la page de connexion.
| Paramètre | Description | Défaut |
|---|---|---|
Activer l'auto-inscription | Lorsque activé, les utilisateurs peuvent créer leurs propres comptes depuis la page de connexion. Les utilisateurs doivent vérifier leur adresse e-mail avant de pouvoir se connecter. | Désactivé |
Autoriser tout domaine | Lorsque activé, les utilisateurs avec n'importe quelle adresse e-mail peuvent s'inscrire. Lorsque désactivé, seules les adresses e-mail des domaines spécifiés sont autorisées. | Activé |
Domaines e-mail autorisés | Lorsque les restrictions de domaine sont activées, seuls les utilisateurs avec des adresses e-mail de ces domaines peuvent s'inscrire. Entrez les domaines séparés par des virgules (ex : entreprise.com, partenaire.org). Utile pour limiter l'inscription à votre organisation. | — |
Les utilisateurs auto-inscrits doivent vérifier leur adresse e-mail avant de pouvoir se connecter. Assurez-vous que SMTP est correctement configuré pour que les e-mails de vérification soient envoyés.
Fournisseurs d'authentification
Configurez des fournisseurs d'authentification externes pour permettre aux utilisateurs de se connecter avec leurs comptes existants. Erugo prend en charge les fournisseurs OAuth2/OIDC, notamment Google, Microsoft, Authentik et OIDC générique.
L'authentification externe nécessite un nom de domaine pleinement qualifié (FQDN). Les fournisseurs OAuth ne peuvent pas être configurés lors de l'accès à Erugo via localhost.
Ajouter un fournisseur d'authentification
- Naviguez vers Paramètres système → Auth
- Cliquez sur le bouton + pour ajouter un nouveau fournisseur
- Sélectionnez le type de fournisseur dans le menu déroulant
- Configurez les paramètres requis (Client ID, Client Secret, etc.)
- Copiez l'URL de rappel et ajoutez-la à la configuration de votre fournisseur d'identité
- Activez le fournisseur et enregistrez
Paramètres du fournisseur
| Paramètre | Description |
|---|---|
Activer | Activer ou désactiver le fournisseur. Les fournisseurs désactivés n'apparaîtront pas sur l'écran de connexion. |
Autoriser l'auto-inscription | Lorsque activé, les utilisateurs qui s'authentifient avec ce fournisseur mais n'ont pas de compte existant en auront un créé automatiquement. N'activez que pour les fournisseurs d'identité de confiance. |
Nom du fournisseur | Le nom d'affichage affiché sur le bouton de connexion (ex : « Se connecter avec Google »). |
Client ID | L'ID client OAuth de votre fournisseur d'identité. |
Client Secret | Le secret client OAuth de votre fournisseur d'identité. |
URL de rappel | L'URL à configurer dans votre fournisseur d'identité. Celle-ci est automatiquement générée par Erugo. |
Ne configurez que des fournisseurs d'authentification en qui vous avez confiance. Les fournisseurs d'authentification ont des privilèges d'accès élevés. L'ajout de fournisseurs non fiables ou compromis pourrait entraîner un accès non autorisé ou des violations de données.
Modèles d'e-mail
Personnalisez le contenu des e-mails de notification envoyés par Erugo. Chaque type d'e-mail peut être configuré individuellement.
Modèles disponibles
- Modèle de base — Le modèle enveloppe dont tous les autres e-mails héritent
- Compte créé — Envoyé aux nouveaux utilisateurs avec un lien pour définir leur mot de passe
- Vérification d'e-mail — Envoyé aux utilisateurs auto-inscrits avec un code de vérification à 6 chiffres pour confirmer leur adresse e-mail
- Réinitialisation de mot de passe — Envoyé lorsqu'un utilisateur demande une réinitialisation de mot de passe
- Invitation de partage inversé — Envoyé lorsqu'un utilisateur invite quelqu'un à télécharger des fichiers
- Partage créé — Envoyé aux destinataires lorsque des fichiers sont partagés avec eux
- Partage téléchargé — Envoyé aux propriétaires lorsque leur partage est téléchargé
- Avertissement d'expiration de partage — Envoyé avant qu'un partage n'expire
- Partage expiré — Envoyé lorsqu'un partage a expiré
- Avertissement de suppression de partage — Envoyé avant que les fichiers ne soient définitivement supprimés
- Partage supprimé — Envoyé lorsque les fichiers ont été définitivement supprimés
Sections de modèle
Chaque modèle peut avoir les sections suivantes personnalisées :
| Section | Description |
|---|---|
Objet | La ligne d'objet de l'e-mail. |
En-tête | Contenu affiché en haut de l'e-mail. |
Contenu du message | Le corps principal de l'e-mail. |
Texte du bouton d'action | Texte affiché sur le bouton d'appel à l'action. |
Texte de secours | Texte affiché au-dessus du lien de secours pour les clients de messagerie qui ne peuvent pas afficher correctement les boutons. |