传真服务器零基础入门教程：手把手搭建收发环境

为什么需要传真服务器：新手常见痛点与入门目标

很多新手第一次接触传真，常遇到三个真实痛点：文件在电脑里，却只能用老式传真机打印后再发；收到传真后纸张堆在角落，查找和归档都很麻烦；多人共用一台传真机时，谁发了什么、有没有发成功，常常说不清。

• 痛点一：电脑里的PDF、合同、证件材料无法直接传真，来回打印浪费时间。
• 痛点二：接收的传真不能自动进电脑，重要文件容易丢页或找不到。
• 痛点三：团队多人共用时缺少权限和记录，发送状态不透明。

传真服务器可以理解为一台专门管理传真收发的“中转站”，把电话线、传真调制解调器、电脑文件和用户权限统一管起来，让电脑直接发传真、自动收传真。

这篇传真服务器零基础入门教程面向没有部署经验的新手，学完能掌握基础环境准备、软件安装、调制解调器配置、用户创建、发送测试和接收目录设置，并知道常见报错怎么排查。

搭建传真服务器前的准备工作

动手前先把条件备齐，能避免装到一半卡住。下面按硬件、软件和基础知识三类说明，并标注必备与可选。

硬件环境：传真服务器必备设备与可选设备

必备：一台可安装Linux的电脑或服务器，最低建议1核CPU、1GB内存、10GB可用硬盘；一个可用的传真调制解调器，例如USB传真猫或串口传真卡；一条能正常拨打的电话线。

可选：支持T.38传真协议的SIP网关，用于走网络电话线路；UPS电源，避免收传真过程中断电；独立交换机或路由器，方便内网客户端访问。

• 传真调制解调器获取方式：选择明确支持传真协议的产品，插到服务器USB口后能在系统中看到设备节点。
• 电话线获取方式：使用运营商固定电话线路，或由单位电话交换机分配一个可外拨的分机线路。
• 服务器获取方式：可用闲置电脑安装Linux，也可用云服务器加本地SIP网关，但纯云服务器没有本地电话线时不能直接接传真猫。

软件工具：传真服务器系统与客户端准备

必备：一套Debian或Ubuntu类Linux系统；HylaFAX服务端与客户端软件包；一个可查看命令行的终端工具。可选：PDF阅读器、TIFF查看器、邮件服务，用于后续归档或转发。

• 系统获取方式：从Linux发行版官方镜像站点下载安装镜像，按常规流程安装并设置管理员账户。
• HylaFAX获取方式：在系统终端中通过apt软件源安装，无需额外找安装包。
• 客户端准备：同网段电脑可通过SSH登录服务器，或直接在服务器本机操作。

基础知识：传真服务器操作前需了解的常识

必备：会使用cd、ls、nano等基础命令；知道传真号码一般按“国家码+区号+号码”填写；能区分发送队列和接收队列。

可选：了解调制解调器AT指令、邮件服务器配置、SIP网关参数。新手先不接触这些也能完成基础收发。

传真服务器分步骤操作指南

下面按从系统安装到收发验证的顺序操作，每一步都给出目的、命令和验证方法。命令中的号码、密码、设备名请替换成自己的实际值。

第一步：安装传真服务器基础系统与软件包

操作目的：让服务器具备传真服务端和客户端命令，这是后续配置的基础。

1. 用管理员账户登录Linux服务器，打开终端。
2. 更新软件源列表。
3. 安装HylaFAX服务端与客户端。

sudo apt update

sudo apt install -y hylafax-server hylafax-client

关键参数说明：-y表示自动确认安装；hylafax-server是传真服务器主程序，hylafax-client提供发送和查看命令。

成功验证：执行下面的命令，能看到server和client相关包即安装成功。

dpkg -l | grep hylafax

第二步：初始化传真服务器并设置管理员

操作目的：生成传真服务器配置文件，设置管理员账户，让服务能够启动。

1. 运行初始化向导。
2. 按提示填写国家码、区号、传真设备类型等信息；不确定的选项先保持默认。
3. 重启服务并设置管理员密码。

sudo faxsetup

sudo systemctl restart hylafax

sudo systemctl status hylafax

sudo faxadduser -a 1234 faxadmin

关键参数说明：-a用于设置管理员密码，示例中的1234必须换成自己的强密码；faxadmin是管理员登录名。

成功验证：执行faxstat，能返回传真服务器状态信息而不是连接失败，说明服务已跑起来。

faxstat

第三步：添加传真服务器调制解调器并确认设备在线

操作目的：把传真调制解调器接入传真服务器，让系统能通过电话线拨号和收传真。

1. 插入USB传真猫或确认串口传真卡已连接，查看设备节点。
2. 把运行传真服务的fax用户加入dialout组，避免权限不足。
3. 添加调制解调器并重启服务。

ls -l /dev/ttyUSB0

sudo usermod -aG dialout fax

sudo faxaddmodem ttyUSB0

sudo systemctl restart hylafax

