실행 모드 비교

NeoSQL은 온라인(웹), 온라인(데스크톱), 오프라인 세 가지 모드로 사용할 수 있습니다. 환경에 맞는 모드를 선택하세요.

모드 개요

온라인 (웹)

브라우저에서 바로 사용. OAuth 로그인 후 클라우드 동기화로 팀 협업이 가능합니다. 퍼블릭 DB만 연결할 수 있습니다.

온라인 (데스크톱)

데스크톱 앱 + 클라우드 동기화. 사내망·로컬 DB는 물론 VPN 환경의 데이터베이스까지 연결할 수 있으며, 팀 협업도 지원합니다.

오프라인 NEW

인터넷 없이 데스크톱 앱에서 사용. 사내망·로컬 DB 및 VPN 환경도 직접 연결 가능합니다. 폐쇄망(Air-gapped) 환경에 적합하며, 라이선스 키로 인증합니다.

기능 비교표

각 모드에서 사용할 수 있는 기능을 한눈에 비교합니다.

기능	온라인 (웹)	온라인 (데스크톱)	오프라인
핵심 기능
ERD 작성/편집	가능	가능	가능
SQL Editor	가능	가능	가능
코드 생성 개발중	가능	가능	가능
Forward / Reverse Engineering	가능	가능	가능
DB 연결
퍼블릭 DB 연결	가능	가능	불가
사내망 / 로컬 DB 연결	불가	가능	가능
협업 및 클라우드
팀 협업 (실시간 동기화)	가능	가능	불가
프로젝트 공유 / 초대	가능	가능	불가
클라우드 백업	가능	가능	불가
부가 기능
AI 기능	가능	가능	불가
템플릿 스토어 (다운로드/업로드)	가능	가능	불가

Tip

사내망·로컬 DB나 VPN/방화벽 제한이 있는 DB에 접속해야 한다면 데스크톱 앱을 사용하세요.

참고: 오프라인 모드에서 작업한 프로젝트를 나중에 온라인으로 전환할 수는 없습니다. 처음부터 사용 환경에 맞는 모드를 선택하세요.

온라인 모드 시작

온라인 모드는 OAuth 소셜 로그인으로 인증합니다. 웹 브라우저 또는 데스크톱 앱에서 사용할 수 있습니다.

앱 실행

NeoSQL 웹 앱에 접속하거나 데스크톱 앱을 실행합니다.

소셜 로그인

로그인 화면에서 Google, GitHub 등 소셜 계정으로 로그인합니다. 데스크톱 앱에서는 브라우저에서 인증 후 자동으로 앱에 연결됩니다.

프로젝트 선택

인증이 완료되면 대시보드로 이동합니다. 참여 중인 프로젝트 목록이 표시되며, 새 프로젝트를 생성하거나 기존 프로젝트를 선택할 수 있습니다.

팀원 초대 및 관리 (온라인 전용)

온라인 모드에서 프로젝트에 팀원을 초대하고 역할을 관리합니다.

팀원 초대

공유 설정 열기

프로젝트 에디터 상단 툴바에서 공유 버튼을 클릭하여 프로젝트 공유 설정을 엽니다.

이메일 입력

초대할 팀원의 이메일을 입력합니다. 쉼표(,)로 구분하여 여러 명을 한 번에 초대할 수 있습니다.

역할 선택 및 초대

부여할 역할을 선택한 뒤 초대를 전송합니다. 초대받은 사용자에게 이메일이 발송됩니다.

초대 수락

팀원이 이메일의 초대 링크를 클릭하면 로그인 후 프로젝트에 자동으로 참여합니다.

역할 및 권한

프로젝트 멤버에게 4가지 역할을 부여할 수 있습니다.

역할	팀원 초대	역할 변경	멤버 제거	소유권 이전
Owner	Manager, DBA, Member	모든 멤버	모든 멤버	가능
Manager	DBA, Member	불가	DBA, Member	불가
DBA	불가	불가	불가	불가
Member	불가	불가	불가	불가

역할별 기능 권한

멤버 관리 외에도 각 역할이 프로젝트 내에서 수행할 수 있는 작업은 권한 플래그로 관리됩니다. 프로젝트 생성 시 기본값은 다음과 같습니다.

권한	Manager	DBA	Member
공유 (다른 멤버 초대 / 공유 설정 변경)	가능	불가	불가
Connection 관리 (조회 / 추가 / 수정 / 삭제)	가능	가능	불가

그 외에도 다음 옵션을 owner가 역할별로 토글할 수 있습니다.

Watermark 강제 — 특정 역할이 ERD Print 시 워터마크를 끄지 못하도록 강제합니다.
DDL 제한 — 특정 역할의 테이블 생성·수정·삭제를 차단합니다.
DDL 승인자 — DDL 실행 전 승인 워크플로우를 사용하는 경우, 어떤 역할이 승인자가 될지 지정합니다.

Tip

이 기본값은 프로젝트 owner가 "프로젝트 설정 → 역할별 권한" 탭에서 언제든 변경할 수 있습니다.

공유 모달 구성

