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
-
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 -xzfpara 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.
Plataforma Pacote mais recente Linux x86-64 https://sqlly.app/download/embedded/latest/linux-amd64Linux arm64 https://sqlly.app/download/embedded/latest/linux-arm64macOS Apple silicon https://sqlly.app/download/embedded/latest/macos-arm64Windows x86-64 https://sqlly.app/download/embedded/latest/windows-amd64Windows arm64 https://sqlly.app/download/embedded/latest/windows-arm64curl -fsSL -o sqlly-embedded.tar.gz https://sqlly.app/download/embedded/latest/linux-amd64 tar -xzf sqlly-embedded.tar.gzAdicionar
/versionpara 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. -
Inicie tudo do
macOS / Linuxsqlly-embeddedpasta:
Janelas./start-sample.shstart-sample.cmdO script cria
.envde.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 emhttp://127.0.0.1:8090. -
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.) -
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_KEYem.envantes de iniciar. Planos offline definemSQLLY_EMBEDDED_LICENSE_FILEpara o arquivo baixado em vez disso. -
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.
-
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ção | Para que serve |
|---|---|
SQLLY_EMBEDDED_LICENSE_KEY | Uma chave de licença conectada (sqe_…). Deixe vazio para fazer o vínculo pela página de administração. |
SQLLY_EMBEDDED_LICENSE_FILE | Um arquivo de licença offline. Não defina os dois. |
SQLLY_EMBEDDED_MANAGE_TOKEN | O segredo compartilhado entre o bridge e o app de administração. Gerado na primeira execução. |
SQLLY_EMBEDDED_DOMAIN | O 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_URL | O wss://…/proxy URL que os navegadores usam, uma vez que você esteja atrás de um proxy reverso. |
SQLLY_EMBEDDED_STATE_DIR | Onde 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
| Caminho | O que é |
|---|---|
bin/sqlly-bridge | A ponte SQLly; sqlly-bridge embedded … é o modo que este pacote utiliza. |
bin/sqlly-cli | O 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.cmd | Inicie 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.