关键参数说明：/dev/ttyUSB0是常见USB传真猫设备名，如果实际是/dev/ttyS0或/dev/ttyACM0，按lsusb和dmesg | grep tty的结果替换。

成功验证：执行faxstat -s，能看到调制解调器状态为Running and idle或Waiting for modem to come ready，说明设备已被识别。

faxstat -s

第四步：创建传真服务器用户并完成发送测试

操作目的：创建普通发送用户，准备一个测试PDF文件，验证电脑文件能否进入发送队列。

1. 创建普通传真用户。
2. 建立测试文件目录并授权给fax用户。
3. 把一页PDF测试文件放入目录，然后执行发送命令。

sudo faxadduser -p 123456 faxuser

sudo mkdir -p /srv/fax

sudo chown fax:fax /srv/fax

sudo -u fax sendfax -n -d 8613800000000 /srv/fax/test.pdf

关键参数说明：-p设置普通用户密码；-n表示不弹出确认提示；-d后面是目标传真号码，示例8613800000000要换成真实号码；文件需为fax用户可读的PDF或TIFF。

成功验证：执行faxstat -s查看发送队列，能看到任务处于Sending或已完成状态；若一直排队，进入常见问题部分排查。

faxstat -s

第五步：配置传真服务器接收目录并验证收件

操作目的：让收到的传真自动落到指定目录，方便电脑查看和归档。

1. 创建接收目录并授权。
2. 备份FaxDispatch脚本，再编辑该脚本加入复制动作。
3. 赋予脚本执行权限，重启服务并确认faxgetty进程存在。

sudo mkdir -p /srv/fax/incoming

sudo chown fax:fax /srv/fax/incoming

sudo cp /var/spool/hylafax/etc/FaxDispatch /var/spool/hylafax/etc/FaxDispatch.bak

sudo nano /var/spool/hylafax/etc/FaxDispatch

在脚本中加入下面两行，保存退出。

#!/bin/sh

cp "$FILE" /srv/fax/incoming/

sudo chmod +x /var/spool/hylafax/etc/FaxDispatch

sudo systemctl restart hylafax

ps aux | grep faxgetty

关键参数说明：$FILE是HylaFAX收到的传真文件变量；配置目录以faxsetup生成的实际路径为准，常见为/var/spool/hylafax/etc。

成功验证：从另一条传真线路向本机号码发送一页测试传真，然后执行sudo ls -l /srv/fax/incoming，能看到新的TIF文件即接收链路打通。

传真服务器常见问题与避坑提示

新手部署传真服务器时，报错多数集中在服务、设备、权限和号码格式。下面按“问题现象→产生原因→解决方法”整理。

• 问题现象：执行faxstat提示无法连接。产生原因：传真服务未启动或端口未监听。解决方法：执行sudo systemctl restart hylafax，再用sudo systemctl status hylafax查看状态。
• 问题现象：faxaddmodem找不到设备。产生原因：USB传真猫未识别、设备名写错或fax用户无串口权限。解决方法：用lsusb和dmesg | grep tty确认设备名，执行sudo usermod -aG dialout fax后重启服务。
• 问题现象：发送任务一直排队不拨号。产生原因：号码格式错误、电话线无拨号音或调制解调器被占用。解决方法：统一写成国家码加区号加号码，检查电话线，执行faxstat -s查看状态。
• 问题现象：接收传真没有生成文件。产生原因：faxgetty未运行、接收脚本无执行权限或目录权限不对。解决方法：检查ps aux | grep faxgetty，给FaxDispatch加执行权限，确认/srv/fax/incoming属于fax用户。
• 问题现象：PDF发送失败。产生原因：文件损坏、格式不支持或fax用户读不到文件。解决方法：重新导出标准PDF，执行sudo chown fax:fax /srv/fax/test.pdf后再发。
• 问题现象：邮件转发收不到。产生原因：本机邮件服务未配置或转发脚本调用失败。解决方法：先用目录转发验证收发，再配置邮件服务，避免同时排查多个环节。

传真服务器新手最容易忽略的3个细节

• 号码格式要统一：国家码、区号、号码连续填写，不要带空格、横杠和小括号，否则容易拨号失败。
• 先做小范围测试：第一次只发一页给自己或同事，不要直接群发大量文件，确认线路和格式无误后再扩大使用。
• 权限和路径要核对：HylaFAX大量问题来自fax用户读不到文件、写不进目录，配置后先看文件属主和脚本权限。

全文总结：传真服务器入门流程回顾与进阶方向

回顾整套流程，核心就是先装好传真服务器软件，再完成初始化和管理员设置，接着接入调制解调器、创建用户、发送测试，最后配置接收目录并验证收件。按顺序做，新手也能把基础收发环境搭起来。

进阶方向可以关注三个：一是把收到的传真自动转发到邮箱，二是接入SIP网关走网络传真线路，三是为团队配置多用户权限和发送记录统计。

传真服务器并不神秘，先把一收一发送通，再逐步优化归档和权限，就能让它真正替代老式传真机，成为团队里稳定好用的传真入口。