parker/linklogger
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update docs

Browse Source
This commit is contained in:
Parker M. 2024-11-16 00:15:27 -06:00
parent e4fd674d6e
commit 4d69b23c90
Signed by: parker
GPG Key ID: 505ED36FC12B5D5E
1 changed files with 35 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

65
README.md
View File

@ -1,55 +1,60 @@
<h1 align="center"> <h1 align="center">LinkLogger</h1>
LinkLogger
</h1>
<h3 align="center"> <h3 align="center">Link Shortener and IP Logger</h3>
Link shortener and IP logger
</h3>
<p align="center"> <p align="center">
<a href="https://github.com/psf/black"> <a href="https://github.com/psf/black">
<img src="https://img.shields.io/badge/code%20style-black-000000.svg" alt="Code Style: Black"> <img src="https://img.shields.io/badge/code%20style-black-000000.svg" alt="Code Style: Black">
</a> </a>
<a href="https://makeapullrequest.com"> <a href="https://makeapullrequest.com">
<img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg"> <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs Welcome">
</a>
<a href="https://ghcr.io/packetparker/linklogger">
<img src="https://img.shields.io/docker/v/packetparker/linklogger?label=Docker" alt="Docker">
</a> </a>
</p> </p>
# Overview # Overview
### Create an account now at [link.pkrm.dev](https://link.pkrm.dev/signup)
<br> ### Create an account at [link.pkrm.dev/signup](https://link.pkrm.dev/signup)
LinkLogger is simple and public API to create redirect links and log IPs. Every visit to a registered short link will log the users IP address, location, user agent, browser, and OS before redirecting them to a specific URL. **LinkLogger** is an *extremely* simple and public link shortener and IP logger. Every visit to a registered short link will log the user's IP address, location, user agent, browser, and OS before redirecting them to a specific URL.
Just like Grabify, but unrestricted and with no real web UI. The API is built on **FastAPI**, and the UI is built with **React**.
*NOTE:* I am NOT a front-end dev, so don't expect much on that. 😅
Feel free to submit an issue for any problems you experience or if you have an idea for a new feature. If you have a fix for anything, feel free to submit a pull request for review. Feel free to submit an issue for any problems you experience or if you have an idea for a new feature. If you have a fix for anything, feel free to submit a pull request for review.
# API Reference **TL;DR:** LinkLogger is like Grabify, but unrestricted and with a rudimentary UI.
View the API reference and try out the endpoints at the [docs page](https://link.pkrm.dev/api/docs)
# Want to self-host? # API Reference
You can view the full **API reference** and try out the endpoints on the [docs page](https://link.pkrm.dev/docs).
# Want to Self-Host?
## Docker
Docker is the recommended method of hosting LinkLogger. Running on bare metal is recommended for development.
To run LinkLogger on Docker, check out the [docker-compose.yaml](docker-compose.yaml) file.
## Bare metal ## Bare metal
To run LinkLogger on bare metal, follow the steps below.
*NOTE: For information on each configuration variable, look at the `Configuration` section of this page.* If you want to work on the LinkLogger source, or just want to run the project on bare metal, follow the instructions below:
1. Install Python and Pip 1. Install python3 (preferably >3.10) & pip
2. Clone this repository 2. Install Node.js
3. Install the requirements with `pip install -r requirements.txt` 3. Install Yarn
4. Run the `linklogger.py` file 4. Install API dependencies (pip install -r requirements.txt)
5. Input information into the newly created `config.ini` file. 5. Run either [linklogger.sh](linklogger.sh) (Linux/MacOS) or [linklogger.bat](linklogger.bat) (Windows)
6. Re-run the `linklogger.py` file.
## Docker *NOTE: Running on bare metal means there is not an NGINX instance to serve the UI and proxy API requests to port 5252.*
To run LinkLogger in Docker, use the [docker-compose.yaml](/docker-compose.yaml) as a template for the contianer.
## Config ## Configuration
Below are all of the configuration variables that are used within LinkLogger.
Variable | Description | Requirement Below are all of the configuration variables that are used within the LinkLogger config.yaml file.
---|---|---
IP_TO_LOCATION | `BOOLEAN`: Whether or not you want toe IP to Location feature <br> *(requires IP2Location.io account)* | **Required** | **Variable** | **Description** | **Requirement** |
API_KEY | `KEY`: IP2Location.io API Key | **Required** *only if IP_TO_LOCATION is set to True* |---------------------|------------------|-----------------|
| `IP_TO_LOCATION` | `BOOLEAN`: Whether or not you want the IP-to-Location feature. *(requires IP2Location.io account)* | **Required** |
| `API_KEY` | `API KEY`: IP2Location.io API Key | **Required** (only if `IP_TO_LOCATION` is set to `True`) |