StackRender Docker Compose 설치: 로컬 DB 스키마 편집기 8080 포트로 열기

DB 스키마를 손으로 그린 뒤 SQL을 따로 관리하면 수정 이력이 갈라지기 쉽습니다. StackRender는 브라우저에서 스키마를 편집하고 SQL DDL과 마이그레이션을 다루는 도구입니다. Docker Compose로 로컬 http://localhost:8080까지 여는 경로만 적습니다.

직접 돌려보지는 않았습니다. 공식 README와 공식 문서를 보고 정리했습니다. 저라면 팀 DB 설계 초안을 빠르게 맞춰야 할 때 이 구성을 검토하겠습니다.

1. 적용 범위

StackRender는 PostgreSQL, MySQL, MariaDB, SQLite, Oracle, SQL Server용 스키마를 지원한다고 안내합니다. 테이블·컬럼·제약 조건을 편집하고 기존 DDL을 가져오거나 내보내는 용도입니다.

작은 프로젝트에서 SQL 파일만 관리한다면 굳이 올릴 이유가 없습니다. 반대로 여러 사람이 ERD와 DDL 변경을 함께 검토해야 하면 화면 하나로 초안을 공유하기 좋습니다. Docker 서비스 구성은 n8n 셀프 호스팅 설치 글과 같은 방식으로 시작하시면 됩니다.

2. Docker Compose 준비

공식 저장소의 Compose 파일은 소스를 빌드해 Nginx 컨테이너로 제공합니다. Docker와 Docker Compose 플러그인이 준비된 Linux 서버나 개발 PC에서 저장소를 받습니다.

git clone https://github.com/stackrender/stackrender.git
cd stackrender
docker compose up --build -d

기본 포트는 호스트 8080, 컨테이너 80입니다. 이미 다른 서비스가 8080을 쓰면 docker-compose.yml의 8080:80 왼쪽 값만 비어 있는 포트로 바꾸시면 됩니다.

ports:
  - "8081:80"

로컬 전용 도구라도 공인 IP에 포트를 바로 열기 전에는 접근 범위를 먼저 정해야 합니다. 저장소 Compose 파일에는 인증 설정이 보이지 않으므로, 외부 공개가 필요하면 리버스 프록시와 별도 인증 계층을 앞에 두는 쪽이 낫습니다.

3. 스키마 가져오기

실행 뒤 브라우저에서 http://localhost:8080을 엽니다. 새 다이어그램을 만들거나 기존 SQL DDL을 가져온 뒤 테이블, 키, 인덱스를 확인합니다. 공식 소개는 외래 키 순환 감지와 인덱스 제안도 기능으로 적고 있습니다.

처음에는 운영 DB에 바로 반영하지 말고 내보낸 DDL을 Git 변경 사항으로 검토하시면 됩니다. 마이그레이션 생성 기능은 현재 스키마와 다음 버전의 차이를 사람이 읽는 과정이 남아야 안전합니다.

확인

docker compose ps
curl -I http://localhost:8080

stackrender 서비스가 실행 중이고 HTTP 응답 헤더가 나오면 로컬 편집기 접속 상태입니다.