什么是 Watchtower？

Watchtower 是一个开源工具，用于自动监控和更新运行中的 Docker 容器。当检测到关联镜像有新版本时，Watchtower 会自动拉取新镜像，重建并重启对应的容器。这样可以实现应用的自动“滚动升级”，极大提升运维效率。

Docker Compose 配置示例

下面是一个典型的 docker-compose.yml 配置片段，加入了 Watchtower 服务：

version: "3.8"

services: 

  watchtower:
    image: registry.cn-beijing.aliyuncs.com/muta/watchtower:amd64
    restart: unless-stopped
    # 挂载 docker.sock 以便 Watchtower 能管理容器
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /root/.docker/:/config/
    environment:
      - DOCKER_CONFIG=/config
    # 监控项目的容器（tuechpresentation-api-1），这样不会影响其他容器
    command: --cleanup --interval 60 tuechpresentation-api-1

下面我们详细解释每一部分的作用。

配置详解

1. 镜像设置

image: registry.cn-beijing.aliyuncs.com/muta/watchtower:amd64

这里使用的是阿里云镜像仓库中的 Watchtower 镜像，适合国内用户加速下载。

2. 容器重启策略

restart: unless-stopped

表示除非手动停止容器，否则 Watchtower 会一直保持运行状态。

3. 挂载 Docker Socket

volumes:
  - /var/run/docker.sock:/var/run/docker.sock
  - /root/.docker/:/config/

• /var/run/docker.sock:/var/run/docker.sock
  Watchtower 需要通过 Docker 的 Unix Socket 与 Docker Daemon 通信，从而管理和重启其他容器。
• /root/.docker/:/config/
  挂载主机上的 Docker 配置目录，便于 Watchtower 使用 Docker 配置（如私有仓库认证信息等）。

4. 环境变量

environment:
  - DOCKER_CONFIG=/config

指定 Docker 配置的路径为 /config，即上面挂载的 /root/.docker/。

5. 启动命令

command: --cleanup --interval 60 tuechpresentation-api-1

• --cleanup
  更新后自动删除旧的无用镜像，节省磁盘空间。
• --interval 60
  每 60 秒检查一次镜像是否有更新。
• tuechpresentation-api-1
  只监控名为 tuechpresentation-api-1 的容器，不会影响其他容器的运行和更新。

这样配置后，Watchtower 只会自动更新指定的 API 容器，非常适合只希望自动维护某个服务的场景。

使用建议

• 安全性：挂载 Docker Socket 具有一定风险，建议只在可信环境下使用。
• 精细化控制：通过在 command 部分指定容器名，可以避免 Watchtower 无差别地更新所有容器，更加灵活。
• 日志查看：可以通过 docker logs watchtower 查看 Watchtower 的工作日志，了解其自动更新的动态。

总结

通过在 Docker Compose 中集成 Watchtower，可以实现容器的自动更新，极大降低了运维成本。合理配置后，还能做到只更新指定容器，安全高效。你可以根据自己的实际需求调整监控容器的范围和更新频率，让你的 Docker 环境始终保持最新和安全。

一、有限状态机（FSM，Finite State Machine）

1. 概念

有限状态机是一种把NPC行为分成几个“状态”的设计方式，比如“巡逻”、“攻击”、“逃跑”等。NPC任意时刻只会处于某一个状态，满足条件才会切换到其他状态。

2. 原理

• 状态：NPC所处的行为阶段。
• 切换条件：决定何时从一个状态跳转到另一个状态。
• 每个状态的具体行为：比如巡逻状态下，NPC会在场景中来回走动。

3. 树图示例

巡逻
└─ 发现敌人? 是 → 追击敌人
    └─ 距离很近? 是 → 攻击敌人
        └─ 血量很低? 是 → 逃跑

4. 讲解

比如一个警卫巡逻，发现敌人就追击，靠近了就攻击，受伤严重就逃跑。每个行为就是一个“状态”，切换条件清晰简单，非常适合新手入门和简单AI。

