Profile Counter
A lightweight, self-hosted SVG visitor counter powered by FastAPI and Redis, deployed via Docker Compose
2025.7.6. ~ 2025.7.10.
간단한 SVG 뱃지를 통해 웹사이트 방문자 수를 보여주는 self-hosted 방문자 카운터입니다.
기존에 GitHub README 등에 사용하던 https://profile-counter.glitch.me/:yourkey:/count.svg 서비스가 종료되면서, 어느 날 갑자기 조회수 이미지가 깨져버리는 경험을 했습니다. 이 일을 계기로 더 이상 외부 API에 의존하지 않고, 직접 방문자 수 카운터 API를 만들어 운영하기로 결심하게 되었습니다.
FastAPI와 Redis를 활용해 서버를 구성하고, 누구나 손쉽게 사용할 수 있도록 Docker Compose 기반으로 오픈소스로 배포하였습니다.
👉 GitHub 레포지토리: 🔗 jagaldol/profile-counter
⏱️ Demo
🔧 사용 기술
🚀 주요 기능
- 경량 & 자체 호스팅 가능한 방문자 수 카운터
- Docker만으로 간편하게 배포 및 실행
- SVG 이미지 형태로 웹사이트 어디든 삽입 가능
⚙️ 배포 방식
FastAPI와 Redis를 기반으로 구성되어 있으며, Docker Compose로 두 컨테이너를 동시에 실행할 수 있도록 설계되어 있습니다. 간단한 설정만으로 로컬 혹은 개인 서버에 쉽게 배포 가능하며, 운영 환경에서는 nginx를 통한 리버스 프록시 구성도 염두에 두고 설계하였습니다.
📄 라이선스
MIT License 하에 공개되어 있으며, 자세한 내용은 LICENSE 파일을 참고해주세요.