项目概述
项目地址: https://gitcode.com/gh_mirrors/ad/addon-ssh Home Assistant 社区插件 - 高级 SSH 和 Web 终端，是一个功能强大的扩展组件，允许用户通过 SSH 或 Web 终端登录到 Home Assistant 实例。该插件基于 Home Assistant 官方提供的 SSH 插件进行了全面增强，专注于安全性、易用性和灵活性，同时提供 Web 界面访问功能。
核心功能特性
SSH 服务器功能
- 基于 OpenSSH 构建的安全 SSH 服务
- 默认仅允许配置用户登录，即使创建了更多用户
- 使用已知安全加密算法和密码套件
- 限制登录尝试次数，有效防御暴力攻击
- 通过所有 SSH-Audit 安全检查，无任何警告
Web 终端集成
- 直接在 Home Assistant 前端嵌入的 Web 终端界面
- 无需额外 SSH 客户端即可访问命令行
- 完整的终端功能支持，包括命令历史记录和自动补全
高级安全特性
- SSH 兼容模式支持老旧客户端连接
- Mosh 支持，适用于移动设备和网络不稳定的环境
- SFTP 支持（默认关闭，用户可配置开启）
- 可配置用户名，不再强制使用 root 账户
系统集成能力
- 硬件访问权限：音频设备、串行设备、GPIO 引脚
- 提升权限运行，便于调试和测试
- 主机系统 DBus 访问
- Docker 实例访问权限
- 主机级网络运行，可打开端口或运行守护进程
技术架构
默认 Shell 环境
- ZSH 作为默认 shell，易于初学者使用，同时满足高级用户需求
- 预装 "Oh My ZSH" 框架及多个启用插件
- 可切换回 Bash shell
内置工具集
- 网络工具：curl、Wget、RSync、Nmap
- 版本控制：GIT
- 数据库客户端：MariaDB/MySQL 客户端
- 消息队列：Mosquitto 客户端
- 网络唤醒：Awake（Wake on LAN）
- 文本编辑器：Nano、Vim
- 终端多路复用：tmux
- 常用网络工具套件
自定义配置选项
包管理功能
- 启动时安装自定义 Alpine 包
- 支持安装常用工具，每次登录时自动可用
- 持久化自定义 SSH 客户端设置和密钥
启动脚本定制
- 插件启动时执行自定义命令
- 可定制 shell 环境配置
- 灵活的日志级别配置，便于问题排查
安装和使用
系统要求
- 支持 aarch64 和 amd64 架构
- 兼容通过通用 Linux 安装器安装的 Home Assistant
- 需要 Home Assistant 插件系统支持
配置说明
插件提供灵活的配置选项，包括：
- 用户账户设置
- SSH 端口和访问控制
- Web 终端集成选项
- 安全策略配置
- 硬件访问权限管理
安全警告
高级 SSH 和 Web 终端插件功能非常强大，几乎可以访问系统的所有工具和硬件。虽然该插件在创建和维护过程中注重安全性，但在不熟悉或不当使用的情况下，可能会对系统造成损害。建议用户在使用前充分了解相关功能和安全风险。
技术支持
用户可通过多种渠道获取技术支持：
- Home Assistant 社区插件 Discord 聊天服务器
- Home Assistant Discord 聊天服务器
- Home Assistant 社区论坛
- Reddit 子版块
许可证信息
本项目采用 MIT 许可证，版权所有 (c) 2017-2025 Franck Nijhof。该许可证允许用户自由使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本，只需保留版权声明和许可声明即可。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
