TWSNMP FC Docker镜像文档

镜像概述

TWSNMP FC是将免费经典网络管理软件TWSNMP适配到Docker环境的容器化版本，方便用户在容器环境中部署和使用网络管理功能，实现对网络设备的监控、管理与数据收集。

源代码与文档

源代码

项目源代码托管于GitHub：
[***]

使用文档

详细使用手册发布于Note平台：
[***]

初次使用建议优先阅读：
[***]

使用方法

基本启动步骤

Linux环境（支持完整网络监控）

bash
# 创建数据卷以持久化存储配置和数据
docker volume create twsnmpfc

# 使用主机网络模式启动容器（推荐Linux环境，支持ARP监控）
docker run --rm -d --net host -v twsnmpfc:/datastore twsnmp/twsnmpfc

Windows/Mac桌面版Docker（网络隔离环境）

由于桌面版Docker的网络隔离特性，ARP监控无法自动创建设备列表，需使用端口映射模式：

bash
# 创建数据卷以持久化存储配置和数据
docker volume create twsnmpfc

# 端口映射模式启动（8080端口用于WebUI访问）
docker run --rm -d -p 8080:8080 -v twsnmpfc:/datastore twsnmp/twsnmpfc

访问方式

容器启动后，通过浏览器访问WebUI：
http://<容器IP地址>:8080/

初始登录凭证：
用户名：twsnmp
密码：twsnmp

端口说明

容器使用以下端口提供服务：

• 8080/tcp：WebUI访问端口
• 514/udp：Syslog接收端口（UDP）
• 514/tcp：Syslog接收端口（TCP）
• 2055/udp：NetFlow数据接收端口
• 162/udp：SNMP Trap接收端口

配置参数与环境变量

启动参数

通过命令行参数可自定义容器运行配置，执行以下命令查看所有参数：

bash
docker run --rm twsnmp/twsnmpfc -h

主要参数说明：

• -datastore string：数据存储目录路径（默认：./datastore）
• -port string：WebUI端口（默认：8080）
• -password string：主密码（默认：twsnmpfc!）
• -ping string：Ping模式（icmp或udp）
• -tls：启用TLS加密
• -host string：TLS证书的主机名
• -ip string：TLS证书的IP地址

环境变量

所有启动参数可通过环境变量配置，命名规则为：TWSNMPFC_前缀 + 大写参数名。例如：

• TWSNMPFC_PASSWORD：设置主密码
• TWSNMPFC_PORT：设置WebUI端口