本站支持搜索的镜像仓库：Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

homebridge/homebridge

基于Ubuntu的Docker镜像，可在x86_64、树莓派等ARM设备上运行Homebridge，模拟iOS HomeKit API，实现智能家居设备与HomeKit的兼容。

90 收藏0 次下载activehomebridge

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

中文简介版本下载

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

Homebridge Docker镜像

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

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

镜像标签	支持架构	基础镜像
latest, ubuntu	amd64, arm32v7, arm64v8	Ubuntu 24.04

分步指南

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

兼容性

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

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

使用方法

命令行：

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

使用Docker Compose（推荐）：

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频道提问。

许可证

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

常见问题

轩辕镜像免费版与专业版有什么区别？

免费版仅支持 Docker Hub 加速，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。

轩辕镜像免费版与专业版有分别支持哪些镜像？

免费版仅支持 docker.io；专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。

流量耗尽错误提示

当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。

410 错误问题

通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。

manifest unknown 错误

先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。

镜像拉取成功后，如何去掉轩辕镜像域名前缀？

使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。

查看全部问题→

轩辕镜像下载加速使用手册

探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式

🔐

登录方式进行 Docker 镜像下载加速教程

通过 Docker 登录方式配置轩辕镜像加速服务，包含7个详细步骤

🐧

Linux Docker 镜像下载加速教程

在 Linux 系统上配置轩辕镜像源，支持主流发行版

🖥️

Windows/Mac Docker 镜像下载加速教程

在 Docker Desktop 中配置轩辕镜像加速，适用于桌面系统

📦

Docker Compose 镜像下载加速教程

在 Docker Compose 中使用轩辕镜像加速，支持容器编排

📋

K8s containerd 镜像下载加速教程

在 k8s 中配置 containerd 使用轩辕镜像加速

🔧

宝塔面板 Docker 镜像下载加速教程

在宝塔面板中配置轩辕镜像加速，提升服务器管理效率

💾

群晖 NAS Docker 镜像下载加速教程

在 Synology 群晖NAS系统中配置轩辕镜像加速

🐂

飞牛fnOS Docker 镜像下载加速教程

在飞牛fnOS系统中配置轩辕镜像加速

📱

极空间 NAS Docker 镜像下载加速教程

在极空间NAS中配置轩辕镜像加速

⚡

爱快路由 ikuai Docker 镜像下载加速教程

在爱快ikuai系统中配置轩辕镜像加速

🔗

绿联 NAS Docker 镜像下载加速教程

在绿联NAS系统中配置轩辕镜像加速

🌐

威联通 NAS Docker 镜像下载加速教程

在威联通NAS系统中配置轩辕镜像加速

📦

Podman Docker 镜像下载加速教程

在 Podman 中配置轩辕镜像加速，支持多系统

📚

ghcr、Quay、nvcr、k8s、gcr 等仓库下载镜像加速教程

配置轩辕镜像加速9大主流镜像仓库，包含详细配置步骤

🚀

专属域名方式进行 Docker 镜像下载加速教程

无需登录即可使用轩辕镜像加速服务，更加便捷高效

需要其他帮助？请查看我们的常见问题或官方QQ群: 13763429

homebridge Docker 镜像下载 - 轩辕镜像

homebridge 镜像详细信息和使用指南

homebridge 镜像标签列表和版本信息

homebridge 镜像拉取命令和加速下载

homebridge 镜像使用说明和配置指南

Docker 镜像加速服务 - 轩辕镜像平台

国内开发者首选的 Docker 镜像加速平台

极速拉取 Docker 镜像服务

相关 Docker 镜像推荐

热门 Docker 镜像下载

homebridge 镜像详细信息

homebridge 镜像标签列表

homebridge 镜像使用说明

homebridge 镜像拉取命令

Docker 镜像加速服务

轩辕镜像平台优势

镜像下载指南