###### tags: `manuales`, `apc`, `es`
LibreRouter (español)
===
[toc]
# 1 - Resumen
## 1.1 - Cómo instalar LibreMesh (versión LibreRouter) en mi enrutador?
Los equipos LibreRouter usan su propia versión de LibreMesh, la cual también se puede instalar en cualquier enrutador compatible con versiones anteriores de LibreMesh (consulte la lista de hardware actualizado).
Para instalar LibreMesh en un LibreRouter o en cualquier otro equipamiento compatible, los pasos son los siguientes:
[[[Para instalar o LibreMesh do LibreRouter e um hardware de LibreRouter ou qualquer outro equipamento compatível, siga os passos a seguir(NO ME QUEDA CLARO QUE DICE LA ORACION, REVISAR TRADUCCION):]]]
### 1.1.1 - Identificar el fabricante y modelo del equipo.
En primer lugar, identifique cuál es el principal fabricante y el modelo del equipo. Si ya es LibreRouter o LibreMesh, puede identificarse con el siguiente comando:
[[[Antes de tudo, identifique qual o principal fabricante e modelo do equipamento. Se vocẽ já librerouter ou libremesh, você pode identificar com o seguinte comando:CORREGIR LibreRouter y LibreMesh EN VERSION ORIGINAL]]]
`ssh root@nodo 'jsonfilter -e @.model.id < /etc/board.json'`
### 1.1.2 - Obtenga el código del LibreRouter y genere el firmware para instalar
Puede crear un firmware con sus configuraciones utilizando el código fuente, siguiendo los pasos en
[[[Pegue o código do LibreRouter... QUE SERIA CODIGO DE LIBREROUTER?]]] e gere o firmware para instalar
Você pode criar um firmware com suas configurações através do código-fonte, seguindo os passos em [Compilando Firmware](#Compilando-Firmware)
### 1.1.3 - Actualice el firmware en el enrutador
Después de compilar el firmware con la configuración necesaria, necesita ***flasharlo*** en su dispositivo, siguiendo los pasos en [Flash Firmware](#Flash-Firmware)
## 1.2 - ¿Cómo hago mi primera configuración?
Después de conectarse a la red por cable o wifi, puede acceder a la configuración del sistema de dos maneras: por LimeApp o por SSH. En ambos casos, si no conoce la IP del equipo o el nombre de host al que está conectado, puede usar la dirección **thisnode.info**
* ### LimeApp web access
1. Access the address http://thisnode.info/app in your browser
* ### SSH command terminal access
1. Access the terminal `ssh root@thisnode.info`
Para obtener más detalles sobre cómo realizar la primera configuración de red y cómo usar las otras funciones, siga las instrucciones en
[Primeiros Passos] y en [Explorando LimeApp].
## 1.3 ¿Cuál es la contraseña para acceder al enrutador?
No hay contraseña predeterminada. Debe agregar una contraseña al crear el firmware o agregar claves SSH para un acceso remoto más seguro.
---
# 2 - Compilando Firmware
## 2.1 - Instale las dependencias
### 2.1.1 - Para Debian y Ubuntu
1. **Update:** Ejecute para actualizar la lista de paquetes disponibles
:~# `apt update`
2. **Install:** Ejecute para bajar e instalar los paquetes de dependencias
Para Debian 9.x/10.x:
:~# `apt install git gcc g++ binutils bzip2 flex python perl make grep diffutils unzip gawk opt subversion time libz-dev zlibc linux-headers-amd64 ncurses-base libghc-ncurses-dev`
Para ubuntu 18.x:
:~# `apt install git gcc g++ binutils bzip2 flex python perl make grep diffutils unzip gawk opt subversion time libz-dev zlibc linux-headers-generic ncurses-base libghc-ncurses-dev`
### 2.1.2 - Clone Repository
1. **Clone repository:** Ejecute para clonar el repositorio principal de Librerouter
[[[Run to clone the main repository of LibreRouter ESTA EN INGLES]]]
:~$ `git clone https://github.com/LibreRouterOrg/openwrt.git`
2. **Enter directory:** Ejecute para ingresar al directorio de trabajo
[[[Run to enter the work directory ESTA EN INGLES]]]
:~$ `cd openwrt`
### 2.1.3 - Descargar paquetes de OpenWRT [[[Download OpenWRT packages EN INGLES]]]
Debe descargar todos los paquetes de los repositorios incluidos en su configuración para poder compilarlos en el proceso de creación de su firmware.
1. **Update:** Ejecute para obtener la lista más reciente de paquetes definidos en feeds.conf.default
:~/openwrt$ `./scripts/feeds update -a`
2. **Install:** Ejecutar para instalar enlaces simbólicos a todos los paquetes obtenidos y almacenados en package/feeds/
:~/openwrt$ `./scripts/feeds install -a`
3. **Config:** Ejecute para crear el archivo de configuración a partir del template
:~/openwrt$ `cp configs/default_config .config`
## 2.2 - Hacer la configuración
Antes de generar su firmware, puede cambiar o agregar algunas configuraciones. Algunas de las configuraciones posibles son:
### 2.2.1 - Configurando el script de inicialización
files/etc/uci-defaults
### 2.2.2 - Configurando Pirania (Portal Cautivo)
1. Acceda al archivo de configuración de Pirania con el comando `vi /etc/config/pirania` y cambie las siguientes líneas:
de:
`enabled: "0"`
para:
`enabled: "1"`
de:
`db_patch='/etc/pirania/db.csv'`
para [[[to EN INGLES]]]]:
`db_patch='/tmp/db.csv'`
2. Cree un archivo en files/etc/uci-defaults/enable-pirania con el siguiente contenido:
```
#!/bin/sh
uci set piranha.base_config.enabled=1
uci set piranha.base_config.db_patch='/tmp/db.csv'
uci commit
/etc/init.d/pirania enable
captive-portal start
```
y modifique el ejecutable con el comando:
`chmod +x files/etc/uci-defaults/enable-pirania`
### 2.2.3 - Configurar post-script lime-config
Para ejecutar comandos después del proceso de lime-config, ingréselo en file/etc/hotplug.d/lime-config/
### 2.2.4 - Configurar claves SSH
Para realizar el acceso remoto a través de SSH de forma segura, sin la necesidad de usar una contraseña cada vez, debe generar y agregar las claves deseadas en el firmware antes de compilarlo. Para hacer esto, debe generar un par de claves ssh en su computadora y agregar el archivo `authorized_keys` a`files/etc/dropbear`.
1. ** Generando par de claves SSH **
Para generar el par de claves ssh, use los siguientes comandos en su computadora, indicando dónde se almacenará la clave (o manténgala en el directorio predeterminado ~./ssh) y una frase de contraseña que debe repetirse para su confirmación:
:~/openwrt$ `ssh-keygen`
2. ** Insertar las llaves **
Para agregarlo allí, debe colocar el contenido del archivo `authorized_keys` en `file/etc/dropbear`
:~/openwrt$ `mkdir -p file/etc/dropbear/`
:~/openwrt$ `cat ~/.ssh/id_rsa.pub >> file/etc/dropbear/authorized_keys`
## 2.3 - Administrar el firmware
Ejecute los siguientes comandos para generar su firmware.
[[[Rode o comando os seguintes comandos para gerar o seu firmware. SOBRA OS COMANDOS?]]]
1. Edite la configuración para generar el firmware. Es muy importante seleccionar correctamente el dispositivo para el que desea crear una imagen del firmware. Después de elegir las opciones en el menú con las flechas del teclado, elija ***Exit**. Luego, cuando se le pregunte si desea guardar, seleccione **Yes**.
[[[A principal opção que deve ficar atento é selecionar corretamente para qual dispositivo quer gerar a imagem do firmware. Depois de escolher as opções no menu com as setas do teclado, escolha ***Exit** e **Yes** quando for perguntado se você deseja salvar. EDITE ESTA REDACCION, ME PARECE POCO CLARA]]]
:~/openwrt$ `make menuconfig`
> Obs: Menuconfig necesita que la ventana del terminal esté maximizada para funcionar correctamente.
2. Ejecute el comando `make` para iniciar el processo de compilación. El processo puede demorar algunas horas, durante las que debe mantener la ocmputadora conectada a internet para poder descargar las dependencias.
:~/openwrt$ `make`
Las imagenes de firmware generadas serán guardadas en: `bin/targets/ar71xx/generic`
# 3 - Flash Firmware
## 3.1 - Conseguir el firmware [[[EN LA REDACCION EN PORTUGES, SE DEJA DE USAR EL INFINITIVO PARA LOS TITULOS DE LOS PASOS, COMENTARIO SOBRE COHERENCIA GRAMATICAL]]]
Si compiló su firmware, la imagen se puede encontrar en bin/targets/ar71xx/generic/openwrt-ar71xx-generic- \<model> -squashfs-sysupgrade.bin where \<model>.
## 3.2 - Acceder al enrutador
Si el enrutador funciona y tiene otra versión de LibreMesh, ya sea por cable o wifi, podemos acceder a él a través de la dirección `thisnode.info`.
> ATENCIÓN: verifique que la conectividad se haya dado con el nodo sobre el que desea trabajar, y no con otro cercano. Para esto, se puede corroborar la red a la que se conecta el equipo. Cada nodo publica dos redes, una exclusiva y otra compartida con el resto de los nodos. La diferencia está en que la red exclusiva del nodo, tiene el nombre del nodo incluido en su nombre de red.
> Si desea acceder a otro nodo que no sea el que está conectando directamente a través de Wi-Fi o cable, debe conocer su nombre de host (nombre de nodo) o su IP. (En este caso, NO usar thisnode.info).
>
[[[> > > ATENÇÃO: verifique se [[[estamos conectados LENGUAJE NO INCLUSIVO]]] a este nó, e não a outro próximo, para isso, conectando-nos ao ponto de acesso do nó e não ao ponto de acesso da rede. O ponto de acesso é a rede wifi publicada pelo nó. cada nó publica duas redes, uma exclusiva e outra compartilhada com o restante dos nós. Eles diferem porque o único possui o nome do nó em seu nome de rede. REDACCION POCO CLARA]]]
## 3.3 Copiar la imagen del firmware al ruteador
`scp (imagen de firmware) root@(host de nodo destino):/tmp`
## 3.4 Actualizar el firmware
```
sh root@(nombre de nodo)
sysupgrade /tmp/(imagen de firmware) (un router normal)
safe-upgrade /tmp/(imagen de firmware); reboot (librerouter)
`
# 4 - Primeros pasos en LibreMesh (FirstBootWizard)

## 4.1 - Configurar una nueva red
Si está configurando el primer nodo que formará la red, seleccione configurar una nueva red.
### 4.1.1 - Crear una nueva red
Haga clic en el botón "Create new network" para comenzar a configurar la nueva red.
! [] (https://i.imgur.com/Tuw2LUd.png)
### 4.1.2 - Elija un nombre
En el campo "Choose a name for your network", ingrese el nombre de su red. En el campo "Choose a name for your node", ingrese el nombre que desea para este nodo. Luego haga clic en "Create network" para finalizar.

### 4.1.3 - Configurar red
Espere a que se apliquen las configuraciones y se reinicie el equipo.
> Si se conecta a través de wifi, la conexión debe desconectarse después de unos segundos.

### 4.1.4 - Comprobar conexión
Después de unos momentos, el sistema intentará verificar la conexión al equipo con la nueva configuración.
> Si no está conectado por cable, asegúrese de conectarse a la nueva red antes de que expire el límite de tiempo para este paso.

### 4.1.5 - Felicitaciones
Si todo el proceso de configuración de la nueva red es exitoso, recibirá un mensaje de Congratulations" (Felicitaciones).

## 4.2 - Agregar a una red existente
Si se está agregando este nodo a una red mesh pre-existente, se debe indicar a qué red se unirá el nodo.
### 4.2.1 - Escanear red
Hacer clic en el botón "Buscar red existente" para agregar este nodo a una red existente.

### 4.2.2 - Ingresar la malla
En el campo "Select a network to join", seleccionar la red de malla a la que se desea agregar este nodo. Luego hacer clic en el botón "Set Network" para aplicar.


### 4.2.3 - Configuración de red
Espere a que se apliquen las configuraciones y se reinicie el equipo.
> Si se conecta a través de wifi, la conexión debe desconectarse después de unos segundos.

### 4.2.4 - Comprobación de la conexión
Después de unos momentos, el sistema intentará verificar la conexión al equipo con la nueva configuración.
> Si no está conectado por cable, asegúrese de conectarse a la nueva red antes de que expire el límite de tiempo para este paso.

### 4.2.5 - Felicitaciones
Si todo el proceso de configuración de la nueva red es exitoso, recibirá un mensaje de Congratulations" (Felicitaciones).
# 5 - Explorando las características de LiMeApp [[[CORREGI EL NOMBRE LiMeApp]]]
LiMeApp es el nombre de la aplicación para administrar las últimas versiones de LibreMesh y se ha desarrollado para reemplazar a LuCi, que es la aplicación estándar para versiones anteriores.
En el menú que encuentra en la esquina superior derecha puede encontrar las siguientes opciones:

## 5.1 - Estado
En esta pantalla es posible tener la información de estado principal del nodo:
1. **Most Active:** informa la MAC Address y la calidad de la señal en el siguiente nodo conectado más activo.
2. **Sistem - Uptime:** le informa cuánto tiempo ha estado activo desde su último inicio.
3. **Internet connection:** informa el estado de la conexión para IPv4, IPv6 y DNS.
4. **IP Address:** informa las direcciones IP para las interfaces activas.

## 5.2 - Alineación
En la opción "Alinear", es posible probar la alineación de la antena entre el nodo actual y cualquier otro nodo accesible de la red.
> Los valores de alineación deben estar entre -55 y -75 para garantizar una buena calidad en la red. Cuanto más cerca de -55, mejor.

## 5.3 - Métrica
En la opción "Métricas", es posible encontrar algunas opciones de métricas para usar la red e Internet.
> Esta opción aún está en desarrollo

## 5.4 - Config
En "Config", puede cambiar la configuración de red de cualquiera de los nodos en la red. Simplemente seleccione el nodo y haga clic en "Cambiar", accederá a la misma pantalla de configuración descrita en la sección [Elija un nombre] (#2.1.2-Elija-un-nombre) [[[ESTO ES UN HIPERVINCULO?]]]

## 5.5 - Administración
En la opción "Admin" puede cambiar el nombre del nodo y la IP del equipo. Para hacer esto, debe ingresar la contraseña de administrador.
> La contraseña de administrador predeterminada es 'admin'

