Mikä on Kutt?
Kutt on moderni, avoimen lähdekoodin, itse isännöity URL-lyhennysalusta, joka on suunniteltu luomaan, hallitsemaan ja seuraamaan lyhennettyjä linkkejä.
Sen avulla käyttäjät voivat muuntaa pitkät URL-osoitteet lyhyiksi, mieleenpainuviksi osoitteiksi käyttämällä omia verkkotunnuksiaan. Kutt tarjoaa keskitetyn kojelaudan linkkien hallintaan, napsautusten tilastojen seurantaan ja lyhennettyjen URL-osoitteiden käytön hallintaan.
Alusta tukee mukautettuja URL-aliaksia, salasanalla suojattuja linkkejä, vanhentumispäiviä ja yksityistä analytiikkaa. Se tarjoaa myös RESTful API: n URL-lyhennystoiminnon integroimiseksi ulkoisiin sovelluksiin, komentosarjoihin ja automatisoituihin työnkulkuihin.
Kutt on erityisen hyödyllinen yrityksille, kehittäjille, sisällöntuottajille ja organisaatioille, jotka haluavat hallita brändättyjä lyhyitä linkkejä säilyttäen samalla infrastruktuurinsa ja tietojensa hallinnan.
Kuttin historia
Kutt on avoimen lähdekoodin URL-lyhennysprojekti, jonka on alun perin kehittänyt The Devs.
Projekti luotiin tarjoamaan moderni vaihtoehto kaupallisille URL-lyhennyspalveluille, ja siinä painotetaan itse isännöintiä, räätälöintiä ja yksityisyyttä.
Kutt on kehittynyt tukemaan mukautettuja verkkotunnuksia, linkkien hallintaa, yksityisiä tilastoja, käyttäjien hallintaa ja API-integraatioita.
Sovellus on rakennettu Node.js: llä ja tarjoaa Docker-pohjaisen käyttöönottovaihtoehdon, joten se on suoraviivainen toimimaan henkilökohtaisilla palvelimilla ja pilvi-infrastruktuurilla.
Kutt on jaettu MIT-lisenssillä.
Kuttin tärkeimmät ominaisuudet
Kutt tarjoaa kattavan joukon ominaisuuksia lyhennettyjen URL-osoitteiden luomiseen ja hallintaan.
- URL-osoitteiden lyhentäminen: Muunna pitkät URL-osoitteet lyhyiksi, jaettaviksi linkeiksi.
- Mukautetut verkkotunnukset: Käytä omaa verkkotunnustasi brändättyihin lyhennettyihin URL-osoitteisiin.
- Custom URL Aliases: Luo mieleenpainuvia lyhyitä linkkejä mukautettuja tunnisteita.
- Klikkaa Analytiikka: Seuraa yksittäisten lyhennettyjen URL-osoitteiden tilastoja.
- Yksityiset tilastot: Käytä linkin suorituskykytietoja hallintakäyttöliittymän kautta.
- Salasanasuojatut linkit: Rajoita pääsyä lyhennettyihin URL-osoitteisiin salasanoilla.
- Linkin vanheneminen: Määritä väliaikaisten linkkien vanhentumispäivät.
- Linkin muokkaus: Muokkaa kohde-URL-osoitteita muuttamatta olemassa olevaa lyhyttä osoitetta.
- Linkkikuvaukset: Lisää kuvauksia, jotka auttavat järjestämään ja tunnistamaan lyhennetyt linkit.
- Käyttäjien hallinta: Hallitse käyttäjätilejä ja linkitä omistajuus hallintaliittymän kautta.
- RESTful API: Luo, hae, muokkaa ja poista lyhennettyjä URL-osoitteita ohjelmallisesti.
- Rekisteröinnin valvonta: Poista julkinen rekisteröinti käytöstä, jotta esiintymä pysyy yksityisenä.
- Anonyymien linkkien hallinta: Edellyttää todennusta, ennen kuin käyttäjät voivat luoda lyhennettyjä URL-osoitteita.
- OpenID Connect: Tukee ulkoisia todennuspalveluntarjoajia OIDC:n kautta.
- Mukautetut teemat: Muokkaa sovelluksen ulkoasua CSS: n, kuvien ja mallien avulla.
- Selaimen laajennukset: Integroi URL-lyhennys tuettuihin selaimiin.
- Tietokannan joustavuus: Tuki SQLite, PostgreSQL ja MySQL / MariaDB.
- Docker-tuki: Ota sovellus käyttöön käyttämällä virallisia Docker-kuvia ja Compose-kokoonpanoja.
Esimerkkejä käytöstä
Kutt sopii yksityishenkilöille ja organisaatioille, jotka tarvitsevat keskitetyn URL-lyhennyspalvelun.
Yleisiä käyttötapauksia ovat:
- Yritysmarkkinointi: Luo brändättyjä linkkejä mainoksia, uutiskirjeitä ja mainoskampanjoita varten.
- Sosiaalisen median hallinta: Luo lyhyempiä URL-osoitteita jakamiseen sosiaalisissa verkostoissa.
- Kehittäjä Integraatiot: Integroi URL lyhennys sovelluksiin kautta REST API.
- Sisäinen infrastruktuuri: Isännöi yksityistä URL-lyhennyspalvelua työntekijöille ja sisäisille sovelluksille.
- Kumppanuusmarkkinointi: Järjestä ja hallinnoi seurantalinkkejä myynninedistämiskampanjoihin.
- Sisällön julkaisu: Luo mieleenpainuvia linkkejä artikkeleihin, videoihin ja ladattaviin resursseihin.
- Väliaikainen jakaminen: Luo linkkejä salasanasuojauksella ja vanhentumispäivillä.
- Sovelluksen automaatio: Lyhennä URL-osoitteita automaattisesti komentosarjojen ja ulkoisten integraatioiden avulla.
- Bränditetty viestintä: Käytä mukautettuja verkkotunnuksia ylläpitääksesi yhtenäistä brändäystä jaetuissa linkeissä.
Kuttin hyödyt
- Avoimen lähdekoodin ja itse isännöity URL-lyhennys
- Tukee mukautettuja verkkotunnuksia ja brändilinkkejä
- Tarjoaa yksityiset klikkaustilastot
- Mahdollistaa mukautetut URL-aliakset
- Tukee salasanasuojausta ja linkin vanhenemista
- Sisältää linkkien muokkauksen ja hallinnan
- Tarjoaa RESTful API:n integraatioita varten
- Tukee useita tietokannan taustajärjestelmiä
- Sisältää käyttäjä- ja käyttöoikeuksien hallinnan
- Tukee OpenID Connect -todennusta
- Tarjoaa muokattavia teemoja ja mallipohjia
- Voidaan ottaa käyttöön Dockerin avulla
- Tarjoaa paremman hallinnan lyhennetyille URL-osoitteille ja niihin liittyville tiedoille
Kuinka asentaa Kutt
Asenna Kutt Esadaxin kautta noudattamalla seuraavia ohjeita:
- Osta sovellus Esadaxin kautta.
- Oston jälkeen sinua pyydetään antamaan tarvittavat kokoonpanoparametrit.
- Anna määritysarvot, mukaan lukien julkinen toimialue ja todennusasetukset tarvittaessa.
- Määritä tietokantayhteys, jos käytät ulkoista tietokantaa.
- Määritä Redis, jos käyttöönottopaketti ottaa sen käyttöön.
- Käynnistä sovellus valitsemalla Ota käyttöön.
- Käytä Kutt-käyttöliittymää sille määritetyn sovellus-URL-osoitteen kautta.
- Suorita järjestelmänvalvojan tilin alkuasetukset loppuun.
- Määritä mukautettu verkkotunnus tarvittaessa.
- Aloita lyhennettyjen URL-osoitteiden luominen ja seuraa niiden suorituskykyä.
Kun se on otettu käyttöön, Kutt tarjoaa keskitetyn kojelaudan linkkien, käyttäjien ja analytiikan hallintaan.
URL-osoitteiden hallinta
Kutt tarjoaa kojelaudan lyhennettyjen URL-osoitteiden luomiseen, järjestämiseen ja hallintaan.
Käyttäjät voivat luoda linkkejä lähettämällä kohde-URL-osoitteen ja valinnaisesti määrittämällä lisäasetuksia.
Käytettävissä olevia linkkivaihtoehtoja ovat:
- Mukautetut lyhyet URL-tunnukset
- Salasanasuojaus
- Linkkikuvaukset
- Viimeiset käyttöpäivät
- Kohde-URL-osoitteen muokkaaminen
Käyttäjät voivat tarkastella olemassa olevia linkkejään, päivittää kohdeosoitteita tai poistaa linkkejä, joita ei enää tarvita.
Tämä tekee Kuttista sopivan suurten lyhennettyjen URL-osoitteiden kokoelmien hallintaan turvautumatta ulkoisiin lyhennyspalveluihin.
Mukautetun verkkotunnuksen tuki
Yksi Kuttin tärkeimmistä ominaisuuksista on mahdollisuus käyttää mukautettuja verkkotunnuksia lyhennettyihin linkkeihin.
Sen sijaan, että linkkejä jaettaisiin yleisen lyhennysalueen kautta, organisaatiot voivat määrittää omat verkkotunnuksensa luomaan brändättyjä URL-osoitteita.
Esimerkiksi:
https://example.com/documentationhttps://links.example.com/producthttps://go.example.com/campaign
Mukautetun verkkotunnuksen määrittäminen:
- Määritä DNS-palveluntarjoajasi haluamasi verkkotunnus tai aliverkkotunnus.
- Osoita DNS-tietue palvelimelle, joka isännöi Kuttia.
- Määritä verkkotunnus Kutt-sovelluksessa.
- Määritä käyttöönottomäärityksessä sopiva oletustoimialue.
- Määritä HTTPS ja kelvolliset TLS-varmenteet verkkotunnukselle.
- Varmista, että luodut linkit käyttävät määritettyä verkkotunnusta.
Kutt tukee myös HTTPS: ää mukautetuille verkkotunnuslinkeille CUSTOM_DOMAIN_USE_HTTPS-konfiguraatiovaihtoehdon kautta.
Mukautettujen verkkotunnusten TLS-varmenteet on määritettävä erikseen.
Analytiikka ja tilastot
Kutt tarjoaa yksityisiä tilastoja lyhennetyille URL-osoitteille, jolloin käyttäjät voivat seurata linkin suorituskykyä.
Analytiikkakäyttöliittymä auttaa käyttäjiä ymmärtämään, miten heidän jaettuja linkkejään käytetään.
Käyttäjät voivat tarkastella lyhennettyihin URL-osoitteisiinsa liittyviä tilastoja ja tunnistaa, mitkä linkit saavat eniten toimintaa.
Analytiikasta on hyötyä:
- Linkin klikkaustoiminnan seuranta
- Eri URL-osoitteiden tehokkuuden vertailu
- Markkinointikampanjoiden arviointi
- Suosittujen jaettujen resurssien tunnistaminen
- Julkaistujen linkkien synnyttämän sitoutumisen mittaaminen
Tilastot ovat käytettävissä sovelluksen hallintakäyttöliittymän kautta.
API ja integraatiot
Kutt tarjoaa RESTful-sovellusliittymän, jonka avulla ulkoiset sovellukset voivat olla vuorovaikutuksessa URL-lyhennysalustan kanssa.
API: n avulla linkkien luominen ja hallinta voidaan automatisoida ilman manuaalista pääsyä verkkokäyttöliittymään.
Yleisiä integrointiskenaarioita ovat:
- Lyhennettyjen URL-osoitteiden luominen komentosarjoista.
- Linkkien luominen automaattisesti verkkosovelluksista.
- Haetaan tietoja olemassa olevista lyhennetyistä URL-osoitteista.
- Kohde-URL-osoitteiden päivittäminen ohjelmallisesti.
- Lyhennettyjen URL-osoitteiden poistaminen.
- URL-lyhennysten integrointi sisällönhallintajärjestelmiin.
- Mukautettujen kojelautojen ja automaatiotyönkulkujen rakentaminen.
API-todennuksessa käytetään Kutt-sovelluksen kautta luotuja tunnistetietoja.
Kutt tukee myös integrointeja työkaluihin, kuten ShareX ja selainlaajennukset kätevään linkkien lyhentämiseen.
Tietoturva / ylläpito / konfigurointi
Kutt tarjoaa hallinto- ja käyttöoikeuksien hallintatoimintoja käyttäjien hallintaan ja valvontaan, jotka voivat luoda lyhennettyjä URL-osoitteita.
Suojausvaihtoehtoja ovat:
- Poista julkinen käyttäjän rekisteröinti.
- Rajoita anonyymin linkin luomista.
- Määritä todennus OpenID Connectin kautta.
- Suojaa yksittäiset linkit salasanoilla.
- Määritä väliaikaisille linkeille vanhentumispäivät.
- Määritä API-todennus.
- Ota käyttöön nopeuden rajoittaminen tuetuille API-reiteille.
- Määritä HTTPS käänteisen välityspalvelimen kautta.
- Suojaa ylläpitäjätilit vahvoilla tunnistetiedoilla.
Julkisissa käyttöönotoissa kannattaa harkita seuraavia käytäntöjä:
- Käytä vahvaa ja satunnaisesti luotua JWT-salasanaa.
- Ota HTTPS käyttöön kaikille sovellusten käyttöoikeuksille.
- Poista rekisteröinti käytöstä, kun julkisia tilejä ei tarvita.
- Rajoita nimettömän linkin luomista yksityisen palvelun toiminnan yhteydessä.
- Ota käyttöön nopeuden rajoittaminen väärinkäytön vähentämiseksi.
- Määritä luotetun välityspalvelimen asetukset oikein.
- Valvo lähetettyjä linkkejä ja poista haitalliset uudelleenohjaukset.
- Rajoita tietokannan ja Redisin käyttöoikeudet luotettuihin palveluihin.
- Pidä Kutt ja sen riippuvuudet ajan tasalla.
- Ylläpidä säännöllisiä tietokannan varmuuskopioita.
URL-lyhentäjiä voidaan käyttää väärin tietojenkalastelulinkkien levittämiseen ja käyttäjien ohjaamiseen haitallisille verkkosivustoille. Julkisten käyttöönottojen tulisi sisältää asianmukaiset väärinkäytösten raportointi- ja moderointimenettelyt.
Kuttille parhaat käytännöt
- Käytä lyhennettyjä URL-osoitteita varten omaa verkkotunnusta tai aliverkkotunnusta.
- Valitse tunnistettavat ja johdonmukaiset mukautetut URL-aliakset.
- Ota HTTPS käyttöön kaikilla määritetyillä verkkotunnuksilla.
- Määritä linkkien vanheneminen tilapäisille resursseille.
- Käytä salasanasuojausta arkaluontoisiin kohteisiin.
- Poista julkinen rekisteröityminen käytöstä sisäistä palvelua operoitaessa.
- Rajoita anonyymien linkkien luomista tarvittaessa.
- Ota käyttöön nopeuden rajoittaminen julkisille esiintymille.
- Suojaa API-tunnistetiedot ja JWT-salaisuudet.
- Seuraa linkkitilastoja säännöllisesti.
- Tarkista ilmoitetut linkit ja epäilyttävä toiminta.
- Varmuuskopioi tietokannan ja sovelluksen kokoonpano.
- Pidä sovellus ja riippuvuudet ajan tasalla.
Määritysparametrit
Kun olet ostanut tämän sovelluksen Esadax, sinua pyydetään antamaan käyttöönoton edellyttämät kokoonpanoparametrit.
Esadax lisää toimitetut muuttujat käyttöönottoon, jotta sovellus voidaan käynnistää sen vaatimalla kokoonpanolla.
Kutt tukee konfigurointia ympäristömuuttujien tai .env-tiedoston kautta.
Seuraavat ovat yleisiä määritysparametreja, joita virallinen Kutt-käyttöönotto tukee:
| Parametri | Kuvaus |
|---|---|
JWT_SECRET |
Salaisuus, jota käytetään todennustunnisteiden allekirjoittamiseen. Tarvitaan tuotantokäyttöönotoissa. |
PORT |
Sovelluksen käyttämä portti. Oletus on 3000. |
SITE_NAME |
Sovelluksen käyttöliittymässä näkyvä nimi. |
DEFAULT_DOMAIN |
Verkkotunnus, jota käytetään lyhennettyjen URL-osoitteiden luomisessa. |
LINK_LENGTH |
Automaattisesti luotujen lyhyiden URL-tunnusten oletuspituus. |
DISALLOW_REGISTRATION |
Poistaa julkisen käyttäjärekisteröinnin käytöstä. |
DISALLOW_LOGIN_FORM |
Poistaa sähköposti- ja salasanakirjautumisen käytöstä, kun OIDC-todennus on käytössä. |
DISALLOW_ANONYMOUS_LINKS |
Estää käyttäjiä luomasta linkkejä ilman todennusta. |
TRUST_PROXY |
Määrittää, luottaako Kutt välityspalvelimen otsikoihin toimiessaan käänteisen välityspalvelimen takana. |
DB_CLIENT |
Tietokantaohjain, kuten better-sqlite3, pg tai mysql2. |
DB_HOST |
Tietokantapalvelimen nimi. |
DB_PORT |
Tietokantapalvelimen portti. |
DB_NAME |
Tietokannan nimi. |
DB_USER |
Tietokannan käyttäjänimi. |
DB_PASSWORD |
Tietokannan salasana. |
DB_FILENAME |
SQLite-tietokantatiedoston sijainti käytettäessä SQLitea. |
REDIS_ENABLED |
Ottaa käyttöön Redis-välimuistin. |
REDIS_HOST |
Redis-palvelimen isäntänimi. |
REDIS_PORT |
Redis-palvelimen portti. |
REDIS_PASSWORD |
Redis-todennuksen salasana. |
CUSTOM_DOMAIN_USE_HTTPS |
Luo HTTPS-URL-osoitteet mukautetuille verkkotunnuksille. |
ENABLE_RATE_LIMIT |
Ottaa käyttöön nopeuden rajoittamisen tuetuille API-reiteille. |
MAIL_ENABLED |
Ottaa käyttöön sähköpostitoiminnon. |
MAIL_HOST |
SMTP-palvelimen isäntänimi. |
MAIL_PORT |
SMTP-palvelimen portti. |
MAIL_USER |
SMTP-todennuksen käyttäjänimi. |
MAIL_PASSWORD |
SMTP-todennuksen salasana. |
MAIL_FROM |
Lähettäjän sähköpostiosoite. |
OIDC_ENABLED |
Ottaa käyttöön OpenID Connect -todennuksen. |
OIDC_ISSUER |
OpenID Connectin myöntäjän URL-osoite. |
OIDC_CLIENT_ID |
OpenID Connect -asiakastunniste. |
OIDC_CLIENT_SECRET |
OpenID Connect -asiakkaan salasana. |
REPORT_EMAIL |
Sähköpostiosoite, jota käytetään lähetettyjen linkkiraporttien vastaanottamiseen. |
CONTACT_EMAIL |
Sovelluksen näyttämä tuen yhteyshenkilön sähköpostiosoite. |
Kaikki ympäristömuuttujat ovat valinnaisia paitsi JWT_SECRET tuotannossa. Muut asetukset riippuvat valitusta käyttöönottokokoonpanosta.
Oletustietokanta on SQLite, jossa käytetään better-sqlite3-ohjainta. PostgreSQL, MySQL / MariaDB ja Redis voidaan määrittää tarvittaessa.
Kun tarvittavat arvot on määritetty, käynnistä Kutt napsauttamalla Käyttöönotto.
Tietokanta ja tallennus
Kutt tukee useita tietokantakokoonpanoja, joten se sopii eri käyttöönottokokoihin.
Tuetut tietokannat ovat:
- SQLite: Oletustietokanta yksinkertaisiin ja kevyisiin asennuksiin.
- PostgreSQL: Sopii tuotantokäyttöönottoihin, jotka edellyttävät erillistä tietokantapalvelua.
- MySQL/MariaDB: Vaihtoehtoiset relaatiotietokantojen taustajärjestelmät.
Redis voidaan valinnaisesti ottaa käyttöön välimuistiin.
Docker-käyttöönottoja varten Kutt tarjoaa useita Compose-kokoonpanoja:
docker-compose.yml- Oletus SQLite-kokoonpano.docker-compose.sqlite-redis.yml- SQLite Redisin kanssa.docker-compose.postgres.yml- PostgreSQL Redisin kanssa.docker-compose.mariadb.yml- MariaDB Redisillä.
Varmista, että pysyvä tallennustila on määritetty SQLite-tietokannalle, kun käytät oletustietokannan taustaohjelmaa.
Varmista PostgreSQL- ja MariaDB-käyttöönotoissa, että tietokantavolyymejä ja varmuuskopioita hallitaan itsenäisesti.
Mukauttaminen ja teemat
Kutt tukee räätälöintiä erityisen /custom-hakemiston kautta.
Järjestelmänvalvojat voivat muokata ulkoasua ja tiettyjä sovellusmalleja muuttamatta sovelluksen lähdekoodia.
Mukautusvaihtoehtoja ovat:
- Mukautetut CSS-tyylitaulukot
- Korvaavat logot ja kuvat
- Mukautetut faviconit
- Mukautetut HTML-mallit
- Mukautettu alatunnisteen sisältö
- Lisäteemaresurssit
Tämän ansiosta organisaatiot voivat mukauttaa URL-lyhennysliittymän brändäys- ja visuaalisiin vaatimuksiinsa.
Mukautettuihin resursseihin tehdyt muutokset saattavat edellyttää sovellussäiliön uudelleenkäynnistämistä.
Johtopäätös
Kutt on moderni, avoimen lähdekoodin URL-lyhennysalusta, joka tarjoaa mukautettuja verkkotunnuksia, linkkien hallintaa, yksityistä analytiikkaa ja API-integraatioita.
Tukemalla salasanalla suojattuja linkkejä, vanhenemispäiviä, mukautettuja URL-aliaksia, käyttäjien hallintaa ja useita tietokannan taustajärjestelmiä, se tarjoaa välttämättömät työkalut keskitetyn URL-lyhennyspalvelun käyttämiseen.
Sen itse isännöity arkkitehtuuri antaa organisaatioille ja yksityishenkilöille mahdollisuuden hallita lyhennettyjä linkkejään, infrastruktuuriaan ja analytiikkatietojaan.
Kutt on käytännöllinen ratkaisu yrityksille, kehittäjille ja organisaatioille, jotka etsivät joustavaa vaihtoehtoa kaupallisille URL-lyhennysalustoille.