二、决策树（Decision Tree）

1. 概念

决策树就像一系列嵌套的“如果……那么……”的判断题。NPC会沿着判断条件，一步步选择最终要做的事情。

2. 原理

• 每一层是一个判断问题。
• 满足条件就继续往下判断，直到找到适合当前情况的行为。

3. 树图示例

发现敌人?
├─ 是
│   └─ 距离近?
│       ├─ 是 → 攻击
│       └─ 否 → 追击
└─ 否 → 巡逻

4. 讲解

比如NPC先问自己“看到敌人了吗？”如果看到，再问“敌人近吗？”，如果近就攻击，不近就追。如果没看到，就继续巡逻。适合逻辑不复杂的NPC。

三、行为树（Behavior Tree）

1. 概念

行为树是一种模块化的设计，把复杂行为拆解成一个个“小动作”，再像拼积木一样组合起来。每个“树枝”表示一个决策流程，叶子节点是具体动作。

2. 原理

• 从根节点出发，按顺序或优先级检查每个子节点。
• 组合复杂行为，比如“先做A，如果不行再做B”。
• 节点可以复用，易于扩展。

3. 树图示例

选择器
├─ 行为1：发现敌人?
│   └─ 是 → 顺序器
│       ├─ 面向敌人
│       ├─ 接近敌人
│       └─ 攻击敌人
├─ 行为2：血量低?
│   └─ 是 → 寻找掩体
└─ 行为3：巡逻

4. 讲解

行为树就像一个智能化的流程表，先判断优先级高的事（比如有敌人就先攻击），否则做次要的事（比如巡逻）。树的结构让每个行为都能灵活组合，非常适合复杂NPC。

四、GOAP（目标导向动作规划，Goal-Oriented Action Planning）

1. 概念

GOAP不是提前写好所有流程，而是让NPC根据“目标”动态规划怎么做。比如目标是“活下来”，NPC会自动选择“找药包”“找掩体”等步骤。

2. 原理

• 给NPC设定多个目标，如“消灭敌人”“保持安全”。
• 每个动作有“前提条件”和“结果”。
• NPC根据当前情况，自动规划一系列动作达成目标。

3. 树图示例（目标：消灭敌人）

目标：消灭敌人
├─ 需要武器?
│   └─ 是 → 去找武器
├─ 有武器 → 靠近敌人
└─ 接近后 → 攻击敌人

4. 讲解

比如NPC没有武器，就会先去找武器；有了武器后再去接近敌人，最后攻击。GOAP让NPC像“思考”一样，灵活应对不同情况，行为更智能。

五、黑板系统（Blackboard System）

1. 概念

黑板系统是一个信息共享平台，NPC的各个模块（比如感知、决策、行动）都可以在黑板上读写信息，实现协同。

2. 原理

• 黑板就像一个公告栏，大家都能看到。
• 感知模块发现敌人后，把信息写到黑板上。
• 行为模块读取这些信息，决定要做什么。

3. 树图示例

黑板
├─ 发现敌人 → 决策模块读取 → 切换到攻击状态
├─ 发现血包 → 决策模块读取 → 前往拾取
└─ 其他信息

4. 讲解

黑板让NPC的不同部分可以互相沟通，比如“感知”发现敌人，“决策”模块就能知道要攻击。这种方式多用于复杂AI系统。

六、基于规则的系统（Rule-based System）

1. 概念

基于规则的系统，就是提前写好一堆“如果……那么……”的规则，NPC遇到情况就一条条检查，满足条件就执行相应行为。

2. 原理

• 规则库里存着各种条件和结果。
• NPC不断检查当前所有规则，执行最先匹配的行为。

3. 树图示例

规则库
├─ 如果血量低 → 寻找医疗包
├─ 如果敌人靠近 → 攻击
└─ 否则 → 巡逻

4. 讲解

比如“如果血量低，去找药包；如果敌人靠近，先攻击”。适合简单或者中等复杂度的AI，但规则多了后管理会变复杂。

