¿Alguna vez has deseado poder ejecutar comandos en tu sistema de manera remota y simplificar tareas repetitivas? Con Linux Commands API, ahora es posible. Esta aplicación web, desarrollada en Spring Boot, te permite gestionar y ejecutar comandos Linux de forma remota, generar códigos QR para compartirlos fácilmente y automatizar tareas comunes. Ya sea que seas un administrador de sistemas, un desarrollador o un entusiasta de Linux, esta herramienta te ayudará a ahorrar tiempo y esfuerzo.
¿Qué es Linux Commands API?
Linux Commands API es una aplicación diseñada para simplificar la gestión y ejecución de comandos Linux. Con esta herramienta, puedes:
- Crear, leer, actualizar y eliminar comandos desde una interfaz web intuitiva.
- Ejecutar comandos de manera remota a través de una API REST o enlaces generados dinámicamente.
- Generar códigos QR para cada comando, lo que facilita su ejecución desde dispositivos móviles.
- Automatizar tareas repetitivas activando o desactivando comandos según tus necesidades.
Esta aplicación es ideal para quienes necesitan ejecutar acciones en sus sistemas de manera rápida y eficiente, sin necesidad de acceder directamente a la terminal.
Características principales
1. Gestión de comandos (CRUD)
Puedes agregar, editar, eliminar y visualizar comandos Linux desde una interfaz web amigable. La aplicación está construida con Thymeleaf y Bootstrap, lo que la hace fácil de usar incluso para principiantes.
2. Ejecución remota de comandos
La aplicación te permite ejecutar comandos en tu sistema de manera remota. Simplemente accede a la URL generada para cada comando, y este se ejecutará en tu sistema. Esto es especialmente útil para administradores de sistemas que necesitan realizar tareas en máquinas remotas.
3. Generación de códigos QR
Cada comando tiene asociado un código QR que puedes escanear desde tu dispositivo móvil para ejecutarlo rápidamente. Esta funcionalidad es perfecta para compartir comandos con otros usuarios o para ejecutarlos desde diferentes dispositivos.
4. API REST para integración
La aplicación ofrece una API REST que te permite gestionar y ejecutar comandos programáticamente. Esto es ideal para integrar la funcionalidad de la aplicación en otros sistemas o scripts.
5. Activación/Desactivación de comandos
Puedes activar o desactivar comandos según tus necesidades. Esto te permite tener un mayor control sobre las tareas que están disponibles en tu sistema.
Tecnologías utilizadas
- Backend: Java 21, Spring Boot, Spring MVC, Spring Data JPA.
- Frontend: HTML5, CSS3, Bootstrap 5.3.3, Alpine.js.
- Base de datos: H2 (configurable con MySQL o PostgreSQL).
- Utilidades: Librería para generar códigos QR.
Instalación y configuración
Pasos para la instalación
-
Descarga el binario:
- Ve a la sección de Releases del repositorio.
-
Descomprime el archivo:
- Descomprime el archivo descargado en la ubicación que prefieras:
$ unzip linuxcommand-1.2202.2025-Linux -d ~/linuxcommand
- Haz que el binario sea ejecutable:
- Navega a la carpeta donde descomprimiste el archivo:
$ cd ~/linuxcommand
- Otorga permisos de ejecución al binario:
$ chmod +x linuxcommand
- Ejecuta la aplicación:
$ ./linuxcommand
- Accede a la aplicación:
- La aplicación se ejecuta en el puerto 10002. Asegúrate de que este puerto esté disponible en tu sistema.
https://localhost:10002/commands
Configuración de inicio automático (opcional)
Si deseas que la aplicación se inicie automáticamente al iniciar sesión en tu entorno gráfico, sigue estos pasos:
- Crea el directorio necesario:
- Si no existe, crea el directorio para los archivos de inicio automático:
$ mkdir -p ~/.config/autostart
- Crea un archivo de configuración:
- Edita o crea un archivo
.desktopen el directorio de inicio automático:
- Edita o crea un archivo
$ nano ~/.config/autostart/linuxcommand.desktop
- Añade el siguiente contenido:
[Desktop Entry]
Type=Application
Exec=/ruta/a/tu/linuxcommand/linuxcommand
X-GNOME-Autostart-enabled=true
Name=Linux Commands API
Comment=Aplicación API de comandos de Linux
- Reemplaza
/ruta/a/tu/linuxcommand/linuxcommandcon la ruta completa al ejecutable de la aplicación.
- Guarda y cierra el archivo:
- Guarda los cambios y cierra el editor. Ahora la aplicación se iniciará automáticamente al iniciar sesión.
Ventajas del Método de Configuración Automática
- Compatibilidad: No necesitas preocuparte por variables como
DISPLAYoXAUTHORITY, ya que el entorno gráfico las configura automáticamente. - Facilidad de Uso: Funciona en la mayoría de entornos gráficos como GNOME, KDE, XFCE, etc.
Con esto, tu aplicación se iniciará automáticamente cada vez que inicies sesión en tu entorno gráfico.
API REST
La aplicación ofrece una API REST con los siguientes endpoints:
- GET
/api/commands: Obtiene todos los comandos. - POST
/api/commands: Crea un nuevo comando. - PUT
/api/commands/{id}: Edita un comando existente. - DELETE
/api/commands/{id}: Elimina un comando. - GET
/api/commands/execute/{url}: Ejecuta un comando por su URL. - GET
/api/commands/{id}/qr: Obtiene el código QR de un comando.
¿Cómo usar Linux Commands API?
- Agrega un comando: Completa el formulario en la interfaz web para agregar un nuevo comando.
- Ejecuta un comando: Haz clic en la URL generada para ejecutar el comando o escanea el código QR desde tu dispositivo móvil.
- Gestiona comandos: Edita o elimina comandos según tus necesidades.
- Usa la API REST: Integra la funcionalidad de la aplicación en otros sistemas o scripts.
Capturas de pantalla y video demostrativo
Interfaz principal

