home-tunnel
自托管家庭服务连接与远程桌面平台，支持 NAS、Home Assistant、Immich、Jellyfin 及本地服务通过公网隧道访问
Ficha actualizada 23 sept 2026, 6:01 · upstream 23 sept 2026, 5:40 · release v8.0.0
Qué es home-tunnel
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Home Tunnel 是一个自托管的家庭服务连接与远程桌面平台。它允许用户在自己的公网服务器上建立隧道，将家里的 NAS、Home Assistant、Immich、Jellyfin 和其他本地服务连接到外部网络。客户端支持 Windows/macOS/Linux，提供 Web 和 Android 管理界面。
核心功能包括：HTTP/HTTPS/TCP/UDP 多种协议支持，SSH/RDP/RTSP 预设连接方式，MFA（多因素认证）与加密备份机制。8.0 版本引入了独立的远程桌面功能，允许浏览器直接连接到 Windows 被控端进行视频、输入和文件传输。
部署流程简单：准备公网 Linux 服务器并配置 Docker Compose 即可启动服务端；家庭设备通过客户端安装程序登记后添加服务即可连接。支持一次性接入码、TOTP/恢复码等安全机制，并提供批量操作、标签管理、脱敏诊断等功能。
界面采用 Web 控制台与 Android 应用双端管理，提供会话撤销、权限控制、日志审计等运维能力。所有数据加密传输，支持 SHA-256 文件完整性校验，确保家庭设备间的数据安全。
- 为 Home Assistant 配置自动化场景，通过隧道访问本地传感器与设备状态
- 将 NAS 的媒体库（如 Jellyfin）从局域网迁移至公网服务器进行集中管理
- 在 Windows 上运行远程桌面应用并控制受控终端进行文件共享或系统维护
- 为 Android 手机提供多服务器管理的统一入口，通过隧道访问多个家庭服务
- 将 Home Assistant 的自动化设备接入公网网络，实现跨网段设备联动
- 在 Linux NAS 上运行 Docker Compose 容器化服务并远程管理其状态
- 8.0 版本新增独立授权的远程桌面功能，浏览器可直接连接 Windows 被控端进行视频、输入与文件传输，且无法直连时明确失败
- 支持 HTTP/HTTPS/TCP/UDP 多种协议隧道模式，并预置 SSH/RDP/RTSP 连接方式
- 提供 SHA-256 文件完整性校验机制，确保 NAS 媒体库等关键数据在传输过程中不被篡改
- Android 客户端集成 JNI 与 Surface API，支持真机解码与系统音频控制
- Windows/macOS 8.0 包提供 Sigstore 签名证明而非 Authenticode 发行签名，增强可信度验证
- 支持批量设备接入、会话撤销、标签管理等功能，提升家庭网络设备的集中管理能力
- macOS 与 Wayland 桌面环境下的被控端观看窗口、系统声音及麦克风回传功能尚未交付
- Android 真机解码能力未经验收，仅支持基础视频播放
- Windows 文本剪贴板互通性未经过完整验证，实际系统级共享仍待确认
- H.264/VP8 硬件加速依赖软件编码实现，无法保证在特定硬件上达到最佳性能
- 多窗口并发、跨网络访问及长期在线稳定性等高级功能尚未完成验收
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
部署服务端需准备一台公网 Linux 主机（推荐 x64），安装 Docker Compose 并运行 `docker-compose up -d`。修改配置文件中的初始管理员密码后，服务即可启动。客户端可通过 `docker compose pull` 拉取镜像或手动下载二进制包。Windows/macOS 用户可下载对应平台的安装包进行部署。建议配置防火墙规则以允许服务端所需的端口（默认 80/443）。如需使用 Docker Compose 编排，请确保网络环境支持容器间通信。所有服务启动后，可通过 Web UI 或 API 接口进行管理。
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.