e1ite/docker-homeseer4

HomeSeer HS4 Docker镜像

该镜像将HomeSeer HS4家庭自动化软件容器化。

当前HomeSeer版本：HS4 4.1.18.0

运行HomeSeer容器

bash
docker run -d \
    --name homeseer \
    -v /opt/homeseer:/HomeSeer \
    -v /etc/localtime:/etc/localtime:ro \
    -p 80:80 \
    -p 10200:10200 \
    -p 10300:10300 \
    -p 10401:10401 \
    -p 11000:11000 \
    --device /dev/ttyUSB0 \
    e1ite/docker-homeseer4:latest

参数说明：

• -e HOMESEER_VERSION=4_1_18_0：手动设置版本号
• --name homeseer：将容器命名为"homeseer"
• -v /opt/homeseer:/HomeSeer：将主机的/opt/homeseer目录（或您选择的其他目录）绑定挂载到容器中，用于持久化存储。主机上的此目录将包含完整的HomeSeer安装，必要时可在系统间迁移（迁移前需通过工具-系统-关闭HomeSeer进行干净关闭）
• -v /etc/localtime:/etc/localtime:ro：确保容器使用正确的本地时间
• -p 80:80：80端口，用于HomeSeer Web用户界面（可通过修改第一个数字指定不同的WebUI监听端口，例如-p 8080:80将监听8080端口）
• -p 10200:10200：***端口，供HSTouch使用
• -p 10300:10300：***端口，供myHS使用
• -p 10401:10401：***端口，供扬声器客户端使用
• --device /dev/ttyUSB0：将USB设备（如USB Zwave接口）传递到容器中；将ttyUSB0替换为实际设备名称（例如ttyUSB1、ttyACM0等）
• e1ite/docker-homeseer4:latest：镜像标签，详见下方说明

可用镜像标签

更新HomeSeer

Linux版HomeSeer发布新版本后，该镜像将很快更新。更新步骤如下：

bash
docker stop homeseer  # 或您通过--name参数指定的容器名称
docker rm homeseer    # 或您通过--name参数指定的容器名称
docker pull e1ite/docker-homeseer4

然后使用首次运行时相同的命令行参数重新创建容器。容器运行时将下载并安装新的HomeSeer版本。现有用户数据、插件等将被保留。

注意事项/已知问题

HomeSeer本质上是Windows程序，通过Mono框架在Linux上运行，因此无法正确响应Unix信号（如SIGTERM、SIGKILL等）。因此，docker stop命令无法干净关闭HomeSeer。应通过工具-系统-关闭HomeSeer进行干净关闭，这也会停止容器。

删除并重新创建容器时，HomeSeer将被重新安装；容器首次运行时，日志中将显示"HomeSeer (re)install/update required at container first run. Installing at /HomeSeer..."。但现有用户数据、插件等不会受影响。首次运行后的后续容器运行将日志显示"HomeSeer already installed, not (re)installing/updating..."。

该镜像目前仅支持amd64/x86_64架构。

问题反馈/贡献

如遇容器相关问题（包括缺少的插件依赖），请在GitHub仓库提交：https://github.com/e1ite/docker-homeseer4%E3%80%82%E6%8F%90%E4%BA%A4GitHub Issue前，请先查看上述"注意事项/已知问题"部分，确认问题是否已被记录。

如需贡献，请fork GitHub仓库，创建功能分支，然后提交Pull Request；对于简单的更改/修复，提交Issue可能更有效。

鸣谢

该镜像受@marthoc的HomeSeer镜像（Docker Hub上的marthoc/homeseer）启发，感谢@luck-y13更新DockerFile至最新版本。

变更日志