secubox-openwrt/package/secubox/luci-app-metablogizer/README.fr.md

MetaBlogizer - Editeur de sites statiques

English | Francais | 中文

Hebergement de sites web statiques en un clic avec vhosts HAProxy automatiques, certificats SSL et synchronisation Gitea.

Fonctionnalites

Fonctionnalite	Description
Auto Vhost	Cree le vhost HAProxy + backend automatiquement
ACME SSL	Certificats Let's Encrypt automatiques
Sync Gitea	Pull depuis les depots Gitea
Upload fichiers	Glisser-deposer des fichiers
Statut sante	Surveillance DNS, certificat et publication
QR Codes	Partager des sites avec des QR codes

Demarrage rapide

Creer un site via LuCI

1. Aller dans Services -> MetaBlogizer
2. Cliquer sur + Nouveau site
3. Remplir :
   • Nom du site : myblog
   • Domaine : blog.example.com
   • Depot Gitea : user/repo (optionnel)
4. Cliquer sur Creer

Ce qui se passe automatiquement

+-----------------------------------------------------+
|  Creer le site "myblog" @ blog.example.com          |
+-----------------------------------------------------+
|  1. Creer /srv/metablogizer/sites/myblog/           |
|  2. Creer le backend HAProxy (metablog_myblog)      |
|  3. Creer le vhost HAProxy (blog.example.com)       |
|  4. Demander le certificat ACME                     |
|  5. Generer index.html par defaut                   |
|  6. Site en ligne a https://blog.example.com        |
+-----------------------------------------------------+

Tableau de bord

Panneau de statut d'hebergement Web

Le tableau de bord montre la sante en temps reel pour tous les sites :

Site	Domaine	DNS	IP resolue	Certificat	Statut
myblog	blog.example.com	ok	185.220.x.x	45j	publie
docs	docs.example.com	echec	-	manquant	en attente

Indicateurs de statut

Icone	Statut DNS	Signification
ok	DNS resout vers votre IP publique
prive	DNS pointe vers une IP privee (192.168.x.x)
discordance	DNS pointe vers une IP publique differente
echec	Echec de la resolution DNS

Icone	Statut certificat	Signification
ok	Certificat valide (30+ jours)
avertissement	Certificat expirant (7-30 jours)
critique	Certificat critique (<7 jours)
expire	Certificat expire
manquant	Pas de certificat

Icone	Statut publication	Signification
publie	Site active avec contenu
en attente	Site active, pas encore de contenu
brouillon	Site desactive

Gestion des fichiers

Uploader des fichiers

1. Cliquer sur Upload sur une carte de site
2. Glisser-deposer des fichiers ou cliquer pour parcourir
3. Cocher "Definir le premier HTML comme page d'accueil" pour utiliser comme index.html
4. Cliquer sur Upload

Gerer les fichiers

1. Cliquer sur Fichiers sur une carte de site
2. Voir tous les fichiers uploades
3. Definir n'importe quel fichier HTML comme page d'accueil
4. Supprimer des fichiers

Synchronisation Gitea

Configuration

1. Creer/editer un site
2. Entrer le depot Gitea : username/repo
3. Cliquer sur Sync pour pull le dernier contenu

Auto-Sync

Le site se synchronise depuis Gitea sur :

• Clic du bouton sync manuel
• Push webhook (si configure)

# Sync manuelle via CLI
ubus call luci.metablogizer sync_site '{"id":"site_myblog"}'

Partage et QR

Cliquer sur Partager sur n'importe quel site pour obtenir :

• Copier l'URL dans le presse-papiers
• QR code pour acces mobile
• Partage Twitter
• Partage LinkedIn
• Partage Facebook
• Partage Telegram
• Partage WhatsApp
• Partage Email

Configuration

Parametres UCI

# /etc/config/metablogizer

config metablogizer 'main'
    option enabled '1'
    option runtime 'auto'           # auto | uhttpd | nginx
    option sites_root '/srv/metablogizer/sites'
    option nginx_container 'nginx'
    option gitea_url 'http://192.168.255.1:3000'

config site 'site_myblog'
    option name 'myblog'
    option domain 'blog.example.com'
    option gitea_repo 'user/myblog'
    option ssl '1'
    option enabled '1'
    option description 'Mon blog personnel'
    option port '8901'
    option runtime 'uhttpd'

Modes d'execution

Mode	Description	Cas d'utilisation
uhttpd	Serveur web integre d'OpenWrt	Par defaut, leger
nginx	Nginx dans conteneur LXC	Fonctionnalites avancees
auto	Detection automatique du runtime disponible	Recommande

API RPCD

Gestion des sites

# Lister tous les sites
ubus call luci.metablogizer list_sites

# Creer un site
ubus call luci.metablogizer create_site '{
  "name": "myblog",
  "domain": "blog.example.com",
  "gitea_repo": "user/myblog",
  "ssl": "1",
  "description": "Mon blog"
}'

# Sync depuis Gitea
ubus call luci.metablogizer sync_site '{"id":"site_myblog"}'

# Supprimer un site
ubus call luci.metablogizer delete_site '{"id":"site_myblog"}'

Surveillance de sante

# Obtenir le statut d'hebergement pour tous les sites
ubus call luci.metablogizer get_hosting_status

# Reponse :
{
  "success": true,
  "public_ip": "185.220.101.12",
  "haproxy_status": "running",
  "sites": [{
    "id": "site_myblog",
    "name": "myblog",
    "domain": "blog.example.com",
    "dns_status": "ok",
    "dns_ip": "185.220.101.12",
    "cert_status": "ok",
    "cert_days": 45,
    "publish_status": "published"
  }]
}

# Verifier la sante d'un site
ubus call luci.metablogizer check_site_health '{"id":"site_myblog"}'

Operations sur les fichiers

# Lister les fichiers d'un site
ubus call luci.metablogizer list_files '{"id":"site_myblog"}'

# Uploader un fichier (contenu base64)
ubus call luci.metablogizer upload_file '{
  "id": "site_myblog",
  "filename": "style.css",
  "content": "Ym9keSB7IGJhY2tncm91bmQ6ICNmZmY7IH0="
}'

Emplacements des fichiers

Chemin	Description
/etc/config/metablogizer	Configuration UCI
/srv/metablogizer/sites/	Repertoires de contenu des sites
/srv/metablogizer/sites/<nom>/index.html	Page d'accueil du site
/usr/libexec/rpcd/luci.metablogizer	Backend RPCD

Depannage

Le site affiche 503

1. Verifier que HAProxy fonctionne : lxc-info -n haproxy
2. Verifier que le port du backend ecoute
3. Verifier l'instance uhttpd : uci show uhttpd | grep metablog

DNS ne resout pas

1. Verifier que l'enregistrement A pointe vers votre IP publique
2. Verifier avec : nslookup blog.example.com
3. Attendre la propagation DNS (jusqu'a 48h)

Certificat manquant

1. S'assurer que le DNS resout correctement d'abord
2. S'assurer que les ports 80/443 sont accessibles depuis Internet
3. Verifier les logs ACME : logread | grep acme

Echec de la sync Gitea

1. Verifier l'URL Gitea : uci get metablogizer.main.gitea_url
2. Verifier que le depot existe et est public
3. Tester manuellement : git clone http://192.168.255.1:3000/user/repo.git

Licence

MIT License - Copyright (C) 2025 CyberMind.fr