프로젝트 공유 모달은 두 가지 영역으로 구성됩니다.

팀원 목록 — 초대를 수락해 현재 프로젝트에 참여 중인 모든 멤버가 표시됩니다. 각 항목에는 이름·이메일과 역할 배지가 표시되며, 권한이 있는 사용자는 우측 메뉴를 통해 역할을 변경하거나 멤버를 제거할 수 있습니다.
대기중인 초대 — 초대 메일을 발송했지만 아직 수락되지 않은 항목이 나열됩니다. owner에게만 표시되며 대기중 항목이 하나 이상 있을 때만 노출됩니다. 각 항목 우측의 X 버튼을 누르면 해당 이메일이 포함된 "○○○ 님에게 보낸 초대를 취소하시겠습니까?" 확인 다이얼로그가 열리고, OK를 누르면 초대가 즉시 취소됩니다. 수락된 초대는 자동으로 팀원 목록으로 이동하고, 만료되거나 취소된 초대는 모달에 더 이상 표시되지 않습니다.

멤버 관리

공유 설정의 Members 탭에서 현재 프로젝트 멤버를 관리합니다.

멤버 목록에서 각 멤버의 역할, 마지막 접속 일시를 확인할 수 있습니다.
Owner 또는 Manager는 멤버의 역할을 변경하거나 프로젝트에서 제거할 수 있습니다.
Owner는 다른 멤버에게 소유권을 이전할 수 있습니다.
Owner가 아닌 멤버는 프로젝트 나가기로 스스로 프로젝트를 떠날 수 있습니다.

Tip

Owner 또는 Manager는 Settings 탭에서 프로젝트 공개 범위(Public/Members Only)와 복사 허용 여부를 설정할 수 있습니다.

오프라인 키 자가 발급 NEW

오프라인 모드를 사용하려면 라이선스 키가 필요합니다. Pro 이상 플랜 사용자는 웹 마이페이지에서 직접 키를 발급받을 수 있습니다.

선행 조건 오프라인 키 발급이 포함된 플랜(Pro 이상)에 가입되어 있어야 합니다. Free · Basic 플랜에서는 오프라인 키 메뉴가 비활성화됩니다.

마이페이지 접속

NeoSQL 웹사이트에 로그인한 뒤, 마이페이지 > 오프라인 키 메뉴로 이동합니다.

키 발급

빈 슬롯의 "발급" 버튼을 클릭합니다. 오프라인에서 접속할 JDBC URL을 입력한 뒤 발급을 완료합니다.

키 파일 다운로드

발급된 슬롯 카드에서 "키 파일 다운로드" 버튼을 클릭하면 JSON 형식의 라이선스 키 파일이 다운로드됩니다.

키 갱신

발급된 키는 30일 후 만료됩니다. 만료 3일 전부터 갱신할 수 있으며, 갱신 시 JDBC URL을 변경할 수도 있습니다. 갱신 후에는 새 키 파일을 다시 다운로드해야 합니다.

참고: 발급된 키는 삭제할 수 없으며, 만료될 때까지 슬롯을 점유합니다. 한 번 다운로드된 키 파일은 만료일까지 유효합니다.

오프라인 모드 시작 NEW

데스크톱 앱에서 오프라인 모드로 NeoSQL을 시작합니다.

앱 실행

NeoSQL 데스크톱 앱을 실행합니다.

오프라인 모드 선택

로그인 화면 하단의 "오프라인 모드로 시작" 링크를 클릭합니다.

라이선스 키 입력

발급받은 라이선스 키를 입력합니다. 마이페이지에서 자가 발급한 JSON 키 파일이 있다면, 파일을 드래그 앤 드롭하거나 업로드하여 자동으로 입력할 수 있습니다.

라이선스 파라미터 설정

"추가" 버튼을 클릭하면 기본 파라미터가 자동으로 생성됩니다. 각 항목을 라이선스에 맞게 입력합니다.

파라미터	설명	예시
`JDBC_URL`	오프라인에서 사용 가능한 JDBC 연결 URL (여러 개 입력 가능)	`jdbc:mariadb://db.example.com:3306/mydb`
`EXPIRED_DT`	라이선스 만료 일시	`2026-12-31 23:59:59`
`LOGIN_ID`	오프라인 사용자 식별 ID	`user@company.com`

Tip

"기억하기" 체크박스를 선택하면 라이선스 키와 파라미터가 로컬에 저장되어 다음 실행 시 자동으로 채워집니다.

인증 완료

"인증" 버튼을 클릭합니다. 라이선스가 검증되면 프로젝트 선택 화면으로 이동합니다.

참고: 라이선스 만료일이 지나면 자동으로 세션이 종료됩니다. 갱신된 라이선스 키로 다시 인증하세요.

오프라인 프로젝트 관리 NEW

오프라인 모드에서는 로컬 파일 시스템 기반으로 프로젝트를 관리합니다.

새 프로젝트 생성

프로젝트 생성 버튼 클릭

프로젝트 관리 화면에서 "New Database Project" 버튼을 클릭합니다.

디렉토리 선택

