NetBox Docker全功能部署方案（Ubuntu 22.04 + Docker 一步到位）

1. 准备工作：更新系统与安装基础工具

在开始之前，请确保你拥有一台运行 Ubuntu 22.04 的服务器或虚拟机，并拥有 sudo 权限。首先更新软件包索引并安装必要的工具：

    sudo apt updatesudo apt upgrade -ysudo apt install -y curl wget git  

2. 安装 Docker 与 Docker Compose

Docker 是容器化平台，Docker Compose 用于定义和运行多容器应用。执行以下命令安装 Docker：

    curl -fsSL https://get.docker.com -o get-docker.shsudo sh get-docker.sh  

将当前用户加入 docker 组，避免每次使用 sudo：

    sudo usermod -aG docker $USERnewgrp docker  

安装 Docker Compose（独立二进制文件）：

    sudo curl -L "https://github.com/docker/compose/releases/download/v2.24.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-composesudo chmod +x /usr/local/bin/docker-compose  

验证安装：docker --version 和 docker-compose --version。

3. 克隆 NetBox Docker 项目

官方 NetBox Docker 项目提供了完整的编排文件。使用 git 克隆到本地：

    git clone https://github.com/netbox-community/netbox-docker.gitcd netbox-docker  

项目包含 docker-compose.yml 以及环境变量示例文件，我们将在下一步进行配置。

4. 配置 NetBox 环境变量

复制环境变量模板：

    cp configuration.example.py configuration.pycp docker-compose.yml docker-compose.override.yml  

编辑 configuration.py，设置 NetBox 的关键参数，如 ALLOWED_HOSTS、SECRET_KEY 等。你也可以使用项目提供的生成密钥脚本：

    python3 generate_secret_key.py  

将生成的密钥填入 configuration.py 中的 SECRET_KEY。

5. 启动全功能 NetBox 容器

使用 Docker Compose 启动所有服务（NetBox, PostgreSQL, Redis, Nginx）：

    docker-compose up -d  

首次启动会拉取镜像并创建数据库，可能需要几分钟。完成后检查容器状态：

    docker-compose ps  

所有容器应为 Up 状态。

6. 创建超级用户并验证部署

执行以下命令在 NetBox 容器内创建管理员账户：

    docker-compose exec netbox python3 manage.py createsuperuser  

按照提示输入用户名、邮箱和密码。然后通过浏览器访问 http://你的服务器IP:8000，即可看到 NetBox 登录界面。使用刚才创建的超级用户登录，开始体验 全功能部署 的 NetBox。

7. 常见问题与排错

• 端口冲突：如果 8000 端口被占用，可以在 docker-compose.override.yml 中修改映射端口。
• 数据库连接失败：检查 PostgreSQL 容器是否正常运行，以及 configuration.py 中的数据库配置是否正确。
• Docker 版本过低：建议使用 Docker 20.10 以上版本，Compose 2.x。

8. 总结

通过本教程，你已成功在 Ubuntu 22.04 上使用 Docker 完成了 NetBox 的 全功能部署。整个过程借助 Docker 简化了依赖管理，使得部署变得快速且可重复。现在你可以开始利用 NetBox 管理你的网络基础设施了。