Scanner não detectado no Ubuntu? Diagnostique primeiro o SANE

Você conecta o scanner, abre o Scanner de documentos e o aparelho não aparece. Antes de instalar um driver encontrado aleatoriamente, é preciso localizar a interrupção: o Ubuntu vê o dispositivo, o SANE o reconhece ou o aplicativo simplesmente não recebe a lista de scanners?

O diagnóstico abaixo segue essas camadas na ordem. Cada comando serve para escolher o seguinte, tanto com um scanner USB quanto com um modelo de rede sob o Ubuntu 22.04 ou 24.04.

Separar o problema de hardware do problema SANE

Comece com um scanner USB. O comando lsusb interroga diretamente o barramento USB. Ele permite verificar se o sistema vê um dispositivo a nível de hardware. Se precisar identificar mais precisamente os dispositivos e as portas USB, você também pode consultar nosso guia para listar as portas USB no Linux.

lsusb

Uma linha correspondente ao fabricante ou ao modelo do scanner indica que a conexão USB é visível pelo núcleo. Se nada mudar ao conectar o aparelho, teste outra porta, remova um eventual hub USB e cheque o cabo. Neste estágio, o Scanner de documentos e SANE ainda não são o problema.

Verifique a detecção pelo ferramenta SANE:

sane-find-scanner

sane-find-scanner procura scanners SCSI e USB, assim como seus arquivos de dispositivo. Uma detecção aqui confirma que o aparelho é acessível a nível de hardware. No entanto, isso não garante a presença de um backend SANE compatível. A documentação do Ubuntu de sane-find-scanner afirma que um dispositivo pode ser encontrado mesmo sem um backend utilizável.

A terceira verificação interroga a camada SANE que será utilizada pelos aplicativos:

scanimage -L

Para um scanner de rede, lsusb não traz nada. O scanner deve estar ligado, conectado à mesma rede local que o computador e acessível sem isolamento entre os clientes Wi-Fi.

Instalar e verificar as ferramentas do Ubuntu

Em uma instalação mínima, os comandos de diagnóstico ou o aplicativo podem estar ausentes. Instale os pacotes do Ubuntu previstos para esta camada:

sudo apt update
sudo apt install sane-utils simple-scan

sane-utils fornece entre outros scanimage e sane-find-scanner. simple-scan instala o Scanner de documentos. A instalação destes pacotes não fornece um driver universal para todos os scanners. Prepara a ferramenta de diagnóstico, mas a compatibilidade depende então do backend SANE e do modelo utilizado.

Verifique as versões dos pacotes oferecidas pelos repositórios ativos:

apt policy sane-utils simple-scan

A saída exibe entre outras as versões Installed e Candidate. Uma versão candidata sem versão instalada significa que o pacote está disponível, mas ausente. Uma candidata vazia indica um problema nos repositórios ou na configuração do APT. Neste caso, verifique as fontes do Ubuntu antes de buscar um pacote de terceiros.

Se sane-utils está instalado, relance scanimage -L. Se o aparelho aparecer, a base de software está em vigor. Você poderá então se concentrar no Scanner de documentos ao invés de modificar desnecessariamente o sistema.

Quando sane-find-scanner vê o dispositivo, mas scanimage não

Essa diferença indica que a detecção USB funciona, mas o SANE ainda não sabe como utilizar o scanner. Comece testando diretamente o backend:

scanimage -T

scanimage -T realiza um teste do backend SANE. Se o teste for bem-sucedido, a camada SANE responde corretamente. Se scanimage -L permanece vazio apesar disso, a lista retornada pelo backend pode estar incompleta, especialmente para dispositivos de rede. A página de manual de scanimage descreve a diferença entre a lista de dispositivos e o teste do backend.

Você pode aumentar temporariamente as mensagens do carregador de bibliotecas SANE:

SANE_DEBUG_DLL=3 scanimage -L

O comando exibe, então, informações adicionais sobre o carregamento dos backends. Procure por um erro de biblioteca ausente, arquivo de configuração inacessível ou backend ignorado. Este nível de logging serve para diagnóstico pontual. Não corrige nada e não deve permanecer definido permanentemente em sua sessão.

Se o log mostra um backend ausente, identifique primeiro o modelo exato e sua compatibilidade com SANE. Alguns fabricantes distribuem um pacote oficial, mas é necessário verificar sua origem, versão do Ubuntu e arquitetura antes de qualquer instalação. Não adicione um repositório desconhecido apenas porque um resultado de busca sugere um arquivo DEB.

