Sessões e ferramentas

O que cada campo, chave e configuração faz: 76 controles nesta página. É o texto por trás do ⓘ ao lado de cada rótulo nos apps: no computador, passe o ponteiro ou clique (ou pressione F1 no campo); no celular, toque nele.

A linha sob cada nome traz o identificador que o código usa e diz quando só um dos apps tem o controle.

Regra de encaminhamento

Onde: Encaminhamento de porta › Nova regra.

Que tipo de túnel?

forward.kind

Em que sentido o tráfego flui pela conexão SSH. Local (-L): uma porta neste dispositivo alcança um serviço do lado do host, por exemplo um banco de dados remoto. Remoto (-R): uma porta no host alcança um serviço neste dispositivo. Dinâmico (-D): um proxy SOCKS neste dispositivo que envia o tráfego de qualquer programa pelo host.

• Padrão: Local.

Host

forward.host

O host salvo pelo qual o túnel passa. A regra se conecta a ele com o login salvo desse host.

Nome da regra

forward.name

Qualquer coisa que ajude você a reconhecer a regra na lista. Obrigatório, até 256 caracteres.

• Exemplo: Postgres no db

Endereço de escuta

forward.bindAddress

Em qual endereço de rede a ponta de escuta do túnel abre: neste dispositivo para uma regra local ou dinâmica, no host para uma regra remota. 127.0.0.1 significa “só esta máquina”. 0.0.0.0 significa todas as redes em que a máquina está. Para uma regra remota, o endereço é só um pedido: quem decide é o servidor (a configuração GatewayPorts), e a maioria dos servidores mantém a porta no próprio 127.0.0.1, a menos que isso esteja ativado.

• Padrão: 127.0.0.1 (também usado quando o campo fica vazio).
• Exemplo: 127.0.0.1
• Atenção: Qualquer coisa diferente de 127.0.0.1 (ou localhost) permite que outros dispositivos na rede usem o túnel, sem senha. Uma regra assim só inicia depois que você a aprova neste dispositivo, e de novo após cada alteração.

Porta local

forward.bindPort

A porta em que o túnel escuta: neste dispositivo para uma regra local ou dinâmica, no host para uma regra remota. É a porta à qual seu programa se conecta. De 1 a 65535.

• Exemplo: 5432
• Atenção: Portas abaixo de 1024 geralmente exigem direitos de administrador, e uma porta já em uso não pode ser aberta.

Host de destino

forward.destHost

Para onde o túnel leva. Para uma regra local, é visto a partir do host, então “localhost” significa o próprio host e um nome privado como db.internal funciona. Para uma regra remota, é visto a partir deste dispositivo. Uma regra dinâmica não tem destino.

• Exemplo: localhost ou db.internal

Porta de destino

forward.destPort

A porta do serviço no destino, de 1 a 65535.

• Exemplo: 5432 para PostgreSQL, 80 para um servidor web

Início automático

forward.autoStart

Quando a regra inicia sozinha: nunca (você a inicia pela lista), cada vez que o host dela conecta ou quando o app é aberto. Você sempre pode iniciá-la e pará-la manualmente.

• Padrão: Nunca: você a inicia manualmente.
• Atenção: Uma regra que inicia com o app se conecta ao host sem perguntar; se a chave precisar de frase secreta, ela aguarda com “Precisa de entrada”. Uma regra de um cofre de equipe ou de um cofre compartilhado com você, ou que abre uma porta que outros dispositivos alcançam, não inicia sozinha até você aprová-la neste dispositivo (ela aguarda com “Aguardando aprovação”), e a pergunta volta após cada alteração.

Snippet

Onde: Snippets › Novo snippet.

Nome

snippet.name

O que você vai procurar na lista. Um snippet é um comando ou script salvo que você pode digitar em qualquer sessão. Obrigatório, até 256 caracteres.

• Exemplo: Reiniciar nginx

Descrição

snippet.description · Só no computador

Uma linha opcional sobre o que o snippet faz, para você e para quem compartilha o cofre.

Pacote

snippet.package

Uma pasta para snippets relacionados. Os pacotes só organizam a lista; não mudam como um snippet é executado.

• Padrão: Sem pacote.

Descreva o que ele deve fazer

snippet.aiPrompt

