简介

本文章主要介绍使用Docker部署中文化的NetBox。

定制化

  • 镜像基于官方的4.0.3 正式版本构建，加入了社区的中文翻译、配置时区为上海。
  • 配置全局默认语言为中文
  • 修改了导出CSV，EXCEL打开乱码的问题。 https://songxwn.com/netbox_csv/
  • 增加了二维码插件，并进行二次修改。https://songxwn.com/netbox_csv/
  • 增加了IP计算器插件。

环境要求

  • Docker 版本要求 20.10.13 +
  • Containerd 版本要求 1.5.6 +
  • Docker-compose 要求1.28.0+
  • 要求有Git

Netbox系列文章：https://songxwn.com/categories/NetBox/

部署

下载配置文件

1
2
3
4
5
cd /opt
git clone https://github.com/Songxwn/netbox-docker-cn.git
# https://gitee.com/songxwn/netbox-docker-cn.git
# 国内网络不稳定的，可克隆码云的。
cd /opt/netbox-docker-cn

创建端口映射文件

1
2
3
4
5
6
7
tee docker-compose.override.yml <<EOF
services:
netbox:
ports:
- 8000:8080
EOF
# 创建Web端口映射定义文件

拉取镜像，运行镜像，创建管理员账号。

1
2
3
4
5
6
7
docker-compose pull
# 下载镜像
docker-compose up -d
# 运行NetBox，第一次初始化数据库较慢，可能超时。如果失败等五分钟再重新执行一次即可。
docker-compose exec netbox /opt/netbox/netbox/manage.py createsuperuser
# 创建管理员用户 (注意要等web可访问后再创建用户，确保初始化完成)
# 以上操作要确保在/opt/netbox-docker-cn目录下执行。

PS：Docker版本高的，可把docker-compose 替换为 docker compose 。

访问

Web默认使用 8000端口，使用浏览器打开 http://192.168.0.1:8000

然后输入手动创建的账号密码。

备份

1
2
3
mkdir -p /opt/netbox-backups
cp -r /opt/netbox-docker-cn /opt/netbox-backups
cp -r /var/lib/docker/volumes/netbox-docker-cn_* /opt/netbox-backups

升级

1
2
3
4
5
6
cd /opt/netbox-docker-cn
git pull
docker-compose down
docker-compose pull
docker-compose up -d
# 升级前注意备份

完全卸载（包括所有数据文件）

1
2
cd /opt/netbox-docker-cn
docker-compose down -v

以root用户进入主程序容器

docker-compose exec -it –user root netbox /bin/bash

使用阿里云容器镜像源部署

PS：要求Docker版本大于20.10.13​

1
2
3
4
5
git clone https://gitee.com/songxwn/netbox-docker-cn.git
cp ./Aliyun_Hub/docker-compose.yml .
# 覆盖当前的配置文件
docker compose pull
docker compose up -d

中文社区微信群

可发送微信号到邮箱➡️ [email protected]