中科院张老师1. 项目概述
efax是Linux系统中一个经典的传真通信工具，它允许用户直接在命令行环境下发送和接收传真文档。这个诞生于上世纪90年代的工具至今仍在某些特定场景下发挥着不可替代的作用，特别是在需要与遗留传真系统对接的企业环境中。
我第一次接触efax是在2015年为一个医疗机构的系统迁移项目中。该机构的病历传输系统仍依赖传统传真协议，而efax以其轻量级和稳定性成为了连接新旧系统的桥梁。相比图形界面的传真软件，efax的最大优势在于可以无缝集成到自动化流程中，通过脚本实现无人值守的传真收发。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心功能解析
2.1 硬件准备与检测
efax需要配合传真调制解调器（Fax Modem）使用。在开始前，建议通过以下命令检测系统是否识别了调制解调器设备：
bash复制dmesg | grep tty
ls /dev/ttyS*
典型的输出应显示类似/dev/ttyS0的串口设备。如果使用USB调制解调器，设备节点可能是/dev/ttyUSB0。我曾在实际项目中遇到过因权限问题导致的设备访问失败，此时需要将用户加入dialout组：
bash复制sudo usermod -a -G dialout $USER
2.2 基础发送流程
发送传真的基本命令结构如下：
bash复制efax -d /dev/ttyS0 -t 8881234567 document.pdf
其中关键参数解析：
-d指定调制解调器设备节点-t后接目标传真号码- 最后参数是要发送的文档路径
重要提示：文档必须转换为传真支持的格式。实测发现，虽然efax声称支持PDF，但在某些版本中会出现兼容性问题。更可靠的做法是先用
gs工具转换为TIFF：
bash复制gs -q -r204x98 -g1728x1078 -dNOPAUSE -sDEVICE=tiffg3 -sOutputFile=output.tif -- document.pdf
2.3 接收传真配置
接收模式需要添加-v参数启用接收功能，并指定保存目录：
bash复制efax -d /dev/ttyS0 -v -D /var/spool/fax/incoming
接收的文件默认保存为fax######.tif格式。在生产环境中，我通常会配合inotify-tools实现接收后的自动处理：
bash复制inotifywait -m /var/spool/fax/incoming -e create |
while read path action file; do
[ "${file: -4}" == ".tif" ] && process_fax "$file"
done
3. 高级配置技巧
3.1 调制解调器初始化字符串
不同品牌的调制解调器可能需要特定的初始化AT命令。通过-i参数可以覆盖默认设置：
bash复制efax -i "AT&F E1 V1 X4" -d /dev/ttyS0 ...
常见的配置参数包括：
E1开启命令回显V1使用文字结果码X4启用高级错误报告
我曾遇到US Robotics调制解调器需要额外设置S7=60（等待载波超时）才能稳定工作，这提醒我们务必参考设备手册。
3.2 批量发送与重试机制
对于大批量传真发送，建议使用shell脚本结合重试逻辑：
bash复制for doc in /faxdocs/*.pdf; do
for attempt in {1..3}; do
if efax -d /dev/ttyS0 -t "$number" "$doc"; then
echo "$(date) - $doc sent successfully" >> /var/log/fax.log
break
else
echo "$(date) - Attempt $attempt failed for $doc" >> /var/log/fax.log
sleep 60
fi
done
done
3.3 日志分析与监控
启用-vv参数可以获得详细调试日志。结合syslog可以构建完整的监控方案：
bash复制efax -vv -d /dev/ttyS0 ... 2>&1 | logger -t efax
然后在/etc/rsyslog.conf中添加：
code复制:programname, isequal, "efax" /var/log/efax.log
& stop
4. 常见问题排查
4.1 调制解调器无响应
典型症状：命令执行后长时间无输出，最终报超时错误。
排查步骤：
- 确认设备节点正确：
stty -F /dev/ttyS0 - 测试AT命令响应：
echo "AT" > /dev/ttyS0 - 检查线缆连接（特别是串口转USB适配器）
4.2 接收传真质量差
可能原因及解决方案：
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 文字模糊 | 波特率过高 | 添加-h 9600降低速率 |
| 图像断裂 | 线路干扰 | 使用-n禁用纠错模式 |
| 空白页 | 格式不兼容 | 强制使用G3标准：-f 1-1 |
4.3 发送失败错误代码
关键错误代码速查：
| 代码 | 含义 | 处理建议 |
|---|---|---|
| 3 | 无拨号音 | 检查电话线连接 |
| 16 | 对方忙音 | 设置重试间隔-w 300 |
| 24 | 协议不匹配 | 添加-f 1-1强制G3标准 |
5. 系统集成实践
5.1 与邮件系统对接
通过procmail可以实现传真到邮件的自动转发：
bash复制:0
* ^From:.*faxd@company.com
| {
FILE=$(mktemp)
cat > $FILE
tiff2pdf -o /faxstore/$(date +%Y%m%d-%H%M%S).pdf $FILE
rm $FILE
}
5.2 云服务集成
虽然现代云传真服务更便捷，但在某些安全要求高的场景仍需本地方案。可以通过API桥接：
python复制import subprocess
from flask import Flask, request
app = Flask(__name__)
@app.route('/sendfax', methods=['POST'])
def send_fax():
number = request.json['to']
with open('/tmp/fax.pdf', 'wb') as f:
f.write(request.files['file'].read())
result = subprocess.run(['efax', '-d', '/dev/ttyS0', '-t', number, '/tmp/fax.pdf'])
return {'status': 'success' if result.returncode == 0 else 'failed'}
5.3 容器化部署
对于现代基础设施，可以将efax打包为Docker容器：
dockerfile复制FROM alpine:3.14
RUN apk add efax ghostscript
VOLUME /var/spool/fax
CMD ["efax", "-d", "/dev/ttyS0", "-v", "-D", "/var/spool/fax/incoming"]
启动时需映射设备节点：
bash复制docker run --device=/dev/ttyS0 -v /faxstorage:/var/spool/fax efax-service
6. 安全加固建议
6.1 访问控制
限制/dev/ttyS*设备的访问权限：
bash复制chown root:dialout /dev/ttyS0
chmod 660 /dev/ttyS0
6.2 日志审计
配置auditd规则监控关键操作：
bash复制auditctl -a always,exit -F arch=b64 -S openat -F path=/dev/ttyS*
6.3 传输加密
虽然传真协议本身不加密，但可以在应用层处理：
bash复制# 发送前加密
gpg --encrypt --recipient fax@company.com document.pdf
# 接收后解密
find /fax/incoming -name "*.gpg" -exec gpg --decrypt --output {}.pdf {} \;
在实际部署中发现，efax与现代系统的集成需要特别注意字符编码问题。特别是当处理包含中文的传真时，建议在转换PDF阶段就确保使用支持中文的字体：
bash复制gs -sDEVICE=tiffg3 -sFONTPATH=/usr/share/fonts/win -o output.tif input.pdf