Descreva a tarefa com palavras simples e o provedor de IA de Configurações › IA escreve o script no campo abaixo (e um nome, se o nome estiver vazio). Só esta descrição é enviada. Nada é salvo até você salvar.

• Exemplo: reiniciar o nginx e acompanhar o log de erros
• Atenção: Gerar substitui o que está no campo Script. Leia o resultado antes de salvar ou executar.

Script

snippet.script

O texto digitado na sessão, exatamente como escrito; várias linhas não são problema. Escreva {{name}} para ser solicitado um valor antes de cada execução, ou {{name:default}} para oferecer um padrão. {{$HOST}}, {{$USER}}, {{$PORT}} e {{$NAME}} são preenchidos, nunca solicitados: o endereço, o nome de usuário com que faz login, a porta SSH e o nome de exibição do host do terminal para onde vai (um terminal local não tem host, então dê um padrão, como em {{$USER:root}}). Até 65.536 caracteres.

• Exemplo: sudo systemctl restart {{service:nginx}}; scp backup.tar {{$USER}}@{{$HOST}}:/tmp
• Atenção: Um valor que você é solicitado a informar é inserido como foi digitado, sem aspas: coloque-o entre aspas no script se ele puder ter espaços. Um valor embutido entra como dado para o shell que lê o script (sh, bash, zsh, dash, BusyBox). Um comando que executa seu argumento como script (sh -c, ssh host ‘…’, eval, su -c, watch) ou como aritmética (let, $(( )), [[ -eq ]]) o lê de novo: use ali um nome simples. Um valor que precisa de aspas só entra num host em que a verificação do próprio Sternway por uma conexão aberta (a que lê o sistema operacional) encontrou um shell de login POSIX ou fish (é preciso uma conexão aberta ao executar o snippet), e é recusado onde não pode ser colocado com segurança (entre crases, ${…}, aritmética, um comentário ou um here-document, ou logo depois de uma barra invertida), assim como um valor com caractere de controle. Uma barra invertida dentro das ‘…’ do próprio script impede um valor embutido entre aspas depois dela quando o snippet é digitado num terminal (cujo shell pode ser o fish mesmo quando o de login não é) ou o shell de login do host é o fish: nesses casos, ponha o valor embutido fora das aspas do próprio script; uma execução em hosts com “Coletar resultados” não é afetada. Um host em que essa verificação não pode rodar ou encontra outro shell (Windows, a CLI de um dispositivo de rede como Junos, Arista EOS ou NX-OS, PowerShell) só aceita valores simples. Um valor embutido que começa com - continua sendo lido como opção pelo comando que o recebe: ponha – antes dele (ssh – {{$HOST}}).

Atalho de teclado

snippet.shortcut · Só no computador

Uma combinação de teclas que executa este snippet no terminal que está em foco, como Executar: uma nota é colada, e um snippet que pede um valor abre o painel lateral para pedir. Clique no campo e pressione as teclas; Backspace ou Limpar remove. Guardado só neste dispositivo, não com o snippet.

• Exemplo: Ctrl+Alt+R
• Atenção: Os atalhos do próprio Sternway vêm primeiro: uma tecla que um deles usa, ou a de outro snippet, é recusada, assim como uma tecla sem Ctrl, Alt ou Cmd (fora uma tecla de função), ou Ctrl ou Alt com uma só tecla (Ctrl+C, Alt+B), que o terminal precisa. O atalho só funciona enquanto um terminal está em foco.

Tipo

snippet.kind

Um comando é digitado na sessão e, com Executar, seguido de Enter. Uma nota só é colada: ela vai para o prompt sem Enter, de qualquer lugar onde um snippet pode ser usado (também como snippet de início de um host), e não pode ser executada em todas as abas nem em vários hosts. Use uma nota para um texto que você quer deixar no prompt e conferir antes. Uma macro é uma lista de passos executados em um terminal: digita, espera o que o host imprime e responde a um pedido de senha com um segredo salvo no cofre dela. Ela nunca é colada, nem executada em todas as abas ou em vários hosts, nem usada como snippet de início.

• Padrão: Comando.
• Atenção: Uma versão mais antiga do app não conhece notas: lá, uma nota é um comando que pode ser executado. Macros nem aparecem nela.

Passos

snippet.macroSteps

