コミュニティソリューション

ZimaOSにHomeyセルフホストサーバーをインストール:最新のDocker Compose、ホストネットワーク、バックアップ

A February 2026 thread where a user asked for an easy Homey Self-Hosted Server install. A community member pasted Homey's official Docker run command using host networking, privileged mode, restart policy, and a persistent ~/.homey-shs volume. The original poster confirmed it installed and worked. Homey's current official Linux/Compose guide still uses the same architecture.

该源方案仍然非常新。一位社区回复者直接指向 Homey 的官方 Linux 说明,并使用了带有主机网络、特权模式、自动重启和持久化 ~/.homey-shs 目录更易于记录和复现。原发帖者回复说安装成功。

Homey 当前的官方支持页面仍使用相同的容器架构,并且现在也提供 Docker Compose 示例。在 ZimaOS 上,Compose 通常比一次性 docker run 命令。

检查 Homey 当前的最低要求

Homey 自托管服务器目前需要:

  • Intel/AMD 或 Arm 64 位 CPU;
  • 至少 1 GB 可用内存;
  • 至少 1 GB 可用存储空间;
  • 客户端可以访问的专用 LAN IP 地址/路径。

ZimaOS 已经提供 Docker,因此不要在主机上运行 Homey 通用的“安装 Docker”脚本。

源方案采用了 Homey 官方的 Docker Run 架构

使用的有效源命令是:

  • --network host;
  • --privileged;
  • --restart unless-stopped;
  • 映射到 /homey/user/;
  • ghcr.io/athombv/homey-shs.

原发帖者确认服务器已安装并正常运行。

当前的 Homey 文档也提供 Docker Compose

Homey 维护的 Compose 示例采用了相同的设计:

services:
  homey-shs:
    image: ghcr.io/athombv/homey-shs:latest
    container_name: homey-shs
    restart: unless-stopped
    network_mode: host
    privileged: true
    volumes:
      - ~/.homey-shs:/homey/user

请参阅 Homey 当前的自托管服务器 Compose 工作流

在 ZimaOS 上使用明确的持久化路径

上游 ~/.homey-shs 该路径在常规 Linux shell 中有效,但在 ZimaOS 上,最好选择明确的可写存储位置,例如在实际进行备份的存储空间下创建专用的 AppData 文件夹。

将该主机文件夹映射到 /homey/user 将其记录下来,以便今后重新安装。

ホストネットワークは意図的に使用されています

Homeyの公式Composeでは network_mode: host通常のDockerポートマッピングではなく、コンテナにホストのネットワーク名前空間への直接アクセスを与える

これによりLAN検出やデバイス通信が容易になりますが、ネットワーク分離も弱まります。コンテナがホスト上で開くサービスを確認してください。

特権モードは重大な権限付与です

公式のHomeyコンテナは特権モードで実行されます。そのため、通常のApp Storeサービスよりもはるかに広範なホスト/デバイス機能をコンテナに与えることになります。

公式のイメージ/ソースだけを使用し、常に最新の状態に保ってください。同じ特権コンテナに無関係なソフトウェアを追加しないでください。

Homeyのサービスポートを確認する

Homeyの現在のドキュメントには、4859~4862を含むデフォルトのサーバー/ブリッジポートが記載されています。ホストネットワークを使用すると、これらのリスナーはZimaOSホスト上に直接公開されます。

ZFWなどのホストファイアウォールを使用する場合は、必要なLANポートが意図したとおりに許可されていることを確認してください。

Homeyモバイルアプリでセットアップを完了する

コンテナの実行後、iOSまたはAndroidでHomeyを開き、新しいHomeyを追加して「Self-Hosted Server」を選択します。自動検出に失敗した場合は、現在のHomey設定で HOMEY_LOCAL_ADDRESS ホストのLAN IPv4アドレスを定義します。

コンテナをプルして再作成することで更新する

Homeyの現在の手順では、永続化されたホストフォルダーを保持したまま、イメージを更新してコンテナを再作成します。データは使い捨てのコンテナの外部に保存されているため、維持されます。

Homeyの永続フォルダーをバックアップする

Homeyは、選択した場所に保存されているファイルとフォルダーをバックアップするよう明示的に案内しています .homey-shs パス。そのバックアップは、コンテナ自体を保持することよりも重要です。

ZimaOSでのHomey FAQ

元のユーザーはHomeyが動作したことを確認しましたか?

はい。推奨されたDockerのインストール方法は問題なく動作しているとのことです。

ZimaOSユーザーはHomeyのcurlスクリプトでDockerをインストールすべきですか?

いいえ。ZimaOSにはすでにDockerが含まれているため、コンテナ/Composeの部分だけを使用してください。

なぜコンテナの外部に/homey/userを永続化するのですか?

そのディレクトリにはHomeyの永続的な状態が保存されているため、設定を失わずにコンテナを更新または再作成できます。