homebridge/homebridge

Homebridge Docker镜像

基于Ubuntu Linux的Docker镜像，允许在家庭网络中运行https://github.com/nfarina%E7%9A%84https://github.com/homebridge/homebridge%EF%BC%8C%E8%AF%A5%E5%B7%A5%E5%85%B7%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/homebridge/docker-homebridge/wiki/Homebridge-on-Synology
• https://github.com/homebridge/docker-homebridge/wiki/Homebridge-on-Unraid

兼容性

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

由于https://github.com/docker/for-mac/issues/68%E5%92%8Chttps://github.com/docker/for-win/issues/543%EF%BC%8C%E8%AF%A5%E9%95%9C%E5%83%8F%E5%9C%A8%E4%BD%BF%E7%94%A8Docker 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

此镜像预安装了https://github.com/homebridge/homebridge-config-ui-x%EF%BC%8C%E6%98%AF%E7%AE%A1%E7%90%86Homebridge%E7%9A%84%E4%BE%BF%E6%8D%B7%E5%B7%A5%E5%85%B7%E3%80%82

要访问管理界面，请在浏览器中打开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/homebridge/docker-homebridge/issues/434%E5%92%8Chttps://github.com/homebridge/docker-homebridge/issues/441%E8%8E%B7%E5%8F%96%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%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) 2023 homebridge
Copyright (C) 2017-2022 oznu

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