FAQ

FAQ / Dépannage

Installation & lancement

« Quelle version de Bun ? » — Bun 1.x. Le projet ne fige la version que dans le Dockerfile (oven/bun:1). Node.js n'est pas nécessaire.

« Le port n'est pas le bon. » — Le port vient de PORT (défaut 3000). Le .env d'exemple utilise 4001 : alignez PORT, AUTH_URL et NEXT_PUBLIC_API_URL.

« AUTH_URL ou NEXTAUTH_URL ? » — NextAuth v5 utilise AUTH_URL. NEXTAUTH_URL n'est pas lu par le code.

« Comment créer le premier compte ? » — Via le CLI : bun cli users (choisir le rôle Administrateur). Stocké haché dans data/users.json.

Uploads

« 401 Clé API manquante. » — L'en-tête x-api-key est absent. ShareX/fu l'envoient automatiquement si le .sxcu est correct.

« 403 Clé API invalide ou permissions insuffisantes. » — Clé inconnue, expirée, ou sans la permission du type de fichier (images/texte/fichiers). Recréez une clé avec les bonnes permissions.

« Type de fichier non supporté / type non autorisé. » — L'extension n'est pas dans la liste (images: jpg/jpeg/png/gif/webp ; docs: pdf/doc/docx/txt ; archives: zip/rar) ou le type est désactivé dans Uploads → Configuration.

« Fichier trop grand / trop petit. » — Voir limits : maxFileSize en Mo, minFileSize en Ko.

« Un fichier avec ce nom existe déjà. » — storage.replaceExisting est false. Activez-le, ou changez filenamePattern (ex. {timestamp}-{random}-{original}).

« Pas de miniature. » — Seules les images ont une miniature, et seulement si thumbnails.enabled est true.

Intégration bureau / mobile

• Windows / Linux / Mobile : suivez Windows, Linux, Mobile.
• Linux — pas d'URL renvoyée : fu a besoin de jq (sudo apt install jq).

Sécurité — à durcir avant exposition publique

Points relevés dans le code, à corriger si vous exposez l'instance :

• PUT /api/settings/domains/config n'a aucune vérification d'authentification.
• GET /api/api-keys renvoie les clés en clair (sk_…) à toute session connectée.
• POST/PUT /api/admin/users renvoient le hash du mot de passe dans la réponse.
• Les uploads d'archives (zip/rar) sont filtrés par la config mais pas par une permission de clé.
• La permission extractColors n'est pas réellement imposée (toute clé valide passe).

Déploiement

• Mises à jour auto : bun run deploy:cron via cron — voir Déploiement.
• Sauvegardes : uploads/, data/, config/.

Une question non couverte ? Ouvrez une issue : https://github.com/pedrokarim/sharex-manager/issues.