Home Assistant 社区插件：高级 SSH & Web 终端

![discord 徽标][discord-shield]

这个 Home Assistant 社区插件允许您通过 SSH 或 Web 终端登录您的 Home Assistant 实例，为您提供访问文件夹的权限，并内置了用于重启、更新和检查实例的命令行工具。

这是官方 Home Assistant 提供的 SSH 插件的增强版，专注于安全、易用性、灵活性，并提供 Web 界面访问功能。

关于

该插件为您提供了一个通过 SSH 和一个 Web 终端登录 Home Assistant 实例的途径，它具有以下特性：

• 直接从 Home Assistant 的前端访问命令行。
• 默认的安全 SSH 配置：
  • 只允许配置的用户登录，即使创建了更多用户。
  • 只使用已知安全的密码算法和加密方式。
  • 限制登录尝试以更好地防止未授权访问。
  • 还有许多其他安全性优化，此插件通过所有 ssh-audit 检查而不产生警告！
• 包含 SSH 兼容模式，以便旧客户端可以连接。
• 支持 Mosh 功能，适用于漫游并支持间歇性连接。
• SFTP 支持默认关闭，但可由用户自定义开启。
• 如果通过通用的 Linux 安装器安装了 Home Assistant，则仍然兼容。
• 可配置用户名，不再局限于"root"。
• 自定义 SSH 客户端设置和密钥在插件重启后保持不变。
• 访问音频、UART/串口设备和 GPIO 引脚的硬件。
• 有更多权限运行，可用于调试和测试多种场景。
• 可以访问主机系统的 dbus。
• 选项访问主机上的 Docker 实例。
• 在主机级别的网络上运行，允许您打开端口或运行小型守护进程。
• 安装自定义 Alpine 包，启动时即可使用，允许您安装自己喜欢的工具。
• 在插件启动时执行自定义命令，使您可以根据喜好定制 shell。
• 使用 ZSH 作为默认 shell，对于初学者更易于使用，对熟练用户来说功能更强大。预装了 "Oh My ZSH"，并且启用了一些插件。
• 如果 ZSH 不是你的首选项，你可以重新启用 Bash，包括 Core CLI 和 Home Assistant CLI 的 Bash 补全。
• 包含了一套合理的基础工具：curl、Wget、Rsync、GIT、Nmap、Mqtt 客户端、MariaDB/MySQL 客户端、Awake（唤醒功能）、Nano、Vim、tmux 以及一系列常用的网络工具。
• 通过 Home Assistant 服务调用来执行命令，例如在自动化中使用。

注意事项

高级 SSH & Web 终端插件非常强大，能让你接触到系统几乎所有的工具和硬件。

虽然这个插件在创建和维护时考虑到了安全，但在不当或者不熟悉的人手中，可能会损坏你的系统。

支持与贡献

有问题？

您可以通过以下几种方式获取帮助：

• 加入 Home Assistant 社区插件 Discord 服务器 获取关于插件的支持和特性请求。
• 加入 Home Assistant Discord 服务器 对于通用的 Home Assistant 讨论和问题。
• 查阅 Home Assistant 社区论坛。
• 加入 [Reddit 子版块][reddit] 中的 [/r/homeassistant][reddit] 社群。

您也可以在这里 在 GitHub 上打开问题。

贡献

这是一个活跃的开源项目。我们始终欢迎想要使用代码或做出贡献的人。

我们在单独的文档中制定了 贡献指南。

感谢参与！ :heart_eyes:

作者与贡献者

这个仓库的原始设置由 [Franck Nijhof][author] 完成。

要查看完整的作者和贡献者列表，请查看 [贡献者页面][contributors]。

我们还有更多的 Home Assistant 插件

想为你的 Home Assistant 添加更多功能吗？

我们已经创建了许多 Home Assistant 插件。要查看完整列表，请访问我们的 GitHub 存储库。

许可证

本项目采用 MIT 许可证。

版权所有 (c) 2017-2023 Franck Nijhof

在遵守许可的前提下，这里授予免费的复制、修改、合并、发布、分发、再授权软件及其副本的权利，没有明确说明的特殊权利除外。