MailAD Admin Panel

Panel de administración web para MailAD, escrito en Node.js, Express y EJS.

Descripción

Este proyecto proporciona una interfaz web para administrar configuraciones y usuarios de MailAD, un sistema de correo conectado a Active Directory mediante Postfix. Está construido utilizando tecnologías modernas de JavaScript:

• Node.js: Entorno de ejecución del servidor
• Express: Framework web para Node.js
• EJS: Motor de plantillas para renderizar vistas
• Express EJS Layouts: Soporte para layouts y templates

Características principales

• Interfaz web intuitiva para gestión de usuarios y grupos
• Configuración de Postfix mediante interfaz gráfica
• Integración con LDAP/Active Directory
• Panel de administración seguro con autenticación
• Logs detallados y sistema de notificaciones

Requisitos del sistema

• Node.js 18 o superior
• npm 9 o superior
• MailAD instalado y configurado

Screenshot

Login

Panel de control

Instalación

1. Clona el repositorio dentro de la carpeta en la deceas instalar ej: ```/opt:

   cd /opt
   git clone https://github.com/cz9dev/mailad-admin.git
   cd /mailad-admin

2. Instala dependencias:

   npm install

3. Configura las variables de entorno:

   Crea un archivo .env basado en .env.example y configura los valores necesarios.

4. Inicia el servidor:

   npm start

Actualización

Suponiendo que tienes el servidor mondato en pm2

1. Detener el servidor

   pm2 stop 0 # Si el id del la aplicacion node es 0, para ver el id de la aplicación debe anteriormente hacer un pm2 status

2. Acceder al directorio del mailad-admin:

   cd /opt/mailad-admin

3. Actualizar desde github:

   git pull

4. Actualizar dependencias:

   npm update

5. Inicia el servidor:

   pm2 start 0 #id de la aplicacion node

Estructura del proyecto

mailad-admin/
├── controllers/          # Controladores de la aplicación
├── postfix/              # Configuraciones relacionadas con Postfix
├── utils/                # Utilidades y helpers
├── views/                # Plantillas EJS
├── .env                  # Variables de entorno
├── .gitignore            # Archivos ignorados por Git
├── app.js                # Punto de entrada de la aplicación
├── package.json          # Dependencias y scripts del proyecto
└── README.md             # Este archivo

Credenciales para entorno de desarrollo

En un entorno de desarrollo las credenciales por defecto son las siguientes:

• usuario: admin
• password: admin123

Si usted decea pasar a un entorno en producción cambie en su archivo .env lo siguiente:

# NODE_ENV=development
NODE_ENV=production

Una ves cambiado a un entorno de producción solo podrá autenticar contra AD, con los usuarios que tenga dentro del grupo LDAP_ADMIN_GROUP que esta declarado en el archivo .env

Sistema de logs

├── logger.js (winston) → logs/app.log
│ ├── Errores técnicos
│ ├── Debug de aplicación
│ └── Info del servidor
│
└── Log.js (SQLite) → database.sqlite
├── Acciones de usuarios
├── Auditoría de cambios
└── Logs de negocio (interfaz web)

Licencia

Este proyecto está licenciado bajo MIT License - ver el archivo LICENSE para más detalles.