이형주 Hyeongju Lee

커뮤니티 리듬게임의 서버,
업데이트 때 최대 약 2,000명 동시 접속

두 사람이 만든 커뮤니티 리듬게임 WJMax에서 서버·DB·보안을 맡았습니다. 게임 클라이언트는 다른 한 명이 만들었습니다. 공개한 서버 코드에서는 부하와 재전송, 입력 검사 문제를 테스트로 다룹니다.

기간
2023.08 – 2024.02커밋 기준
형태
사이드 프로젝트2인 팀
역할
서버·DB·보안 담당게임 클라이언트는 다른 1명
기술
FastAPI · DockerAWS EC2 · RDS MySQL · Cloudflare
업데이트 때 최대~2,000명동시 접속
평소~300명평균 동시 접속
CI3개 DBSQLite · MySQL 8.0 · 8.4에서 테스트

아키텍처

게임 클라이언트는 곡마다 차트 8개의 플레이 횟수를 보고로 보내고, 서버는 이를 받아 데이터베이스에 저장했습니다.

직접 구축 다른 주체
  1. 01클라이언트
    • 다른 주체
      게임 클라이언트는 팀의 다른 1명이 만들었습니다.
      규모
      평균 동시 접속 약 300명, 업데이트 때 최대 약 2,000명.
      보고
      곡마다 차트 8개의 플레이 횟수를 서버로 보냅니다.
  2. 02엣지
    • 한 일
      서버 앞단에 Cloudflare 프록시와 WAF를 구성. 인증 없이 들어오는 보고의 남용을 앞에서 막습니다.
      기술
      • Cloudflare
      • WAF
  3. 03API 서버
    • 한 일
      EC2의 Docker 컨테이너에서 FastAPI 플레이 로그 수집 API를 운영. 공개 정리본은 커넥션 풀 고갈, 재전송 중복 저장, 입력 검사를 다룹니다.
      기술
      • FastAPI
      • Docker
      • AWS EC2
  4. 04저장
    • 한 일
      플레이 보고를 RDS MySQL에 저장. 공개 정리본은 곡 제목을 글자 그대로 비교해, 대소문자나 히라가나·가타카나만 다른 곡이 합쳐지지 않게 했습니다.
      기술
      • MySQL
      • AWS RDS
결과업데이트 날 최대 약 2,000명 동시 접속을 받아 운영서버 로그 같은 원자료는 남아 있지 않아, 운영이 끝난 뒤 처음 정리한 기록(2025년 포트폴리오)의 값을 씁니다

공개 정리본에서 다룬 문제

게임 클라이언트가 보내는 요청은 그대로 두고, 서버 쪽 문제를 하나씩 테스트로 고정했습니다.

  1. 동시 접속이 몰릴 때 요청이 실패하던 문제

    문제
    정리 초기 버전은 요청이 데이터베이스 연결을 너무 일찍 잡는 구조라, 60명이 동시에 보내는 시험에서 요청의 절반 가까이가 서로 기다리다 실패했습니다.
    해결
    연결을 잡아 쓰고 돌려주는 일을 작업 스레드 하나 안에서 끝내게 하고, 연결 수를 작업 스레드 수(40)와 맞췄습니다. 60명 동시 시험을 CI에 넣어 모두 응답이 오는지 계속 확인합니다.
  2. 재전송된 보고가 두 번 저장되는 문제

    문제
    연결이 끊겨 같은 보고가 다시 오면 플레이 횟수가 두 번 쌓일 수 있습니다.
    해결
    보고에 번호(보고 ID)가 붙어 오면 같은 번호는 한 번만 저장합니다. 같은 보고 두 개가 동시에 도착해도 하나만 저장되고, 번호는 같은데 내용이 다르면 거절합니다. 다만 지금 배포된 게임은 이 번호를 보내지 않아, 그 재전송은 여전히 별개의 보고로 저장됩니다.
  3. 곡 제목이 서로 합쳐지는 문제

    문제
    MySQL은 기본 설정에서 대문자와 소문자, 히라가나와 가타카나를 구분하지 않아 "Glory"와 "GLORY", "ゆめ"와 "ユメ"를 같은 곡으로 봅니다.
    해결
    제목과 ID는 글자 하나하나를 그대로 비교하도록 설정을 바꾸고, CI에서 이를 확인합니다.
  4. 누구나 보낼 수 있는 입력

    문제
    배포된 게임은 로그인 같은 인증 없이 보고를 보내서, 서버 주소만 알면 누구나 보고를 보낼 수 있습니다.
    해결
    서버가 내용을 읽기 전에 형식부터 검사해, 잘못된 입력과 1 MB가 넘는 요청은 바로 거절합니다. 앞단의 Cloudflare도 함께 남용을 막습니다. 보고가 실제로 플레이했다는 증명은 아니라는 한계도 README에 적었습니다.

테스트는 GitHub Actions에서 SQLite와 MySQL 8.0·8.4로 돌리고, 데이터베이스 정의 파일(schema.sql)이 코드와 맞는지도 확인합니다.

  • Python
  • FastAPI
  • Docker
  • AWS EC2
  • AWS RDS
  • MySQL
  • Cloudflare
  • GitHub Actions
연락

채용·협업 문의는 이메일로 받습니다.

데이터 엔지니어링, 백엔드, 비전 데이터 파이프라인 직무를 찾고 있습니다.

2027년 3월 석사 졸업 예정