zeigren/netbox

NetBox的Docker栈

!Docker镜像大小（最新版） !Docker拉取次数

链接

https://hub.docker.com/r/zeigren/netbox

ghcr.io

https://github.com/Zeigren/netbox_docker

标签

• latest
• v2.11.9

技术栈

• Python:Alpine - netbox
• Caddy 或 NGINX - Web服务器
• Postgres:Alpine - 数据库
• Redis:Alpine - 缓存

使用方法

使用Docker Compose或Docker Swarm进行部署。容器可从Docker Hub和GitHub容器 registry获取。

提供了使用Caddy或NGINX作为Web服务器的示例，以及使用Caddy、NGINX或Traefik实现HTTPS的示例（Traefik示例还包括将其用作反向代理的配置）。NGINX示例位于nginx文件夹中。

推荐建议

推荐使用Caddy作为Web服务器，可让其处理HTTPS或与Traefik配合使用，因为两者都原生支持ACME，能自动从Let's Encrypt获取HTTPS证书，或为本地使用创建自签名证书。

如果可能，还建议使用Docker Swarm而非Docker Compose，因为它支持Docker Secrets和Docker Configs。

如果Caddy不适用或追求性能，可查看NGINX示例。虽未进行性能测试，但NGINX具有高度可配置性，若用户量较大，可能通过配置获得更好性能，也可参考下文的性能部分。

配置说明

配置通过在.yml文件中设置环境变量实现。更多用于配置netbox的环境变量可在docker-entrypoint.sh中找到，Caddy的环境变量在netbox_caddyfile中。

设置DOMAIN变量会改变Caddy使用HTTP、带自签名证书的HTTPS，还是带Let's Encrypt或ZeroSSL证书的HTTPS。更多信息请查看Caddy文档。

首次运行时，需通过在.yml文件中设置相关环境变量创建超级用户。

Docker Swarm

个人使用Traefik作为反向代理，已包含traefik.yml示例（非必需）。

需创建相应的Docker Secrets和Docker Configs。

docker-entrypoint.sh中netbox的任何环境变量都可改用Docker Secrets设置，相关.yml文件中有示例说明。

运行命令：docker stack deploy --compose-file docker-swarm.yml netbox

Docker Compose

运行命令：docker-compose -f docker-compose.yml up -d。通过127.0.0.1:9080访问。

性能调优

Web服务器设置相关HTTP头，使浏览器尽可能长时间缓存文件，同时要求浏览器检查文件是否有变化，以在享受缓存 benefits 的同时避免提供旧内容。若内容不常变化或可通过其他方式失效，可修改此行为以减少请求数。

Gunicorn的工作进程数可通过GUNICORN_WORKERS环境变量设置。

工作原理

Dockerfile使用多阶段构建，创建包含所有Python包依赖的构建容器，这些依赖安装到Python虚拟环境中。生产容器从构建容器复制Python虚拟环境并从中运行netbox，使其更轻量。

容器启动时，先运行docker-entrypoint.sh脚本，然后运行gunicorn。

docker-entrypoint.sh根据各.yml文件中声明的环境变量创建配置文件并运行命令。

env_secrets_expand.sh处理Docker Secrets的使用。