Instalar Servidor FTP en Raspberry Pi 4 - vsftpd

En esta entrada quiero registra el paso a paso del proceso de instalar y configurar un Servidor FTP en una Raspberry Pi 4, esto lo hago porque hace parte de un proyecto personal que estoy desarrollando en donde requiero de un servidor FTP para cargar archivos.

Actualmente ya tengo una Raspberry Pi 4 configurada con una versión de Linux Ubuntu Server 22.04.2 LTS (64-bit), pueden consultar el paso a paso de este proceso en mi anterior entrada:

Instalar Ubuntu Server en Raspberry Pi 4

Luego de explorar documentación y otros blogs en internet, finalmente pude realizar una instalación y configuración exitosa en mi Raspberry Pi 4, en los primeros intentos estaba teniendo algunos problemas al momento de conectarme usando un Cliente FTP como FileZilla, por alguna razón, la autenticación era exitosa pero la conexión se quedaba haciendo múltiples intentos en listar el directorio del usuario autenticado, al final del proceso encontré la solución solo agregando un atributo en el archivo de configuración del Servidor vsftpd.

El objetivo de esta entrada es documentar el proceso de una configuración básica para un entorno de desarrollo, existen configuraciones adicionales que hay que agregar como una capa extra de seguridad en el caso de hacer una instalación y configuración en un entorno de producción.

No voy entrar en detalles sobre qué es FTP o SFTP, tampoco quiero entrar en detalles sobre los protocolos involucrados o capas de seguridad de encriptación de datos SSL. Creo que para obtener información detallada existe la documentación oficial, y no es relevante para el objetivo de esta entrada. Quiero compartir una guía rápida y práctica, lista para usar.

Cabe mencionar que los pasos a seguir en esta entrada también se pueden aplicar a una Raspberry Pi 3 y, en general, a una distribución Linux Ubuntu Server 22.04.2 LTS (64 bits).

Prerrequisitos:

• Raspberry Pi 4/3
• Linux Ubuntu Server 22.04.2 LTS (64-bit)

Paso 0: Actualizar Paquetes de Ubuntu Server

sudo apt update

sudo apt upgrade

Paso 1:  Instalar vsftpd

sudo apt install vsftpd

Cuando la instalación termine, lo primero que debemos hacer en el siguiente paso es realizar una copia del archivo de configuración de vsftpd antes de continuar con la configuración en los siguientes pasos.

Paso 2: Backup de vsftpd.conf

sudo cp /etc/vsftpd.conf /home/pi/Backup/vsftpd.conf

Paso 3: Habilitar el Firewall

Aquí debemos habilitar el Firewall y permitir las conexiones a los puertos correspondientes que usa el protocolo FTP, en este caso, las conexiones entrantes en los puertos 20, 21 y 990.

• Verficar el estado del Firewall:

sudo ufw status

Nos debe mostrar algo similar a esto:

Output

Status: active

To                         Action      From

--                         ------      ----

OpenSSH                    ALLOW       Anywhere

OpenSSH (v6)               ALLOW       Anywhere (v6)

• Abrir los puertos:

sudo ufw allow 20,21,990/tcp

• Abrir puertos en un rago para conexiones pasivas:

sudo ufw allow 40000:50000/tcp

• Verficar el estado del Firewall:

sudo ufw status

Nos debe mostrar algo similar a esto:

Output

Status: active

To                         Action      From

--                         ------      ----

OpenSSH                    ALLOW       Anywhere

20,21,990/tcp              ALLOW       Anywhere

40000:50000/tcp            ALLOW       Anywhere

OpenSSH (v6)               ALLOW       Anywhere (v6)

20,21,990/tcp (v6)         ALLOW       Anywhere (v6)

40000:50000/tcp (v6)       ALLOW       Anywhere (v6)

Paso 4: Crear Usuario FTP

En este paso, vamos a crear un usuario dedicado únicamente para tener acceso mediante FTP al servidor. Esa será la única función de este usuario, con un directorio dedicado y solo con acceso a dicho directorio. Estará aislado del resto del sistema.

• Crear Usuario:

sudo adduser ftpi

• Crear Directorio Aislado:

sudo mkdir /home/ftpi/public

• Modificar el propietario del directorio aislado:

sudo chown nobody:nogroup /home/ftpi/public

• Remover permisos de escritura sobre el directorio aislado:

