### 如何通过 Docker 安装 NetBox #### 准备工作 在开始之前，确保已经安装并配置好 Docker 和 Docker Compose 工具。可以通过以下命令验证其版本是否存在： ```bash docker --version docker-compose --version ``` 如果没有安装，请先按照官方文档完成安装[^1]。 --- #### 步骤说明 ##### 1. 下载配置文件 进入目标目录 `/opt` 并克隆中文版的 `netbox-docker-cn` 配置仓库： ```bash cd /opt git clone https://github.com/Songxwn/netbox-docker-cn.git cd /opt/netbox-docker-cn ``` 此操作会下载所需的默认配置文件以及脚本工具。 ##### 2. 创建端口映射文件 为了能够从外部访问 NetBox Web 界面，需创建一个自定义的端口映射文件 `docker-compose.override.yml`： ```bash tee docker-compose.override.yml <<EOF version: '3.4' services: netbox: ports: - 8000:8080 EOF ``` 该文件将主机的 8000 端口映射到容器内的 8080 端口。 ##### 3. 拉取镜像并启动服务 执行以下命令来拉取所需的服务镜像，并以后台模式运行容器： ```bash docker-compose pull docker-compose up -d ``` 首次启动可能会花费一些时间，因为需要初始化数据库和其他组件。如果遇到超时错误，可以尝试再次运行 `docker-compose up -d` 来恢复中断的任务[^1]。 ##### 4. 初始化管理员账户 当确认 Web 接口已正常运行后，可通过以下命令创建超级用户账户： ```bash docker-compose exec netbox /opt/netbox/netbox/manage.py createsuperuser ``` 根据提示输入用户名、邮箱地址和密码以完成设置。 ##### 5. 测试访问 打开浏览器并导航至 http://<服务器IP>:8000 地址，登录刚刚创建好的管理账号即可查看 NetBox 主界面[^1]。 --- #### 参考补充方案 对于更高级别的定制化需求，比如集成插件支持，则推荐参考社区维护的标准部署方式： ```bash cd /opt git clone -b release https://github.com/netbox-community/netbox-docker.git cd netbox-docker vim docker-compose.yml ``` 编辑完成后保存退出，继续执行前述相同的操作流程即能实现扩展功能的支持[^2]。 另外还有一种简化形式仅依靠单个 YAML 文件描述整个环境结构如下所示： ```yaml version: '3' services: netbox: image: netboxcommunity/netbox ports: - "8000:8000" volumes: - /path/to/netbox/data:/netbox/venv/Lib/site-packages/netbox/media/netbox restart: unless-stopped ``` 这种方法适合快速测试场景而不涉及复杂持久化存储设计等情况[^3]。 最后提醒一点，在实际生产环境中应当考虑安全性加固措施例如修改默认监听端口号或者启用 HTTPS 加密连接等等[^4]。 ---