gringolito/ser2net

ser2net Docker容器

ser2net应用的Docker容器化实现。

Docker仓库：https://hub.docker.com/r/gringolito/ser2net
GitHub仓库：https://github.com/gringolito/docker-ser2net

镜像概述和主要用途

本镜像提供了ser2net应用的容器化部署方案，ser2net是一款用于将串行端口（如USB串口设备）通过网络协议（TCP/IP）共享的工具。通过本容器，用户可在隔离环境中快速部署串口转网络服务，实现对串行设备的远程访问和管理。

核心功能和特性

• 前台运行模式：容器以 foreground 模式运行ser2net，确保进程状态可被容器运行时有效监控
• 可配置路径：默认从/etc/目录加载ser2net.conf配置文件，支持通过SER2NET_CONFIGPATH环境变量自定义配置文件路径
• 设备映射：支持将宿主机串行设备（如USB串口）映射到容器内部，实现对物理串口的访问
• 端口映射：可通过端口映射将容器内的网络服务端口暴露到宿主机，实现外部网络访问

使用场景和适用范围

• 工业自动化场景：远程访问PLC、传感器等串行设备
• 嵌入式开发：通过网络调试串口设备
• 物联网应用：将串口设备接入网络，实现远程监控和管理
• 多设备共享：在容器化环境中集中管理多个串行设备的网络共享

使用方法和配置说明

环境变量

卷挂载

建议将配置文件目录挂载为卷，以便持久化配置和方便修改：

• 挂载宿主机目录或命名卷到容器内的配置路径（如/ser2net），存放ser2net.conf配置文件

设备映射

需将宿主机的串行设备路径映射到容器，格式为：/dev/serial/by-id/[设备ID]:/dev/[设备名称]
示例：/dev/serial/by-id/usb-Prolific_Technology_Inc._USB-Serial_Controller-if00-port0:/dev/ttyUSB0

端口映射

根据ser2net.conf配置的网络端口，将容器端口映射到宿主机，格式为：宿主机端口:容器端口
示例：4000:4000（映射默认4000端口）

Docker部署示例

docker-compose配置

yaml
version: '3.4'
services:
  ser2net:
    image: gringolito/ser2net:latest
    container_name: ser2net
    environment:
      - SER2NET_CONFIGPATH=/ser2net  # 自定义配置文件目录
    volumes:
      - ser2net-data:/ser2net  # 挂载卷用于持久化配置
    devices:
      # 映射宿主机串行设备到容器
      - /dev/serial/by-id/usb-Prolific_Technology_Inc._USB-Serial_Controller-if00-port0:/dev/ttyUSB0
    ports:
      - 4000:4000  # 映射网络端口
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）

volumes:
  ser2net-data:  # 定义命名卷

基本docker run命令

bash
docker run -d \
  --name ser2net \
  -e SER2NET_CONFIGPATH=/ser2net \
  -v ser2net-data:/ser2net \
  --device /dev/serial/by-id/usb-Prolific_Technology_Inc._USB-Serial_Controller-if00-port0:/dev/ttyUSB0 \
  -p 4000:4000 \
  --restart unless-stopped \
  gringolito/ser2net:latest