sbs20/scanservjs

scanservjs

!https://github.com/sbs20/scanservjs/raw/master/docs/screen0.jpg

用户评价

我决定只使用这个工具，在浏览器中操作非常完美，比打印机厂商的臃肿软件好太多了

它让我仍能使用旧的hp3900扫描仪，无需担心驱动和厂商特定界面。更棒的是，扫描结果可通过出色的Web界面访问！

这是个很棒的项目！我的Brother扫描仪的触摸屏和按键坏了，原本无法触发扫描而变无用，但通过这个项目我可以远程触发扫描，非常好用。

概述

scanservjs是扫描仪的Web UI前端，允许通过网络共享一台或多台扫描仪（使用SANE），无需驱动程序或复杂安装。适用于任何SANE兼容设备。

核心功能

• 图像编辑：支持裁剪、自动色阶、阈值、模糊等滤镜
• 扫描控制：来源选择（平板/自动送稿器）、分辨率调整
• 格式输出：支持TIF、JPG、PNG、PDF格式，及Tesseract OCR生成TXT，可配置压缩设置
• 高级扫描：多页扫描（支持双面扫描的 collation 功能）
• 自定义配置：可覆盖所有默认值、滤镜和格式的配置
• 多语言支持：捷克语、法语、德语、意大利语、中文（普通话）、波兰语、葡萄牙语（巴西）、俄语、西班牙语（https://github.com/sbs20/scanservjs/issues/154%EF%BC%89
• 界面体验：明暗模式切换、响应式设计

使用场景

• 需要在网络中共享扫描仪，避免多设备安装驱动
• 老旧扫描仪缺乏官方驱动或厂商UI
• 扫描仪物理按键/触摸屏损坏，需远程触发扫描
• 需通过Web界面统一管理多台扫描仪
• 对扫描结果有裁剪、格式转换、OCR识别等需求

系统要求

• SANE兼容扫描仪
• Linux主机（或带有必要直通功能的虚拟机，如USB）
• 软件依赖：sane-utils、ImageMagick、Tesseract（可选，用于OCR）、nodejs

安装方式

支持多种安装途径：

• 手动安装
• Docker安装
• 扫描仪与SANE设置
• 代理设置
• 故障排除
• 开发说明

配置与设备覆盖

如需覆盖特定配置设置，可通过./config/config.local.js实现。详细配置方法参见Configuration。

使用方法

Docker部署示例

典型的Docker运行命令（需根据实际环境调整设备挂载）：

bash
docker run -d \
  --name scanservjs \
  -p 8080:8080 \
  --device /dev/bus/usb \
  -v /var/run/dbus:/var/run/dbus \
  docker.xuanyuan.run/sbs20/scanservjs

基本操作流程

1. 访问Web界面（默认端口8080）
2. 选择扫描仪（多设备时）
3. 配置扫描参数：来源（平板/ADF）、分辨率、输出格式等
4. 预览并裁剪扫描区域（如需）
5. 应用滤镜（如自动色阶、阈值）
6. 启动扫描，获取结果文件

项目背景

scanservjs源于对phpsane的改编，旨在提供更新的界面、简化安装流程，并支持更多功能。作为基于Node.js的Web前端，它解决了传统扫描仪共享中驱动依赖、跨平台兼容等问题，成为网络扫描仪共享的轻量解决方案。

致谢

• 本项目灵感源自http://sourceforge.net/projects/phpsane/
• 感谢所有https://github.com/sbs20/scanservjs/graphs/contributors%E6%8F%90%E4%BA%A4%E9%97%AE%E9%A2%98%E3%80%81%E6%B5%8B%E8%AF%95%E3%80%81%E4%BF%AE%E5%A4%8D%E6%BC%8F%E6%B4%9E%E3%80%81%E6%B7%BB%E5%8A%A0%E7%BF%BB%E8%AF%91%E5%B9%B6%E6%8F%90%E4%BE%9B%E9%95%BF%E6%9C%9F%E6%94%AF%E6%8C%81%EF%BC%81

更多关于SANE的信息：[***]