Location 항목의 "Search..." 버튼을 클릭하여 프로젝트 디렉토리를 선택합니다.

프로젝트 설정 및 저장

프로젝트 이름과 DBMS를 설정한 뒤 "Save"를 클릭합니다. 선택한 디렉토리에 .neosql/ 폴더가 자동 생성됩니다.

기존 프로젝트 불러오기

Import 버튼 클릭

프로젝트 관리 화면에서 "Import Project" 버튼을 클릭합니다. (오프라인 모드에서만 표시)

프로젝트 디렉토리 선택

기존 .neosql/ 폴더가 있는 디렉토리를 선택합니다. project-config.json이 감지되면 자동으로 프로젝트 설정을 불러옵니다.

Tip

.neosql/ 디렉토리를 Git에 커밋하면 팀원 간에 프로젝트 설정(ERD, 테이블 정의, 연결 정보)을 공유할 수 있습니다. 각 팀원이 같은 저장소를 clone 후 "Import Project"로 불러오면 동일한 환경에서 작업할 수 있습니다.

데이터 저장 구조

온라인 모드

프로젝트 데이터는 클라우드에 자동으로 동기화됩니다. 프로젝트를 열면 자동으로 동기화가 시작되며, 별도의 저장 작업이 필요 없습니다.

참고: 네트워크가 일시적으로 끊기더라도 로컬에 데이터가 유지되어 작업을 계속할 수 있습니다. 네트워크가 복구되면 자동으로 동기화가 재개됩니다.

오프라인 모드

모든 데이터는 프로젝트 디렉토리의 .neosql/ 폴더에 JSON 파일로 저장됩니다.

{project-root}/.neosql/
├── project-config.json                        # 프로젝트 설정 (이름, DBMS, 템플릿 팩 등)
├── connections/                               # DB 연결 정보
│   └── {connectionId}_{connectionName}/       # 연결별 디렉토리
│       ├── connection.json                    # 연결 설정 (호스트, 포트, 드라이버 등)
│       └── {schemaName}/                      # 스키마별 디렉토리
│           ├── {tableName}.json               # 테이블 정의 (컬럼, 인덱스, FK 등)
│           └── {tableName}_entity.json        # Java Entity 매핑 정보
├── erd/                                       # ERD 다이어그램
│   └── {erdId}.json                           # ERD 정의 (노드, 엣지, 레이아웃 등)
└── sql/                                       # SQL Editor 저장본
    └── {sqlId}.json                           # SQL 스크립트 (쿼리 본문, 메타데이터)

민감한 자격증명(DB 비밀번호, SSH 키 등)은 .neosql/에 저장되지 않고 OS 보안 저장소에 암호화되어 저장됩니다. 따라서 .neosql/ 폴더를 Git에 커밋해도 비밀번호가 포함되지 않으며, 자격증명은 각 팀원의 PC에 개별 저장됩니다.

데이터 이동성

실행 모드는 프로젝트 생성 시점에 결정되며, 한 번 만든 프로젝트의 모드를 사후에 전환할 수는 없습니다. 다만 오프라인 모드의 .neosql/ 폴더는 그 자체로 이식 가능한 데이터 묶음이므로 다른 머신·팀원에게 전달해 동일한 프로젝트를 재구성할 수 있습니다.

모드 간 전환이 불가능한 이유

오프라인 모드는 로컬 파일 시스템(.neosql/ 폴더)을, 온라인 모드는 PouchDB ↔ CouchDB 동기화를 사용해 저장 백엔드 자체가 다릅니다. 따라서 한 번 오프라인으로 만든 프로젝트는 클라우드에 올릴 수 없고, 반대로 온라인 프로젝트를 그대로 다운로드해 폐쇄망에서 사용할 수도 없습니다. 환경 전환이 필요하다면 새 모드에서 프로젝트를 다시 만든 뒤 ERD·SQL 정의만 별도 마이그레이션 도구로 옮겨야 합니다.

오프라인 프로젝트의 팀 공유

오프라인 .neosql/ 폴더는 일반 텍스트 JSON으로 구성되어 있으며, 자격증명(DB 비밀번호, SSH 키 등)은 .neosql/에 저장되지 않고 OS 보안 저장소에 별도로 들어갑니다. 즉, .neosql/ 폴더를 Git 저장소에 커밋해도 비밀번호 누출 위험 없이 ERD·테이블 정의·SQL 스크립트를 팀원과 공유할 수 있습니다.

프로젝트를 만든 사용자가 프로젝트 디렉토리의 .neosql/ 폴더를 Git에 커밋·푸시합니다.
팀원이 동일 저장소를 clone합니다.
팀원의 NeoSQL 데스크톱 앱에서 "Import Project"로 .neosql/ 폴더가 있는 디렉토리를 선택하면 동일한 ERD·SQL 환경에서 작업을 이어갈 수 있습니다.
각 팀원은 자기 PC에서 OS 키체인에 DB 비밀번호를 개별 입력해 사용합니다 — 자격증명이 저장소에 들어가지 않으므로 보안이 유지됩니다.