七、机器学习/深度学习方法

1. 概念

机器学习让NPC通过“学习”来变得更聪明，比如通过反复试错，自动学会最佳行为。

2. 原理

• 通过大量训练，AI模型掌握在不同情况下的最佳反应。
• 强化学习：NPC每做一次选择，都会得到奖励或惩罚，通过不断尝试，学会最优策略。

3. 树图示例（简化思路）

环境反馈
├─ 尝试动作A → 得到奖励 → 增强动作A
├─ 尝试动作B → 得到惩罚 → 减少动作B
└─ 反复迭代 → 学习到最佳行为

4. 讲解

比如NPC在模拟环境里尝试“攻击”“逃跑”“躲避”，每次尝试后都通过奖励机制调整行为，最终学会如何做得最好。这种方法适合做高智能NPC，但开发和训练成本高。

八、基于大语言模型的生成式智能体架构（以斯坦福AI小人虚拟小镇为例）

1. 概念

生成式智能体（Generative Agent）是一种借助大语言模型（如GPT）作为“智能大脑”，结合记忆、检索、反思、计划等模块，模拟出高度拟人的行为和交互。其典型代表是斯坦福大学提出的“AI小人虚拟小镇”，在开源社区（如a16z重写版）得到了广泛应用。

传统AI方法如有限状态机、行为树、GOAP等，行为多为“脚本化”或“规则化”。生成式智能体则通过自然语言驱动行为，能够自我进化、动态适应环境，表现出类似人类的复杂行为。

2. 技术架构与整体思路

2.1 架构树状图

生成式智能体架构
├─ 记忆流（Memory Stream）
│   ├─ 观察（Observations）
│   ├─ 反思（Reflections）
│   └─ 计划（Plans）
├─ 检索机制（Retrieval）
│   ├─ 近因性
│   ├─ 重要性
│   └─ 相关性（向量数据库）
├─ 反思机制（Reflection）
│   └─ 抽象/推理（生成反思树）
├─ 计划与反应（Planning & Reaction）
│   ├─ 高层计划
│   └─ 递归细化
├─ 行为生成（Action Generation）
│   ├─ 环境互动
│   └─ 代理对话
├─ 用户交互
│   └─ 用户输入（自然语言）
├─ 外部支持系统
│   ├─ 游戏引擎、数据库
│   ├─ 向量数据库
│   ├─ 文字生成模型（LLM）
│   └─ 像素图生成等

2.2 架构详细讲解

A. 记忆流（Memory Stream）

• 每个智能体都有自己的“记忆数据库”，记录着所有经历过的事件、对话、计划、反思等。
• 记忆以自然语言形式存储，包含时间戳和访问时间，既有“观测”也有“抽象反思”。
• 例如：AI小人“伊莎贝拉”会记得“今天早上在厨房遇到朋友做早餐”。

B. 检索机制（Retrieval）

• 智能体需要从大量记忆中检索出“当前最相关”的记忆，指导当下行为。
• 检索包括三大指标：
  • 近因性：越新发生的事件，分数越高。
  • 重要性：事件越重要，分数越高（如“分手”比“刷牙”重要）。
  • 相关性：用向量数据库（如Pinecone）计算与当前情境的相似度。
• 例如，AI小人要决定是否去见某人，会回忆最近有关此人的经历和情感。

C. 反思机制（Reflection）

• 不只是被动记忆，还会主动“总结归纳”，形成“反思”。
• 反思是对多个相关记忆的抽象，比如“我和朋友的关系变得更亲密了”。
• 反思会形成“树状结构”，叶节点是具体事件，高层节点是抽象见解。
• 反思周期性发生，重要事件累积到阈值时触发。

D. 计划与反应（Planning & Reaction）

• 智能体会制定自己的“日程计划”，比如“早上做早餐、上午去公园、下午工作”。
• 计划可以递归细化成更小的行动步骤，并随时根据环境变化做出调整。
• 每当环境或其他智能体行为发生变化，计划会实时更新。

