PiServer con docker – Parte 17: Instalación de Filegator.

Seguro que muchos de vosotros habréis usado servicios de terceros para subir archivos pesados a internet, como WeTransfer, Dropsend o TochoMail. En este artículo vamos a aprender a desplegar un contenedor de docker muy sencillo de instalar y de mantener que nos permitirá tener un servicio similar para nosotros solitos: vamos a abordar la instalación de Filegator.

Pues no lo entiendo. Yo he usado muchas veces servicios cómo los que nos comentas, pero a mi me funcionan muy bien. No entiendo por qué debería complicarme la vida instalando algo como ésto en mi raspberry. 

Pues podrías tener varios motivos. El primero y más evidente es que realizando la instalación de Filegator en tu propio servidor no vas a depender de un tercero para nada. El servicio de turno no te va a poner restricciones de ningún tipo, ni de tamaño de archivo ni de número de archivos que puedes subir cada día. Tampoco va a haber peligro de que el servicio cierre un día y te deje tirado, o que los archivos desaparezcan porque el servicio te los haya borrado por inactividad de la cuenta.

Pero para mi lo más importante es que con esta aplicación eres el dueño de tus propios archivos. No le estarás dando tus archivos a nadie, y nadie más que la persona a la que le mandes el enlace podrá verlos. La letra pequeña de sitios como WeTransfer es muy peligrosa y muchos servicios de este tipo se reservan el derecho a ver y usar los contenidos que estás publicando para los fines que ellos consideren oportuno.

Veeeeenga. Vale. Pero aún así, en el tutorial número 12 abordamos la instalación de Nextcloud, que es completamente capaz de hacer todo esto y muchísimo más. ¿Por qué habría de instalar Filegator, si ya puedo compartir archivos con Nextcloud?

Pues el motivo se resume en una palabra: Simplicidad. Efectivamente Nextcloud es una herramienta tremendamente potente y podemos hacer con ella muchísimas cosas más de las que podemos hacer con Filegator. Pero si queremos subir algo para que alguien se lo descargue en internet, en Nextcloud deberíamos poner el archivo en nuestra cuenta. Ese archivo se estaría sincronizando con la carpeta de nuestro escritorio todo el rato (Si lo quitamos, se dejaría de compartir). Y además las opciones de compartir son mucho más complejas (precisamente porque Nextcloud permite compartir archivos y carpetas de mil formas distintas).

Con Filegator sólo es subir el archivo y recoger el enlace. No tardas nada en hacerlo y el archivo queda subido a una ubicación que no te molesta (porque no se sincroniza con nada). Es ideal si lo único que quieres es un enlace para que una persona o grupo de personas se descarguen tus archivos de internet.

Si habéis seguido el resto de artículos que hemos ido poniendo sobre docker, seguro que la instalación de Filegator os va a parecer muy sencilla. Vamos a verla.

1- Creamos la estructura de carpetas en el directorio Dockers.

Como siempre, vamos a crear la estructura de carpetas que vamos a necesitar para que funcione este docker en particular. Si habéis seguido el resto de artículos, sabréis que estamos poniendo todos nuestros dockers en un directorio llamado «docker» que está en la carpeta de nuestro usuario, es decir, en esta ruta.

/home/<tu_usuario>/docker

Si no tenéis esa ruta creada, creadla con el comando mkdir docker. Lo que haremos es entrar en la carpeta docker y ahí crear una carpeta específica para este docker en particular (la llamaremos filegator). Dentro de ella, crearemos la única carpeta que necesita filegator para gestionar sus archivos y la llamaremos files. Todo esto lo haremos con los siguientes comandos:

cd docker
mkdir filegator
cd filegator
mkdir files
mkdir private

En otros dockers pasaríamos ya al siguiente punto, pero en este caso tenemos que hacer un pequeño ajuste a esa última carpeta. Este contenedor necesita que la carpeta files tenga permisos especiales (necesita que el usuario www-data sea el propietario de esa carpeta). Así que vamos a hacer esos cambios con el siguiente comando.

sudo chown www-data:www-data files

Este docker también requiere descargar un archivo de configuración a la carpeta «filegator». Se trata de un archivo de configuración que podréis descargar en la carpeta «filegator» con el siguiente comando.

wget https://github.com/causefx/filegator/raw/master/configuration.php

Por si ese archivo desaparece de ese enlace, os voy a proporcionar el archivo también en este enlace (Que está generado precisamente con Filegator. Así comprobáis que el servicio funciona correctamente).

Con esto sí que tenemos todo listo para pasar al siguiente punto.

2) Creamos el archivo de configuración de Docker Compose

