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.
- Crie uma pasta de compartilhamento própria, por exemplo
paperoffice, não a pasta de PaperOffice Classic ou do MariaDB. - Permita SSH e SFTP em Painel de Controle › Serviços de Rede e Arquivos › Telnet / SSH.
- 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.
- 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
- Abra Document AI › Storage Mounts e clique em Adicionar Storage Mount.
- Os campos com asterisco vermelho (*) são obrigatórios.
- Nome para este Storage Mount: à sua escolha.
- Referência: Usar como BYOS-Storage.
- Tipo de Conexão: Conectar pasta local via Reverse-SSH.
- Seu NAS: Selecione QNAP. O aplicativo sugerirá então
/share/paperoffice(Synology, ASUSTOR, UGREEN:/volume1/paperoffice). - Usuário SSH local: seu usuário no NAS. Ele deve ser membro dos administradores.
- 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. - Senha de Criptografia e Confirmar senha: pelo menos 16 caracteres, ou Gerar senha segura (símbolo de chave).
- 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.
- 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):
- Insira no Host o endereço IP do seu NAS na rede doméstica, Porta
22e abra a conexão. - Faça login com o usuário NAS do passo 2. Ao inserir a senha, nenhum caractere será exibido. Isso é normal.
- 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
Qe depoisY. - 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
- Abra o armazenamento em Storage Mounts com Editar.
- Clique em Testar Conexão (disponível apenas após salvar).
- 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:
- Exclua a mensagem, sempre que possível.
- Não existe um botão "Gerar nova chave". Ao editar, a chave permanece a mesma.
- 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.
- Remova a chave antiga no NAS: na pasta
.sshdo seu usuário NAS, exclua a linha emauthorized_keysque termina com "PaperOffice" e o alias do túnel antigo, e o arquivopaperoffice_<alter Tunnel-Alias>. Com Docker: exclua na sua interface Docker (QNAP: Container Station) o contêiner antigo, cujo nome começa compaperoffice-tunnel-. Sem Docker: exclua no mesmo diretório.ssho scriptpaperoffice_tunnel_<alter Tunnel-Alias>.she remova a entrada antiga da inicialização automática. - 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.