E. 行为生成（Action Generation）

• 智能体的每一步行为由大语言模型（如GPT）生成，行为描述为自然语言，并映射到具体动作。
• 智能体之间的对话、与环境的交互都通过自然语言描述和解释。

F. 用户交互

• 用户可以通过自然语言输入影响智能体（如指派任务、修改属性）。
• 用户也可以“化身”进入虚拟小镇，成为其中一员。

G. 外部支持系统

• 游戏引擎（Convex）、数据库、向量数据库（Pinecone）、文字生成模型（OpenAI）、像素图生成（Replicate/Fal.ai）等，构成整个技术栈的基础设施。

3. 与传统AI方法的对比

4. 生成式智能体的创新点

• 内逻辑与外逻辑结合：大语言模型负责“想”，外部系统负责“管”数据和操作。
• 记忆驱动行为：不再依赖死板脚本，行为由“记忆-检索-反思-计划”动态生成。
• 行为高度拟人：能模拟人类的长期记忆、情感变化、临场反应、社会互动。
• 自进化能力：环境或用户输入变化时，智能体能自动适应，无需修改代码。

5. 示例：AI小人的一天（树状图）

伊莎贝拉的一天
├─ 记忆流
│   ├─ 早上做早餐
│   ├─ 与朋友聊天
│   ├─ 计划去公园
│   └─ 下午工作
├─ 检索
│   ├─ 最近与朋友的对话
│   └─ 上次工作时的反思
├─ 反思
│   ├─ 今天与朋友关系更亲密
│   └─ 工作效率提升
├─ 计划
│   ├─ 上午：社交
│   └─ 下午：工作
├─ 行为
│   ├─ 与朋友互动
│   └─ 执行工作任务

这些行为全自动生成，AI小人会根据记忆和环境调整自己的计划和反应。

6. 适用场景与未来趋势

• 虚拟世界/元宇宙：高度拟人NPC、虚拟居民。
• 游戏开发：复杂剧情与开放世界中的真实NPC行为。
• 社交/教育/陪伴：情感丰富、可自我进化的AI伙伴。
• 智能体系统：自动化办公、协作机器人等。

7. 相关资源

• 项目地址（GitHub）
• 论文原文（英文）
• 论文（中文机翻）
• 官方演示

总结

斯坦福AI小人虚拟小镇项目开启了大语言模型驱动的AI智能体新时代。它打破了传统脚本和规则系统的限制，让AI像“人”一样，有记忆、会反思、能规划、会交流，真正实现了“虚拟居民”的可信模拟。这一架构的理解，对设计下一代AI应用极具参考价值。

啊

当然现在这里啥都没有

那

玩一下鸭子吧

version: '3.8'

services:  
  emqx:
    image: registry.cn-beijing.aliyuncs.com/muta/emqx:amd64
    restart: always
    container_name: emqx
    ports:
      - "1883:1883"   # MQTT 协议端口
      - "8083:8083"   # WebSocket 端口
      - "8084:8084"   # WebSocket(SSL) 端口
      - "18083:18083" # 管理后台端口
    logging:
      driver: "json-file"
      options:
        max-size: "100m"
        max-file: "3"

  rabbitmq:
    image: registry.cn-beijing.aliyuncs.com/muta/rabbitmq:management-amd64
    restart: always
    container_name: rabbitmq
    ports:
      - "5672:5672"   # AMQP 协议端口
      - "15672:15672" # 管理页面端口
    environment:
      RABBITMQ_DEFAULT_USER: admin
      RABBITMQ_DEFAULT_PASS: admin123
    logging:
      driver: "json-file"
      options:
        max-size: "100m"
        max-file: "3"

  mqtt2rabbitmq:
    image: registry.cn-beijing.aliyuncs.com/dfzh/mqtt2rabbitmq:latest
    restart: always
    container_name: mqtt2rabbitmq
    environment:
      RabbitMQ__Hostname: rabbitmq
      RabbitMQ__Username: admin
      RabbitMQ__Password: admin123
      RabbitMQ__QueueName: Sensor 
      MQTT__Broker: emqx
      MQTT__Topic: /dev/luna/# 
    logging:
      driver: "json-file"
      options:
        max-size: "100m"
        max-file: "3"

  rabbitmqvbrationwebapi:
    image: registry.cn-beijing.aliyuncs.com/dfzh/rabbitmqvibrationwebapi:latest
    restart: always
    container_name: rabbitmqvbrationwebapi
    ports:
      - "8222:5759"   
    volumes:
      - /home/HisDatas:/app/HisDatas
    environment:
      RabbitMQ__Hostname: rabbitmq
      RABBITMQ__Port: 5672
      RabbitMQ__Username: admin
      RabbitMQ__Password: admin123
      RabbitMQ__QueueName: vibhex  
      RABBITMQ__ProductionEnvironment: true
    logging:
      driver: "json-file"
      options:
        max-size: "100m"
        max-file: "3"