Para realizar la instalación de Filegator usando docker, necesitamos crear en la carpeta Filegator un archivo llamado docker-compose.yml. Lo crearemos con el comando sudo nano docker-compose.yml y le pegaremos exactamente el siguiente contenido sin modificar nada.

version: '3.3'
services:
    filegator:
        container_name: filegator
        ports:
            - '5518:80'
            - '5517:8080'
        volumes:
            - $DOCKERDIR/filegator/files:/var/www/html/demorepo
            - $DOCKERDIR/filegator/configuration.php:/var/www/filegator/configuration.php
            - $DOCKERDIR/filegator/private:/var/www/filegator/private

        restart: always
        image: 'filegator/filegator:v7.9.2-multiarch'

Nota importante: Si en lugar de hacer la instalación en una raspberry la hacéis en un equipo X64, poned este otro contenido en su lugar:

version: '3.3'
services:
    filegator:
        container_name: filegator
        ports:
            - '5518:80'
            - '5517:8080'
        volumes:
            - $DOCKERDIR/filegator/files:/var/www/filegator/repository
            - $DOCKERDIR/filegator/configuration.php:/var/www/filegator/configuration.php
            - $DOCKERDIR/filegator/private:/var/www/filegator/private
        restart: always
        image: 'filegator/filegator:latest'

(y mis agradecimientos al usuario «Carlos» por darme en los comentarios del artículo indicaciones para añadir esta anotación)

Acordaos de teclear Control + O para guardar los cambios y luego Control + X para salir de nano.

3) Creamos el archivo de variables de entorno

Vamos a crear un archivo de variables de entorno al que vamos a llamar .env. Lo crearemos con el siguiente comando.

sudo nano .env

Dentro, le pondremos el siguiente contenido:

DOCKERDIR=/home/<tu_usuario>/docker

Antes de guardar cambios, fíjate que debes cambiar la ruta por la ruta correcta hacia la carpeta docker. Así que cambia eso de <tu_usuario> por el usuario que estás usando en Linux. Una vez hecho ésto, pulsa Control + O para guardar cambios y luego Control + X para salir del editor nano.

No te olvides que en todos estos tutoriales estamos protegiendo el archivo .env para que nadie con oscuras intenciones pueda modificarlo. Lo podemos proteger tecleando este comando en el terminal.

sudo chmod 600 .env

Llegados a este punto ya podemos comenzar, por fin, la instalación de Filegator.

4) Desplegamos la máquina: instalación de Filegator

Para realizar la instalación de Filegator, después de haber realizado los tres pasos anteriores, sólo tenemos que teclear este comando.

sudo docker-compose -p "filegator" up -d

Después de unos segundos, si hemos hecho todo bien, podremos acceder a nuestro Filegator usando como URL la ip de nuestra raspberry y el puerto 5517, de esta forma.

http://<ip.de.tu.raspberry>:5517

Perfecto. Pero esta web me pregunta por un usuario y contraseña que ni siquiera he definido. 

Efectivamente. Fijaos que durante la instalación de Filegator no hemos llegado a poner en ningún momento las credenciales. Filegator usa credenciales genéricas para el primer usuario. Puedes entrar en tu instalación poniendo lo siguiente:

Usuario: admin

Contraseña: admin123

Ni que decir tiene que nada más logarte en el interface, debes ir corriendo a la configuración de tu usuario para cambiar estas credenciales por otras. Es un riesgo de seguridad enorme dejar sin cambiar las credenciales que nos dan por defecto.

Ya que estamos, en la gestión de los usuarios, edita el usuario Guest (invitado) y habilita la opción para que cualquier invitado pueda descargar ficheros. Esto te va a permitir que otros descarguen las cosas que tú vas a colgar de tu Filegator.

5) Creamos un proxy para acceder desde fuera de nuestra red local.

En el artículo número 9 de esta serie explicamos cómo podríamos instalar un proxy para poder acceder a este tipo de aplicaciones desde fuera de nuestra red. De nuevo vamos a usar lo aprendido y crear un subdominio para este servicio. Si no lo hacemos va a ser imposible acceder a nuestra instalación de Filegator a través de internet.

Voy a suponer que me habéis hecho caso en el artículo número 9 y tenéis en vuestra red un Nginx Proxy Manager. Si es así, lo que debemos hacer es añadir un proxy pulsando el botón «hosts» y luego pulsando en «proxy Hosts».

Pulsaremos ahora arriba a la derecha el botón que dice Add Proxy Host.

Ahora cubrimos los siguientes datos:

• Domain names: ponemos un subdominio del dominio que tenemos contratado. Algo del tipo «filegator.midominio.com»
• scheme: http
• Forward Hostname / IP: ponemos la ip local del host dónde hemos hecho la instalación de Filegator.
• Forward Port: 5517

