Homebridge Docker镜像

基于Ubuntu Linux的Docker镜像，允许在家庭网络中运行Nfarina的Homebridge，该工具模拟iOS HomeKit API。

这是一个多架构镜像，可在x86_64、树莓派2、3、4、Zero 2 W或其他支持Docker的ARMv7/8设备上运行。Docker会自动拉取适合您系统的正确镜像。

分步指南

• 在Linux上使用Docker运行Homebridge
• 在群晖NAS上运行Homebridge
• 在Unraid上运行Homebridge

兼容性

Homebridge需要完全访问本地网络才能正常运行，可通过--net=host标志实现。

由于此问题和此问题，该镜像在使用Docker for Mac或Docker for Windows时无法工作。

使用方法

命令行：

bash
docker run --net=host --name=homebridge -v $(pwd)/homebridge:/homebridge homebridge/homebridge:latest

使用Docker Compose（推荐）：

yml
version: '2'
services:
  homebridge:
    image: homebridge/homebridge:latest
    restart: always
    network_mode: host
    volumes:
      - ./volumes/homebridge:/homebridge
    logging:
      driver: json-file
      options:
        max-size: "10mb"
        max-file: "1"

参数说明

参数格式为主机端:容器端，左侧为主机配置，右侧为容器配置。

• --net=host - 使容器共享主机网络，必需
• -v /homebridge - Homebridge配置和插件存储路径，必需

可选设置：

• -e TZ - 设置时区，例如-e TZ=Asia/Shanghai（参考时区列表）
• -e ENABLE_AVAHI - 默认值为1；设为0可禁用容器内的Avahi mDNS服务

Homebridge UI

此镜像预安装了Homebridge UI，是管理Homebridge的便捷工具。

要访问管理界面，请在浏览器中打开http://<服务器IP>:8581，例如[***]。通过该界面可安装、卸载和更新插件，修改Homebridge的config.json配置文件，以及重启Homebridge。

自动更新

强烈不建议使用Watchtower等工具自动更新Homebridge Docker镜像，此类操作风险自负。您可在容器内直接更新Homebridge、Homebridge UI和Node.js运行时。

故障排除

1. 需要ffmpeg？

此镜像已包含带有libfdk-aac音频支持的ffmpeg。

2. 容器在旧版Raspbian上无法启动

如果出现以下错误，需更新主机操作系统：

详见#434和#441获取解决方案。

Node.js[445]: ../src/util.cc:188:double node::GetCurrentTimeInMicroseconds(): Assertion `(0) == (uv_gettimeofday(&tv))' failed.
Aborted (core dumped)

homebridge_1  | s6-svscan: warning: unable to iopause: Operation not permitted
homebridge_1  | s6-svscan: warning: executing into .s6-svscan/crash
homebridge_1  | s6-svscan crashed. Killing everything and exiting.

homebridge    | # Fatal error in , line 0
homebridge    | # unreachable code

3. 在***上提问

加入Homebridge******社区，在#docker频道提问。

许可证

Copyright (C) 2023 homebridge
Copyright (C) 2017-2022 oznu

本程序为自由软件：您可以根据GNU通用公共许可证第3版（或更高版本）的条款重新分发和/或修改它。
本程序的分发希望它有用，但不提供任何担保，包括适销性或特定用途适用性的隐含担保。详见GNU通用公共许可证以获取更多详情。