1. 原理区别

帧差法（Frame Difference）

• 基本思想：直接对连续两帧图像的像素灰度值做差分，若差值大于阈值，则判定为运动区域。
• 输出结果：主要得到运动的“掩膜”或“区域”，即哪个像素发生了变化。
• 适用场景：简单的运动检测和目标分割。

光流法（Optical Flow）

• 基本思想：基于亮度一致性假设，通过分析连续帧间像素灰度分布的变化，估计每个像素的速度矢量（即运动方向和幅度）。
• 输出结果：每个像素的运动矢量场（速度场），可进一步分析位移、速度、振动等物理量。
• 适用场景：需要精确估计物体运动、结构振动、速度场、位移场等场景。

2. 结果对比

3. 优缺点对比

帧差法：

• 优点：实现简单，计算速度快，适合实时检测。
• 缺点：只能检测运动区域，无法准确估计运动的方向和幅度，易受光照变化影响，对微小运动不敏感。

光流法：

• 优点：可获得像素级别的运动方向和幅度信息，适合微小运动（如结构振动、模态识别、运动放大）。
• 缺点：计算复杂度高，对噪声和光照变化较敏感，需较好的视频质量。

4. 应用举例

• 帧差法：适合用于安防监控中检测是否有物体进入画面，或简单的运动目标检测。
• 光流法：适合用于结构健康监测、桥梁/建筑物振动检测、模态参数识别、运动放大等需要高精度运动分析的场景。

5. 总结

帧差法更偏向于“有没有运动”的检测，而光流法则能“量化运动”，包括运动的方向和幅度。在结构振动、模态识别、运动放大等需要定量分析运动的场景，光流法明显优于帧差法。

前言

对于很多初学者来说，Portainer 这个工具可能比较陌生。其实，Portainer 的作用和安卓手机上的“应用商店”非常类似。应用商店让我们方便地安装、管理和卸载各种手机应用，而 Portainer 则让我们在服务器上用可视化方式管理 Docker 容器（各种服务器应用）。本教程将用详细的类比和表格，帮助初学者快速理解 Portainer 的各项功能和实际操作细节。

一、Portainer 与安卓应用商店功能对照表

二、Portainer 安装与初次使用细节

1. 安装 Docker

• Portainer 依赖 Docker 环境，需先在服务器上安装好 Docker。类似于安卓系统必须先准备好，才能安装应用商店。
• 初学者推荐在干净的服务器或虚拟机上操作，避免环境冲突。

1. 部署 Portainer

• Portainer 本身也是一个容器应用。部署后，会自动生成管理界面，通常通过浏览器访问。
• 访问方式为：http://服务器IP:9000，首次进入需要设置管理员账号和密码，确保安全性。

1. 首次登录

• 建议初学者使用强密码，并妥善保存账号信息。
• 登录后会看到主界面，包括管理节点、容器、镜像、网络、卷等模块。

三、Portainer 图形界面与应用商店界面细节对比

四、典型操作场景细节讲解