sudo chmod a-w /home/ftpi/public

• Verificar permisos:

sudo ls -la /home/ftpi/public

Nos debe mostrar algo similar a esto:

Output

total 8

dr-xr-xr-x 2 nobody nogroup 4096 Nov 15 17:20 .

drwxr-x--- 3 ftpi ftpi  4096 Nov 15 17:20 ..

• Crear un directorio dedicado a la carga de archivos:

sudo mkdir /home/ftpi/public/uploads

• Asignar como propietario al usuario:

sudo chown ftpi:ftpi /home/ftpi/public/uploads

• Verificar permisos:

sudo ls -la /home/ftpi/public

Nos debe mostrar algo similar a esto:

Output

total 12

dr-xr-xr-x 3 nobody nogroup 4096 Nov 15 17:20 .

drwxr-x--- 3 ftpi ftpi  4096 Nov 15 17:20 ..

drwxr-xr-x 2 ftpi ftpi  4096 Sep 14 20:30 uploads

• Finalmente creamos un archivo de prueba en el directorio uploads:

echo "vsftpd test file" | sudo tee /home/ftpi/public/uploads/test.txt

Paso 5: Configurar Acceso FTP

Usar cualquier editor de texto, en este caso vamos a usar nano:

sudo nano /etc/vsftpd.conf

Cuando tenemos acceso al archivo de configuración desde nano, debemos buscar y modificar las siguientes variables, en caso de no existir alguna variable se crea como nueva al final del archivo:

anonymous_enable=NO

local_enable=YES

write_enable=YES

chroot_local_user=YES

user_sub_token=$USER

local_root=/home/$USER/public

pasv_enable=YES

pasv_min_port=40000

pasv_max_port=50000

userlist_enable=YES

userlist_file=/etc/vsftpd.userlist

userlist_deny=NO

• Finalmente agregar el usuario a: /etc/vsftpd.userlist

echo "ftpi" | sudo tee -a /etc/vsftpd.userlist

• Verificar el archivo /etc/vsftpd.userlist

cat /etc/vsftpd.userlist

Paso 6: Inhabilitar Acceso al Shell

Este paso es opcional si queremos bloquear el acceso al shell del usuario, de esta forma podemos bloquear el acceso al shell cuando el usuario se conecta por ssh, es una medida básica y simple de inhabilitar el acceso al shell de un usuario, mas no es la forma más segura.

• Crear un archivo script:

sudo nano /bin/ftponly

#!/bin/sh

echo "This account is limited to FTP access only."

• Agregar permisos de ejecucion al archivo:

sudo chmod a+x /bin/ftponly

• Abrir la lista de shell's validas:

sudo nano /etc/shells

• Agregar al final del archivo y guardar:

/bin/ftponly

• Actualizar el Shell del usuario:

sudo usermod ftpi -s /bin/ftponly

• Ahora cuando el usuario intente hacer un login mediante ssh:

ssh ftpi@your_server_ip

Obtendra el siguiente mensaje:

This account is limited to FTP access only.

Connection to 203.0.113.0 closed.

Paso 7: Probar el Acceso FTP con FileZilla

• Finalmente solo queda reiniciar el servicio vsftpd:

sudo service vsftpd restart

• Y desde una maquina externa probar el acceso FTP a nuestra Raspberry Pi 4 usando el programa FileZilla:

Usando los datos de acceso del Usuario FTP nos conectamos a nuestra Raspberry Pi 4:

Cuando la conexión sea exitosa podemos ver en el panel del sitio remoto el directorio de uploads donde podemos cargar y descargar archivos:

Dentro del directorio uploads podemos ver que existe el archivo de prueba que habíamos creado previamente durante la configuración:

Listo, con esto terminamos y verificamos que nuestro Servicio FTP está funcionando y listo para usar.

Para concluir, quiero mencionar nuevamente que el objetivo de esta guía es realizar una instalación básica en un entorno de desarrollo. Hay otras configuraciones adicionales que se deben considerar, especialmente en temas de seguridad, cuando se implementa en un entorno de producción. Sin embargo, para un servidor básico en casa o en un entorno de desarrollo donde la seguridad no es la prioridad principal, esta solución es adecuada.

Esto es todo lo que quería compartir en esta entrada. Espero poder publicar una próxima entrada lo más pronto posible.