Início rápido

Execute o pacote SQLly Embedded no localhost em cinco minutos: inicie a ponte e o app de exemplo, vincule uma licença, adicione um perfil e abra o SQLly como usuário.

Isso executa todo o pacote SQLly Embedded em uma máquina: o bridge, seu mecanismo e o aplicativo de administração de exemplo. Tudo permanece em localhost, e o teste gratuito na sua conta sqlly.app cobre isso. Você precisa de Node.js 20 ou superior, além de um banco de dados que o SQLly consiga alcançar.

Execute

  1. Baixe e descompacte o pacote SQLly Embedded para sua plataforma a partir de Downloads (Linux x86-64 e arm64, macOS Apple silicon, Windows x86-64 e arm64). No Linux, descompacte com tar -xzf para que os executáveis mantenham suas permissões.

    Para automatizar via script, cada plataforma tem um link estável que sempre entrega o pacote mais recente gerado para ela. Se um lançamento não foi gerado para a sua plataforma, o link entrega o mais recente que foi.

    PlataformaPacote mais recente
    Linux x86-64https://sqlly.app/download/embedded/latest/linux-amd64
    Linux arm64https://sqlly.app/download/embedded/latest/linux-arm64
    macOS Apple siliconhttps://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

    Adicionar /version para qualquer um deles (por exemplo /download/embedded/latest/linux-amd64/version) para obter a versão e o nome do arquivo como JSON sem baixar.

  2. Inicie tudo do sqlly-embedded pasta:

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

    O script cria .env de .env.example, verifica o Node.js, gera o token de gerenciamento compartilhado na primeira execução, inicia a ponte, aguarda sua API de gerenciamento e inicia o app de exemplo em http://127.0.0.1:8090.

  3. Faça login como administrador em http://127.0.0.1:8090/admin com sqlly-admin / GoodLittlePiggy. (O aplicativo de exemplo se recusa a escutar em qualquer coisa que não seja o loopback até você trocar essa senha.)

  4. Vincule uma licença. Ativado Status, clique em Conecte-se ao sqlly.app, então Abra o sqlly.app para aprovar. Faça login no sqlly.app, verifique se o código corresponde ao da sua página de administrador, escolha uma licença (sua versão de teste funciona) e clique Aprovar. A página de Status percebe sozinha e mostra a conta vinculada. Esta instalação agora tem a própria chave, e a ponte a mantém entre reinicializações.

    Prefere configuração? Gere uma chave em sua página Embedded e defina SQLLY_EMBEDDED_LICENSE_KEY em .env antes de iniciar. Planos offline definem SQLLY_EMBEDDED_LICENSE_FILE para o arquivo baixado em vez disso.

  5. Crie um perfil. Perfis → Criar perfil, dê um nome e adicione uma conexão: escolha o mecanismo, preencha servidor, banco de dados e login. Clique Teste para provar que a ponte pode alcançá-lo; o resultado aparece no formulário antes de você salvar. Então Inicialização abre o SQLly com esse perfil em uma nova aba.

  6. Adicione um usuário. Usuários → Criar usuário com um nome de usuário, uma senha e o perfil. Abra http://127.0.0.1:8090/ em uma janela privada, faça login como esse usuário, e clique Abrir SQLly. É essa a experiência que seus próprios usuários terão.

Ao voltar para Status você verá o assento que esse usuário ocupa agora. Feche a aba SQLly dele e o assento se libera.

As configurações em .env

ConfiguraçãoPara que serve
SQLLY_EMBEDDED_LICENSE_KEYUma chave de licença conectada (sqe_…). Deixe vazio para fazer o vínculo pela página de administração.
SQLLY_EMBEDDED_LICENSE_FILEUm arquivo de licença offline. Não defina os dois.
SQLLY_EMBEDDED_MANAGE_TOKENO segredo compartilhado entre o bridge e o app de administração. Gerado na primeira execução.
SQLLY_EMBEDDED_DOMAINO domínio de onde seu aplicativo é servido. Deixe vazio no localhost. Defini-lo vincula uma licença não vinculada na primeira verificação.
SQLLY_EMBEDDED_PUBLIC_URLO wss://…/proxy URL que os navegadores usam, uma vez que você esteja atrás de um proxy reverso.
SQLLY_EMBEDDED_STATE_DIROnde o bridge mantém perfis, o cache de licenças e uma chave vinculada.

Cada flag de ponte tem uma variável de ambiente; a lista completa está em Indo para produção.

O que há no pacote

CaminhoO que é
bin/sqlly-bridgeA ponte SQLly; sqlly-bridge embedded … é o modo que este pacote utiliza.
bin/sqlly-cliO mecanismo que a ponte inicia por sessão. Mantenha-o ao lado da ponte.
web/A build do SQLly para navegador: index.html, boot.js, spill-worker.js, sqlly_browser.js, sqlly_browser_bg.wasm, sqlly2.svg. Independente de plataforma.
sample-app/O aplicativo de exemplo de administração e inicialização. server.js é o roteamento, lib/bridge.js um cliente completo da API de gerenciamento, lib/credentials.js constrói documentos de credenciais.
start-sample.sh, start-sample.cmdInicie a ponte e o aplicativo de exemplo juntos a partir de .env.

Próximo

Faça o tour do aplicativo de exemplo para ver cada tela, ou ir direto para construindo seu próprio aplicativo.