Con lo que acabamos de hacer, podremos acceder a Filegator por http, pero no por https, así que vamos a pulsar en los tres puntitos que hay al final de la línea del proxy que acabamos de configurar y luego pulsar sobre la opción «Edit».

En la pestaña «SSL» vamos a seleccionar la opción que dice «Request a new SSL Certificate» y a activar los botones «Force SSL» y «HTTP/2 Support». Luego guardamos cambios.

Con esto la instalación de Filegator ya debería funcionar sin problemas en la dirección web que has establecido al principio de este punto.

Ahora lo único que deberíais hacer para probarla es subir algún archivo y generar algún enlace. Luego poner el enlace en el navegador y comprobar que cualquiera desde internet puede acceder a él.

6) Actualización de nuestra instalación de Filegator.

Cada cierto tiempo es conveniente revisar si existe alguna actualización de los contenedores que tenemos instalados para evitar cualquier brecha de seguridad. Si éste es el único contenedor que tenemos, lo ideal es crear en alguna carpeta un archivo al que vamos a llamar actualizar.sh. Lo podemos crear así.

sudo nano actualizar.sh

Una vez que hayamos entrado en el editor de texto, le pondremos este contenido.

cd /home/usuario/docker/filegator
sudo docker-compose pull
sudo docker-compose up -d --remove-orphans
sudo docker image prune -f

Podemos guardar cambios con Control + O y saldremos del editor con Control + X. Sin embargo, tal cual está ahora no podríamos ejecutar ese archivo, así que lo hacemos ejecutable con este comando.

sudo chmod +x actualizar.sh

Ahora, cada vez que queramos comprobar si hay actualizaciones del contenedor, sólo tendremos que ir a la línea de comandos, situarnos dónde hemos dejado ese archivo y teclear lo siguiente:

sudo ./actualizar.sh

Esto comprobará si hay actualizaciones y en caso afirmativo las descargará y las aplicará.

Pero si lo que quieres es actualizar todos los contenedores de una vez, tendrás que hacer un script que actualice uno por uno todos los contenedores. Pero esta vez vamos a hacer el script de forma un poco más profesional respecto a lo que hemos hecho en los artículo anteriores.

Si habéis hecho todos los artículos de esta serie, deberíais tener un montón de contenedores funcionando y ya en el último artículo el script para actualizarlos todos se estaba haciendo un poco largo. Así que vamos a automatizar un poco el proceso.

En lugar de ir carpeta por carpeta diciéndole al script que actualice el contenedor que se indica en la carpeta, vamos a hacer un bucle para que el script recorra automáticamente todas las carpetas que hay dentro del directorio docker y si en alguna de esas carpetas hay un docker-compose, que lo actualice. Así que vamos a editar nuestro script con este comando

sudo nano actualizar.sh

Y vamos a cambiar el código que está dentro por este otro.

#!/bin/bash

# Actualizo el sistema operativo
sudo apt-get update -y
sudo apt-get dist-upgrade -y
sudo apt-get autoremove -y
sudo apt-get autoclean -y


# Definimos el directorio base
BASE_DIR="/home/<tu_usuario>/docker"

# Recorro todas las subcarpetas dentro del directorio base
for dir in $BASE_DIR/*; do
  if [ -d "$dir" ]; then
    echo "Procesando $dir ..."
    cd "$dir"
    sudo docker-compose pull
    sudo docker-compose up -d --remove-orphans
    sudo docker image prune -f
  fi
done

# Ya he actualizado todo. Ahora reinicio el sistema. 
sudo shutdown -r now

Acuérdate de cambiar la línea que pone BASE_DIR="/home/<tu_usuario>/docker". Debe poner la ruta correcta a la carpeta docker.

Tiene buena pinta, pero yo he hecho pruebas con algunos dockers y dentro del directorio docker tengo un par de carpetas con dockers que no estoy usando y no están activos. 

Entonces casi mejor usa el método que hemos indicado en los artículos anteriores. Si hay algún contenedor que por el motivo que sea está inactivo o no quieres que se actualice, o bien pones ese contenedor en otra carpeta que no sea la carpeta docker, o bien actualizas a mano, uno a uno, todos los contenedores (aunque sea dentro de un script para hacerlo todo a la vez) tal y como estábamos haciendo hasta ahora.

Ten en cuenta que este nuevo script va a actualizar e intentar levantar cualquier contenedor que esté dentro de la carpeta de dockers, así que si tienes algo que no debería estar en producción, mejor cámbialo de carpeta.

Y con esto hemos terminado la instalación de Filegator. Aunque se trata de un contenedor muy sencillo a mi me resulta especialmente útil. ¿Os ha resultado complicada la instalación? ¿Habéis tenido problemas con el nuevo script para actualizar todos los dockers? Estaré atento a vuestros comentarios.