1. 安装新容器服务（如 WordPress 网站）

• 在应用模板中找到 WordPress，点击部署。
• 细致填写数据库密码、端口号等参数，确认后即可自动完成安装。
• 部署后自动跳转到容器列表，可一键启动、停止或重启服务。
• 类似于在应用商店中搜索微信，点击安装，填写账号信息后即可使用。

1. 启动或停止容器

• 容器列表中，每个容器都有启动、停止、重启按钮。
• 可根据需要灵活操作，适合测试和维护环境。
• 类比于手机上打开或关闭应用。

1. 卸载容器服务

• 停止容器后，点击删除即可完成卸载。
• 建议初学者在删除前备份重要数据（如数据库内容），避免误删。
• 类似于卸载手机应用时确认是否保留数据。

1. 更新容器应用

• 检查镜像库是否有新版本，拉取最新镜像后重建容器。
• 更新前建议备份数据，并确认新版本兼容性。
• 类比于应用商店提示应用有新版本时，点击升级按钮。

1. 查看容器日志

• 容器详情页可实时查看运行日志，支持搜索关键字（如“error”、“failed”）。
• 日志可帮助排查启动失败、配置错误等问题，是运维必备工具。
• 类似于应用崩溃后查看日志定位问题。

五、常见问题与细节排查方法

六、进阶建议

• 初学者可优先使用模板部署常用服务，熟悉参数填写和基本管理流程。
• 建议定期查看容器日志，及时发现和解决潜在问题。
• 多用户协作时，合理分配权限，避免误操作影响整个环境。
• 学习数据卷和网络管理，提高服务的稳定性和安全性。
• 探索远程节点管理，适合多台服务器或云平台场景。

结语

Portainer 就像服务器世界里的“应用商店”，让初学者无需复杂命令，就能像管理手机应用一样，轻松管理服务器上的各种服务。通过图形界面、详细日志和丰富模板，Portainer 不仅提升了管理效率，也降低了运维门槛。建议初学者在实践中多尝试、多探索，逐步掌握容器化应用的管理技巧。

最近在学习目标检测，想用 Ultralytics 的 YOLOv8 框架训练自己拍摄的“蓝色黄色小球”数据集。由于本地环境复杂，决定用 Docker 来隔离环境，保证依赖一致性。本文记录整个流程，便于以后复用和查阅。

1. 准备工作

1.1 安装 Docker

请确保电脑已安装 Docker Desktop，并且已开启 GPU 支持（NVIDIA 驱动 & CUDA 已配置好）。

1.2 检查 GPU 驱动

在命令行（PowerShell）输入：

nvidia-smi

如果能看到显卡信息，说明驱动没问题。

2. 数据集准备

我的数据集结构如下：

E:\
└── 机器学习训练集\
    └── 蓝色黄色小球\
        └── boll\
            ├── train\
            │    ├── images\
            │    └── labels\
            └── val\
                 ├── images\
                 └── labels\

• images 目录下是图片（jpg/png等）
• labels 目录下是和图片同名的 txt 文件（YOLO 格式标注）

3. 使用 Docker 启动 YOLO 环境并挂载数据集

在 PowerShell 中运行如下命令，将本地数据集挂载到 Docker 容器内：

docker run -it --ipc=host --gpus all `
  -v "E:/机器学习训练集/蓝色黄色小球/boll:/ultralytics/data/boll" `
  ultralytics/ultralytics:latest

• -v 参数用于挂载本地目录到容器内部。
• 挂载后，容器内的数据路径为 /ultralytics/data/boll。

4. 准备 data.yaml 配置文件

在本地 E:/机器学习训练集/蓝色黄色小球/boll/ 下新建 data.yaml 文件，内容如下：

train: /ultralytics/data/boll/train/images
val: /ultralytics/data/boll/val/images

nc: 2
names: ['blue_ball', 'yellow_ball']

• nc：类别数
• names：类别名称，顺序要和你的标注一致
• train 和 val 路径要用容器内的挂载路径

