Servidor Docker KF2

Servidor dedicado de Killing Floor 2 usando LinuxGSM con soporte SSH ejecutándose en Docker.

Características

• ✅ Servidor Dedicado Killing Floor 2 usando LinuxGSM
• ✅ Acceso SSH para gestión del servidor
• ✅ Puertos Configurables via variables de entorno

Inicio Rápido

1. Clonar el repositorio:

git clone https://github.com/lechuga16/Docker-KF2.git
cd Docker-KF2

2. Copiar y configurar variables de entorno:

cp example.env .env
# Editar .env con tu configuración

3. Iniciar el servidor:

docker compose up -d

4. Conectar via SSH para configurar:

ssh linuxgsm@localhost -p 22

Configuración

Variables de Entorno

Edita el archivo .env para personalizar:

Variable	Por Defecto	Descripción
LGSM_PASSWORD	-	Contraseña para el usuario linuxgsm
SSH_PORT	22	Puerto SSH para acceso al contenedor
SSH_KEY	-	Clave(s) pública(s) SSH para autenticación
KF2_GAME_PORT	7777	Puerto principal del juego (UDP)
KF2_QUERY_PORT	27015	Puerto Steam Master Server (UDP)
KF2_WEBADMIN_PORT	8080	Puerto del panel Web Admin (TCP)
KF2_STEAM_PORT	20560	Puerto de red Steam (UDP)
KF2_NTP_PORT	123	Puerto NTP para Weekly Outbreak (UDP)

Configuración del Servidor

Después de iniciar el contenedor, conecta via SSH y configura:

# Conectar al contenedor
ssh linuxgsm@localhost -p 22

# Instalar/Actualizar servidor KF2
./kf2server install

# Configurar ajustes del servidor
nano /data/config-lgsm/kf2server/kf2server.cfg

# Iniciar el servidor
./kf2server start

Archivos Docker Compose

Producción (docker-compose.yml)

Usa imagen precompilada del GitHub Container Registry:

docker compose up -d

Desarrollo (docker-compose.dev.yml)

Construye imagen localmente para desarrollo:

docker compose -f docker-compose.dev.yml up -d --build

Imágenes Disponibles

Tag	Descripción	Rama
latest	Última versión estable	main
develop	Build de desarrollo	develop
main	Build de rama main	main

Gestión del Servidor

Comandos Comunes de LinuxGSM

# Estado del servidor
./kf2server details

# Iniciar servidor
./kf2server start

# Detener servidor
./kf2server stop

# Reiniciar servidor
./kf2server restart

# Actualizar servidor
./kf2server update

# Monitorear servidor
./kf2server monitor

# Ver logs
./kf2server console

Acceso Web Admin

Accede al panel de administración web en: http://tu-ip-servidor:8080

Las credenciales por defecto se configuran en los archivos de configuración del servidor.

Puertos

Puerto	Protocolo	Descripción
7777	UDP	Puerto del Juego - Los jugadores se conectan aquí
27015	UDP	Puerto de Consulta - Steam Master Server
8080	TCP	Web Admin - Interfaz de gestión
20560	UDP	Puerto Steam - Red de Steam
123	UDP	Puerto NTP - Solo Weekly Outbreak
22	TCP	Puerto SSH - Acceso al contenedor

Volúmenes

• /data - Directorio de datos persistentes que contiene:
  • Archivos del servidor
  • Archivos de configuración
  • Archivos de guardado
  • Logs
  • Claves SSH

Solución de Problemas

El contenedor no inicia

Revisar los logs:

docker compose logs -f

No se puede conectar via SSH

Verificar configuración SSH:

# Verificar si el servicio SSH está ejecutándose
docker exec -it kf2-server service ssh status

# Verificar configuración SSH
docker exec -it kf2-server cat /etc/ssh/sshd_config

El servidor no aparece en el navegador

1. Verificar que los puertos estén correctamente reenviados
2. Verificar configuración del firewall
3. Asegurar que el puerto de consulta Steam sea accesible

Desarrollo

Construcción local

# Construir imagen de desarrollo
docker compose -f docker-compose.dev.yml build

# Ejecutar con construcción personalizada
docker compose -f docker-compose.dev.yml up -d

Contribuir

1. Hacer fork del repositorio
2. Crear una rama de característica desde develop
3. Hacer tus cambios
4. Enviar un pull request

Soporte

• Documentación LinuxGSM
• Wiki Killing Floor 2
• GitHub Issues

Licencia

Este proyecto está licenciado bajo la Licencia MIT - ver el archivo LICENSE para detalles.

Reconocimientos

• LinuxGSM - Linux Game Server Managers
• Tripwire Interactive - Desarrolladores de Killing Floor 2