n8n-nodes-sftp-tp

Nodo comunitario de n8n para subir archivos por SFTP a servidores SSH legacy.

Por qué existe

El nodo SFTP nativo de n8n (n8n-nodes-base.ftp) usa la librería ssh2 y no
expone ninguna configuración de algoritmos SSH. Contra el SFTP de TP
(mfxsftp.mfxservices.com) la conexión falla con:

Couldn't connect with these settings
read ECONNRESET

…aunque las mismas credenciales conectan bien desde FileZilla. La causa es que
el servidor sólo negocia algoritmos SSH antiguos que la librería ssh2
rechaza por defecto, y n8n no deja ajustarlos.

Este nodo hace lo mismo que el nativo (subir un archivo), pero expone los
algoritmos de negociación (KEX, host key, cipher, HMAC) y la cadena de
identificación del cliente. Por defecto agrega un set de algoritmos legacy,
así que funciona out-of-the-box contra servidores viejos.

Qué hace

• Operación única: subir un archivo binario de un item a una ruta remota.
• Reutiliza la credencial nativa de n8n tipo SFTP (no hay que crear una
  credencial nueva).
• Parámetros:
  • Propiedad Binaria — propiedad del item con el archivo (por defecto data).
  • Ruta Remota — ruta absoluta completa, incluido el nombre del archivo.
  • Opciones → Crear Directorios Faltantes — crea el directorio remoto si no existe.
  • Opciones SSH — listas de algoritmos a agregar (kex, serverHostKey,
    cipher, hmac), ident, readyTimeout, debug. Si no se tocan, se
    aplican valores legacy por defecto.

Publicar en npm

Para poder instalarlo desde la interfaz de n8n, el paquete tiene que estar en
el registro público de npm. El código del nodo no contiene secretos (las
credenciales viven en el almacén de credenciales de n8n, no en el código), así
que es seguro publicarlo público.

Vía GitHub Actions (recomendado)

El repo incluye el workflow .github/workflows/publish-n8n-nodes-sftp-tp.yml,
que publica el paquete en npm desde GitHub.

Setup (una sola vez):

1. Crear una cuenta en npmjs.com si no se tiene.
2. En npm: Access Tokens → Generate New Token → tipo Automation
   (el tipo Automation salta el 2FA, necesario para CI). Copiar el token.
3. En GitHub: repo Settings → Secrets and variables → Actions → New
   repository secret. Nombre: NPM_TOKEN. Valor: el token de npm.

⚠️ El token de npm es un secreto. Va sólo en el secret de GitHub, nunca
en el código, ni en el chat, ni en un archivo del repo.

Publicar:

1. Subir la versión en package.json (version). npm rechaza publicar dos
   veces la misma versión.
2. Disparar el workflow, por cualquiera de estas vías:
   • Manual: pestaña Actions del repo → workflow Publicar
     n8n-nodes-sftp-tp en npm → Run workflow.
   • Por tag: crear y pushear un tag n8n-nodes-sftp-tp-vX.Y.Z:

     git tag n8n-nodes-sftp-tp-v0.1.0
     git push origin n8n-nodes-sftp-tp-v0.1.0
     

El workflow compila el TypeScript y corre npm publish con el NPM_TOKEN.

Manual desde la terminal (alternativa)

cd flows/n8n/custom-nodes/n8n-nodes-sftp-tp
npm login                      # requiere cuenta npm
npm publish --access public    # prepublishOnly compila solo

El nombre n8n-nodes-sftp-tp está libre en npm al momento de escribir esto. Si
ya estuviera tomado, cambiar name en package.json (debe seguir empezando
con n8n-nodes-).

Instalar en n8n desde la interfaz (recomendado)

Una vez publicado en npm:

1. En n8n, ir a Settings → Community nodes.
2. Click en Install a community node.
3. En npm package name escribir: n8n-nodes-sftp-tp.
4. Aceptar el aviso de riesgo e Install.
5. El nodo SFTP TP Upload queda disponible en el panel de nodos.

Requiere que la instancia tenga los paquetes comunitarios habilitados
(N8N_COMMUNITY_PACKAGES_ENABLED=true, que es el valor por defecto).

Para actualizar a una versión nueva publicada en npm, usar el botón de
actualizar del paquete en esa misma pantalla.

Instalación manual (alternativa, sin publicar)

Si se prefiere no publicar en npm, se puede instalar el paquete compilado a
mano.

# 1. Build
cd flows/n8n/custom-nodes/n8n-nodes-sftp-tp
npm install
npm run build

# 2. Registrarlo en la carpeta de extensiones de n8n
mkdir -p ~/.n8n/custom
cd ~/.n8n/custom
npm init -y                                    # sólo la primera vez
npm install /ruta/absoluta/al/repo/flows/n8n/custom-nodes/n8n-nodes-sftp-tp

# 3. Reiniciar n8n

En Docker, ~/.n8n es un volumen montado (normalmente /home/node/.n8n); hay
que hacer el npm install contra esa ruta dentro del contenedor y reiniciarlo.

Uso

1. En el workflow, usar el nodo SFTP TP Upload.
2. Seleccionar la credencial SFTP existente (SFTP TP Lead-Status PROD).
3. Propiedad Binaria: data. Ruta Remota: la ruta absoluta del archivo.
4. Dejar Opciones SSH sin tocar (usa los algoritmos legacy por defecto). Si
   aún así no conecta, activar Debug SSH para ver la negociación en los logs
   de n8n y, si hace falta, probar el campo Ident.

Nota

Este nodo es un workaround mientras el servidor de TP no habilite algoritmos
SSH modernos. Si en algún momento lo hacen, se puede volver al nodo SFTP
nativo de n8n. Ver docs/integraciones/lead-status-tp-sftp.md.