Afegir un nou menú desplegable a OpenWRT LUCI

Traducció de l’original en anglès. Llegeix-lo en: CastellanoEnglish

OpenWRT, el popular sistema operatiu Linux de codi obert dissenyat per a dispositius incrustats, ofereix la interfície LUCI per a una configuració i gestió senzilles. LUCI és, essencialment, la interfície web d'OpenWRT i, tot i que ja és molt completa, de vegades potser vols ampliar-ne les funcionalitats segons les teves necessitats.

Recentment, vaig tenir la necessitat de millorar la meva interfície OpenWRT LUCI. Concretament, volia introduir un nou menú anomenat "Apps" al tauler de LUCI. L'objectiu era que cada entrada d'aquest nou menú enllacés amb diferents aplicacions instal·lades al dispositiu. I no només això! Volia que aquestes pàgines d'aplicacions s'obrissin en pestanyes noves per facilitar-hi l'accés.

La solució

Els canvis es van fer en un sol fitxer situat a:

/usr/lib/lua/luci/controller/apps.lua

Dins d'aquest fitxer, vaig implementar el codi següent:

module("luci.controller.apps", package.seeall)

function index()
    local page

    page = entry({"admin", "apps"}, firstchild(), _("Apps"), 60)
    page.dependent = false

    entry({"admin", "apps", "portainer"}, call("serve_js_redirect", "https", "9443"), _("Portainer"), 10).leaf = true
    entry({"admin", "apps", "nodered"}, call("serve_js_redirect", "http", "1880"), _("NodeRED"), 20).leaf = true
    entry({"admin", "apps", "grafana"}, call("serve_js_redirect", "http", "3000"), _("Grafana"), 30).leaf = true
    entry({"admin", "apps", "prometheus"}, call("serve_js_redirect", "http", "9090"), _("Prometheus"), 40).leaf = true
end

function serve_js_redirect(protocol, port)
    local ip = luci.http.getenv("SERVER_ADDR")
    local url = protocol .. "://" .. ip .. ":" .. port
    luci.http.prepare_content("text/html; charset=utf-8")
    luci.http.write("<!DOCTYPE html><html><head><meta charset='UTF-8'><title>Redirecting...</title></head><body>")
    luci.http.write("<script type='text/javascript'>")
    luci.http.write("window.onload = function() {")
    luci.http.write("  var newWindow = window.open('".. url .."', '_blank');")
    luci.http.write("  if (!newWindow || newWindow.closed || typeof newWindow.closed == 'undefined') {")
    luci.http.write("    document.getElementById('manualLink').style.display = 'block';")
    luci.http.write("    setTimeout(function() { window.location.href = document.referrer; }, 60000);")  -- Redirigir después de 60 segundos
    luci.http.write("  }")
    luci.http.write("}")
    luci.http.write("</script>")
    luci.http.write("<p id='manualLink' style='display: none;'>The window didn't open automatically. <a href='".. url .."' target='_blank'>Click here</a> to open manually.</p>")
    luci.http.write("</body></html>")
end

Punts clau

  • La funció index s'encarrega de definir el nou menú i les seves entrades.

  • La funció serve_js_redirect crea una pàgina web que utilitza JavaScript per obrir automàticament l'aplicació desitjada en una pestanya nova del navegador.

  • S'afegeix un mecanisme de seguretat en forma d'enllaç. Si, per qualsevol motiu (com ara els bloquejadors de finestres emergents), la pestanya nova no s'obre automàticament, l'usuari té l'opció de fer clic manualment en un enllaç per obrir l'aplicació.

  • L'script també inclou una funcionalitat que redirigirà l'usuari de tornada a la pàgina anterior al cap de 60 segons si la pestanya nova no s'obre.

Aquesta modificació ofereix una manera fluida d'integrar aplicacions externes directament a la interfície LUCI, fent que la navegació i la gestió siguin encara més còmodes!