go-admin-team/go-admin

어떤 프로젝트인가요?

핵심 기능

• 01인증, CORS, 접근 로그, 요청 추적 미들웨어를 갖춘 Gin 기반 RESTful API
• 02Casbin 기반 RBAC 권한 제어
• 03JWT 기반 인증
• 04데이터베이스 테이블에서 CRUD 페이지를 생성하는 코드 생성기
• 05드래그 앤 드롭 방식의 폼 빌더
• 06swaggo로 생성하는 Swagger API 문서
• 07설정 가능한 데이터베이스 백엔드를 지원하는 GORM 데이터 계층

활용 사례

• 사용자, 역할, 메뉴가 포함된 사내 백오피스 또는 관리 콘솔 구축
• Gin과 Vue를 사용하는 기본 템플릿으로 Go 관리자 프로젝트 시작
• 직접 작성하는 코드를 최소화해 데이터베이스 테이블의 기본 CRUD 화면 생성

빠른 시작

1. 1

   백엔드 프로젝트 폴더로 이동합니다

   cd ./go-admin
2. 2

   SQLite 태그를 지정해 바이너리를 빌드합니다(C 컴파일러 필요)

   go build -tags sqlite3
3. 3

   SQLite 설정으로 데이터베이스를 초기화합니다

   ./go-admin migrate -c config/settings.sqlite.yml
4. 4

   API 서버를 시작합니다

   ./go-admin server -c config/settings.sqlite.yml

사용 전 알아둘 점

• !SQLite 빠른 시작에는 C 컴파일러(cgo)가 필요하며, 일반 go build에는 sqlite3 태그가 포함되지 않습니다.
• !프런트엔드는 별도의 저장소(go-admin-ui)에 있으므로 이를 클론해 백엔드와 함께 실행해야 합니다.
• !README에 단위 테스트가 TODO로 표시되어 있어 테스트 커버리지가 제공되지 않습니다.

토픽

자주 묻는 질문

go-admin은(는) 무엇인가요?

RBAC, JWT 인증, 코드 생성기와 폼 빌더를 갖추고 Element UI, Arco Design, Ant Design 프런트엔드를 지원하는 Gin + Vue 관리자 시스템 스타터입니다. go-admin은 프런트엔드와 백엔드가 분리된 관리자 시스템입니다. 백엔드는 Gin 웹 프레임워크 기반의 Go로 작성되었으며 데이터베이스 접근에는 GORM을 사용합니다. 이에 맞는 프런트엔드는 Vue로 구축되었고 Element UI, Arco Design 또는 Ant Design을 사용할 수 있습니다.

go-admin은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

go-admin은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

go-admin은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. go-admin의 마지막 커밋은 2026년 10월 27일입니다.

go-admin은(는) 어디에 사용할 수 있나요?

사용자, 역할, 메뉴가 포함된 사내 백오피스 또는 관리 콘솔 구축 Gin과 Vue를 사용하는 기본 템플릿으로 Go 관리자 프로젝트 시작 직접 작성하는 코드를 최소화해 데이터베이스 테이블의 기본 CRUD 화면 생성

go-admin는 어떻게 설치하나요?

백엔드 프로젝트 폴더로 이동합니다: cd ./go-admin SQLite 태그를 지정해 바이너리를 빌드합니다(C 컴파일러 필요): go build -tags sqlite3 SQLite 설정으로 데이터베이스를 초기화합니다: ./go-admin migrate -c config/settings.sqlite.yml API 서버를 시작합니다: ./go-admin server -c config/settings.sqlite.yml

go-admin은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/go-admin-team/go-admin