shortlink

(★ 768)

Shortlink service (Microservice example) ⭐️ Star the repo if you like it!

파일 탐색기

최종 버전 다운로드 (.zip)
  • .adr-dir
  • .code-workspace
  • .codecov.yml
  • .editorconfig
  • .env.example
  • .gitattributes
  • .gitignore
  • .golangci.yml
  • .pre-commit-config.yaml
  • .sops.yaml
  • _config.yml
  • ADOPTERS.md
  • AGENTS.md
  • CHANGELOG.md
  • CITATION.cff
  • CODE_OF_CONDUCT.md
  • CONTRIBUTING.md
  • cr.yaml
  • ct.yaml
  • docker-compose.yaml
  • GOVERNANCE.md
  • LICENSE
  • Makefile
  • README.md
  • ROADMAP.md
  • SECURITY.md

🚀 설치 가이드

1. 코드 내려받기
git clone https://github.com/shortlink-org/shortlink

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd shortlink

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Docker

쉬움 추천
사전 준비물
  • Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
  • Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.
docker compose up -d --build

정의된 모든 컨테이너(서버, DB 등)를 한 번에 빌드하고 백그라운드에서 실행합니다.

✅ 터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.

3. Node.js

쉬움
사전 준비물
  • Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
  • Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.
⚠️ 이 프로젝트는 규모가 큰 저장소라, 이 방법이 실제 핵심 제품이 아니라 내부 하위 패키지를 가리키는 것일 수 있습니다. README 전체를 함께 확인해보세요.
cd boundaries/chrome-extension

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

npm install

package.json에 명시된 라이브러리들을 내려받아 설치합니다.

npm start

개발/실행 서버를 켭니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

4. Python

쉬움
사전 준비물
  • Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
  • Python 3 설치 시 'Add Python to PATH' 옵션을 꼭 체크하세요 (Windows).
⚠️ 이 프로젝트는 규모가 큰 저장소라, 이 방법이 실제 핵심 제품이 아니라 내부 하위 패키지를 가리키는 것일 수 있습니다. README 전체를 함께 확인해보세요.
pip install -r poc/ml-diff/ml/requirements.txt

requirements.txt 등에 명시된 파이썬 라이브러리를 설치합니다.

python <실행할 파일명>.py # README에서 정확한 실행 파일명을 확인하세요

파이썬 스크립트(또는 모듈)를 실행합니다.

✅ 에러 메시지 없이 실행되고 터미널에 안내 문구가 출력되면 정상입니다.

5. Go

보통
사전 준비물
  • Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
  • Go Go 언어 컴파일러 및 도구 모음입니다.
⚠️ 이 프로젝트는 규모가 큰 저장소라, 이 방법이 실제 핵심 제품이 아니라 내부 하위 패키지를 가리키는 것일 수 있습니다. README 전체를 함께 확인해보세요.
cd boundaries/api/api-gateway

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

go build ./...

Go 프로그램을 컴파일해 실행 파일을 만듭니다.

go run .

따로 빌드하지 않고 바로 Go 프로그램을 실행합니다.

✅ 빌드가 에러 없이 끝나면 성공입니다. go run . 을 썼다면 터미널 출력을 확인하세요.

6. Make

보통
사전 준비물
  • Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
  • Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.
make

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.

오늘의 추천 프로젝트

firecrawl ★ 168,136

웹을 대규모로 검색, 스크랩하고 상호작용하기 위한 Context API입니다. 🔥

TypeScript
lazygit ★ 81,379

git 명령어를 위한 간편한 터미널 UI

Go
angular ★ 101,020

확신을 가지고 웹 앱을 배포하세요 🚀

TypeScript
v2rayN ★ 113,981

Windows, Linux, macOS를 지원하며 Xray, sing-box 및 기타 코어를 지원하는 GUI 클라이언트입니다.

C#
free-for-dev ★ 131,972

devops 및 infradev 엔지니어들에게 유용한 무료 티어(Free Tier)를 제공하는 SaaS, PaaS, IaaS 서비스 목록입니다.

HTML
superset ★ 74,282

Apache Superset은 데이터 시각화 및 데이터 탐색 플랫폼입니다.

Python
// repository documentation