環境準備

1. 檢查操作系統版本：
   • 本方案使用 Ubuntu 22.04，并在 VMware 虛擬機中運行。通過以下命令檢查系統版本：

     lsb_release -a

   • 如果未安裝 Ubuntu 22.04，請下載并安裝一個全新的系統。
2. 更新系統軟件源：
   • 更新軟件包列表并安裝最新軟件：

     sudo apt-get update
     sudo apt-get upgrade -y

安裝 Docker 和 Docker Compose

1. 安裝必備工具：

   sudo apt-get install -y ca-certificates curl gnupg lsb-release

2. 添加 Docker 官方 GPG 密鑰和倉庫：

   curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
   echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
   sudo apt-get update

3. 安裝 Docker Engine：

   sudo apt-get install -y docker-ce docker-ce-cli containerd.io

   • 驗證 Docker 安裝：

     docker --version

4. 配置 Docker 守護進程：
   • 創建或編輯 Docker 守護進程配置文件 /etc/docker/daemon.json：

     sudo mkdir -p /etc/docker
     sudo tee /etc/docker/daemon.json <<EOF
     {"dns": ["114.114.114.114", "8.8.8.8"],"registry-mirrors": ["https://mirror.gcr.io"],"max-concurrent-downloads": 10,"max-download-attempts": 3
     }
     EOF

   • 重新加載 Docker 服務以應用配置：

     sudo systemctl daemon-reload
     sudo systemctl restart docker

   • 驗證 Docker 服務狀態：

     systemctl status docker

5. 安裝 Docker Compose（官方插件版）：

   sudo apt-get install -y docker-compose-plugin

   • 驗證 Docker Compose 安裝：

     docker compose version

克隆 NetBox Docker 倉庫并配置

1. 創建項目目錄并克隆源碼：

   mkdir -p ~/projects && cd ~/projects
   git clone -b release https://github.com/netbox-community/netbox-docker.git
   cd netbox-docker

2. 配置 Docker Compose 覆蓋文件：
   • NetBox 默認使用 8080 端口，我們將其映射到宿主機的 8000 端口。在項目根目錄創建 docker-compose.override.yml 文件：

     tee docker-compose.override.yml <<EOF
     services:netbox:ports:- "8000:8080"
     EOF

   • 這會將容器的 8080 端口映射到宿主機的 8000 端口。如果端口被占用，可更改為其他端口。
3. 指定穩定版本鏡像（可選）：
   • 默認配置拉取最新版本鏡像。如需使用穩定版本（例如 NetBox v4.2 對應 Docker 版本 3.2.1），創建 .env 文件：

     echo "VERSION=v4.2-3.2.1" > .env

拉取鏡像并啟動容器

1. 拉取 Docker 鏡像：
   • 在 netbox-docker 目錄下運行：

     docker compose pull

2. 啟動 NetBox 服務：
   • 啟動容器：

     docker compose up -d

   • 檢查容器狀態：

     docker compose ps

   • 等待幾分鐘，直到所有容器狀態變為 healthy。可通過以下命令查看容器日志：

     docker compose logs netbox

創建管理員用戶并訪問 Web UI

1. 創建超級管理員賬戶：
   • NetBox 啟動后，首次登錄需創建管理員賬戶：

     docker compose exec netbox /opt/netbox/netbox/manage.py createsuperuser

   • 根據提示輸入用戶名、電子郵件和密碼，完成后顯示 Superuser created successfully。
2. 訪問 NetBox Web 界面：
   • 獲取虛擬機 IP 地址：

     hostname -I

   • 假設虛擬機 IP 為 192.168.1.100，通過瀏覽器訪問：

     http://192.168.1.100:8000/

   • 使用剛創建的管理員賬戶登錄，進入 NetBox 儀表盤。
3. 功能驗證：
   • 登錄后，驗證核心功能（IPAM、DCIM、設備管理等）是否正常。嘗試添加測試數據（如新設備或網絡段），確認 API 和權限系統正常工作。