bludesign/faxserver

bludesign/faxserver 镜像说明

镜像概述

bludesign/faxserver是一款基于Twilio可编程传真API构建的传真服务器镜像，支持发送/接收传真及Twilio/Nexmo的短信/彩信功能。镜像采用Vapor 3.0框架和Swift 4.0开发，遵循MIT开源许可，提供Web管理界面、iOS客户端集成及完善的安全配置选项。

核心功能

• 传真处理：通过Twilio API发送/接收传真，支持PDF文件上传
• 短信/彩信：集成Twilio SMS API发送/接收短信/彩信，支持Nexmo SMS API接收短信
• 多平台集成：提供iOS客户端（App Store可下载），支持远程管理
• 安全配置：支持禁用***注册、HTTPS加密、双因素认证（TOTP）等安全措施
• 邮件通知：通过Mailgun实现传真/短信的邮件提醒
• 多号码管理：支持添加多个Twilio号码，每个号码独立配置

使用场景

• 企业自动化传真处理：替代传统传真机，实现数字化传真管理
• 个人远程传真需求：通过手机或Web界面随时随地发送/接收传真
• 多号码业务管理：适用于需要管理多个传真/短信号码的团队或个人
• 短信接收整合：统一管理Twilio和Nexmo的短信接收业务

部署与配置

Docker部署示例

1. 克隆仓库并启动服务：

bash
git clone --depth=1 git@github.com:bludesign/FaxServer.git
cd FaxServer
docker-compose up -d

服务启动后可访问 http://127.0.0.1:8080

Nginx反向代理配置（推荐）

为支持大文件上传及HTTPS，建议使用Nginx代理：

nginx
server {
    listen 80;
    client_max_body_size 20M; # 支持最大20M的PDF上传

    location / {
        proxy_set_header Host $http_host;
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_connect_timeout 3s;
        proxy_read_timeout 10s;
    }
}

关键配置步骤

Twilio配置

1. 登录Twilio控制台，进入管理活动号码页面
2. 为每个号码设置Webhook：
   • 传真：https://[服务器地址]/fax/twiml
   • 短信：https://[服务器地址]/message/twiml
3. 获取Twilio账户SID和Auth Token（账户设置页面）

Fax Server配置

1. 访问服务器地址，注册管理员账户后禁用*注册**
2. 进入账户管理，添加Twilio号码（填写号码、账户SID、Auth Token）
3. 配置邮件通知：通过Mailgun获取API密钥，在设置中填写邮件地址及API信息

安全建议

• 必须禁用***注册（设置中关闭）
• 强烈建议为Nginx配置HTTPS（使用Let's Encrypt证书）
• 高级用户可启用双因素认证（TOTP）及HTTPS-only cookies

iOS客户端集成

1. 在Fax Server的客户端管理中创建新客户端
2. 复制客户端ID和密钥，填写到iOS App（App Store搜索"Fax Server"）
3. 输入服务器URL即可远程管理传真/短信业务