HA文档 目录

  1. 首页
  2. HA文档
  3. HA文档
  4. 基础配置
  5. HTTP配置

HTTP配置

这篇文章是系列文章的第4/8篇:

http组件为HomeAssistant WEB前端提供文件和数据服务,也是HomeAssistant对外提供API服务的基础。

系统缺省的configuration.yaml中,会加载http组件,其中所有的配置项都是空的。

http的配置项包含如下:

配置项 说明
api_password(可选) 访问http的密码
server_host(可选) 仅仅监听发送到指定ip/host的网络请求,缺省为全部(0.0.0.0)
server_port(可选) 监听的端口,缺省是8123
base_url(可选) internet上HA的访问地址,例如“hass-example.duckdns.org:8123”。缺省是本机的ip地址。当配置了数字证书后需要配置对应的域名
ssl_certificate(可选) 建立https通讯用的TLS/SSL证书文件地址
ssl_key(可选) 建立https通讯用的密钥文件地址
cors_allowed_origins(可选) 允许跨域资源共享(CORS,Cross-origin resource sharing)的域名列表
use_x_forwarded_for(可选) 接受http头的“X-Forwarded-For”信息,一般是由proxy在http访问请求信息中设置的客户端的真实地址。建议在安全的网络环境中使用此设置。缺省值是False。
trusted_networks(可选) 可信的(IP)网络列表,在可信网络列表中的客户端不需要密码即可访问HomeAssistant。如果你使用了反向代理,所有HA的请求都会来自反向代理的地址,所以在这种情况下,此设置要格外小心。
ip_ban_enabled(可选) 是否打开ip禁止功能,缺省为False。
login_attempts_threshold(可选) 在ip_ban_enabled为true情况下,单个IP错误密码尝试次数(超过尝试次数,此ip会被禁止访问)。缺省值为-1,表示尝试次数无穷大。

注:可选项代表此项可以不设置。

下面是一个http组件实际配置的例子(初始使用设置一个密码就可以了,其它设置当碰到实际需求时再进行设置):

在“ip_ban_enabled”设置为true的情况下,在首次阻止某个IP的时候,会在配置目录下生成文件“ip_bans.yaml”,其中包含被禁止的ip地址以及禁止的时间(国际标准时间)。同时在Home Assistant的web前端会生成一个持续的公告。

如果你想通过home assistant的http组件访问主机上的静态文件,可以在配置目录(.homeassistant)下创建一个www目录。这样,此目录下的文件就可以通过“http://your.homeassistant.hostip_or_domainname:8123/local/”访问了。

遇到问题了?快来学习免费在线课程吧,博学老司机在线答疑,找到更多志同道合的HA玩家一起进步

此文不允许转载,如需转载请与BD@hachina.io联系。

以上内容是否对您有帮助? 3 有帮助 1 没帮助