josephtknight/snipeit-netbox

Snipe-IT to NetBox 数据同步工具镜像

镜像概述

本镜像提供了一个数据同步工具，用于将Snipe-IT（IT资产管理系统）中的数据同步至NetBox（网络设备管理系统），帮助用户在两个系统间保持数据一致性，简化跨系统数据管理流程。

核心功能

• 数据同步：支持将Snipe-IT中的资产、设备等核心数据同步至NetBox
• 跨系统整合：实现Snipe-IT与NetBox间的数据互通，避免手动重复录入
• 配置灵活：通过环境变量配置同步参数，适应不同部署环境

使用场景

• 同时使用Snipe-IT和NetBox进行IT资源管理的组织
• 需要保持IT资产数据在两个系统间一致的场景
• 希望减少跨系统数据维护工作量的IT运维团队

使用方法

环境变量配置

使用该镜像需配置以下环境变量：

Docker Run 示例

bash
docker run -d \
  -e SNIPEIT_URL="https://snipeit.example.com" \
  -e SNIPEIT_TOKEN="your_snipeit_api_token" \
  -e NETBOX_URL="https://netbox.example.com" \
  -e NETBOX_TOKEN="your_netbox_api_token" \
  josephtknight/snipeit-netbox

Docker Compose 配置示例

yaml
version: '3'
services:
  snipeit-netbox-sync:
    image: josephtknight/snipeit-netbox
    environment:
      - SNIPEIT_URL=https://snipeit.example.com
      - SNIPEIT_TOKEN=your_snipeit_api_token
      - NETBOX_URL=https://netbox.example.com
      - NETBOX_TOKEN=your_netbox_api_token
    restart: unless-stopped

配置说明

1. 获取API令牌：

   • 在Snipe-IT中，通过"Admin > API Keys"生成API令牌
   • 在NetBox中，通过"User Profile > API Tokens"创建API令牌，确保令牌具有必要的读写权限

2. 同步频率：默认同步逻辑需参考项目文档，可通过外部定时任务（如cron）触发容器执行同步

3. 数据映射：具体同步的数据字段和映射规则请参考项目GitHub文档（https://github.com/josephtknight/snipeit-netbox%EF%BC%89