跳到主要内容

出门在外,家里的设备照样能管

家里的 Home Assistant、影音库都在局域网里,宽带又没有公网 IP?给它们一个 HTTPS 域名,在外打开 App 或浏览器就能控制设备、看片,设备状态也会实时刷新。

适合谁
在家用服务器、软路由或 NAS 上运行 Home Assistant、Jellyfin 等服务的个人用户。
推荐协议
HTTPS

它是怎么连起来的

客户端装在能访问服务的电脑上,主动连接网云穿,由网云穿提供公网入口。

  1. 内网服务家庭服务器Home Assistant 8123 · Jellyfin 8096
  2. 网云穿网云穿客户端Docker 或同一内网常开设备
  3. 外网访问手机 App / 浏览器https://home.example.com
示意图 · 地址与端口仅作说明,请按实际环境填写。

四步完成接入

  1. 1

    在家里的局域网内确认服务可以正常打开和登录,并为账号设置强密码。

  2. 2

    在家庭服务器的 Docker 中运行官方 Linux 客户端,或装在同一内网一台常开的电脑上。

  3. 3

    创建 HTTPS 隧道并填写服务的内网地址和端口;Home Assistant 需要先信任客户端的转发,见下方常见问题。

  4. 4

    在手机 App 的外部访问地址里填写 HTTPS 域名,切换到手机流量验证控制和实时刷新。

配置完成后,这样验证

用手机流量打开 App,确认登录、设备控制和状态实时刷新都正常;影音服务再完整播放一段视频。

请只发布带账号登录的服务,不要把路由器、光猫的管理后台发布到公网。影音播放的流畅度取决于家里宽带的上传带宽和购买的带宽规格,高码率视频建议在服务端转码。

常见问题

打开 Home Assistant 提示 400: Bad Request?

网云穿会通过 X-Forwarded-For 传递访客真实 IP,Home Assistant 默认拒绝未信任代理的转发请求。在 configuration.yaml 的 http 中开启 use_x_forwarded_for,并把客户端所在设备的地址(同机运行通常是 127.0.0.1 或 Docker 网段)加入 trusted_proxies,然后重启。

设备状态能实时刷新吗?

可以。HTTP / HTTPS 隧道支持 WebSocket,Home Assistant 等服务的实时状态推送可以正常工作。

家里的宽带没有公网 IP,也能用吗?

可以。客户端从家里主动连接网云穿节点,不需要公网 IP,也不用在光猫或路由器上做端口映射。

现在开始配置

下载客户端,按上面的步骤创建第一条隧道。