ed: README

This commit is contained in:
jp.av.dev 2022-05-21 00:59:11 -04:00
parent 9901fc32f9
commit a373e66d29

View File

@ -1,3 +1,7 @@
+ POR HACER:
+ Reportes: pais - codigo - fecha
+ Generar Imagen: loc y codigo?
# iplocate # iplocate
## Gestión de logs *nginx* archivados ## Gestión de logs *nginx* archivados
@ -38,24 +42,28 @@ Crea base de datos ***SQLite3*** **`./ipinfo.db`** con tablas de **registro** y
`./iplocate.py -h` `./iplocate.py -h`
ej. alias `alias iploc='~/ruta/script/iplocate.py'` ej. alias `alias iploc='~/ruta/script/iplocate.py'`
```bash ```bash
ipLocate ipLocate
Consulta información sobre IP(s) disponibles en ipinfo.io con o sin token.
Carga logs de nginx en base de datos. Consulta con ipinfo.io y registra
en base de datos.
Consultas y reportes según información en la base de datos.
Uso: Consulta información sobre IP(s) disponibles en ipinfo.io con o sin token.
iploc <IP> - Consulta la información de <IP> disponible en ipinfo.io. Carga logs de nginx en base de datos. Consulta con ipinfo.io y registra
iploc -t <IP> - Consulta la info. de <IP> usando 'token' de ipinfo.io, en base de datos.
especificado en config.cfg. Consultas y reportes según información en la base de datos.
iploc -d <IP> - Consulta la información de <IP> disponible en base de datos.
iploc -f <archivo> - Consulta info. de las IPs en <archivo> (ipinfo.io). iploc -h - Muestra esta ayuda.
iploc -F <archivo> - Consulta info. de las IPs en <archivo> (token, ipinfo.io).
iploc -D <archivo> - Consulta info. de las IPs en <archivo> (base de datos). Uso para consultas:
iploc -c - Carga logs en base de datos. iploc <IP> - Consulta la información de <IP> disponible en ipinfo.io.
iploc -g - Guarda ipinfo de IPs sin registro en la BD. iploc -t <IP> - Consulta la info. de <IP> usando 'token' de ipinfo.io,
iploc -h - Muestra esta ayuda. especificado en config.cfg.
iploc --sync - Sincroniza logs del servidor (bash script). iploc -d <IP> - Consulta la información de <IP> disponible en base de datos.
iploc -f <archivo> - Consulta info. de las IPs en <archivo> (ipinfo.io).
iploc -F <archivo> - Consulta info. de las IPs en <archivo> (token, ipinfo.io).
iploc -D <archivo> - Consulta info. de las IPs en <archivo> (base de datos).
Operaciones base de datos:
iploc --sync - Sincroniza logs del servidor (bash script).
iploc -c - Carga logs en base de datos.
iploc -g - Guarda ipinfo de IPs sin registro en la BD.
``` ```
**`iploc --sync`** **`iploc --sync`**
@ -63,7 +71,7 @@ Realiza el proceso de copia de archivos del servidor, extracción y concatenado.
Explicado con detalle mas arriba. Explicado con detalle mas arriba.
**`iploc -c`** **`iploc -c`**
Poblar la tabla **visita** de la BD. Carga los registros en archivos de log en la tabla. Poblar tabla **visita** de la base de datos. Carga los registros en archivos de log en la tabla.
**`iploc -g`** **`iploc -g`**
Consulta a `ipinfo.io` por cada ip registrada en **visita** (una vez por ip). Consulta a `ipinfo.io` por cada ip registrada en **visita** (una vez por ip).
@ -71,25 +79,25 @@ Guarda los datos en tabla **registro**.
### Otras opciones ### Otras opciones
`iploc <IP>`: **`iploc <IP>`**
- Muestra la información sobre \<IP\> disponible en ipinfo.io. - Muestra la información sobre \<IP\> disponible en ipinfo.io.
`iploc -t <IP>`: **PENDIENTE** **`iploc -t <IP>`**
- Muestra la información sobre \<IP\> disponible en ipinfo.io - Muestra la información sobre \<IP\> disponible en ipinfo.io
usando el **token** especificado en `./config.cfg`. usando el **token** especificado en `./config.cfg`.
`iploc -d <IP>`: **PENDIENTE** **`iploc -d <IP>`**
- Muestra toda la información disponible en BD acerca de \<IP\> - Muestra toda la información disponible en BD acerca de \<IP\>
`iploc -f <archivo_IPs>`: **`iploc -f <archivo_IPs>`**
- Muestra la información disponible en ipinfo.io para cada \<IP\> - Muestra la información disponible en ipinfo.io para cada \<IP\>
en archivo pasado como argumento. en archivo pasado como argumento.
`iploc -D <archivo_IPs>`: **PENDIENTE** **`iploc -D <archivo_IPs>`**
- Muestra toda la información disponible en BD para cada \<IP\> - Muestra toda la información disponible en BD para cada \<IP\>
en archivo pasado como argumento. en archivo pasado como argumento.
ej. formato \<archivo_IPs\>. ej. formato `./archivo_IPs`.
``` ```
1.1.1.1 1.1.1.1
8.8.8.8 8.8.8.8
@ -154,21 +162,26 @@ Correr `iploc -h` para crear base de datos.
Seguir los pasos explicados en **Uso**. Seguir los pasos explicados en **Uso**.
### Requerimientos, dependencias ### Dependencias
<br>
Servidor: - Servidor:
- Bash >= 5.0 - Bash >= 5.0
- rsync - rsync
Local: <br>
- Bash local >= 5.1.16
- SQLite3 3.38.5 - Local:
- sqlitebrowser 3.35.5 (opc.) - Bash >= 5.1.16
- Python >= 3.10 - SQLite3 3.38.5
- requests - Python >= 3.10
- SQLAlchemy 1.4.32 - requests
- colorama - SQLAlchemy 1.4.32
- rich
Token API [ipinfo.io](https://ipinfo.io/) - sqlitebrowser 3.35.5 (opc.)
<br>
- *[Token](https://ipinfo.io/)*