Una guía interactiva, práctica y contenedorizada para el bastionado (hardening) y aseguramiento de servidores Linux en entornos de producción. Este repositorio no solo recopila las mejores prácticas de seguridad a nivel de kernel y de servidor web, sino que también proporciona herramientas automatizadas de auditoría y sirve una interfaz web (Wiki) totalmente optimizada para su consulta.
El proyecto How-To-Secure-A-Linux-Server es una plataforma de conocimiento y un conjunto de herramientas de automatización diseñadas para administradores de sistemas e ingenieros de seguridad. El repositorio está estructurado para cumplir una doble función:
- Base de Conocimiento Activa (Wiki): Una aplicación web estática (OpenWiki) construida sobre tecnologías modernas de frontend, que recopila guías detalladas sobre la configuración segura del Kernel de Linux, optimizaciones de red y securización de servidores web.
- Scripts de Auditoría y Control: Herramientas en bash para realizar auditorías de seguridad locales y verificar el estado de cumplimiento del servidor antes de su puesta en producción.
El proyecto utiliza un stack tecnológico moderno orientado al rendimiento, la seguridad y la consistencia en el desarrollo:
- Entorno de Ejecución y Servidor:
- Frontend (OpenWiki):
- Auditoría y Automatización:
- Bumblebee (por Perplexity AI): Motor de auditoría de seguridad integrado para análisis locales.
- Bash Scripting: Automatización de chequeos de conformidad de seguridad del sistema.
- Calidad de Código y Estilo:
La arquitectura de archivos del proyecto está organizada de la siguiente manera:
.
├── .env # Variables de entorno locales
├── .gitignore # Exclusiones de Git
├── .no-mistakes.yaml # Configuración del proxy de calidad para commits
├── AGENTS.md # Documentación de agentes de IA y automatizaciones
├── CONTRIBUTING.md # Directrices para contribuir al proyecto
├── Dockerfile # Construcción multi-stage de la aplicación Wiki
├── LICENSE # Licencia del proyecto
├── LICENSE.txt # Términos de licencia alternativos o de dependencias
├── SECURITY.md # Política de divulgación de vulnerabilidades
├── biome.json # Reglas de formato y calidad de Biome
├── lefthook.yml # Configuración de Git Hooks (pre-commit / pre-push)
├── linux-kernel-sysctl-hardening.md # Guía y configuración para el endurecimiento de sysctl en Linux
├── mem0.yaml # Configuración de persistencia/memoria para integraciones
├── nginx.conf # Configuración de producción de Nginx con foco en seguridad
├── nginx.md # Documentación específica de bastionado de Nginx
├── openwiki.stderr.log # Registro de errores del servicio OpenWiki
├── openwiki.stdout.log # Registro de salida estándar del servicio OpenWiki
├── scripts/
│ ├── security_audit.sh # Script de auditoría de seguridad local con Bumblebee
│ └── status.sh # Cuadro de mando (dashboard) de conformidad local
└── package.json (inferido) # Gestión de dependencias y scripts de construcción de la Wiki- Docker y Docker Compose instalados en el sistema.
- Para ejecutar las auditorías locales, se recomienda tener instalado Bash y la herramienta Bumblebee (opcional, el script la detectará automáticamente).
Para compilar la aplicación OpenWiki y servirla localmente a través del servidor Nginx seguro:
-
Construye la imagen de Docker localmente:
docker build -t how-to-secure-linux-wiki . -
Ejecuta el contenedor exponiendo el puerto seguro:
docker run -d -p 8080:80 --name secure-linux-wiki how-to-secure-linux-wiki
-
Accede a la interfaz web en tu navegador:
http://localhost:8080
Puedes analizar la seguridad de tu entorno local utilizando los scripts incorporados.
-
Auditoría de Seguridad (Bumblebee): Este script analiza las dependencias, configuraciones de red y posibles fugas de información.
chmod +x scripts/security_audit.sh ./scripts/security_audit.sh
-
Dashboard de Estado de Conformidad: Verifica el estado del repositorio frente a los estándares de calidad antes de realizar contribuciones:
chmod +x scripts/status.sh ./scripts/status.sh
Este repositorio cuenta con un estricto flujo de calidad e integración continua automatizado localmente para garantizar que ninguna configuración insegura o código defectuoso llegue a las ramas principales:
- Validación de Formato: El archivo
biome.jsondefine reglas estrictas para el código y la documentación. Estas validaciones son ejecutadas automáticamente por Lefthook antes de cada commit. - Git Proxy (no-mistakes): El archivo
.no-mistakes.yamlactúa como puerta de enlace local, interceptando los comandos de Git para evitar errores comunes de despliegue o la inclusión de secretos en el historial. - Auditorías continuas: Se promueve el uso del script
./scripts/security_audit.shcomo paso previo a cualquier solicitud de cambio (Pull Request).
Megacore - Automatizando y estandarizando la calidad del software en Megasoft.