빠른 시작

5분 만에 로컬호스트에서 SQLly Embedded 패키지 실행하기: 브리지와 샘플 앱을 시작하고, 라이선스를 연결하고, 프로필을 추가하고, 사용자처럼 SQLly를 열어 봅니다.

이는 머신 한 대에서 SQLly Embedded 패키지 전체를 실행합니다: 브리지, 엔진, 샘플 관리자 앱. 모든 것이 머무는 곳은 localhost, 그리고 sqlly.app 계정의 무료 체험으로 충분합니다. 필요한 것은 Node.js 20 이상, 그리고 SQLly가 접근할 수 있는 데이터베이스가 필요합니다.

실행하기

  1. 다운로드 후 압축 해제 플랫폼에 맞는 SQLly Embedded 패키지를 다음에서 다운로드 (Linux x86-64 및 arm64, macOS Apple Silicon, Windows x86-64 및 arm64). Linux에서는 다음으로 압축을 풉니다 tar -xzf 그래서 실행 파일은 권한을 유지합니다.

    스크립트로 설치할 수 있게, 각 플랫폼마다 그 플랫폼용으로 빌드된 최신 패키지를 항상 내려주는 안정 링크가 있습니다. 어떤 릴리스가 그 플랫폼용으로 빌드되지 못했다면, 링크는 빌드된 가장 최신 패키지를 내려줍니다.

    플랫폼최신 패키지
    Linux x86-64https://sqlly.app/download/embedded/latest/linux-amd64
    Linux arm64https://sqlly.app/download/embedded/latest/linux-arm64
    macOS 애플 실리콘https://sqlly.app/download/embedded/latest/macos-arm64
    Windows x86-64https://sqlly.app/download/embedded/latest/windows-amd64
    Windows arm64https://sqlly.app/download/embedded/latest/windows-arm64
    curl -fsSL -o sqlly-embedded.tar.gz https://sqlly.app/download/embedded/latest/linux-amd64
    tar -xzf sqlly-embedded.tar.gz

    추가 /version 를 어느 경로에나 붙이면 됩니다(예를 들어 /download/embedded/latest/linux-amd64/version) 다운로드 없이 버전과 파일 이름을 JSON으로 받아 볼 수 있습니다.

  2. 전체 시작 에서 sqlly-embedded 폴더:

    macOS / Linux
    ./start-sample.sh
    Windows
    start-sample.cmd

    스크립트가 만드는 것은 .env 에서 .env.example, Node.js를 확인하고, 첫 실행 시 공유 관리 토큰을 생성하며, 브리지를 시작하고, 관리 API를 대기한 후, 샘플 앱을 시작합니다. http://127.0.0.1:8090.

  3. 관리자로 로그인 에서 http://127.0.0.1:8090/admin 와 함께 sqlly-admin / GoodLittlePiggy. (샘플 앱은 그 암호를 바꾸기 전까지는 루프백 이외의 주소로 수신을 거부합니다.)

  4. 라이선스를 연결하세요. 켬 상태, 다음을 클릭 sqlly.app에 연결, 그런 다음 승인하려면 sqlly.app을 여세요. sqlly.app에 로그인하고, 코드가 관리자 페이지의 코드와 일치하는지 확인한 후, 라이선스를 선택하세요(체험판도 사용 가능) 그리고 클릭하세요 승인. 상태 페이지가 이를 자동으로 감지해 연결된 계정을 표시합니다. 이 설치에는 이제 자체 키가 있으며, 브리지는 재시작 시에도 이를 유지합니다.

    구성 파일로 하고 싶나요? 키 발급은 Embedded 관리 페이지 그리고 다음을 설정하세요 SQLLY_EMBEDDED_LICENSE_KEY in .env 시작하기 전에 넣습니다. 오프라인 플랜은 대신 다음을 설정합니다 SQLLY_EMBEDDED_LICENSE_FILE 대신 다운로드한 파일로.

  5. 프로필을 생성하세요. 프로필 → 프로필 생성, 이름을 입력하고 연결을 추가하세요. 엔진을 선택하고 서버, 데이터베이스, 로그인 정보를 입력한 후 테스트 를 클릭해 브리지가 연결할 수 있는지 확인하세요. 저장하기 전에 결과가 폼에 표시됩니다. 그다음 실행 해당 프로필로 새 탭에서 SQLly를 엽니다.

  6. 사용자를 추가합니다. 사용자 → 사용자 생성 사용자 이름과 비밀번호, 그리고 프로필과 함께 전달합니다. 다음을 여세요 http://127.0.0.1:8090/ 비공개 창을 열어 그 사용자로 로그인한 뒤 SQLly 열기. 다음

다시 상태 화면에서 이제 그 사용자가 차지한 좌석이 표시됩니다. 그 사용자의 SQLly 탭을 닫으면 좌석이 해제됩니다.

다음에 있는 설정은 .env

설정용도
SQLLY_EMBEDDED_LICENSE_KEY연결된 라이선스 키(sqe_…). 대신 관리 페이지에서 연결하려면 비워두세요.
SQLLY_EMBEDDED_LICENSE_FILE오프라인 라이선스 파일. 두 가지를 모두 설정하지 마세요.
SQLLY_EMBEDDED_MANAGE_TOKEN브리지와 관리자 앱이 쓰는 공유 비밀값. 처음 실행 때 생성됩니다.
SQLLY_EMBEDDED_DOMAIN앱이 서비스되는 도메인입니다. localhost에서는 비워 두세요. 설정해 두면 첫 체크인 때 아직 바인딩되지 않은 라이선스가 바인딩됩니다.
SQLLY_EMBEDDED_PUBLIC_URL그 wss://…/proxy 브라우저가 사용하는 URL로, 리버스 프록시 뒤에 있을 때 쓰입니다.
SQLLY_EMBEDDED_STATE_DIR브리지가 프로필, 라이선스 캐시 및 연결된 키를 저장하는 위치.

모든 브리지 플래그에는 환경 변수 형태가 있고, 전체 목록은 다음 문서에 정리되어 있습니다 프로덕션에 배포하기.

패키지에 포함된 내용

경로무엇인지
bin/sqlly-bridgeSQLly 브리지; sqlly-bridge embedded … 이 패키지가 사용하는 모드입니다.
bin/sqlly-cli세션마다 브리지가 시작하는 엔진입니다. 브리지 옆에 두세요.
web/SQLly 브라우저 빌드: index.html, boot.js, spill-worker.js, sqlly_browser.js, sqlly_browser_bg.wasm, sqlly2.svg플랫폼 독립적입니다.
sample-app/샘플 관리 및 실행기 앱. server.js 라우팅이며, lib/bridge.js 완전한 관리 API 클라이언트, lib/credentials.js 자격 증명 문서를 생성합니다.
start-sample.sh, start-sample.cmd브리지와 샘플 앱을 함께 시작하려면 .env.

다음

먼저 샘플 앱 투어 각 화면을 보거나 바로 이동하세요 직접 앱 만들기.