oznu/homebridge

Homebridge Docker镜像

该基于Ubuntu Linux的Docker镜像允许您在家庭网络上运行https://github.com/nfarina%E7%9A%84https://github.com/nfarina/homebridge%EF%BC%8C%E5%85%B6%E5%8F%AF%E6%A8%A1%E6%8B%9FiOS HomeKit API。

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

分步指南

• https://github.com/homebridge/homebridge/wiki/Install-Homebridge-on-Docker
• https://github.com/oznu/docker-homebridge/wiki/Homebridge-on-Synology
• https://github.com/oznu/docker-homebridge/wiki/Homebridge-on-Unraid

兼容性

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

**此镜像在使用https://docs.docker.com/docker-for-mac/%E6%88%96https://docs.docker.com/docker-for-windows/%E6%97%B6%E6%97%A0%E6%B3%95%E5%B7%A5%E4%BD%9C%EF%BC%8C%E5%8E%9F%E5%9B%A0%E6%98%AFhttps://github.com/docker/for-mac/issues/68%E5%92%8Chttps://github.com/docker/for-win/issues/543**%E3%80%82

使用方法

命令行：

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

使用https://docs.docker.com/compose/%EF%BC%88%E6%8E%A8%E8%8D%90%EF%BC%89%EF%BC%9A

yml
version: '2'
services:
  homebridge:
    image: oznu/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=Australia/Canberra
• -e ENABLE_AVAHI - 默认值为1；设置为0可阻止容器中运行Avahi mDNS服务

Homebridge UI

此镜像预安装了https://github.com/oznu/homebridge-config-ui-x%EF%BC%8C%E6%98%AF%E7%AE%A1%E7%90%86Homebridge%E5%90%84%E6%96%B9%E9%9D%A2%E7%9A%84%E6%9C%80%E7%AE%80%E5%8D%95%E6%96%B9%E5%BC%8F%E3%80%82

要管理Homebridge，请在浏览器中访问http://<服务器IP>:8581。例如，http://192.168.1.20:8581。从这里您可以安装、删除和更新插件，修改Homebridge的config.json并重启Homebridge。

自动更新

强烈不建议使用Watchtower或类似工具自动更新Homebridge Docker镜像，风险自负。您可以从容器内部更新Homebridge、Homebridge UI和Node.js运行时。

故障排除

1. 需要ffmpeg？

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

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

如果您看到以下类似错误，您的主机操作系统需要更新。

有关可能的解决方案，请参见https://github.com/oznu/docker-homebridge/issues/434%E5%92%8Chttps://github.com/oznu/docker-homebridge/issues/441%E3%80%82

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) 2017-2022 oznu

本程序是自由软件：您可以根据自由软件基金会发布的GNU通用公共许可证（第三版或更高版本）的条款重新分发和/或修改它。

本程序的发布旨在希望它有用，但不提供任何明示或暗示的担保，包括但不限于适销性和特定用途适用性的担保。有关更多详细信息，请参见GNU通用公共许可证。