11notes/netbox

NETBOX

!size!https://github.com/11notes/defaults/blob/main/static/img/transparent5x2px.png?raw=true!version!https://github.com/11notes/defaults/blob/main/static/img/transparent5x2px.png?raw=true!pulls!https://github.com/11notes/defaults/blob/main/static/img/transparent5x2px.png?raw=true%5B](https://github.com/11notes/docker-NETBOX/issues)!https://github.com/11notes/defaults/blob/main/static/img/transparent5x2px.png?raw=true!swiss_made

镜像概述和主要用途

该镜像提供了一个无root权限、轻量级的NetBox安装。NetBox自2016年发布以来，已成为全球数千家组织建模和文档化网络基础设施的首选解决方案。作为传统IPAM和DCIM应用的继任者，NetBox为所有网络相关事物提供了一个连贯、全面且可访问的数据模型。通过提供单一强大的用户界面和可编程API（从电缆图到设备配置），NetBox成为现代网络的核心真实数据源。

核心功能和特性

独特价值主张

为什么选择此镜像而非其他现有镜像？该镜像提供以下独特优势：

• 默认以1000:1000用户身份运行，而大多数其他镜像以root用户运行
• 通过安全、固定的CI/CD流程创建，免受上游***，大多数其他镜像存在可被利用的上游依赖
• 包含验证应用实际运行状态的健康检查，大多数其他镜像要么没有健康检查，要么仅检查端口是否开放或ping是否工作
• 仓库具有自动更新功能，在新版本发布时自动构建最新版本，大多数其他提供者不具备此功能
• 镜像体积小于大多数其他镜像

对比

以下是该镜像与最常用或原始镜像的对比：

使用场景和适用范围

适用于需要安全、轻量级网络基础设施建模与文档工具的组织和网络工程师，尤其适合对安全性、资源占用和自动化更新有较高要求的环境。

详细使用方法和配置说明

卷

• /netbox/etc - config.py配置文件目录
• /netbox/var - 报告、上传文件和脚本目录

Docker Compose配置示例

yaml
name: "netbox"
services:
  postgres:
    image: "11notes/postgres:16"
    read_only: true
    environment:
      TZ: "Europe/Zurich"
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    volumes:
      - "postgres.etc:/postgres/etc"
      - "postgres.var:/postgres/var"
      - "postgres.cmd:/run/cmd"
    tmpfs:
      - "/run/postgresql:uid=1000,gid=1000"
      - "/postgres/log:uid=1000,gid=1000"
    networks:
      backend:
    restart: "always"

  cron:
    depends_on:
      postgres:
        condition: "service_healthy"
        restart: true
    image: "11notes/cron:4.6"
    environment:
      TZ: "Europe/Zurich"
      CRONTAB: |-
        0 3 * * * cmd-socket '{"bin":"backup"}' > /proc/1/fd/1
    volumes:
      - "postgres.cmd:/run/cmd"
    restart: "always"

  redis:
    image: "11notes/redis:7.4.2"
    environment:
      REDIS_PASSWORD: ${REDIS_PASSWORD}
      TZ: "Europe/Zurich"
    volumes:
      - "redis.etc:/redis/etc"
      - "redis.var:/redis/var"
    networks:
      backend:
    restart: always

  app:
    depends_on:
      postgres:
        condition: "service_healthy"
        restart: true
      redis:
        condition: "service_healthy"
        restart: true
    image: "11notes/netbox:4.3.3"
    environment:
      TZ: "Europe/Zurich"
      NETBOX_ADMIN_PASSWORD: ${NETBOX_ADMIN_PASSWORD}
    volumes:
      - "etc:/netbox/etc"
      - "var:/netbox/var"
    tmpfs:
      - "/run:uid=1000,gid=1000"
    ports:
      - "3000:3000/tcp"
    networks:
      frontend:
      backend:
    restart: "always"

volumes:
  etc:
  var:
  postgres.etc:
  postgres.var:
  postgres.cmd:
  redis.etc:
  redis.var:

networks:
  frontend:
  backend:
    internal: true

默认设置

环境变量

主要标签

以下是镜像的主要标签，同时也存在每个提交及其简写sha256值的标签：

• https://hub.docker.com/r/11notes/netbox/tags?name=4.3.3

没有latest标签，如何处理更新？

latest标签被认为是危险的，因为可能引入破坏性变更。若不想手动更改标签至最新语义化版本，可使用语义化版本的短版本：如使用:4或:4.3而非:4.3.3，这些标签会在新版本发布时更新至最新版本，效果类似:latest但固定在主版本或次版本。

若坚持使用最新版本，可使用:rolling标签，但需注意：将立即获取应用的最新版本，无论是否存在破坏性变更或安全问题，风险自负！

镜像仓库

docker pull 11notes/netbox:4.3.3
docker pull ghcr.io/11notes/netbox:4.3.3
docker pull quay.io/11notes/netbox:4.3.3

相关链接

• 源代码：https://github.com/11notes/docker-NETBOX
• 基础镜像：https://hub.docker.com/r/11notes/alpine
• 构建工具：
  • https://github.com/netbox-community/netbox
  • https://github.com/11notes/docker-util

通用提示

• 使用反向代理（如Traefik、Nginx、HAproxy）终止TLS并保护端点
• 使用Let’s Encrypt DNS-01挑战获取有效的SSL证书

ElevenNotes™️

本镜像按"现状"提供，使用风险自负。更新镜像版本前请务必备份。查看https://github.com/11notes/docker-netbox/releases%E4%BA%86%E8%A7%A3%E7%A0%B4%E5%9D%8F%E6%80%A7%E5%8F%98%E6%9B%B4%E3%80%82%E4%BD%BF%E7%94%A8%E4%B8%AD%E9%81%87%E5%88%B0%E9%97%AE%E9%A2%98%E8%AF%B7%E6%8F%90%E4%BA%A4https://github.com/11notes/docker-netbox/issues%EF%BC%8C%E6%9C%89%E9%97%AE%E9%A2%98%E6%88%96%E5%BB%BA%E8%AE%AE%E8%AF%B7%E5%88%9B%E5%BB%BAhttps://github.com/11notes/docker-netbox/discussions%E8%80%8C%E9%9D%9Eissue%E3%80%82%E6%89%80%E6%9C%89%E5%85%B6%E4%BB%96%E4%BB%93%E5%BA%93%E5%8F%AF%E5%9C%A8https://github.com/11notes?tab=repositories%E6%9F%A5%E7%9C%8B%E3%80%82

创建于 27.06.2025, 08:20:32 (CET)