跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Python

Linux 本地部署 ESPHome 智能家居并实现外网访问

介绍在 Linux Ubuntu 系统上部署 ESPHome 智能家居集成方案,并通过 Docker 容器化方式配置内网穿透服务以实现局域网内部署服务的公网访问。步骤包括环境准备、虚拟环境创建、ESPHome 安装及 Dashboard 启动,最后通过配置映射端口完成外网连接。

PentesterX发布于 2026/4/6更新于 2026/9/877 浏览
Linux 本地部署 ESPHome 智能家居并实现外网访问

ESPHome 本地部署与外网访问指南

ESPHome 是一款用于 ESP8266 和 ESP32 芯片设备的开源系统,允许用户通过定义简单的 YAML 配置文件来创建复杂的物联网 (IoT) 设备应用,而无需直接编写底层代码。它特别适合于智能家居解决方案,可以与 Home Assistant 完美集成,也可以独立使用。

第一步:本地部署 ESPHome

本教程以 Linux Ubuntu 系统为例。

  1. 更新软件包列表并安装必要的依赖项。
sudo apt-get update && sudo apt-get install -y python3-pip python3-dev git
  1. 安装虚拟环境 venv 模块并创建虚拟环境。
sudo apt install -y python3-venv
python3 -m venv ~/venv_esphome
source ~/venv_esphome/bin/activate
  1. 使用国内源加速下载安装 esphome。
pip install esphome -i https://pypi.tuna.tsinghua.edu.cn/simple
esphome --version
  1. 创建并进入项目目录,使用向导生成配置文件。
mkdir ~/esphome-dashboard
cd ~/esphome-dashboard
esphome wizard your_device.yaml
  1. 在项目目录中启动 ESPHome Dashboard。
esphome dashboard .
  1. 打开浏览器访问 http://你的服务器 IP:6052,即可看到 ESPHome 界面。

文章配图

第二步:外网访问本地 ESPHome

1. 配置内网穿透服务

由于当前版本未提供网页管理,需配合客户端进行跨设备管理。

  1. 在客户端主界面进入'设备管理',点击'添加设备'查看安装码,复制该码用于后续配置。

文章配图 文章配图 文章配图

  1. 下载镜像并导入。
wget https://dl.luyouxia.com:8443/v2/lyx-docker-x86_64.tar
docker load -i lyx-docker-x86_64.tar
  1. 启动容器,填入安装码。
docker run --name lyx -it --restart=always --net=host -e code=这里填写安装码 luyouxia/lyx
  1. 等待安装完成,终端输出 [Device] Logged in. 表示成功。

若容器在前台运行,可按 Ctrl + C 退出,随后使用以下命令将其放入后台持续运行:

docker start lyx

注意:容器参数已添加 --restart=always,开机将自动启动。

2. 配置映射端口

  1. 回到管理界面,点击右上角返回主界面,找到刚添加的设备并修改名称。

文章配图

  1. 点击【内网映射】。

文章配图

  1. 选中设备名称,点击【添加映射】。

文章配图

  1. 选择【原生端口】。

文章配图

  1. 在内网地址填写服务器 IP 和 ESPHome 端口 6052,点击【创建】。

文章配图

  1. 创建成功后,复制生成的公网地址。

文章配图

  1. 在外网电脑浏览器输入该地址,即可查看内网部署的 ESPHome 界面。

文章配图

目录

  1. ESPHome 本地部署与外网访问指南
  2. 第一步:本地部署 ESPHome
  3. 第二步:外网访问本地 ESPHome
  4. 1. 配置内网穿透服务
  5. 2. 配置映射端口

更多推荐文章

查看全部
  • 从零开始模拟实现 STL vector 容器
  • MAVROS 安装与基础知识梳理及 ROS C++ 仿真案例
  • 多模态大语言模型(MM-LLMs)架构与训练进展综述
  • 10 个实用的 Python 自动化办公脚本示例
  • 基于 DeepFace 和 OpenCV 的情绪分析器
  • Python 学习路线与核心技能树详解
  • DeepSeek、Kimi、笔灵等 5 款网文 AI 写作工具实测横评
  • Django Web 框架入门与核心使用
  • 基于 AI 大模型的培训题库自动生成方案与实践
  • Stable Diffusion 系列演进与核心技术解析 (2022-2026)
  • 基于开源多情感 TTS 模型的 WebUI 部署与实践
  • 基于 YOLOv13 的无人机航拍电动自行车违规载人检测系统实战
  • OpenClaw Cron 系统设计:AI Agent 自主定时任务实现
  • MiniMax 海螺 AI 视频:图文生视频功能与 API 接入指南
  • WebPlotDigitizer 图表数据提取工具使用指南
  • 从低代码到 Vibe Coding:速度如何转化为资产与交付能力
  • FLUX.1-dev FP8 低显存部署教程
  • 大模型转行指南:核心知识、技能要求与学习路径
  • AI 生成内容水印技术:原理、工具与实践
  • Linux OpenEuler 部署 Qwen3-32B 大模型华为昇腾 Arm 服务器 MindIE Docker Dify 方案

相关免费在线工具

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online