5. 在容器里开始训练

进入容器后，执行以下命令开始训练：

yolo task=detect mode=train model=yolov8n.pt data=/ultralytics/data/boll/data.yaml epochs=100 imgsz=640

参数说明：

• model=yolov8n.pt：使用 YOLOv8 nano 预训练模型
• data：指向 data.yaml 文件
• epochs：训练轮数
• imgsz：输入图片尺寸

6. 查看训练结果

训练完成后，模型和日志会保存在 /ultralytics/runs/detect/ 目录下。

可以通过如下命令查看：

ls /ultralytics/runs/detect/

如果需要把结果拷贝回本地，可用 docker cp 命令。

7. 常见问题总结

• 路径中有中文或空格：建议尽量用英文路径，或确保 Docker Desktop 已授权对应盘符。
• labels 格式：务必是 YOLO 标准格式，类别编号从 0 开始。
• 挂载后目录为空：请检查路径拼写和 Docker 权限设置。

8. 参考资料

• Ultralytics YOLO 官方文档
• Docker 官方文档

9. 用命令行直接导出 YOLO 模型为 ONNX

best.pt 路径确保正确：

yolo export model=/ultralytics/data/boll/train3/weights/best.pt format=onnx

• model=... 指定你的 .pt 文件路径
• format=onnx 指定导出格式为 ONNX

导出后会在 runs/ 目录下生成对应的 ONNX 文件。

还可以加其他参数，比如指定输出路径、导出的输入尺寸等：

yolo export model=/ultralytics/data/boll/train3/weights/best.pt format=onnx imgsz=640

更多参数可以用 yolo export --help 查看。

在容器化开发过程中，常常遇到容器需要访问宿主机上的服务，比如数据库、API 或其他本地应用。对于 macOS 和 Windows 用户来说，Docker 官方提供了 host.docker.internal 这个 DNS 名称，方便容器自动识别宿主机。然而，Linux 用户则需要额外配置。自 Docker 20.10 起，host-gateway 关键字极大简化了这一过程。本篇将详细介绍如何在 Docker Compose 中实现容器访问宿主机的最佳实践，并结合实战案例帮助理解。

二、容器访问宿主机的常见方式

在 Linux 环境下，容器默认无法通过 host.docker.internal 访问宿主机上的服务。常见的几种做法包括：

• 手动指定宿主机 IP：在 extra_hosts 或命令行中写死宿主机 IP，缺点是 IP 可能变化，维护不便。
• 使用 network_mode: host：容器与宿主机共享网络栈，虽然简单，但会牺牲隔离性，且端口暴露风险增加。
• 利用 host-gateway：结合 Docker 20.10+ 的新特性，自动将 host.docker.internal 映射到宿主机网关 IP，推荐使用。

三、Docker 命令行与 Compose 的实现方式

1. 命令行方式

直接运行容器时，可以用如下参数：

docker run \
  --add-host=host.docker.internal:host-gateway \
  <其他参数> \
  <镜像名>

这样容器内部的 /etc/hosts 会新增一条，把 host.docker.internal 指向宿主机网关 IP。

2. Docker Compose 配置

在 Compose 文件中，使用 extra_hosts 字段实现同样功能：

version: '3.9'
services:
  app:
    image: <镜像名>
    extra_hosts:
      - "host.docker.internal:host-gateway"

Compose 会自动查找 bridge 网络的网关地址，并注入到容器 hosts 文件中，跨平台兼容性极强。

四、实战案例：容器访问宿主机 HTTP 服务

1. 宿主机启动 HTTP 服务

在宿主机上运行如下 Python 命令：

python3 -m http.server 8080

确保服务监听在 0.0.0.0，方便容器访问。

2. 编写 docker-compose.yml

创建如下 Compose 文件，实现容器内 curl 访问宿主机服务：

version: '3.9'
services:
  curltest:
    image: curlimages/curl
    command: ["curl", "http://host.docker.internal:8080"]
    extra_hosts:
      - "host.docker.internal:host-gateway"

