Acceso SFTP al servidor de juegos: gestionar archivos

SFTP es la forma práctica de gestionar los archivos de tu servidor de juegos fuera del panel: editar configuraciones, subir plugins o mods, guardar logs y descargar mundos. Solo necesitas un cliente adecuado, las credenciales del dashboard y algo de cuidado al sobrescribir archivos importantes.

Qué aporta SFTP en un servidor de juegos

SFTP significa SSH File Transfer Protocol y transfiere archivos mediante una conexión cifrada. Para servidores de juegos es especialmente útil porque no tienes que hacer cada cambio mediante un gestor de archivos en el navegador. Las carpetas grandes, muchos archivos de plugins o backups locales suelen gestionarse de forma más clara con un cliente de escritorio.

Es importante diferenciarlo: SFTP no es lo mismo que el FTP clásico. Si tu cliente ofrece varios protocolos, selecciona expresamente SFTP. FileZilla menciona SFTP como protocolo compatible en la documentación oficial; WinSCP se describe oficialmente como cliente para transferencias de archivos, entre otras cosas mediante SFTP. Por eso usa las descargas oficiales y evita instaladores no oficiales de terceros.

Requisitos

Necesitas un servidor de juegos activo, acceso a tu dashboard de game-serverhosting y un cliente SFTP en tu ordenador. Además, antes de cambios arriesgados deberías crear un backup o al menos descargar localmente los archivos afectados. Esto vale especialmente para mundos, bases de datos, configuraciones de servidor y carpetas de plugins.

Si vienes de otro proveedor, la guía Migrar un servidor de juegos: de cualquier proveedor de hosting a game-serverhosting te ayuda con el orden de backup, subida y comprobación. Para extensiones específicas de Minecraft, la guía Instalar y gestionar plugins de Minecraft: Spigot/Paper en el panel complementa los pasos SFTP con detalles de plugins.

Instalar un cliente SFTP

En Windows, WinSCP suele ser cómodo porque la interfaz, la integración con editor y la sincronización están claramente separadas. FileZilla es multiplataforma y funciona bien si quieres trabajar de forma parecida en Windows, macOS o Linux. Cyberduck también es una opción si prefieres una interfaz sencilla.

Establecer la conexión

Abre tu cliente SFTP y crea una nueva conexión. Encontrarás los valores en el dashboard de tu servidor. No los envíes a terceros mediante captura de pantalla y guarda contraseñas solo en dispositivos en los que confíes.

Después haz clic en conectar. En la primera conexión, tu cliente puede preguntar por una clave de host. Comprueba que te conectas al host correcto y confirma la clave solo si los datos del servidor coinciden. Después, el cliente suele mostrar dos áreas: a la izquierda tus archivos locales, a la derecha los archivos del servidor de juegos.

Estructura típica de carpetas

La estructura exacta depende del juego y del tipo de servidor usado. Muchos setups se orientan a un directorio de contenedor como este:

/home/container/
├── server.properties     # Configuración del servidor
├── plugins/              # Plugins (Paper/Spigot)
├── mods/                 # Mods (Forge/Fabric)
├── world/                # Mundo del juego
├── logs/                 # Logs del servidor
└── backups/              # Backups

Edita los archivos de forma lo más específica posible. Descarga primero un archivo de configuración, modifícalo localmente en un editor adecuado y súbelo de nuevo después. Asegúrate de no cambiar extensiones de archivo. Por ejemplo, server.properties no debe convertirse por accidente en server.properties.txt.

Tareas frecuentes

• Editar config: Descargar archivo → editar → subir
• Instalar plugins: Subir el JAR a /plugins/
• Descargar backups: Descargar la carpeta /world/
• Revisar logs: Descargar latest.log

En plugins o mods deberías comprobar la versión del servidor, loader y dependencias antes de subir archivos. Un plugin de Paper normalmente va en /plugins/, un mod de Forge o Fabric en /mods/. Tras la subida suele ser necesario reiniciar para que el servidor cargue el nuevo archivo.

Para backups de mundos se recomienda un proceso claro: detener el servidor, descargar la carpeta del mundo, nombrar la copia local de forma útil y solo después hacer cambios grandes. Si el servidor escribe activamente durante la copia, un backup puede quedar incompleto o inconsistente.

Comprobar el resultado