La interfaz principal muestra una tabla con todos los comandos disponibles.
Ejecución de un comando

Haz clic en la URL para ejecutar el comando directamente.
Código QR

Escanea el código QR para ejecutar el comando desde otro dispositivo.
¿Por qué usar Linux Commands API?
- Ahorra tiempo: Ejecuta comandos de manera remota sin necesidad de acceder directamente a la terminal.
- Simplifica tareas: Automatiza tareas repetitivas y comparte comandos fácilmente.
- Fácil de usar: La interfaz web es intuitiva y no requiere conocimientos avanzados.
- Extensible: La API REST permite integrar la aplicación en otros sistemas.
¿Cómo contribuir o donar?
Si te gusta este proyecto y deseas apoyar su desarrollo, puedes hacerlo mediante donaciones en criptomonedas. Aquí tienes las direcciones:
- Bitcoin (BTC):
bc1qkpswywdqjht6zpfm694t2m6ewww3ukw25vlemu
- Osmosis (OSMO):
osmo1gcqmcc8xa4lgxflwfm4fcg2nh722dgmel9l54m
- Cosmos (ATOM):
cosmos1gcqmcc8xa4lgxflwfm4fcg2nh722dgmeh7vyrf
¡Todas las donaciones son bienvenidas y agradecidas!
Licencia
Este proyecto está licenciado bajo la Licencia Apache 2.0, lo que significa que puedes usarlo, modificarlo y distribuirlo libremente, siempre y cuando atribuyas el trabajo original al autor.
Conclusión
Linux Commands API es una herramienta poderosa que te permitirá ejecutar acciones remotas en tu sistema y simplificar tareas repetitivas. Ya sea que estés administrando servidores, desarrollando aplicaciones o simplemente explorando el mundo de Linux, esta aplicación te será de gran utilidad.
¡No dudes en probarla y compartir tus comentarios! Puedes encontrar más información y el código fuente en el repositorio de GitHub.
Autor: Cristian Escobedo
GitHub: Cristian-Esc
Licencia: Apache 2.0
¡Gracias por usar Linux Commands API! 🚀
Foto de Robert Katzki en Unsplash



Deja un comentario