Se o backend está carregado, mas o dispositivo continua ausente, passe para as permissões. Um dispositivo visível por lsusb pode permanecer inutilizável pela sua sessão de usuário.

Corrigir uma permissão USB corretamente

Observe os arquivos de dispositivo USB sem modificar seus direitos:

ls -l /dev/bus/usb/*/*

As entradas exibidas correspondem aos dispositivos do barramento. O proprietário, o grupo e os bits de permissão permitem ver se sua sessão pode acessá-los. Um erro de permissão no scanimage ou no log do SANE confirma esta pista, mas a ausência do scanner na lista não é suficiente por si só.

Desconecte o scanner, aguarde alguns segundos, e então reconecte-o diretamente ao computador. Em seguida, relance:

lsusb
sane-find-scanner
scanimage -L

Essa reconexão força a recriação do arquivo em /dev/bus/usb e permite verificar a regra udev aplicada ao dispositivo. Se o acesso funciona apenas após uma reconexão ou somente em uma sessão específica, verifique sua identidade e os grupos realmente associados à sessão:

id
groups

Uma modificação de grupo só é considerada após um novo login, mas adicionar cegamente o usuário a um grupo chamado scanner não é um método confiável. Este grupo pode não existir, não ser utilizado pela regra do dispositivo ou não corresponder ao backend. Nunca conceda permissões globais com chmod 666 em um dispositivo USB.

Para ir além, compare as regras udev fornecidas pelo Ubuntu ou pelo fabricante com as permissões realmente presentes. Os princípios de controle das permissões Linux se aplicam aqui: corrija a regra específica, em seguida, abra uma nova sessão e teste o acesso com seu usuário normal.

Scanner de rede: SANE, AirScan e descoberta mDNS

Um scanner de rede pode funcionar sem aparecer no lsusb. O Ubuntu deve descobrir um serviço eSCL/AirScan ou WSD na rede local. Instale o backend AirScan e o serviço Avahi:

sudo apt update
sudo apt install sane-airscan avahi-daemon

Verifique se o serviço de descoberta mDNS está ativo:

systemctl is-active avahi-daemon

A resposta esperada é active. Uma resposta inactive, failed ou a ausência do serviço indica uma etapa a ser corrigida antes de testar a detecção de rede.

Em seguida, interrogação os dispositivos AirScan detectáveis:

airscan-discover

O comando pode exibir os serviços encontrados com seu tipo e endereço. Uma lista vazia não prova que o scanner é incompatível. Pode sinalizar uma rede de convidados, isolamento Wi-Fi, um firewall, Avahi inativo ou um scanner colocado em uma VLAN diferente.

Verifique o perfil de rede utilizado pelo Ubuntu e assegure-se de que o computador não esteja conectado a uma rede de convidados:

nmcli connection show --active
nmcli device status

Nosso guia sobre como modificar um perfil de rede com nmcli ajuda a verificar a conexão ativa. O scanner e a máquina devem ser capazes de comunicar na mesma LAN. A descoberta mDNS utiliza anúncios de rede que nem sempre atravessam VLANs ou certas configurações de pontos de acesso.

Após esta verificação, relance:

scanimage -L

Se o scanner de rede aparecer, o SANE encontrou o backend e o serviço de descoberta. O projeto sane-airscan suporta scanners de rede eSCL/AirScan e WSD, com descoberta automática ou configuração manual. Se a descoberta automática falhar enquanto o endereço IP do scanner é conhecido, consulte sua documentação para a configuração manual do backend, sem inventar um nome de dispositivo ou URL.

Validar no Scanner de documentos

Quando scanimage -L lista o scanner, inicie o aplicativo:

simple-scan

A lista visível no Scanner de documentos deve corresponder ao dispositivo fornecido pelo SANE. Inicie uma digitalização simples e verifique se a visualização carrega, se o documento é legível e se o salvamento funciona no formato escolhido.

• USB ausente no lsusb: corrija primeiro o cabo, a porta ou a energia.
• USB visível, mas ausente de scanimage -L: verifique o backend, os logs do SANE e as permissões.
• Scanner de rede ausente de airscan-discover: verifique o Avahi, a mesma LAN e o isolamento Wi-Fi.
• Scanner listado, mas aplicativo em erro: teste scanimage -T, em seguida, relance o Scanner de documentos em sua sessão de usuário.

A validação é concluída quando scanimage -L lista o scanner e simple-scan realiza uma digitalização completa sem privilégios de administrador. Em seguida, inicie uma última digitalização com o documento realmente utilizado e verifique o arquivo salvo.