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

📝 MetaBlogizer - Static Site Publisher

One-click static website hosting with automatic HAProxy vhosts, SSL certificates, and Gitea sync.

✨ Features

Feature	Description
🌐 Auto Vhost	Creates HAProxy vhost + backend automatically
🔒 ACME SSL	Automatic Let's Encrypt certificates
📦 Gitea Sync	Pull from Gitea repositories
📤 File Upload	Drag & drop file uploads
📊 Health Status	DNS, certificate, and publish monitoring
🔗 QR Codes	Share sites with QR codes

🚀 Quick Start

Create a Site via LuCI

1. Go to Services → MetaBlogizer
2. Click + New Site
3. Fill in:
   • Site Name: myblog
   • Domain: blog.example.com
   • Gitea Repo: user/repo (optional)
4. Click Create

What Happens Automatically

┌─────────────────────────────────────────────────────┐
│  📝 Create Site "myblog" @ blog.example.com         │
├─────────────────────────────────────────────────────┤
│  1. 📁 Create /srv/metablogizer/sites/myblog/       │
│  2. 🌐 Create HAProxy backend (metablog_myblog)     │
│  3. 🔗 Create HAProxy vhost (blog.example.com)      │
│  4. 🔒 Request ACME certificate                     │
│  5. 📄 Generate default index.html                  │
│  6. ✅ Site live at https://blog.example.com        │
└─────────────────────────────────────────────────────┘

📊 Dashboard

Web Hosting Status Panel

The dashboard shows real-time health for all sites:

Site	Domain	DNS	Resolved IP	Certificate	Status
myblog	blog.example.com	🌐 ok	185.220.x.x	🔒 45d	✅ published
docs	docs.example.com	❌ failed	-	⚪ missing	🕐 pending

Status Indicators

Icon	DNS Status	Meaning
🌐	ok	DNS resolves to your public IP
⚠️	private	DNS points to private IP (192.168.x.x)
❗	mismatch	DNS points to different public IP
❌	failed	DNS resolution failed

Icon	Cert Status	Meaning
🔒	ok	Certificate valid (30+ days)
⚠️	warning	Certificate expiring (7-30 days)
🔴	critical	Certificate critical (<7 days)
💀	expired	Certificate expired
⚪	missing	No certificate

Icon	Publish Status	Meaning
✅	published	Site enabled with content
🕐	pending	Site enabled, no content yet
📝	draft	Site disabled

📁 File Management

Upload Files

1. Click Upload on a site card
2. Drag & drop files or click to browse
3. Check "Set first HTML as homepage" to use as index.html
4. Click Upload

Manage Files

1. Click Files on a site card
2. View all uploaded files
3. 🏠 Set any HTML file as homepage
4. 🗑️ Delete files

🔄 Gitea Sync

Setup

1. Create/edit a site
2. Enter Gitea repository: username/repo
3. Click Sync to pull latest

Auto-Sync

The site syncs from Gitea on:

• Manual sync button click
• Webhook push (if configured)

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

📤 Share & QR

Click Share on any site to get:

• 📋 Copy URL to clipboard
• 📱 QR code for mobile access
• 🐦 Twitter share
• 💼 LinkedIn share
• 📘 Facebook share
• ✈️ Telegram share
• 📱 WhatsApp share
• ✉️ Email share

🔧 Configuration

UCI Settings

# /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 'My personal blog'
    option port '8901'
    option runtime 'uhttpd'

Runtime Modes

Mode	Description	Use Case
uhttpd	OpenWrt's built-in web server	Default, lightweight
nginx	Nginx in LXC container	Advanced features
auto	Auto-detect available runtime	Recommended

📡 RPCD API

Site Management

# List all sites
ubus call luci.metablogizer list_sites

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

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

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

Health Monitoring

# Get hosting status for all sites
ubus call luci.metablogizer get_hosting_status

# Response:
{
  "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"
  }]
}

# Check single site health
ubus call luci.metablogizer check_site_health '{"id":"site_myblog"}'

File Operations

# List files in site
ubus call luci.metablogizer list_files '{"id":"site_myblog"}'

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

📁 File Locations

Path	Description
/etc/config/metablogizer	UCI configuration
/srv/metablogizer/sites/	Site content directories
/srv/metablogizer/sites/<name>/index.html	Site homepage
/usr/libexec/rpcd/luci.metablogizer	RPCD backend

🛠️ Troubleshooting

Site Shows 503

1. Check HAProxy is running: lxc-info -n haproxy
2. Check backend port is listening
3. Verify uhttpd instance: uci show uhttpd | grep metablog

DNS Not Resolving

1. Verify A record points to your public IP
2. Check with: nslookup blog.example.com
3. Wait for DNS propagation (up to 48h)

Certificate Missing

1. Ensure DNS resolves correctly first
2. Ensure ports 80/443 accessible from internet
3. Check ACME logs: logread | grep acme

Gitea Sync Fails

1. Verify Gitea URL: uci get metablogizer.main.gitea_url
2. Check repository exists and is public
3. Test manually: git clone http://192.168.255.1:3000/user/repo.git

📜 License

MIT License - Copyright (C) 2025 CyberMind.fr