Tasmota Compiler Docker镜像文档

镜像概述

Tasmota Compiler是一个提供Web图形界面(GUI)的Docker镜像，旨在简化Tasmota固件的自定义编译流程。通过该镜像，用户无需在本地配置复杂的开发环境，即可通过浏览器界面完成Tasmota固件的参数配置、功能选择和编译操作，降低了自定义Tasmota固件的技术门槛。

核心功能与特性

• Web界面操作：全图形化操作界面，无需命令行知识，直观配置编译参数
• 自定义配置：支持选择Tasmota版本、设备模块、功能组件、网络参数等核心配置项
• 一键编译：自动处理编译依赖，点击按钮即可完成固件编译流程
• 固件下载：编译完成后可直接下载生成的二进制固件文件
• 环境隔离：所有编译过程在容器内完成，不影响本地系统环境
• 轻量部署：基于Docker容器，部署简单，支持多平台运行

使用场景与适用范围

• 智能家居爱好者：需要为不同智能设备（如传感器、开关）定制Tasmota固件，开启/关闭特定功能
• 物联网开发者：快速测试不同Tasmota配置组合，验证功能兼容性
• DIY设备制作者：根据自定义硬件需求编译适配固件，减少不必要的功能冗余
• 无本地开发环境用户：无法或不愿在本地安装编译工具链（如Git、Python、编译依赖库）的用户

使用方法

基本部署（Docker Run）

通过以下命令快速启动容器：

docker run -d \
  --name tasmocompiler \
  -p 3000:3000 \
  --restart unless-stopped \
  benzino77/tasmocompiler

• -p 3000:3000：将容器内3000端口映射到主机3000端口（默认Web服务端口）
• --restart unless-stopped：容器退出时自动重启（可选）

启动后，通过浏览器访问 http://<主机IP>:3000 即可打开Web界面。

Docker Compose配置

创建 docker-compose.yml 文件：

version: '3'
services:
  tasmocompiler:
    image: benzino77/tasmocompiler
    container_name: tasmocompiler
    ports:
      - "3000:3000"
    restart: unless-stopped
    # 可选：挂载数据卷保存编译缓存或配置（如需要持久化）
    # volumes:
    #   - ./tasmocompiler_data:/app/data

执行 docker-compose up -d 启动服务。

访问与操作流程

1. 容器启动后，访问 http://<主机IP>:3000 进入Web界面
2. 在界面中选择Tasmota版本（如最新稳定版或开发版）
3. 配置设备参数：选择设备类型、GPIO映射、使能/禁用功能（如MQTT、OTA、传感器支持等）
4. 点击"编译"按钮开始固件生成
5. 编译完成后，界面将提供固件下载链接，保存文件后即可刷入设备

配置说明

环境变量（可选）

• PORT：自定义Web服务端口（默认3000），如 -e PORT=8080 可将端口改为8080
• TZ：设置时区（如 -e TZ=Asia/Shanghai），影响日志时间戳显示

数据持久化（可选）

若需保存编译历史或配置，可挂载数据卷到容器内 /app/data 目录（具体路径以镜像实际设计为准）：

docker run -d \
  --name tasmocompiler \
  -p 3000:3000 \
  -v ./tasmocompiler_data:/app/data \
  benzino77/tasmocompiler

注意事项

• 编译过程依赖网络连接，需确保容器可访问互联网以下载Tasmota源码和编译依赖
• 编译时间受设备性能影响，低配置主机可能需要更长时间
• 生成的固件仅适用于对应配置的设备，刷写前请确认硬件兼容性