thejf/antennas

Antennas Docker镜像文档

!https://raw.githubusercontent.com/TheJF/antennas/master/docs/images/antennas-logo.png

镜像概述

Antennas是https://github.com/jkaberg/tvhProxy%E7%9A%84JavaScript%E7%A7%BB%E6%A4%8D%E7%89%88%EF%BC%8C%E5%85%B6%E6%A0%B8%E5%BF%83%E5%8A%9F%E8%83%BD%E6%98%AF%E5%B0%86Tvheadend API转换为模拟的HDHomeRun API。这一工具特别适用于将Plex的DVR功能与Tvheadend连接，实现Plex直播电视和DVR功能的正常运行。

核心功能与特性

• API转换：将Tvheadend API转换为HDHomeRun兼容API，使Plex DVR能够识别Tvheadend作为电视调谐器
• 配置灵活：支持通过配置文件（config.yml）或环境变量进行参数设置，环境变量优先级高于配置文件
• 多部署方式：支持Docker容器部署，同时提供二进制文件和Node.js本地运行选项
• 调谐器数量控制：可自定义Tvheadend调谐器数量，适应不同的并发流需求

使用场景

• 需要将Plex Media Server的直播电视和DVR功能与Tvheadend后端集成的用户
• 希望通过Docker容器化部署实现服务隔离和简化管理的场景
• 家庭媒体中心用户，需要统一管理直播电视和录制内容

使用方法

Tvheadend配置

为使Plex能够通过Antennas从Tvheadend流式传输内容，需在Tvheadend中设置具有流式传输权限的***用户：

1. 进入Tvheadend的用户管理界面
2. 创建用户名为*的用户（***用户）
3. 授予该用户流式传输权限

!https://raw.githubusercontent.com/TheJF/antennas/master/docs/images/tvheadend-config.png

Docker部署

基础运行命令

使用以下命令启动Antennas容器，需替换ANTENNAS_URL和TVHEADEND_URL为实际环境值：

bash
docker run -p 5004:5004 \
  -e ANTENNAS_URL=http://x.x.x.x:5004 \
  -e TVHEADEND_URL=http://replace:me@x.x.x.x:9981 \
  thejf/antennas

带完整环境变量的创建命令

可通过以下命令创建包含所有可用环境变量的容器：

bash
docker create --name=antennas \
  -e ANTENNAS_URL=http://x.x.x.x:5004 \
  -e TVHEADEND_URL=http://replace:me@x.x.x.x:9981 \
  -e TUNER_COUNT=6 \
  -p 5004:5004 \
  thejf/antennas

创建后启动容器：

bash
docker start antennas

挂载配置文件方式

通过挂载配置文件目录进行部署：

1. 创建本地配置目录（如/path/to/config）
2. 在该目录下创建config.yml文件，内容示例：

yaml
tvheadend_url: http://replace:me@x.x.x.x:9981
antennas_url: http://x.x.x.x:5004
tuner_count: 6

3. 创建并启动容器：

bash
docker create --name=antennas \
  -v /path/to/config:/antennas/config \
  -p 5004:5004 \
  thejf/antennas

docker start antennas

验证部署

部署完成后，可通过浏览器访问Antennas服务地址（如http://x.x.x.x:5004），页面将显示当前配置摘要，确认配置是否生效：

!https://raw.githubusercontent.com/TheJF/antennas/master/docs/images/example-index.png

配置说明

Antennas支持通过配置文件（config.yml）或环境变量进行配置，环境变量优先级高于配置文件。

config.yml配置文件

配置文件路径为/antennas/config/config.yml，包含以下参数：

• tvheadend_url: Tvheadend服务地址，需包含用户名、密码和端口，例如：http://user:pass@192.168.0.1:9981（不建议使用localhost，推荐使用实际IP地址）
• antennas_url: Antennas服务自身的访问地址，例如：http://192.168.0.2:5004
• tuner_count: Tvheadend调谐器数量，默认为6

环境变量配置

环境变量与配置文件参数对应，名称为配置参数的大写形式：

• TVHEADEND_URL: 对应tvheadend_url
• ANTENNAS_URL: 对应antennas_url
• TUNER_COUNT: 对应tuner_count

注意事项

• Docker部署时，Plex可能无法自动发现Antennas服务，需手动配置
• 确保Tvheadend与Antennas之间网络通畅，防火墙规则允许相应端口通信
• Node.js版本需高于7.0（本地运行时）