Um passo por linha, executados em ordem no terminal em que a macro é iniciada. send digita o resto da linha e Enter (variáveis e integradas são preenchidas como em um script). wait for “texto” ou wait for /padrão/ espera até a saída mostrar isso, por 30 segundos ou pelo tempo escrito depois (como 10s, até 3600s); um padrão é verificado em um tempo que só cresce com o tamanho da saída, então nenhum padrão pode travar o app, e ele não pode usar referências anteriores nem lookaround. send secret identity “Nome” digita a senha salva dessa identidade e Enter (key “Nome”: a frase secreta de uma chave; host “Nome”: a senha salva de um host). pause 500ms ou pause 2s espera. Uma linha que começa com # é um comentário. Um passo cujo tempo acaba para a macro e diz a linha; Cancelar para a macro a qualquer momento.

• Exemplo: send sudo -i wait for “password for” send secret identity “Ops admin” wait for /[#$] $/ 10s send systemctl restart nginx
• Atenção: Um segredo só é procurado no cofre em que a macro está salva, então uma macro compartilhada com uma equipe não alcança seus segredos pessoais, e só é digitado em um terminal ao qual pertence: a senha de um host em uma sessão para esse host ou passando por ele, a de uma identidade ou chave em uma sessão que entra com ela; nunca em um terminal local. Só é digitado logo depois de uma espera, e só quando a linha que essa espera encontrou ainda é a última linha do terminal e é um pedido de senha que termina em “:” (que esconde o que é digitado); senão a macro para sem digitá-lo. Nunca é escrito na janela, no histórico de rolagem, em gravações, logs, na IA ou em uma sessão compartilhada: só para o host. Um padrão que exige trabalho demais para a saída para a macro, assim como bloquear o app. Ela também para se logo depois de um segredo vier qualquer pedido de senha (o mesmo: uma senha errada; ou outro, como uma senha logo depois de uma frase secreta) ou não houver resposta: nada mais é digitado.

Uma variável do script

snippet.variable

O valor colocado onde o script diz {{name}}. É inserido exatamente como digitado; uma quebra de linha é recusada.

• Padrão: O padrão escrito no script, se houver.

Nome

snippetPackage.name

O nome do pacote, uma pasta para snippets relacionados (por exemplo, “Docker” ou “Backups”). A lista de snippets pode ser filtrada por pacote, e um snippet pode estar em um pacote ou em nenhum. Excluir um pacote mantém os snippets dele.

• Exemplo: Docker

Cofre de destino

snippet.moveVault · Só no computador

O cofre para onde copiar ou mover o snippet. Todos com acesso a esse cofre poderão usá-lo.

Hosts

snippetRun.hosts · Só no computador

Os hosts onde executar o snippet: os marcados, ou (Por regra de tags) os hosts com as tags escolhidas quando ele executa.

Como executa

snippetRun.output · Só no computador

Abrir terminais: uma nova sessão SSH abre para cada host, em uma aba, e o script é digitado lá quando a sessão fica pronta. Coletar resultados: o script executa em cada host por um canal próprio (quatro hosts por vez, nada é digitado em terminal), e uma tabela mostra o status de cada host, o código de saída, quanto tempo levou e as últimas linhas impressas; Ver a saída tem o resto (até 64 KB), e Executar de novo repete onde falhou.

• Padrão: Abrir terminais.
• Atenção: Coletar resultados executa o script sem terminal: um comando que pergunta algo (a senha do sudo, um sim/não) espera uma resposta que nunca vem e para depois de dois minutos.

Salvar estes destinos como padrão

snippetRun.saveTargets · Só no computador

Lembra os hosts marcados, ou a regra de tags, com o snippet, para que já estejam escolhidos da próxima vez que você o executar em hosts. Uma regra de tags salva escolhe os hosts de novo a cada vez.

• Padrão: Desativado.

Nome do espaço de trabalho

workspace.name · Só no computador

Um espaço de trabalho é um conjunto salvo de abas e painéis divididos com os hosts neles, reaberto de uma vez. Obrigatório, até 256 caracteres.

• Exemplo: Dia de deploy

SFTP: arquivos e pastas

Onde: SFTP › “Novo” de um painel, o menu de um arquivo.

Nome

sftp.name

O nome do arquivo ou da pasta. Não pode ser vazio, “.” ou “..”, conter barra nem ser um nome já usado nesta pasta.

Nome do link

sftp.linkName · Só no computador

O nome do link simbólico: uma entrada que aponta para outro arquivo ou pasta, como um atalho.

Caminho de destino

sftp.linkTarget · Só no computador

O caminho para o qual o link aponta. É armazenado como digitado e não é verificado, então um link pode apontar para algo que ainda não existe.

• Exemplo: /var/www/releases/current

Permissões

sftp.permissionBits · Só no computador

Quem pode fazer o quê com o item. As linhas são o proprietário, o grupo do proprietário e todos os demais; as colunas são leitura, gravação e execução (para uma pasta, execução significa “pode entrar nela”). As caixas e o número octal mostram a mesma coisa. Com vários itens selecionados, uma caixa com um traço é uma que alguns têm e outros não; só as caixas que você altera são aplicadas, e cada item mantém o resto das próprias permissões.

Octal

sftp.octal

As mesmas permissões em três dígitos, um para proprietário, grupo e outros: leitura vale 4, gravação 2, execução 1, somados.

• Exemplo: 644 para um arquivo (o proprietário grava, todos leem), 755 para uma pasta ou programa
• Atenção: No desktop, o número define os três dígitos básicos de cada item; um quarto dígito inicial (setuid, setgid, sticky) é ignorado e esses bits ficam como cada item os tem. O celular aplica os quatro.

Aplicar ao conteúdo das pastas

sftp.recursive

Aplicar a alteração também a tudo dentro da pasta, em qualquer profundidade.

• Padrão: Desativado.
• Atenção: Com Alterar definido como arquivos e pastas, tudo dentro recebe a alteração, o que pode tornar arquivos executáveis ou pastas inacessíveis; escolha Só arquivos ou Só pastas para separá-los. Não há como desfazer.

Alterar

sftp.chmodOnly · Só no computador

Quais itens, e o que há dentro das pastas quando a alteração se aplica ao conteúdo, a recebem: arquivos e pastas, só arquivos ou só pastas. Links simbólicos são ignorados por Só arquivos e Só pastas.

• Padrão: Arquivos e pastas.
• Exemplo: Só pastas com 755 e depois Só arquivos com 644 para a raiz de um site

Proprietário (uid)

sftp.uid

O ID numérico do usuário proprietário do item. Deixe como está para manter o proprietário. Alterá-lo normalmente exige direitos de administrador no servidor.

• Exemplo: 1000

Grupo (gid)

sftp.gid

O ID numérico do grupo proprietário do item. Deixe como está para manter o grupo.

• Exemplo: 33 (www-data no Debian)

Aplicar a todos os conflitos restantes

sftp.conflictAll

Usar a resposta que você der agora para todos os outros arquivos desta transferência que já existem, em vez de perguntar sobre cada um.

• Padrão: Desativado.
• Atenção: Combinado com Substituir, os demais arquivos existentes são sobrescritos sem nova pergunta.

Aplicativo

sftp.openWithApp · Só no computador

O programa com que abrir o arquivo baixado: o caminho completo ou um comando no seu PATH. Ele é iniciado com o arquivo como único argumento. No Windows, deve ser um programa (.exe), não um iniciador .cmd ou .bat: para o VS Code, escolha Code.exe na pasta de instalação em vez de “code”.

• Exemplo: /usr/bin/code, ou C:\Program Files\Notepad++\notepad++.exe

Sempre usar este app para arquivos .…

sftp.openWithRemember · Só no computador

Lembrar este programa para a extensão do arquivo, para que “Abrir com” não pergunte de novo. A lista fica em Configurações › SFTP › Abrir com.

• Padrão: Ativado.

Host

openIn.host · Só no celular

O host salvo para o qual os arquivos compartilhados com o Sternway por outro app são enviados, via SFTP.

Diretório remoto

openIn.directory · Só no celular

A pasta nesse host para a qual os arquivos são enviados.

• Padrão: /tmp
• Exemplo: /home/ada/inbox

Conexão serial

Onde: Hosts › Novo › Conexão serial….

Porta

serial.port

A porta serial ou adaptador USB-serial a abrir: o cabo para o console de um roteador, switch ou placa.

• Padrão: No desktop, “Outro dispositivo…” com o caminho abaixo.

Caminho do dispositivo

serial.path · Só no computador

O nome de sistema da porta serial, para uma que a lista não mostra.

• Padrão: /dev/ttyUSB0, ou COM1 no Windows.
• Exemplo: /dev/ttyUSB0 no Linux, /dev/tty.usbserial-1410 no macOS, COM3 no Windows

Taxa de transmissão

serial.baud

A velocidade da linha em bits por segundo. Deve corresponder exatamente à do dispositivo, ou você verá lixo ou nada. O manual do dispositivo informa qual.

• Padrão: 115200 no desktop, 9600 no celular.
• Exemplo: 9600 para a maioria dos equipamentos de rede, 115200 para a maioria das placas de desenvolvimento

Taxa de transmissão personalizada

serial.customBaud

Uma velocidade que não está na lista: um número inteiro de 50 a 4000000.

• Exemplo: 250000

Bits de dados

serial.dataBits

Quantos bits formam um caractere. Quase tudo usa 8.

• Padrão: 8.

Bits de parada

serial.stopBits

Quantos bits marcam o fim de um caractere. Quase tudo usa 1.

• Padrão: 1.

Paridade

serial.parity

Um bit opcional de verificação de erro por caractere. Deve corresponder ao do dispositivo; a maioria não usa. A abreviação comum “8N1” significa 8 bits de dados, sem paridade, 1 bit de parada.

• Padrão: Nenhuma.

Controle de fluxo

serial.flow

Como as duas pontas avisam uma à outra para pausar: de nenhuma forma, com fios extras (RTS/CTS) ou com caracteres especiais (XON/XOFF). Use o que o manual do dispositivo indicar; a maioria dos consoles não usa nenhum.

• Padrão: Nenhum.

Compartilhar uma sessão

Onde: O menu de uma sessão › Compartilhar sessão; Sessões › Entrar em uma sessão compartilhada.

O link vale por

share.linkWorksFor · Só no computador

Por quanto tempo o link de convite deixa convidados entrarem. Quando o tempo acaba, o compartilhamento termina para todos, o servidor também o fecha e recusa quem ainda tiver o link; compartilhe de novo para ter um link novo. 1 hora, 24 horas ou 7 dias.

• Padrão: 24 horas.

Os convidados podem

share.guestsCan · Só no computador

Só assistir: os convidados veem o terminal e não podem digitar, e ninguém pode receber o controle; o servidor também recusa. Assistir e pedir o controle a você: um convidado pode pedir e só digita depois que você der o controle, que você pode retomar a qualquer momento.

• Padrão: Só assistir.

Link de convite

share.inviteLink

O link que permite a alguém assistir a este terminal ao vivo. Envie para a pessoa ou cole um que você recebeu para entrar. Um convidado precisa de uma conta no mesmo servidor Sternway e é admitido pelo anfitrião. O link funciona até o tempo escolhido em O link vale por (24 horas, a menos que você escolha outro), e para de vez antes disso quando você para de compartilhar ou a sessão fecha.

• Exemplo: https://sternway.example.com/share/…#…
• Atenção: A parte depois do # é a chave que descriptografa a sessão, então envie o link de forma privada. Qualquer pessoa que o tenha e uma conta no servidor pode pedir para participar.

Solicitações ao conectar

Onde: Aparecem quando uma conexão precisa de uma resposta.

Senha

prompt.password

A senha da sua conta no servidor indicado no título. Quando um servidor faz a própria pergunta (um código de uso único, por exemplo), o campo mostra a redação do servidor com um selo “Perguntado pelo servidor”.

• Atenção: O que você digita fica na memória durante esta execução do app, para que reconexões, SFTP e encaminhamentos de porta para o mesmo host não perguntem de novo. É esquecido quando o app bloqueia, você sai da conta ou o app fecha.

Ocultar o que eu digito

terminal.composeHide · Só no celular

Para uma senha, um token ou outro segredo que um programa no host pede. O campo Compor vira um campo de senha de uma linha: o que você digita aparece como pontos, e o teclado não sugere, não corrige nem aprende. “Inserir no prompt” então o digita no prompt exatamente como está, sem Enter e nunca encapsulado como colagem. É ativado sozinho quando Compor é aberto enquanto o host está pedindo uma senha.

• Padrão: Desativado; ativado quando o host está pedindo uma senha.

Salvar no host

prompt.savePassword

Guardar esta senha para não ser perguntado na próxima vez. Ela só é salva depois que o login dá certo: na identidade com que o host faz login, se ele usar uma (assim, todos os hosts que compartilham essa identidade a recebem), ou então no host.

• Padrão: Desativado.
• Atenção: Uma senha salva é armazenada no cofre e sincronizada com ele; em um cofre de equipe, os colegas que podem abrir o cofre podem usá-la.

Frase secreta

prompt.passphrase

A frase secreta que desbloqueia a chave privada indicada no título. Não é a senha da sua conta no servidor.

Lembrar durante esta sessão

prompt.rememberPassphrase

Manter a frase secreta na memória para que esta chave não pergunte de novo até o app bloquear, você sair da conta ou o app fechar. Ela nunca é gravada em disco.

• Padrão: Desativado.

Painel de IA

Onde: O botão de IA de um terminal (quando a IA está configurada em Configurações › IA).

O que você quer fazer?

aiPanel.command

Descreva uma tarefa com palavras simples e o provedor de IA escreve um comando de shell para ela. Só o seu pedido é enviado, nada do terminal. O comando é mostrado para você editar e nunca é executado por você.

• Exemplo: listar os 10 maiores arquivos em /var

Comando (você pode editá-lo antes de inserir)

aiPanel.draft

O comando que a IA escreveu. Edite à vontade; depois, “Inserir no prompt” o digita no terminal sem pressionar Enter, então você ainda decide se o executa.

• Atenção: Uma IA pode errar. Leia o comando, sobretudo um que exclua ou sobrescreva algo.

Sua pergunta

aiPanel.ask

Pergunte sobre o que está na tela. Sua pergunta e o texto que você tinha selecionado no terminal antes de abrir o painel (no máximo cerca de 8.000 caracteres) são enviados ao provedor de IA; nada mais do terminal é enviado.

• Exemplo: O que significa este erro?
• Atenção: Não selecione texto que contenha uma senha ou chave: a seleção sai deste dispositivo.

Logs

Onde: Logs (computador).

Comentário

logs.comment · Só no computador

Uma nota mostrada abaixo do log na lista, para você encontrá-lo de novo. Até 4000 caracteres. É sincronizada com o log.

• Exemplo: Migração do banco de dados, 12 de março

Aparência da sessão

Onde: O menu de um terminal › Aparência da sessão….

Tema

session.theme · Só no computador

As cores só desta sessão. Vale sobre o tema do host e do app até o painel fechar, e não é salvo em lugar nenhum.

• Padrão: O tema do host; senão, o do app.

Fonte

session.font

A fonte só desta sessão, enquanto ela estiver aberta.

• Padrão: A fonte do host; senão, a do app.

Tamanho da fonte

session.fontSize

O tamanho do texto só desta sessão, de 6 a 72 pixels. Fazer pinça para zoom em um terminal no celular muda este mesmo valor: o texto acompanha seus dedos e se ajusta a um tamanho inteiro quando você solta.

• Padrão: O tamanho do host; senão, o do app.

Altura da linha

session.lineHeight

O espaçamento entre linhas só desta sessão, como múltiplo do tamanho da fonte, de 0,8 a 2.

• Padrão: O valor do host; senão, o do app.

Texto em negrito

session.boldText · Só no celular

Se o texto que um programa marca como negrito é desenhado com peso maior só nesta sessão. Desativado, é desenhado com peso normal, que algumas fontes renderizam com mais nitidez em tamanhos pequenos. Vale até a sessão fechar.

• Padrão: A configuração do app.

Texto em negrito usa cores brilhantes

session.boldIsBright

Se o texto em negrito é desenhado na variante brilhante da sua cor só nesta sessão. Vale até a sessão fechar e não altera nenhuma configuração.

• Padrão: A configuração do app.

Destaque inteligente

session.smartHighlight

Se o Sternway colore o que reconhece na saída simples só nesta sessão. Desative para uma sessão cuja saída ele interpreta errado; os tipos coloridos continuam como definidos em Configurações › Terminal. Vale até a sessão fechar e não altera nenhuma configuração.

• Padrão: A configuração do host; senão, a do app.

Cursor

session.cursorStyle

O formato do cursor só nesta sessão: um bloco preenchido, um sublinhado ou uma barra fina. Uma barra fina é mais fácil de posicionar entre dois caracteres; um bloco é mais fácil de encontrar. Vale até a sessão fechar e não altera nenhuma configuração.

• Padrão: A configuração do app.

Cursor piscante

session.cursorBlink

Se o cursor pisca só nesta sessão. Desative se o movimento distrair você, ou ative se você perder o cursor em uma tela carregada. Vale até a sessão fechar e não altera nenhuma configuração.

• Padrão: A configuração do app.

Linhas do histórico de rolagem

session.scrollback

Quantas linhas de saída anterior esta sessão guarda, de 1.000 a 100.000.

• Padrão: A configuração do app.

Sino

session.bell

O que o sino do terminal faz só nesta sessão: piscar, tocar um som (vibrar no celular) ou nada.

• Padrão: A configuração do app.

Gravações de sessões e exportações

Onde: Configurações › Logs (computador); o menu de um terminal › Gravar esta sessão…; Gravações.

Gravação máxima (MB)

settings.recording.maxSizeMb · Só no computador

Até que tamanho uma gravação pode crescer, de 1 a 100 MB. Uma sessão que passa disso não é interrompida: a gravação é fechada e uma nova, parte 2, continua a partir dali. Cada parte é reproduzida sozinha. Nunca passa do espaço para gravações abaixo; reduzir esse espaço reduz isto também.

• Padrão: 50 MB.
• Mais: Leia mais (em inglês)

Manter gravações por (dias)

settings.recording.retentionDays · Só no computador

Gravações mais antigas que isto são excluídas deste dispositivo, de 0 a 3650 dias. 0 as mantém até você excluí-las (ou o espaço abaixo acabar). A retenção é aplicada quando o app inicia e depois que cada gravação termina.

• Padrão: 30 dias.
• Mais: Leia mais (em inglês)

Espaço para gravações (MB)

settings.recording.storageMb · Só no computador

Quanto espaço todas as gravações neste dispositivo podem ocupar juntas, de 16 a 65536 MB. Quando ocupam mais, as gravações concluídas mais antigas são excluídas até caberem. Uma gravação ainda em andamento nunca é excluída, nem a concluída mais recente, para que a parte que uma sessão longa acabou de fechar seja mantida.

• Padrão: 1.024 MB.
• Mais: Leia mais (em inglês)

Gravar também o que eu digitar nesta sessão

recording.sessionInput · Só no computador

Guarda na gravação as teclas que você digita, além do que o terminal mostrou. O que você digita depois de uma solicitação que o app reconhece (uma linha terminando em “password:”, “passphrase:”, “PIN:” e similares, também nos idiomas europeus comuns, russo, japonês, chinês e coreano, mesmo quando o programa exibe * a cada tecla) nunca é guardado, até Enter, Ctrl-C ou Ctrl-D.

• Padrão: Desativado: só o que o terminal mostrou é gravado.
• Atenção: O texto digitado pode conter segredos que o app não consegue reconhecer como tal: uma senha colada em uma linha de comando, um token, uma solicitação com outra redação (“Verification code:”, um idioma que a documentação não lista) ou uma que não esteja no fim da última linha. Esses seriam gravados.
• Mais: Leia mais (em inglês)

Formato do arquivo

export.format · Só no computador

O CSV abre em uma planilha: uma linha por evento abaixo de uma linha de cabeçalho. O NDJSON é um objeto JSON por linha, para scripts e ferramentas de log. Ambos têm os mesmos campos, listados na documentação.

• Padrão: CSV.
• Mais: Leia mais (em inglês)

De

audit.from · Só no computador

O primeiro dia a exportar, a partir do início dele no fuso horário do seu computador. Vazio: desde o primeiro evento da equipe.

• Mais: Leia mais (em inglês)

Até

audit.to · Só no computador

O último dia a exportar, até o fim dele no fuso horário do seu computador. Vazio: até agora.

• Mais: Leia mais (em inglês)

Tipos de evento

audit.types · Só no computador

Só estes tipos de evento entram no arquivo, separados por vírgulas (por exemplo, member.added, vault.shared). Vazio: todos os tipos. A documentação lista todos.

• Padrão: Todos os tipos.
• Mais: Leia mais (em inglês)