Conectar NAS por Reverse SSH e Docker como armazenamento próprio (exemplo QNAP)

Sobre o que se trata

Com Reverse SSH, você mesmo estabelece uma conexão criptografada (túnel) de saída para PaperOffice. Não é necessária nenhuma liberação de porta no roteador. PaperOffice AI armazena os documentos criptografados de um Workspaces em seu NAS.

Crie o armazenamento antes de criar o Workspace. O modo de armazenamento de um Workspaces é definitivo após a criação.

Passo 1: Preparar NAS (exemplo QNAP)

Os menus no QTS podem variar ligeiramente dependendo da versão do QTS.

  1. Crie uma pasta de compartilhamento própria, por exemplo paperoffice, não a pasta de PaperOffice Classic ou do MariaDB.
  2. Permita SSH e SFTP em Painel de Controle › Serviços de Rede e Arquivos › Telnet / SSH.
  3. Em "Editar permissões de acesso", insira o usuário NAS com o qual você fará login. Se ele não estiver nesta lista, o NAS rejeitará o login SSH.
  4. Instale a Container Station (Docker). Você pode manter a pasta de compartilhamento sugerida para contêineres.

Synology: Gerenciador de Contêineres, serviço Home do Usuário ativo, usuário no grupo administrators. ASUSTOR: Motor Docker. UGREEN: Docker.

Passo 2: Criar armazenamento em PaperOffice AI

  1. Abra Document AI › Storage Mounts e clique em Adicionar Storage Mount.
  2. Os campos com asterisco vermelho (*) são obrigatórios.
  3. Nome para este Storage Mount: à sua escolha.
  4. Referência: Usar como BYOS-Storage.
  5. Tipo de Conexão: Conectar pasta local via Reverse-SSH.
  6. Seu NAS: Selecione QNAP. O aplicativo sugerirá então /share/paperoffice (Synology, ASUSTOR, UGREEN: /volume1/paperoffice).
  7. Usuário SSH local: seu usuário no NAS. Ele deve ser membro dos administradores.
  8. Pasta local: o caminho completo para a pasta; no QNAP, /share/<Name des Freigabeordners>. Sem aspas, barra invertida e * ? [ ]. A pasta e o usuário não podem ser alterados posteriormente.
  9. Senha de Criptografia e Confirmar senha: pelo menos 16 caracteres, ou Gerar senha segura (símbolo de chave).
  10. Clique em Baixar como .txt. Somente depois disso é possível criar o armazenamento. Guarde o arquivo com segurança: sem a Senha, não há recuperação.
  11. Marque a caixa de confirmação e salve.

Passo 3: Escolher o bloco de configuração correto

Após salvar, a janela Configuração Reverse-SSH abre com sua Alias do túnel. No topo, selecione a variante:

  • NAS com Docker: um bloco que inicia um pequeno contêiner de túnel. A escolha correta para QNAP com Container Station.
  • NAS sem Docker: Bloco 1 via SSH uma vez, Bloco 2 na inicialização automática.
  • Linux / macOS e Windows: para computadores.

Copie o bloco com Copiar configuração. Em NAS sem Docker, cada um dos dois blocos possui seu próprio botão.

Passo 4: Conectar-se ao NAS e inserir o bloco

No Windows, por exemplo, com PuTTY (as designações podem variar ligeiramente dependendo da versão):

  1. Insira no Host o endereço IP do seu NAS na rede doméstica, Porta 22 e abra a conexão.
  2. Faça login com o usuário NAS do passo 2. Ao inserir a senha, nenhum caractere será exibido. Isso é normal.
  3. Se o QNAP exibir um menu de console após o login (por exemplo, "Console Management"), saia dele para acessar a linha de comando normal, dependendo da versão do QTS, usando Q e depois Y.
  4. Um clique com o botão direito na janela insere o bloco. Pressione Enter em seguida.

No Mac: Abra o programa Terminal e execute ssh <Benutzer>@<IP-Adresse des NAS>.

O bloco deve ser inserido apenas nesta janela no NAS. O NAS precisa de acesso à internet: o túnel é estabelecido do seu NAS para o exterior, e o contêiner carrega um pequeno pacote Linux durante a inicialização.

Passo 5: Testar a conexão

  1. Abra o armazenamento em Storage Mounts com Editar.
  2. Clique em Testar Conexão (disponível apenas após salvar).
  3. Sucesso: "Túnel ativo: NAS acessível e pasta gravável." Em seguida, crie o Workspace com Armazenamento Próprio (BYOS).

Se o teste indicar login negado, verifique o usuário NAS e a lista de acesso do passo 1. Insira a configuração novamente como o usuário NAS registrado e teste novamente.

O que o trace mostra

Testar Conexão na visão geral inicia o rastreamento PaperOffice com o mapa. Em Reverse SSH, o destino é o servidor do túnel de PaperOffice, não a sua NAS. As localizações são nós de rede nesse caminho, não o local de armazenamento dos seus arquivos.

Após uma reinicialização

O contêiner do túnel inicia automaticamente após cada reinicialização assim que Docker estiver em execução. Se a conexão for interrompida, ele reconectará após 10 segundos. Sem Docker, o bloco 2 no inicialização automática garante o funcionamento.

Segurança: O bloco de configuração contém uma chave privada

O bloco contém uma chave privada e a registra como chave de login para o seu usuário NAS. Quem possui o bloco pode se passar pelo seu túnel e, onde o serviço SSH do seu NAS estiver acessível para ele, fazer login como o seu usuário NAS. A sua senha de criptografia não está no bloco.

  • Nunca insira o bloco em chats, assistentes de IA, e-mails ou tickets de suporte.
  • O suporte não precisa do bloco. Em vez disso, informe a mensagem de erro do teste.

Wenn es doch passiert ist:

  1. Exclua a mensagem, sempre que possível.
  2. Não existe um botão "Gerar nova chave". Ao editar, a chave permanece a mesma.
  3. Se nenhum Workspace ainda usa o armazenamento: exclua o Storage Mount. PaperOffice remove a chave do servidor do túnel; os arquivos no NAS permanecem. Crie o armazenamento novamente (nova chave, novo alias do túnel), com a mesma senha de criptografia ou uma pasta vazia.
  4. Remova a chave antiga no NAS: na pasta .ssh do seu usuário NAS, exclua a linha em authorized_keys que termina com "PaperOffice" e o alias do túnel antigo, e o arquivo paperoffice_<alter Tunnel-Alias>. Com Docker: exclua na sua interface Docker (QNAP: Container Station) o contêiner antigo, cujo nome começa com paperoffice-tunnel-. Sem Docker: exclua no mesmo diretório .ssh o script paperoffice_tunnel_<alter Tunnel-Alias>.sh e remova a entrada antiga da inicialização automática.
  5. Se um Workspace já usa o armazenamento, ele não pode ser excluído. Crie então um ticket no app em Suporte e informe que a chave foi exposta. Não insira o bloco nisso.

Continuar