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

ESPHome 本地部署及外网访问指南(Linux)

在 Linux 系统上部署 ESPHome 开源物联网平台,并结合内网穿透工具实现外网访问的完整流程。主要步骤包括使用 Python 虚拟环境安装 ESPHome Dashboard,创建设备配置文件,启动服务。随后通过 Docker 部署内网穿透容器,配置端口映射,使局域网内的 ESPHome 界面可通过公网地址访问。

古灵精怪发布于 2026/4/6更新于 2026/7/2559 浏览
ESPHome 本地部署及外网访问指南(Linux)

ESPHome 是一款用于 ESP8266 和 ESP32 芯片设备的开源系统,允许用户通过定义简单的 YAML 配置文件来创建物联网 (IoT) 设备应用,无需直接编写底层代码。它特别适合智能家居解决方案,可与 Home Assistant 集成,也可独立使用。本文将详细介绍如何在 Linux 系统局域网内部署 ESPHome 并结合内网穿透工具实现外网访问。

第一步,本地部署 ESPHome
  1. 本教程基于 Linux Ubuntu 系统进行演示,首先输入以下命令更新软件包列表并安装必要的依赖项。
sudo apt-get update && sudo apt-get install -y python3-pip python3-dev git
  1. 安装虚拟环境 venv 模块。
sudo apt install -y python3-venv

创建一个虚拟环境(例如在 ~/venv_esphome)。

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. 创建并进入一个空的 ESPHome 项目目录。
mkdir ~/esphome-dashboard
cd ~/esphome-dashboard

使用向导创建配置文件,按照提示完成。

esphome wizard your_device.yaml
  1. 在项目目录中运行以下命令启动 ESPHome Dashboard。
esphome dashboard .
  1. 打开浏览器访问地址 http://你的服务器 IP:6052 ,即可看到部署的 ESPHome 界面。

文章配图

第二步,外网访问本地 ESPHome

安装内网穿透工具。

  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. Token: ....

这表示安装成功了。

当前 Linux 终端这边,如果是使用的上面的命令,Docker 是运行在前台,此时可以按住 Ctrl + C 退出路由侠,容器也将退出。现在可以使用以下命令将其放入后台持续运行:

docker start lyx

注意如果容器删除,重新 docker run,将创建为新的设备。

需要注意的是,因为容器参数已经添加了 --restart=always,这样开机就会自动启动,不需要再手动启动路由侠了。

  1. 回到管理端设备列表,再次进入,就可以找到这个设备,可以修改名称。

文章配图

  1. 回到主界面,点击【内网映射】。

文章配图

  1. 注意右上角的设备名称下拉框,这里选中刚刚添加的设备名称,此时在这个界面上添加的映射,就属于刚刚这个设备。添加或修改一般需要等待 30 秒,容器中的路由侠进程就会更新并加载。切换好设备后,点击【添加映射】。

文章配图

  1. 选择【原生端口】。

文章配图

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

文章配图

  1. 创建好后,就可以看到一条映射的公网地址,复制地址。

文章配图

  1. 在外网电脑上,打开浏览器,在地址栏输入从工具生成的外网地址,就可以看到内网部署的 ESPHome 界面了。

文章配图

目录

  1. 第一步,本地部署 ESPHome
  2. 第二步,外网访问本地 ESPHome
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 前端 PDF 导出实战:JSPDF 与 HTML2Canvas 深度解析
  • AIGC 核心概念解析:22 个基础术语详解
  • Python 素数判断与查找算法详解
  • OpenCode 使用 GitHub Copilot 按次计费账单暴涨原因与优化方案
  • Spring Web MVC 核心概念与实战应用
  • OpenClaw 安全 AI 助理搭建与部署实战指南
  • Rust 控制流详解:条件、循环与模式匹配
  • 免费版 Trae 编辑器实测:i18n 任务排队千位与死循环问题
  • C++ 核心就业方向与技术成长指南
  • web应用集成AI翻译:前端+后端完整调用示例代码分享
  • 前端实现视频画中画功能 - 主页面与小窗同步控制
  • Git 工作流程详解:核心概念与主流模式选择
  • Git 新手必学:git clone -b 命令详解与实操
  • 前端 API 设计最佳实践
  • HTML/CSS 文本字体与字号设置实战指南
  • 宇树 G1 机器人开发入门:有线与无线连接配置
  • OpenClaw 开源多渠道 AI 个人助手技术架构与实践
  • 数据结构与算法:单链表综合练习(删除节点、反转、找中间节点)
  • OpenCode:开源 AI 编程代理技术与行业分析
  • AIGC 时代 R 语言在数据科学中的应用与优势

相关免费在线工具

  • 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