Después de un cambio, comprueba primero si la subida se completó por completo. Muchos clientes SFTP muestran transferencias fallidas en una cola o pestaña de errores. Después reinicia el servidor de juegos si hace falta y revisa los logs. En Minecraft, latest.log suele ser el primer punto de revisión; en otros juegos hay archivos de log propios en el directorio correspondiente del servidor.

Luego prueba en el juego o en el panel si el cambio está realmente activo. Un archivo subido por sí solo no significa que el servidor lo haya leído. Lo decisivo es si el arranque termina sin errores y si la función deseada es visible.

Consejos para trabajar de forma limpia

• Drag & Drop: Transferir archivos fácilmente con Drag & Drop
• Doble clic: Abrir archivos directamente en el editor
• Sincronizar: Algunos clientes ofrecen sincronización de carpetas
• Auth con clave: SSH-Keys en lugar de contraseña para más seguridad

Aun así, trabaja de forma controlada: la sincronización puede transferir errores locales rápidamente al servidor. Si reemplazas muchos archivos, revisa antes la carpeta de destino y la dirección de la sincronización. En archivos de configuración, una copia local antes de cada cambio tiene sentido.

Solución de problemas

Si la conexión falla, revisa primero protocolo, host, puerto, usuario y contraseña. Un error frecuente es seleccionar FTP en lugar de SFTP por accidente o introducir mal el puerto. El puerto estándar usado en muchos setups de Pterodactyl es 2022; lo determinante son siempre los valores de tu dashboard.

Si la subida se interrumpe, la conexión local puede ser inestable o puede faltar la carpeta de destino. Repite la transferencia y fíjate si tu cliente ha subido un archivo solo parcialmente. En caso de duda, elimina el archivo de destino incompleto y súbelo de nuevo.

Si el servidor no arranca después de un cambio, vuelve a subir el último archivo funcional o elimina el último plugin subido o el mod. Después revisa los logs. Para trabajo básico de terminal alrededor de archivos de servidor también te ayuda la guía Comandos de Linux para servidores de juegos: los comandos de terminal más importantes.

Comprobación, límites y vuelta atrás segura

La guía “Acceso SFTP al servidor de juegos: gestionar archivos” se aplica al tipo de servidor descrito en el artículo y al estado de versión visible en el momento de la comprobación. Los nombres de menús, versiones disponibles, compatibilidad de mods o plugins y recursos necesarios pueden cambiar después de actualizaciones. Por eso no transfieras valores sin comprobarlos a otra versión de juego, loader o servidor.

Antes de hacer cambios en el mundo, partida, configuración o extensiones, crea una copia de seguridad de los archivos afectados. Después cambia solo un paso relacionado y compruébalo con la misma versión de cliente y servidor con la que quieras jugar más tarde.

Una prueba individual correcta no es una garantía de rendimiento ni de disponibilidad. El tamaño del mundo, mods, plugins, número de jugadores, ruta de red y carga simultánea pueden cambiar el resultado. Documenta versión, cambio y resultado de la prueba para poder entender desviaciones posteriores.

FAQ

¿SFTP es más seguro que FTP?

Sí, SFTP transfiere archivos mediante una conexión cifrada. Aun así, es importante que protejas las credenciales, uses solo clientes de confianza y no guardes contraseñas en dispositivos compartidos.

¿Qué cliente SFTP debería usar?

Usa el cliente con el que puedas trabajar de forma fiable. FileZilla es multiplataforma, WinSCP es muy popular en Windows, Cyberduck funciona en macOS y Windows. Descarga el cliente directamente desde la web oficial.

¿Tengo que detener el servidor de juegos antes de cada subida?

No con cada archivo. Para logs o descargas sencillas normalmente no hace falta. En carpetas de mundos, bases de datos, mods, plugins o configuraciones centrales, detener o reiniciar tiene sentido según el cambio para que no se escriban archivos al mismo tiempo.

¿Por qué no veo mi cambio subido en el juego?

Las posibles causas son un reinicio pendiente, una carpeta de destino incorrecta, una versión de plugin o mod incompatible o un error en la configuración. Revisa primero la subida, luego los logs del servidor y después la ruta exacta.

¿Puedo descargar backups completos por SFTP?

Sí, puedes descargar carpetas como /world/ o directorios de backup existentes. Para backups consistentes de mundos deberías detener antes el servidor o usar la función de backup de tu panel si está disponible para tu servidor.