Traducción automática – aún no revisada por un hablante nativo.
Conexiones SSH y SFTP
Conecta Paralake.AI a servidores Linux y hosts con SSH (beta desde 0.1.1): prepara el servidor, añade una conexión y confirma la clave del host, qué puede hacer el agente y qué te pregunta, despliegue con vista previa y reversión, staging frente a producción y copias de seguridad.
Capítulos
- 00:00 Conexiones SSH y SFTP (beta)
- 00:40 Prepara tu servidor
- 01:30 Añade una conexión y confirma la clave del host
- 02:40 Qué puede hacer el agente y qué te pregunta
- 03:30 Desplegar, previsualizar y revertir
- 04:40 Staging, producción y copias de seguridad
Guion / transcripción
Paralake.AI puede trabajar con archivos y comandos en servidores Linux y otros hosts a través de SSH y SFTP. Está en beta desde la versión 0.1.1.
Empieza por el servidor: usa inicio de sesión con clave, crea un usuario aparte que solo tenga acceso a las carpetas que necesita el sitio o el servidor, y anota la huella de la clave del host del servidor.
En la app, abre Connections y haz clic en New connection. Elige SSH para archivos y comandos, o SFTP solo para archivos. Introduce el host, el puerto y el usuario, elige el entorno —Development, Staging o Production— y la carpeta raíz. La IA nunca sale de esa carpeta. Elige los permisos e inicia sesión con una clave SSH o una contraseña. La clave se guarda cifrada en este ordenador y nunca se envía a paralake.ai ni al modelo de IA.
Haz clic en Save and test. La primera vez, Paralake.AI muestra la huella de la clave del host del servidor. Compárala con la del servidor y solo entonces haz clic en Trust key and connect.
El agente puede listar y leer archivos dentro de la carpeta raíz. Escribir un archivo, ejecutar un comando, desplegar y revertir siempre piden tu aprobación, y los comandos peligrosos están bloqueados.
Para desplegar, haz clic en Deploy, elige la carpeta local y la carpeta del servidor, y haz clic en Preview. Verás qué archivos son nuevos o han cambiado. En producción, escribes el nombre de host del servidor para confirmar. Primero se hace una copia de seguridad de los originales en el servidor, se verifica cada archivo y puedes revertir el despliegue.
Está en beta: pruébalo en staging antes que en producción y mantén tus propias copias de seguridad.
Requisitos previos
- Paralake.AI instalado y con la sesión iniciada.
- Un servidor o host que ofrezca SSH o SFTP, y un usuario con el que tengas permiso para conectarte.
- Preferiblemente un par de claves creado para este fin (la clave privada se queda en tu ordenador).
- Una copia de seguridad probada de los archivos y las bases de datos del servidor.
-
Beta desde la versión 0.1.1
Beta. Las conexiones SSH y SFTP —explorar, leer y escribir archivos, comandos aprobados y la comprobación de la clave del host— están disponibles desde la versión 0.1.1. Desplegar, previsualizar y revertir por SSH/SFTP también están en beta.
Todavía no se ha verificado ningún despliegue en producción de un cliente. Prueba todo primero en un servidor de staging, mantén tus propias copias de seguridad e informa de cualquier cosa inesperada a help@paralake.ai.
-
Qué significan los tipos de acceso
Acceso Qué es Notas SSH Un terminal remoto cifrado más acceso a archivos En Paralake.AI: archivos y comandos SFTP Transferencia de archivos por SSH En Paralake.AI: solo archivos, sin comandos FTPS FTP con cifrado TLS No es compatible como conexión de Paralake.AI; usa un cliente FTP FTP Transferencia de archivos sin cifrar Evítalo: las contraseñas y los archivos viajan en texto plano Inicio de sesión con clave Inicias sesión con un par de claves; la clave privada se queda en tu ordenador Más seguro que las contraseñas -
Prepara tu servidor
- Usa autenticación con clave. Crea una clave dedicada para Paralake.AI para poder revocarla por separado.
- Crea un usuario aparte con acceso solo a las carpetas del sitio o del servidor, no
root. - Si puedes, desactiva el inicio de sesión directo como root y el inicio de sesión con contraseña cuando funcione el de clave.
- Anota la huella de la clave del host del servidor, por ejemplo con el comando de abajo en el servidor, o desde el panel de control de tu proveedor.
- Conoce tus rutas (raíz web, carpeta de FXServer) y cómo se reinician los servicios.
ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub -
Añade la conexión
- Abre Connections en la barra lateral y haz clic en New connection.
- Name: algo que reconozcas, como Staging web.
- Type: SSH (archivos + comandos) o SFTP (solo archivos).
- Host, Port (normalmente
22) y User. - Environment: Development, Staging o Production. Production añade advertencias y confirmaciones adicionales.
- Root folder on the server (carpeta raíz en el servidor): la IA nunca sale de ella. Elige la carpeta del sitio o del servidor, no
/. - Permissions: Read files siempre está activado. Marca Write files (with backup) y, para SSH, Run commands solo si los necesitas.
- Sign-in: SSH key (recomendado) o Password. Pega la clave privada o la contraseña solo en este campo del formulario de conexión, nunca en el chat.
- Haz clic en Save and test.
La clave o la contraseña se guarda cifrada en este ordenador (Windows DPAPI) y nunca se envía a paralake.ai ni al modelo de IA.
-
Confirma la clave del host
La primera vez que te conectas, Paralake.AI muestra New server – confirm the host key con la huella del servidor.
- Compárala con la huella del paso 3.
- Solo si coincide, haz clic en Trust key and connect. Si no, haz clic en Cancel.
Si más adelante ves WARNING: the host key has changed, puede que el servidor se haya reinstalado, o que alguien esté intentando interceptar la conexión. Confía en la nueva clave solo si sabes por qué ha cambiado.
Tras una prueba correcta, la conexión muestra su clave del host, las capacidades medidas (lectura, escritura, comandos) y un botón Browse para los archivos dentro de la carpeta raíz.
-
Qué puede hacer el agente y qué te pregunta
Acción Qué ocurre Listar y leer archivos dentro de la carpeta raíz Sin preguntar Escribir un archivo Pregunta cada vez. Comprueba que el archivo no ha cambiado desde que se leyó, hace una copia de seguridad y verifica el resultado Ejecutar un comando (SSH con Run commands) Pregunta cada vez. Los comandos peligrosos (formatear, elevar privilegios, apagar, descargar y ejecutar y similares) están bloqueados y nunca se pueden aprobar Desplegar o revertir Pregunta cada vez y nunca se puede permitir siempre En una conexión Production, las escrituras y los comandos se marcan como producción en la tarjeta de aprobación. Cada operación indica a qué conexión se aplica, y todo lo que hace la IA en el servidor queda registrado en el Security log en Settings.
-
Desplegar, previsualizar y revertir (beta)
El botón Deploy aparece cuando la conexión tiene el permiso Write files.
- Haz clic en Deploy.
- Introduce la carpeta local del proyecto (por ejemplo
web/site) y la carpeta del servidor, relativa a la carpeta raíz. - Haz clic en Preview. Verás cada archivo nuevo y modificado; los archivos sin cambios se omiten.
- En una conexión Production, escribe el nombre de host del servidor para confirmar el destino.
- Haz clic en Deploy … file(s).
Antes de sobrescribir nada, se hace una copia de seguridad de los originales en el servidor en
.paralake-backups, y cada archivo se verifica tras subirlo. Obtienes un Deploy ID, y Roll back this deployment restaura los archivos modificados y elimina los nuevos..git,node_modules,.envy las claves nunca se incluyen.Si el agente inicia un despliegue por su cuenta, primero muestra el destino y la lista de archivos en una tarjeta de aprobación.
-
Staging frente a producción
- Staging es una copia de tu sitio o servidor donde pruebas los cambios. Nadie depende de ella.
- Production es lo que usan tus jugadores o clientes.
Configura una conexión Staging aparte, despliega allí primero, comprueba el resultado y solo entonces despliega en Production. Para FiveM, un servidor de desarrollo aparte (otro puerto y otra base de datos) es tu staging. Para sitios web, un subdominio como
staging.example.comcon su propia base de datos funciona bien. -
Copias de seguridad
Antes de cualquier trabajo remoto, ya lo hagas tú, un compañero o una IA:
- Haz una copia de seguridad completa de los archivos y las bases de datos, y confirma que puedes restaurarla.
- Usa la función de instantáneas/copias de seguridad de tu proveedor o servidor si está disponible.
- Guarda al menos una copia fuera del servidor.
Las copias de
.paralake-backupssolo cubren los archivos que sobrescribió un despliegue, y los puntos de restauración de Paralake.AI solo cubren los archivos de tu ordenador. Ninguno sustituye a una copia de seguridad completa del servidor.
Seguridad
- Nunca pegues contraseñas, claves privadas, tokens de API ni credenciales del panel en el chat de Paralake.AI ni en un ticket de soporte. Las claves y contraseñas solo van en el formulario de conexión, donde se guardan cifradas en tu ordenador.
- Usa una clave dedicada y un usuario limitado, no root. Revoca la clave en el servidor si pierdes un ordenador.
- Haz clic en Trust key and connect solo cuando la huella coincida con la del servidor.
- Elige una carpeta raíz acotada y solo los permisos que necesites.
- Deploy está en beta: prueba primero en staging y mantén tus propias copias de seguridad.
Solución de problemas
Save and test falla
Causas probables: Host, puerto o usuario incorrectos. · El servidor solo acepta claves, o la clave no está en el authorized_keys del usuario. · La carpeta raíz no existe o el usuario no puede leerla.
- Comprueba el host, el puerto y el usuario con tu proveedor, y prueba el mismo inicio de sesión con tu cliente SSH o SFTP habitual.
- Comprueba que la clave pública está instalada para ese usuario en el servidor.
- Comprueba la ruta de la carpeta raíz y sus permisos.
Contacta con soporte si: El mismo inicio de sesión funciona en otro cliente SSH/SFTP pero falla en Paralake.AI; incluye el texto del error, nunca la clave. Soporte
WARNING: the host key has changed
Causas probables: El servidor se ha reinstalado o trasladado. · Puede que alguien esté intentando interceptar la conexión.
- Haz clic en Cancel y pregunta a tu proveedor o al administrador del servidor si la clave ha cambiado.
- Haz clic en Trust key and connect solo después de confirmar la nueva huella.
No hay botón Deploy, o el agente no puede escribir
Causas probables: La conexión no tiene el permiso Write files. · El usuario no tiene acceso de escritura a la carpeta raíz en el servidor.
- Haz clic en Edit en la conexión y marca Write files (with backup).
- Revisa las capacidades medidas tras Save and test; corrige los permisos de las carpetas en el servidor si la escritura aparece como no disponible.
No se pueden ejecutar comandos en el servidor
Causas probables: El tipo de conexión es SFTP, que solo da acceso a archivos. · Run commands no está marcado. · El comando está bloqueado porque se clasifica como peligroso.
- Usa el tipo SSH y marca Run commands si necesitas comandos.
- Para comandos bloqueados, pide al agente una alternativa más segura, o ejecútalo tú mismo tras revisarlo con cuidado.
Contacta con soporte si: Se bloquea un comando normal e inofensivo. Soporte
Un despliegue ha salido mal
Causas probables: Carpeta local o del servidor incorrecta. · El sitio necesita un paso de compilación o un cambio en la base de datos que no se hizo.
- Haz clic en Roll back this deployment (o pide al agente que revierta usando el Deploy ID).
- Revisa las carpetas en Preview antes de volver a desplegar, y prueba primero en staging.
Contacta con soporte si: Roll back falla; incluye el Deploy ID y el texto del error. Soporte
FAQ
¿Puedo iniciar sesión con una contraseña?
Sí, Password es una opción. Una clave SSH con un usuario limitado es la opción más segura.
¿Tendrá el agente acceso root?
Tú decides con qué usuario se conecta y qué carpeta raíz puede usar. Usa un usuario limitado y una carpeta acotada.
¿Dónde se guarda mi clave?
Cifrada en tu ordenador con Windows DPAPI. Nunca se envía a paralake.ai ni al modelo de IA. Al eliminar la conexión se borra la clave guardada del ordenador.
¿Es seguro desplegar en producción?
Deploy está en beta y todavía no se ha verificado ningún despliegue en producción de un cliente. Despliega primero en staging, comprueba el resultado y mantén tus propias copias de seguridad.