ub-lldpd完整安装指南：从源码编译到Docker部署全解析

ub-lldpd完整安装指南：从源码编译到Docker部署全解析

【免费下载链接】ub-lldpdub-lldpd is an ISC-licensed implementation of Linux LLDP for ub device.项目地址: https://gitcode.com/openeuler/ub-lldpd

前往项目官网免费下载：https://ar.openeuler.org/ar/

ub-lldpd是一款基于ISC许可证的Linux LLDP（链路层发现协议）实现，专为嵌入式设备设计。本指南将带你完成从源码编译到Docker部署的全过程，帮助你快速在openEuler系统中搭建高效的网络设备发现服务。

一、准备工作：环境与依赖安装

在开始安装ub-lldpd前，请确保你的系统满足以下要求：

• openEuler或其他基于RPM的Linux发行版
• 至少2GB内存和10GB可用磁盘空间
• 具备sudo权限的用户账号

首先安装必要的编译工具和依赖库：

sudo dnf install -y autoconf automake libtool gcc make git sudo dnf install -y libevent-devel libcap-devel net-snmp-devel

二、源码编译：从克隆到安装

2.1 获取源码

使用git克隆ub-lldpd仓库到本地：

git clone https://gitcode.com/openeuler/ub-lldpd cd ub-lldpd

2.2 生成配置文件

运行autogen.sh脚本生成配置脚本：

./autogen.sh

2.3 配置编译选项

执行configure脚本配置编译参数，可根据需求添加额外选项：

./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var

2.4 编译与安装

使用make命令编译源码并安装：

make -j$(nproc) sudo make install

三、基础配置：快速上手

3.1 配置文件位置

ub-lldpd的主要配置文件位于：

• 主配置文件：/etc/ub-lldpd.conf
• 系统服务配置：/usr/lib/systemd/system/ub-lldpd.service

3.2 常用配置命令

通过lldpcli工具可以轻松配置ub-lldpd，常用命令包括：

# 设置系统主机名 sudo lldpcli configure system hostname "MyDevice" # 配置LLDP发送间隔（秒） sudo lldpcli configure lldp tx-interval 30 # 启用特定接口的LLDP sudo lldpcli configure ports eth0 lldp status rx-and-tx

3.3 启动服务

使用systemd管理ub-lldpd服务：

sudo systemctl enable --now ub-lldpd sudo systemctl status ub-lldpd

四、Docker部署：容器化方案

4.1 创建Dockerfile

在项目根目录创建Dockerfile：

FROM openeuler:latest WORKDIR /app COPY . . RUN dnf install -y autoconf automake libtool gcc make \ && dnf install -y libevent-devel libcap-devel net-snmp-devel \ && ./autogen.sh \ && ./configure --prefix=/usr --sysconfdir=/etc \ && make -j$(nproc) \ && make install EXPOSE 5900 CMD ["ub-lldpd", "-d"]

4.2 构建镜像

docker build -t ub-lldpd:latest .

4.3 运行容器

docker run -d --name ub-lldpd --net=host ub-lldpd:latest

注意：由于LLDP需要访问网络接口，建议使用--net=host模式运行容器，确保能正确发现网络设备。

五、验证与故障排除

5.1 验证安装

检查ub-lldpd是否正常运行：

# 查看服务状态 systemctl status ub-lldpd # 查看邻居信息 lldpcli show neighbors

5.2 常见问题解决

问题1：服务启动失败

检查日志文件获取详细信息：

journalctl -u ub-lldpd

问题2：无法发现邻居

确保网络接口已启用LLDP：

lldpcli show interfaces

六、高级配置与优化

6.1 安全加固

通过seccomp限制系统调用，配置文件位于：

• src/daemon/priv-seccomp.c

6.2 性能调优

调整LLDP发送间隔和保持时间：

lldpcli configure lldp tx-interval 60 lldpcli configure lldp tx-hold 4

6.3 自定义TLV

添加自定义TLV（类型长度值）：

lldpcli configure lldp custom-tlv oui 00,11,22 subtype 33 oui-info 44,55,66

七、总结

通过本指南，你已经掌握了ub-lldpd的完整安装流程，包括源码编译、基础配置、Docker部署以及故障排除方法。ub-lldpd作为轻量级LLDP实现，非常适合嵌入式设备和资源受限环境，帮助你构建高效的网络设备发现系统。

如需更多高级功能和详细配置选项，请参考项目中的文档和源码：

• src/client/commands.c：命令处理实现
• src/daemon/lldpd.c：主程序逻辑
• tests/lldpcli.conf：配置示例

【免费下载链接】ub-lldpdub-lldpd is an ISC-licensed implementation of Linux LLDP for ub device.项目地址: https://gitcode.com/openeuler/ub-lldpd