1. 项目概述与核心价值最近在折腾一个挺有意思的项目叫“wanwuguixia-home”。光看这个名字可能有点摸不着头脑但如果你对智能家居、家庭自动化或者本地化部署的私有云服务感兴趣那这个项目绝对值得你花时间研究一下。简单来说这是一个旨在将你的家庭网络环境打造成一个功能强大、高度集成且完全由你掌控的“智慧家庭中枢”的开源项目。它不是一个单一的软件而是一个精心编排的“全家桶”式解决方案通过Docker容器化技术将一系列优秀的开源服务整合在一起让你能轻松搭建起一个集媒体管理、文件同步、智能控制、数据备份于一体的私有化平台。我之所以对这个项目产生浓厚兴趣是因为在尝试过市面上各种智能家居平台和云服务后总感觉有些“不自在”。数据隐私是一方面更重要的是很多服务功能割裂A平台的设备无法和B平台的服务联动想要实现一个复杂的自动化场景往往需要在多个App和网页间跳转配置繁琐不说稳定性也堪忧。而“wanwuguixia-home”的核心思路就是“All in One, All in Local”。它把控制权完全交还给你所有数据都在你自己的服务器或NAS上服务之间通过内部网络高效通信你可以像搭积木一样自由组合和扩展功能。这个项目适合谁呢首先你需要有一台可以7x24小时运行的设备比如一台闲置的旧电脑、一台树莓派或者更专业的NAS如群晖、威联通。其次你需要对Docker和Linux命令行有基本的了解至少知道怎么安装Docker、拉取镜像、运行容器。不过别担心即使你是新手跟着清晰的步骤走也能成功搭建。最后也是最重要的你需要有一颗爱折腾、爱探索的心。这个项目带来的不仅仅是功能上的便利更是一种“自己动手丰衣足食”的成就感和对数字生活的完全掌控。2. 项目整体架构与设计思路拆解2.1 核心设计哲学容器化与微服务“wanwuguixia-home”项目最精妙的设计在于它彻底拥抱了容器化和微服务架构。它没有尝试去开发一个庞大而臃肿的单一应用来满足所有需求而是采用了“专业的事交给专业的工具”的策略。项目维护者chenchen1010像一位经验丰富的交响乐指挥精心挑选了各个领域最出色的开源软件作为“乐手”然后通过 Docker Compose 这个“乐谱”将它们和谐地组织在一起共同演奏出家庭自动化的华丽乐章。为什么选择 Docker这背后有几个关键考量。首先是隔离性。每个服务如媒体服务器、下载工具、智能网关都运行在独立的容器中拥有自己的文件系统、网络和进程空间。这意味着即使某个服务崩溃或出现安全漏洞也不会影响到其他服务极大地提升了整个系统的稳定性和安全性。其次是可移植性与一致性。Docker 镜像包含了应用运行所需的所有依赖确保了“一次构建处处运行”。你在自己的电脑上测试好的配置可以毫无障碍地部署到树莓派或云服务器上完全避免了“在我机器上好好的”这类环境问题。最后是易于管理。通过一个统一的docker-compose.yml文件你可以用几条简单的命令完成所有服务的启动、停止、更新和配置管理复杂度直线下降。2.2 核心服务栈选型解析项目集成的服务通常覆盖了家庭数字生活的几个核心领域。虽然具体的服务列表可能会随版本更新而变化但我们可以根据常见的“智慧家庭中枢”需求来剖析其典型的选型逻辑媒体管理与播放如 Jellyfin/Plex/Emby这是家庭娱乐的核心。项目很可能会集成 Jellyfin因为它完全免费、开源且功能强大。它能自动刮削影视剧的元数据封面、简介、演员表并实时转码让你在任何设备手机、平板、电视上都能流畅播放不同格式的视频。选择它的理由在于其活跃的社区、对硬件转码的良好支持以及没有订阅费用的纯粹开源精神。下载与内容获取如 qBittorrent 自动追剧工具一个高效的家庭中枢离不开自动化的内容下载。项目可能会组合使用 qBittorrent下载客户端和 Sonarr/Radarr电视剧/电影自动追更工具。qBittorrent 以其轻量、无广告和强大的功能著称。而 Sonarr/Radarr 则能监控你关注的剧集或电影一旦有资源发布就自动调用 qBittorrent 下载并重命名、移动到 Jellyfin 的媒体库文件夹中实现“订阅即观看”的全自动化流程。文件同步与备份如 Nextcloud/Syncthing数据是数字家庭的血液。Nextcloud 可以看作是一个开源的私有云盘提供类似网盘的文件同步、分享、在线协作功能。将它部署在家里你的照片、文档可以自动从手机同步到服务器既安全又快速完全摆脱对公有云服务的依赖。Syncthing 则是点对点的文件同步工具更适合在多台设备间同步特定文件夹配置更灵活。智能家居与自动化如 Home Assistant这是将“家庭”升级为“智慧家庭”的灵魂。Home Assistant (HA) 是一个极其强大的开源家庭自动化平台。它能接入成百上千种不同品牌的智能设备通过官方集成、社区插件或本地协议并将它们统一管理。你可以在 HA 里创建复杂的自动化场景例如“晚上10点自动关闭所有灯并启动睡眠模式”、“下雨时自动关闭窗户并推送通知”。项目集成 HA就是为了打造一个跨品牌、本地执行的智能控制中心。网络与安全如 Nginx Proxy Manager, AdGuard Home为了让外部安全地访问内部服务以及优化家庭网络环境项目通常会包含反向代理和广告过滤工具。Nginx Proxy Manager 提供了一个漂亮的网页界面让你轻松为每个内部服务如 Jellyfin, Nextcloud设置域名和 SSL 证书实现 HTTPS 加密访问。AdGuard Home 则是一个网络级的广告拦截器部署后你家庭网络中的所有设备上网时大部分广告都会被过滤掉提升浏览体验和安全性。注意以上服务选型是基于常见模式的推断。实际项目中维护者chenchen1010可能会有更个性化的选择或版本偏好。部署前务必查阅项目最新的docker-compose.yml文件或文档以确认实际包含的服务。2.3 网络与存储架构设计一个稳健的架构是系统长期稳定运行的基础。这个项目在 Docker Compose 中通常会定义两个关键的自定义网络和精心规划的存储卷。网络设计前端网络如frontend-net供需要被外部访问的服务使用如 Nginx Proxy Manager。这个网络通常会被映射到宿主机的端口。后端网络如backend-net供内部服务之间通信使用如 Jellyfin 访问下载器的完成目录Home Assistant 与其他容器交互。这个网络是隔离的不直接暴露给外网更安全。服务间通信通过 Docker 的内部 DNS容器之间可以直接使用在docker-compose.yml中定义的服务名进行访问例如 Jellyfin 可以通过http://qbittorrent:8080来访问 qBittorrent 的 Web 界面这比使用易变的 IP 地址要可靠得多。存储设计 这是避免数据丢失的关键。项目会通过 Docker 的“卷”volumes或“绑定挂载”bind mounts来持久化数据。配置卷Config Volumes每个服务的配置数据如 Jellyfin 的用户数据库、Home Assistant 的配置文件会保存在独立的命名卷中。即使删除并重建容器配置也不会丢失。数据卷Data Volumes媒体文件、下载内容、Nextcloud 的文件等大量数据通常建议使用“绑定挂载”直接映射到宿主机的物理目录如/home/user/media。这样做的好处是你可以直接用系统工具如 rsync备份这些目录管理起来更直观。统一的父目录一个好的实践是在宿主机上创建一个总项目目录如/opt/wanwuguixia然后在下面为每个服务建立子目录/opt/wanwuguixia/jellyfin/config,/opt/wanwuguixia/media/movies。这样结构清晰便于管理和备份。3. 从零开始的详细部署实操3.1 基础环境准备假设我们在一台安装好 Ubuntu Server 22.04 LTS 的机器上进行部署。这是目前一个非常稳定且社区支持完善的选择。第一步系统更新与基础工具安装sudo apt update sudo apt upgrade -y sudo apt install -y curl wget git vim net-tools更新系统确保安全补丁到位安装的这些小工具在后续排查问题时非常有用。第二步安装 Docker 与 Docker ComposeDocker 是项目的运行基石。我们使用 Docker 官方提供的安装脚本这是最可靠的方法。# 安装 Docker curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh # 将当前用户加入 docker 组避免每次都要 sudo sudo usermod -aG docker $USER # 退出当前终端并重新登录使组权限生效安装 Docker Compose。虽然 Docker 现在有compose插件但独立的docker-compose脚本在某些场景下更通用。sudo curl -L https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose sudo chmod x /usr/local/bin/docker-compose # 验证安装 docker --version docker-compose --version第三步获取项目代码我们需要将chenchen1010/wanwuguixia-home的配置拿到本地。通常这类项目会托管在代码仓库中。# 创建一个项目总目录并进入 mkdir -p ~/wanwuguixia cd ~/wanwuguixia # 假设项目在 GitHub 上使用 git 克隆请替换为实际仓库地址 git clone https://github.com/chenchen1010/wanwuguixia-home.git . # 如果没有 git或者项目以压缩包形式提供也可以用 wget 下载 # wget https://example.com/wanwuguixia-home.tar.gz tar -xzvf wanwuguixia-home.tar.gz进入项目目录后你首先应该看到一个docker-compose.yml文件和一个README.md或.env.example文件。README.md是部署圣经一定要先读。3.2 配置文件详解与个性化调整直接运行docker-compose up大概率会失败因为我们需要先配置环境变量和目录。理解docker-compose.yml 用编辑器打开这个文件。你会看到它定义了一系列服务services、网络networks和卷volumes。每个服务部分重点关注image: 使用的 Docker 镜像如linuxserver/jellyfin:latest。container_name: 容器的名字方便管理。environment: 环境变量这是配置服务的核心比如设置时区、管理员密码等。volumes: 挂载卷格式为宿主机目录:容器内目录。这决定了数据存哪里。ports: 端口映射格式为宿主机端口:容器端口。将容器内部端口暴露给宿主机。networks: 该容器加入哪个 Docker 网络。restart: 重启策略通常设为unless-stopped确保服务在 Docker 守护进程启动时自动运行。配置.env文件 项目通常会提供一个.env.example文件。你需要复制它并重命名为.env然后编辑。cp .env.example .env vim .env这个文件定义了在整个docker-compose.yml中引用的变量。关键配置包括PUID和PGID设置运行容器的用户和组ID。这关系到容器内创建的文件权限。可以通过id $USER命令查看你当前用户的 UID 和 GID。TZ时区设为Asia/Shanghai。MEDIA_PATH媒体文件的根目录在宿主机上的路径如/home/yourname/media。CONFIG_PATH各服务配置文件的根目录如/home/yourname/docker-config。各个服务的特定密码如QBITTORRENT_WEBUI_PASSWORD、NEXTCLOUD_ADMIN_PASSWORD等。务必修改这些默认密码创建目录结构 根据你在.env文件中设置的路径创建相应的目录。mkdir -p ${MEDIA_PATH}/movies ${MEDIA_PATH}/tvshows ${MEDIA_PATH}/downloads mkdir -p ${CONFIG_PATH}/jellyfin ${CONFIG_PATH}/qbittorrent ${CONFIG_PATH}/nextcloud ${CONFIG_PATH}/homeassistant # 注意${MEDIA_PATH} 等变量需要你替换为 .env 中设置的实际值或者先 source .env 文件。一个清晰的目录结构是后续维护的福音。3.3 启动服务与初步验证配置完成后就可以启动所有服务了。# 在项目目录包含 docker-compose.yml 和 .env 的目录下执行 docker-compose up -d-d参数代表“后台运行”。这条命令会依次拉取镜像如果本地没有、创建网络和卷并启动所有容器。检查运行状态docker-compose ps这个命令会列出所有服务并显示它们的状态Up 表示运行中、端口映射等信息。查看实时日志 如果某个服务没有正常启动状态不是 Up可以查看其日志排查。# 查看所有服务的日志 docker-compose logs # 查看特定服务的日志例如 jellyfin docker-compose logs jellyfin # 持续跟踪日志类似 tail -f docker-compose logs -f jellyfin初步访问测试 在宿主机上打开浏览器访问http://localhost:PORTPORT 为docker-compose.yml中映射的宿主机端口。例如Jellyfin:http://localhost:8096qBittorrent:http://localhost:8080Nextcloud:http://localhost:8080(注意端口冲突实际项目会区分开) 如果能打开登录页面说明服务基本启动成功。实操心得第一次启动时建议先不用-d参数直接运行docker-compose up在前台观察所有容器的启动日志。这样一旦有报错比如权限错误、目录不存在你能立刻在终端看到方便快速定位问题。确认所有服务都启动成功后按CtrlC停止再用docker-compose up -d放到后台运行。4. 核心服务配置与深度集成指南4.1 媒体服务器 Jellyfin 的优化配置成功登录 Jellyfin 后默认用户可能是 admin密码在.env中设置你会发现媒体库是空的。我们需要告诉它媒体文件在哪里。添加媒体库在控制台 - 媒体库点击“添加媒体库”。内容类型选择电影、剧集等。文件夹点击“”号添加容器内的路径。这里至关重要容器内路径是在docker-compose.yml的volumes部分定义的。例如如果你在volumes中配置了- ${MEDIA_PATH}/movies:/data/movies那么容器内路径就填/data/movies。Jellyfin 会去扫描这个目录。元数据下载器建议勾选所有可用的如 TheMovieDb, The Open Movie Database。语言选择“中文中国”。NFO 保存建议选择“仅优先使用互联网图像”让 Jellyfin 自己管理元数据。硬件转码设置大幅提升性能如果你的服务器 CPU 性能一般但带有 Intel 核显或 NVIDIA 显卡开启硬件转码能让视频实时转码流畅数倍。前提需要在docker-compose.yml中为 Jellyfin 服务添加设备映射。对于 Intel 核显添加devices: - /dev/dri:/dev/dri。对于 NVIDIA 显卡需要更复杂的设置安装 nvidia-container-runtime。Jellyfin 内设置控制台 - 播放找到“硬件加速”选项。根据你的显卡选择“Intel QuickSync (QSV)”或“NVIDIA NVENC”。编码格式建议选择“H.264”和“HEVC”兼容性最好。用户与权限管理可以为家人创建独立的用户并设置不同的媒体库访问权限、播放限制如是否允许转码、最大码率。4.2 自动化下载流水线搭建这是实现“追剧自由”的关键。我们需要让 Sonarr/Radarr 和 qBittorrent 联动起来。配置 qBittorrent访问 Web UI默认用户admin密码在.env中。进入“工具 - 选项”。连接确保 Web UI 端口和你在docker-compose.yml中映射的一致。可以勾选“启用备用 Web UI”提升界面响应速度。下载设置默认保存路径。这个路径必须是容器内路径并且要确保 Sonarr/Radarr 容器有权限访问。通常设置为/downloads对应宿主机${MEDIA_PATH}/downloads。重点设置分类和标签。在“BitTorrent”选项中启用“自动根据种子追踪器添加分类”。这方便后续工具识别下载内容。配置 Sonarr (电视剧)首次访问 Sonarr Web UI需要添加媒体根目录。同样添加容器内路径如/tv对应宿主机${MEDIA_PATH}/tvshows。添加索引器这是 Sonarr 搜索资源的来源。通常需要配置 Jackett一个聚合种子索引器的工具或 Prowlarr。在 Sonarr 设置 - 索引器中添加 Jackett 的 API 端点如http://jackett:9117/api/v2.0/indexers/all/results?apikeyYOUR_KEYtsearchq{Query}。添加下载客户端设置 - 下载客户端添加 qBittorrent。主机填qbittorrentDocker 服务名端口8080用户名密码填.env中设置的。测试连接保存前务必点击“测试”确保 Sonarr 能成功连接到 qBittorrent。添加剧集在“系列”页面搜索你想追的剧添加后可以设置监控状态如“全部剧集”、质量档位。Sonarr 会自动搜索并发送下载任务到 qBittorrent。配置 Radarr (电影)流程与 Sonarr 几乎完全一样只是媒体根目录指向/movies。联动原理当你添加一部剧集到 Sonarr 后Sonarr 会定期通过索引器搜索资源找到后通过下载客户端qBittorrent的 API 提交下载任务。qBittorrent 下载完成后Sonarr 会监控下载文件夹一旦发现文件完成就将其移动到最终的媒体库文件夹如/tv/剧集名/Season 01/并重命名为规范的格式如剧集名 - S01E01 - 集名.mkv。最后Jellyfin 的媒体库扫描会发现新文件并自动更新海报和元数据。4.3 智能家居中枢 Home Assistant 的入门与集成Home Assistant (HA) 的配置文件目录通常映射在${CONFIG_PATH}/homeassistant。其核心配置文件是configuration.yaml。初次启动与发现首次访问 HA它会尝试自动发现同一网络中的设备。你可能会看到一些发现的设备如电视、路由器等。可以按照向导完成初步设置。理解配置HA 的配置主要靠 YAML 文件。configuration.yaml是主入口你可以在里面通过include语句引入其他更模块化的配置文件推荐。# configuration.yaml 示例片段 default_config: # 启用一系列默认集成 homeassistant: time_zone: Asia/Shanghai # 引入其他配置文件 automation: !include automations.yaml script: !include scripts.yaml scene: !include scenes.yaml添加一个设备以小米温湿度计为例在 HA 侧边栏进入“配置 - 设备与服务”。点击“添加集成”搜索“Xiaomi Miot Auto”这是一个强大的第三方集成支持众多小米设备。按照提示选择“账号模式”输入你的小米账号密码建议使用账号集成而非本地模式兼容性更好。添加成功后HA 会自动扫描你小米账号下的所有设备。稍等片刻温湿度计等实体就会出现在“概览”页面上。创建一个简单的自动化 自动化是 HA 的灵魂。我们创建一个“当客厅温度高于28度时发送通知到手机”的自动化。进入“配置 - 自动化与场景 - 创建自动化”。触发器选择“设备”然后选择你刚添加的温湿度计的“温度”实体条件设为“高于”值填 28。动作选择“通知”然后选择“发送移动设备通知”。在消息中填写“客厅太热了当前温度 {{ trigger.to_state.state }}°C”。保存后这个自动化就生效了。你可以手动修改automations.yaml文件来更精细地控制。接入外部服务HA 的强大之处在于其海量的集成。你可以在“添加集成”里搜索并添加“Google Cast”控制 Chromecast 设备、“Spotify”、“ESPHome”自制智能硬件等。4.4 安全外网访问与反向代理让服务在家庭网络内运行只是第一步安全地从外部访问才是真便利。Nginx Proxy Manager (NPM) 让这一切变得简单。访问 NPM默认端口可能是81。首次访问需要创建管理员账户。设置 SSL 证书在 NPM 仪表盘进入“SSL Certificates”点击“Add SSL Certificate”。选择“Let‘s Encrypt”。输入一个你拥有的域名例如home.yourdomain.com并确保该域名的 DNS A 记录已指向你家的公网 IP 地址。填写你的邮箱勾选“Use a DNS Challenge”通常更可靠尤其是家宽 IP 可能变化的情况并选择你的 DNS 提供商如 Cloudflare, Aliyun进行验证。成功后会获得一个 SSL 证书。添加代理主机回到“Hosts”点击“Proxy Hosts” - “Add Proxy Host”。Domain Names填写子域名如jellyfin.yourdomain.com。Schemehttp。Forward Hostname / IP填 Docker 内部的服务名如jellyfin。Forward Port填该服务容器内暴露的端口如8096。SSL选择你刚才申请的 SSL 证书并强制开启 SSL。保存后你就可以通过https://jellyfin.yourdomain.com安全地访问内网的 Jellyfin 了。家宽动态公网 IP 处理大多数家庭宽带是动态公网 IP。你需要使用 DDNS动态域名解析服务。可以在你的路由器中配置 DDNS支持花生壳、DynDNS等或者在一个始终在线的 Docker 容器如ddclient中配置。将你的域名动态绑定到变化的公网 IP 上。端口转发最后一步在你的家庭路由器上将外部端口如 443转发到运行 NPM 的服务器的内部 IP 和端口如 192.168.1.100:443。这样外网的请求才能到达 NPM。5. 运维、监控与故障排查实录5.1 日常运维命令与数据备份系统跑起来后日常维护很简单。常用 Docker Compose 命令# 查看所有服务状态 docker-compose ps # 查看特定服务日志 docker-compose logs -f service_name # 重启某个服务如修改了配置 docker-compose restart service_name # 停止所有服务 docker-compose down # 停止并删除所有容器、网络数据卷不会删除 docker-compose down -v # 谨慎这会删除匿名卷可能包含数据。 # 更新所有服务到最新镜像先拉取镜像再重新创建容器 docker-compose pull docker-compose up -d数据备份策略 这是重中之重你需要定期备份两类数据配置数据即${CONFIG_PATH}下的所有子目录。这些数据量小但丢了很麻烦。# 使用 tar 打包压缩 tar -czvf /backup/wanwuguixia-config-$(date %Y%m%d).tar.gz -C /home/yourname/docker-config .媒体与用户数据即${MEDIA_PATH}和 Nextcloud 等服务的数据库文件通常也在配置卷里。数据量大可以使用rsync进行增量备份到外部硬盘或另一台服务器。rsync -av --delete /home/yourname/media/ /mnt/backup_disk/media_backup/建议将备份命令写成脚本并通过系统的cron计划任务定期执行。5.2 性能监控与健康检查确保系统健康运行需要一些监控手段。基础资源监控使用htop或glances命令查看 CPU、内存、磁盘和网络使用情况。Docker 资源监控docker stats # 查看所有容器的实时资源占用 docker system df # 查看 Docker 磁盘使用情况集成 Portainer可选但推荐Portainer 是一个 Docker 图形化管理工具。你可以把它也作为一个服务添加到docker-compose.yml中通过网页界面直观地管理容器、镜像、卷和网络查看日志非常方便。服务健康检查在docker-compose.yml中可以为服务定义healthcheck指令。Docker 会定期执行检查命令如 curl 一个健康检查端点如果失败容器状态会显示为unhealthy。这有助于更早发现问题。5.3 常见问题与排查技巧在部署和运行过程中你肯定会遇到各种问题。这里记录几个最常见的坑和解决办法。问题1容器启动失败日志显示“Permission denied”原因这是最常见的问题。容器内进程通常以非 root 用户运行对挂载的宿主机目录没有读写权限。解决确保宿主机目录的权限正确。最简单的方法是在创建目录后将其所有者改为你在.env中指定的PUID和PGID对应的用户。sudo chown -R 1000:1000 /home/yourname/media /home/yourname/docker-config假设你的PUID和PGID是 1000问题2Jellyfin/Sonarr 扫描不到媒体文件原因1挂载路径错误。容器内路径填错了或者宿主机目录不存在。排查进入容器内部查看。docker exec -it jellyfin bash ls -la /data/movies # 查看容器内路径是否存在文件原因2文件权限问题同上。原因3文件格式或命名不规范。虽然 Sonarr/Radarr 会重命名但初始下载的文件名太乱可能导致识别失败。确保索引器能提供相对规范的资源。问题3硬件转码不工作Jellyfin 转码时 CPU 占用率依然很高原因1设备未正确映射。检查docker-compose.yml中 Jellyfin 服务的devices配置。排查在宿主机上运行ls -la /dev/dri确认设备存在。进入容器内再次运行该命令确认设备已映射进去。原因2驱动问题。确保宿主机已安装正确的显卡驱动如intel-media-va-driver对于 Intel GPU。原因3Jellyfin 内设置错误。确认硬件加速选项选择正确并且转码时在播放界面点击“齿轮”图标查看是否显示“硬解”。问题4外网无法通过域名访问原因1DDNS 未更新或解析错误。用ping yourdomain.com检查解析的 IP 是否是你当前的公网 IP。原因2路由器端口转发未设置或设置错误。检查路由器中外部端口如443是否正确转发到了运行 NPM 的服务器内网 IP 和端口如 8443 或 443。原因3运营商封锁了家庭宽带的 80/443 端口。这是国内常见情况。解决方案是在 NPM 中将代理主机的“外部端口”改为一个非常用端口如 4443然后在路由器转发这个端口。访问时使用https://jellyfin.yourdomain.com:4443。原因4防火墙未放行端口。在宿主机上使用sudo ufw allow 4443/tcp如果使用 UFW放行端口。问题5下载速度慢原因1种子/ tracker 问题。尝试添加更多 tracker 服务器到 qBittorrent 中。原因2网络设置问题。在 qBittorrent 设置中确保“连接”里的端口是开放的可以在路由器做端口转发并启用“使用 UPnP / NAT-PMP”。原因3资源本身热度低。这是无法避免的。问题6Home Assistant 集成添加失败原因网络问题、Token 过期、集成已变更。排查首先查看 HA 的日志配置 - 日志。最常见的解决方法是删除这个集成清理浏览器缓存然后重新添加。对于第三方集成如 Xiaomi Miot Auto确保你安装的是最新版本可以通过 HACS 安装。搭建和运维这样一个复杂的家庭中枢系统就像打理一个数字花园。初期需要投入时间学习和配置但一旦系统稳定运行它所带来的自动化、便捷性和掌控感会让你觉得一切投入都是值得的。最关键的是你拥有了完全属于自己、不受任何商业公司掣肘的数字生活基础设施。