Já está em um diretório remoto e precisa enviar um arquivo de configuração ou trazer um log de volta para o seu dispositivo? A implementação nativa de ZMODEM do NeoServer permite transferir arquivos dentro do terminal SSH: execute rz para enviar ou sz para baixar. Um painel de transferência cuida da seleção de arquivos, do progresso, da confirmação de recebimento e do cancelamento.
Suporte no iOS e macOS
O fluxo abaixo usa o terminal iOS do NeoServer, incluindo o app baseado em iOS no macOS. O terminal nativo separado do macOS ainda não tem essa integração ZMODEM na implementação atual. Em um Mac, verifique qual edição você está usando antes de testar os comandos.
Aqui, ZMODEM nativo significa que o protocolo de transferência é implementado diretamente em Swift, incluindo o enquadramento de dados, a verificação de CRC e a retransmissão. Não é necessária extensão de navegador nem ponte de transferência em JavaScript.
Prepare o servidor remoto
Use uma conexão de terminal SSH e verifique se a máquina remota oferece rz e sz. O projeto lrzsz fornece implementações de linha de comando dos protocolos de transferência. Confira os comandos no seu shell remoto:
command -v rz
command -v sz
Se algum dos comandos estiver ausente, instale o pacote lrzsz da distribuição do seu servidor ou peça ao administrador do servidor que o forneça. O NeoServer cuida do lado cliente; a máquina remota ainda precisa do remetente ou do receptor correspondente.
Comece com um shell SSH direto. Conexões Mosh não carregam o fluxo bruto de bytes do terminal exigido por essa integração. Se você usa tmux, screen ou zellij, essa camada intermediária também precisa transmitir o tráfego ZMODEM corretamente.
Envie arquivos com rz
rz significa que a máquina remota recebe os arquivos. Do ponto de vista do seu dispositivo, isso é um upload.
- No terminal remoto, acesse o diretório de destino e confirme-o com
pwd. - Execute
rz. - O NeoServer abre seu painel ZMODEM. Selecione Choose Files e escolha um ou mais arquivos locais.
- Acompanhe o progresso e aguarde a conclusão antes de voltar ao trabalho normal no terminal.
cd ~/uploads
pwd
rz
O diretório de destino já deve existir e ser gravável pela sua conta SSH. Os arquivos são enviados ao receptor em execução naquele diretório. Se um arquivo com o mesmo nome já existir remotamente, as opções do receptor remoto determinam como ele trata esse conflito.
O NeoServer prepara cópias locais dos arquivos selecionados para envio e os transmite em blocos. As cópias temporárias de upload são removidas quando a transferência é concluída, cancelada ou desconectada.
Baixe arquivos com sz
sz faz a máquina remota enviar arquivos ao NeoServer. Informe um ou mais caminhos de arquivos remotos:
sz server.log
Para vários arquivos, liste-os juntos. Use aspas em caminhos que contenham espaços:
sz server.log report.json "build output.txt"
O NeoServer apresenta cada arquivo recebido para confirmação. Escolha Receive File para aceitá-lo ou Skip File para deixá-lo de fora do lote. Os arquivos recebidos aparecem na seção Received Files do painel; use Save to Files para exportar os arquivos concluídos para o local escolhido.
No iOS, os downloads concluídos também ficam disponíveis na pasta ZMODEM do NeoServer no app Arquivos. Cada arquivo recebido é armazenado em seu próprio diretório, então downloads separados não sobrescrevem uns aos outros no armazenamento local.
Verificações de CRC e arquivos incompletos
O ZMODEM adiciona verificações de integridade aos seus quadros de transferência e blocos de dados. Para uma explicação em nível de protocolo, consulte a documentação ZMODEM do Tera Term.
O NeoServer aceita quadros Hex, Binary16 e Binary32 recebidos, com verificação CRC16 ou CRC32 conforme apropriado. Os uploads usam CRC16. Um erro de checksum pode acionar uma nova tentativa ou uma retransmissão a partir de um offset durante a sessão de transferência atual.
Os downloads são gravados em um arquivo temporário .partial. O NeoServer só move o download para o nome de arquivo final depois que as verificações de transferência passam, incluindo o tamanho esperado quando o remetente o informa. Transferências canceladas, com falha ou desconectadas removem os arquivos de download inacabados; os arquivos já concluídos permanecem disponíveis.
O CRC detecta corrupção na transferência; ele não estabelece quem criou um arquivo. Se você precisa de uma verificação independente de ponta a ponta, compare um hash criptográfico do arquivo de origem e do arquivo recebido usando ferramentas disponíveis nas duas máquinas.
Cancelar, repetir e limites de transferência
Durante uma transferência, o NeoServer bloqueia a entrada normal do teclado do terminal para evitar misturar teclas com dados do protocolo. Use Cancel no painel ZMODEM para interromper a transferência.
Fique atento a estes limites:
- Somente arquivos. A transferência de diretórios não é suportada. Compacte o diretório primeiro e envie o arquivo compactado.
- Tamanho máximo por arquivo: no máximo 4.294.967.295 bytes, ou 4 GiB menos um byte.
- As novas tentativas pertencem à sessão atual. O NeoServer não salva o estado de retomada entre conexões desconectadas. Reconecte e inicie uma nova transferência se a conexão cair.
- Use SSH. Essa integração não funciona pelo caminho do terminal Mosh nem por um transporte de 7 bits.
Se rz ou sz não abrir o painel de transferência
Primeiro confirme que o comando existe na máquina remota e que você está usando a edição de terminal do NeoServer com suporte. Depois teste o mesmo comando em um shell SSH direto, fora de qualquer multiplexador de terminal.
Para uploads, verifique o diretório de destino remoto e as permissões da conta. Para downloads, verifique o caminho de origem e a permissão de leitura. Se uma transferência começa mas não termina, use a mensagem de erro do painel e tente de novo depois de conferir a conexão, o tamanho do arquivo e o espaço de armazenamento local.
O ZMODEM é útil quando você quer mover arquivos do diretório em que já está trabalhando. As ferramentas SFTP do NeoServer continuam úteis para navegar em pastas remotas e gerenciar arquivos visualmente. Para a conexão SSH inicial, consulte o guia de início rápido do NeoServer.
Pronto para experimentar?
NeoServer · SSH, Mosh, Docker & SFTP client for iPhone, iPad and Mac
Grátis na App Store