Link shortener in Rust. https://s.42l.fr/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Neil 955d78b0bd v2.1.2: reduce database locks, see #1 7 months ago
assets version 2.0.0, initial commit 7 months ago
db Don't delete the db folder; don't push blacklists 1 year ago
migrations version 2.0.0, initial commit 7 months ago
screenshots version 2.0.0, initial commit 7 months ago
src v2.1.2: reduce database locks, see #1 7 months ago
templates error in phishing template 7 months ago
.gitignore version 2.0.0, initial commit 7 months ago
Cargo.toml v2.1.2: reduce database locks, see #1 7 months ago
LICENSE Initial commit, version 1.0.0 1 year ago
README.md Removing try blocks to compile on Rust stable 7 months ago
config.toml.sample adding config_version for real 7 months ago
lang.json now using hoster_name in templates 7 months ago
url_from_blacklist.txt version 2.0.0, initial commit 7 months ago
url_to_blacklist.txt version 2.0.0, initial commit 7 months ago

README.md

rs-short

Warning: A few steps are necessary to migrate the database from rs-short 1.x.x. Please check the release notes for details.

Link shortener in Rust.

Developed to be as minimalist and lightweight as possible.

Powered by the Actix framework using (server-side) Askama templates.

  • Around 1000 lines of code, including 20% of comments
  • Consumes between 5MB and 20MB of RAM
  • No JS
  • No CSS framework ; CSS is handmade and all rules are prefixed to avoid rule conflicts
  • No tracking features at all, user IPs are not saved in database
  • No unsafe block
  • Compiles on Rust stable

Features:

  • Includes a captcha as a minimal protection against spamming
  • Easily customizable assets, contact details, and hoster information
  • Light / dark theme
  • Only needs a SQLite database to work
  • Localization (available in French and English)
  • Basic protection against spambots (captcha with a customizable difficulty)
  • Active detection of phishing links (detects "suspicious activity")
  • Counting clicks
  • Allows shortcut deletion by the user
  • Allows marking a shortcut as "phishing", which displays a awareness-raising message to victims

Official instance: https://s.42l.fr/

Screenshots

Main page:

Main page screenshot

Admin page for users when they create a link:

New link screenshot

Page displayed when a link is marked as phishing by the server administrator:

Main page screenshot

Running an instance

First, you must install Cargo and the latest stable version of Rust by following the instructions on this website. Alternatively, you can use the liuchong/rustup Docker image.

  • Clone the project:
git clone https://git.42l.fr/42l/rs-short.git
  • Edit what you need. You might want to change the following files:

    • assets/hoster-logo.svg: replace with the logo of your organization
    • assets/logo.svg: the software logo
    • assets/themes/light/background.jpg: the default background for the light theme
  • Copy config.toml.sample to config.toml and edit its values to suit your needs:

    • Important: Replace default values of cookie_key and phishing_password.
  • Edit blacklists at your convenience.

    • banned_url_from.list: Any client that submits a link name fully matching one of the elements in this list will get a 403 Forbidden HTTP status code.
    • banned_url_to.list: Any client that submits an URL containing one of the elements in this list will get a 403 Forbidden HTTP status code.

You can configure a fail2ban instance and watch your favourite reverse-proxy logs to see which IPs are getting a 403 and ban accordingly for the duration of your choice.

  • cargo run --release

Contributing

Here are many ways to contribute:

  • Translate!
    • Add your entries in the lang.json file.
    • Once you're done, edit init.rs and add your language in the ValidLanguages structure.
  • Add PostgreSQL compatibility
  • Add some more CSS themes
  • Rework default themes' CSS (they've gone a bit messy since then. hopefully they are commented)
  • Develop a more resilient protection to spambots
    • Improve blacklist support?
  • Add the possibility to disable the captcha
  • Experiment around captchas to match accessibility needs. I have no idea... :(

This software is mainly developed and maintained by Neil for the Association 42l.

If you like the work done on this project, please consider to donate or join the association. Thank you!

Graphical credits