phoneblock/answerbot

PhoneBlock智能答录机

PhoneBlock提供一款智能答录机，仅当来电号码出现在PhoneBlock垃圾电话数据库中时才会应答。该答录机需注册为路由器上的VOIP设备，默认配置假设您使用Fritz!Box路由器。

便捷的设置方式是通过PhoneBlock-Dongle（在ESP 32微控制器上运行答录机，通过WLAN连接），其包含设置向导和Web界面。

请注意：无论是Dongle版本还是Docker版本，都需要将来电号码与PhoneBlock数据库匹配，因此运行Docker镜像也需使用PhoneBlock API密钥（免费获取）。

核心功能

• 智能垃圾电话筛选: 仅对PhoneBlock垃圾电话数据库中的号码来电自动应答。
• VOIP设备集成: 可作为VOIP设备注册到路由器（默认支持Fritz!Box）。
• 自定义音频: 支持挂载本地目录替换默认应答音频文件。
• 日志与调试: 提供日志查看及容器登录功能，便于问题排查。

使用场景

• 家庭或小型办公环境自动拦截垃圾电话，减少干扰。
• 配合Fritz!Box路由器实现VOIP答录机功能，无需额外硬件。
• 需要个性化应答音频的用户，可自定义与垃圾来电者的交互内容。

配置说明

前提条件

1. 从PhoneBlock设置页面获取免费API密钥。
2. 在Fritz!Box路由器中创建VOIP电话，用户名为phoneblock，密码为VOIP-phone-password（可自定义）。

Docker运行命令

使用以下命令启动答录机：

bash
docker run --network=host -d --rm --name phoneblock \
    -e "PHONEBLOCK_API_KEY=your-API-key" \
    -e "SIP_USER=phoneblock" \
    -e "SIP_PASSWD=VOIP-phone-password" \
    -e "VIA_ADDR=宿主设备IP地址" \
    -e "VIA_ADDR_V6=宿主设备IPv6地址（可选）" \
    -e "REGISTRAR=fritz.box" \
    -e "ROUTE=fritz.box;lr" \
    docker.xuanyuan.run/phoneblock/answerbot:latest

注意:

• 必须使用--network=host模式，因为VOIP和RTP协议需要路由器直接访问宿主设备（否则需复杂端口转发）。
• 若容器无法自动检测宿主IP，需手动设置VIA_ADDR或VIA_ADDR_V6。
• 若宿主无法解析fritz.box，可替换为路由器IP地址。

自定义音频文件

准备本地目录$PWD/conversation，按https://github.com/haumacher/phoneblock/tree/master/phoneblock-ab/conversation放置音频文件，启动时添加挂载参数：

bash
-v $PWD/conversation:/opt/phoneblock/conversation

查看日志

启动后可查看日志：

bash
docker container logs phoneblock

示例日志输出：

[2025-01-01 13:08:32] INFO: [de.haumacher.phoneblock.answerbot.AnswerBot]: AnswerBot 1.5.0-SNAPSHOT
[2025-01-01 13:08:32] INFO: [org.mjsip.config.OptionParser]: Using '--via-addr' from environment: VIA_ADDR=...
[2025-01-01 13:08:32] INFO: [org.mjsip.config.OptionParser]: Using '--via-addr-v6' from environment: VIA_ADDR_V6=...
[2025-01-01 13:08:32] INFO: [org.mjsip.config.OptionParser]: Using '--sip-user' from environment: SIP_USER=phoneblock
[2025-01-01 13:08:32] INFO: [org.mjsip.config.OptionParser]: Using '--sip-passwd' from environment: SIP_PASSWD=your-password
[2025-01-01 13:08:32] INFO: [org.mjsip.sip.provider.SipProvider]: SipStack: mjsip 1.9.0-SNAPSHOT
[2025-01-01 13:08:32] INFO: [org.mjsip.sip.provider.SipProvider]: SipProvider: 50060
[2025-01-01 13:08:32] INFO: [org.mjsip.sip.provider.SipProvider]: udp is up at port 50060
[2025-01-01 13:08:32] INFO: [org.mjsip.sip.provider.SipProvider]: tcp is up at port 50060
[2025-01-01 13:08:32] INFO: [de.haumacher.phoneblock.answerbot.AnswerBot]: Supported media: audio 4080 RTP/AVP { 8 PCMA 8000 160 1 }
[2025-01-01 13:08:32] INFO: [org.mjsip.ua.registration.RegistrationLogger]: Registration of '<sip:phoneblock@...:50060>' 200 OK, expires in 300s, renewing in 300s.

登录容器调试

若需排查问题，可登录运行中的容器：

bash
docker exec -it phoneblock /bin/bash

使用Compose脚本启动

若偏好Compose脚本，可参考https://github.com/haumacher/phoneblock/blob/master/phoneblock-ab/compose.yaml。所有配置项可通过环境变量传递（转为大写，将`-`替换为`_`），配置说明见https://github.com/haumacher/phoneblock/blob/master/phoneblock-ab/.phoneblock.template。 ===END===