3. 启动并验证

执行：

docker-compose up

如能看到 HTTP 服务返回内容，说明配置成功。

五、常见问题与排查技巧

1. host-gateway 报错

• 报错信息：invalid IP address in add-host: host-gateway
• 原因：Docker 版本过低。请升级至 20.10 或以上。

2. 无法访问宿主机服务

• 检查服务监听地址必须为 0.0.0.0，否则只在本地回环可用。
• 查看防火墙设置是否允许 Docker 网络访问指定端口。
• 确认 Compose 文件 extra_hosts 配置无误。

六、适用场景与注意事项

适用场景

• 容器需要调用本地数据库或 API
• 开发环境下调试本地服务
• 跨平台项目需要兼容性配置

不推荐做法

• 使用 network_mode: host，丧失网络隔离
• 手动硬编码宿主机 IP，难以维护

七、结语

通过 extra_hosts 配合 host-gateway，Docker Compose 能方便地实现容器到宿主机的通信，无需关心平台差异，配置简洁且易于迁移。无论是本地开发还是自动化测试，这一技巧都能显著提升开发效率与体验。

参考资料

• Docker 官方文档
• Docker Compose 说明
• host-gateway 介绍

一、串口设备识别

大多数Linux系统的串口设备节点如下：

• 标准串口：/dev/ttyS0, /dev/ttyS1 …
• USB转串口：/dev/ttyUSB0, /dev/ttyUSB1 …
• FTDI类芯片：/dev/ttyACM0, /dev/ttyACM1 …

查看串口设备

ls /dev/tty*

插拔USB转串口线后，可以用 dmesg 查看设备挂载情况：

dmesg | tail -20

二、串口参数配置

使用 stty 查看和设置串口参数

查看当前参数

stty -F /dev/ttyS0 -a

设置波特率、数据位、校验位、停止位

例如设置为115200 8N1（115200波特率，8数据位，无校验，1停止位）：

stty -F /dev/ttyS0 speed 115200 cs8 -cstopb -parenb

参数说明：

• speed 115200：波特率
• cs8：8数据位
• -cstopb：1停止位
• -parenb：无校验

三、串口收发测试

1. 使用 echo 和 cat 简单测试

发送数据：

echo "hello world" > /dev/ttyS0

接收数据：

cat /dev/ttyS0

2. 使用 minicom 图形化串口工具

安装

sudo apt-get install minicom

配置并打开串口

sudo minicom -s

进入设置菜单，选择“Serial port setup”进行端口、波特率等参数配置，然后保存并退出。

直接打开

sudo minicom -D /dev/ttyS0 -b 115200

3. 使用 screen 作为串口终端

screen /dev/ttyS0 115200

退出：同时按下 Ctrl+A 然后按 K，再按 y。

4. 使用 picocom（轻量级串口工具）

安装

sudo apt-get install picocom

启动

sudo picocom -b 115200 /dev/ttyS0

退出：Ctrl+A 再按 Ctrl+X

5. 使用 cu 命令

安装

sudo apt-get install cu

启动

sudo cu -l /dev/ttyS0 -s 115200

退出：~.

四、串口数据的十六进制查看

有时候需要以十六进制方式查看串口数据：

cat /dev/ttyS0 | hexdump -C
# 或
cat /dev/ttyS0 | xxd

五、常见问题排查

1. 权限不足

• 添加用户到 dialout 组
  bash sudo usermod -a -G dialout $USER
• 重新登录生效

1. 设备不存在

• 检查驱动是否加载，dmesg 查看内核日志
• 检查硬件连接

1. 串口占用

• 用 lsof | grep ttyS0 检查是否有进程占用

1. 收发异常

• 检查串口参数、交叉线连接、GND是否共地

六、实用脚本举例

循环发送数据：

while true; do echo "test" > /dev/ttyS0; sleep 1; done

自动收数据并保存：

cat /dev/ttyS0 > recv.log