Repolode
thedevs-network

thedevs-network/kutt

Kutt는 커스텀 도메인, 링크 통계, 관리자 패널, RESTful API를 지원하는 자체 호스팅 URL 단축 서비스입니다.

대체할 수 있는 제품:Bitly

스타
11,161
포크
1,514
열린 이슈
88
마지막 커밋
3일 전

어떤 프로젝트인가요?

Kutt는 자체 서버에서 실행하거나 호스팅 서비스인 kutt.to를 통해 사용할 수 있는 URL 단축 서비스입니다. 사용자는 짧은 링크를 만들고 수정할 수 있으며, 커스텀 URL, 비밀번호, 설명, 만료 시간을 설정하고 각 링크의 비공개 통계를 확인할 수 있습니다. 관리자는 전용 관리자 페이지에서 사용자와 링크를 관리할 수 있습니다.

직접 호스팅할 때 Kutt에는 Node.js 20 이상만 필요하며, 기본적으로 SQLite를 사용합니다. 필요에 따라 Postgres, MySQL 또는 MariaDB와 캐싱용 Redis를 사용할 수도 있습니다. 여러 데이터베이스 구성에 맞춘 Docker Compose 파일이 제공되며, 환경 변수로 앱을 설정합니다. 회원 가입, 익명 링크, 이메일/비밀번호 로그인을 비활성화할 수 있고 OpenID Connect 로그인도 지원합니다.

Kutt는 RESTful API와 `/custom` 폴더를 통한 커스텀 테마(CSS, 이미지, Handlebars 뷰) 지원도 제공하며, Chrome과 Firefox용 브라우저 확장 프로그램도 있습니다. Python, Go, Rust, C# 등의 언어로 작성된 커뮤니티 클라이언트도 제공됩니다.

핵심 기능

  • 01짧은 링크에 커스텀 도메인 사용 지원
  • 02커스텀 URL, 비밀번호, 만료 시간을 설정해 링크 생성·수정·삭제
  • 03단축 URL별 비공개 통계
  • 04사용자와 링크를 관리하는 관리자 페이지
  • 05프로그래밍 방식으로 링크를 관리할 수 있는 RESTful API
  • 06SQLite, Postgres, MySQL/MariaDB 지원 및 선택형 Redis 캐시

활용 사례

  • 팀이나 조직을 위해 자체 도메인에서 비공개 URL 단축 서비스를 호스팅
  • 데이터를 자체 인프라에 보관하면서 통계를 확인할 수 있도록 링크 단축
  • API를 통해 스크립트나 앱에 짧은 링크 생성 기능 추가
  • 회원 가입과 익명 링크를 비활성화해 인스턴스 이용을 초대된 사용자로 제한

빠른 시작

  1. 1

    이 저장소를 클론하거나 최신 zip 파일을 다운로드합니다

  2. 2

    종속성을 설치합니다

    npm install
  3. 3

    데이터베이스를 초기화합니다

    npm run migrate
  4. 4

    개발용으로 앱을 시작합니다 (프로덕션에서는 npm start를 사용하세요)

    npm run dev

사용 전 알아둘 점

  • Node.js 20 이상이 필요합니다.
  • 프로덕션 환경에서는 JWT_SECRET을 길고 무작위적인 문자열로 설정해야 합니다.
  • 가입은 기본적으로 비활성화되어 있으며, 새 사용자가 가입하려면 이메일 기능을 활성화해야 합니다.

토픽

자주 묻는 질문

kutt은(는) 무엇인가요?
Kutt는 커스텀 도메인, 링크 통계, 관리자 패널, RESTful API를 지원하는 자체 호스팅 URL 단축 서비스입니다. Kutt는 자체 서버에서 실행하거나 호스팅 서비스인 kutt.to를 통해 사용할 수 있는 URL 단축 서비스입니다. 사용자는 짧은 링크를 만들고 수정할 수 있으며, 커스텀 URL, 비밀번호, 설명, 만료 시간을 설정하고 각 링크의 비공개 통계를 확인할 수 있습니다. 관리자는 전용 관리자 페이지에서 사용자와 링크를 관리할 수 있습니다.
kutt은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
kutt은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
kutt은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. kutt의 마지막 커밋은 2026년 10월 19일입니다.
kutt은(는) 어디에 사용할 수 있나요?
팀이나 조직을 위해 자체 도메인에서 비공개 URL 단축 서비스를 호스팅 데이터를 자체 인프라에 보관하면서 통계를 확인할 수 있도록 링크 단축 API를 통해 스크립트나 앱에 짧은 링크 생성 기능 추가 회원 가입과 익명 링크를 비활성화해 인스턴스 이용을 초대된 사용자로 제한
kutt는 어떻게 설치하나요?
이 저장소를 클론하거나 최신 zip 파일을 다운로드합니다 종속성을 설치합니다: npm install 데이터베이스를 초기화합니다: npm run migrate 개발용으로 앱을 시작합니다 (프로덕션에서는 npm start를 사용하세요): npm run dev
kutt은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/thedevs-network/kutt

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트