mirror of
https://github.com/okxlin/appstore.git
synced 2026-09-23 16:01:01 +00:00
75 lines
3.2 KiB
Markdown
75 lines
3.2 KiB
Markdown
# NetBox
|
|
|
|
## 产品介绍
|
|
NetBox 是一款用于 IP 地址管理（IPAM）与机房基础设施管理（DCIM）的开源平台，这里使用 LinuxServer.io 提供的容器镜像进行部署。
|
|
|
|
## 主要功能
|
|
- 管理 IP 地址、VLAN、VRF、机柜与设备等基础设施数据
|
|
- 依赖内置 PostgreSQL 与 Redis 组件完成数据存储和任务队列
|
|
- 支持通过 Web UI 进行日常运维与资产管理
|
|
|
|
## 访问说明
|
|
安装完成后，通过 `http://<服务器 IP>:<PANEL_APP_PORT_HTTP>` 访问 Web UI，实际端口以安装表单或 1Panel 展示为准。
|
|
|
|
## Introduction
|
|
NetBox is an open source IPAM and DCIM platform, deployed here with the LinuxServer.io container image.
|
|
|
|
## Features
|
|
- Manage IP addresses, VLANs, VRFs, racks and device inventory
|
|
- Bundle PostgreSQL and Redis sidecars for storage and background jobs
|
|
- Provide a Web UI for day-to-day infrastructure operations
|
|
|
|
## 部署说明
|
|
- 本应用使用 Docker Compose 在 1Panel 中部署。
|
|
- 应用分类：运维。
|
|
- 支持架构：amd64、arm64。
|
|
- 可选版本：`latest`；固定版本以应用商店当前版本目录和安装表单为准。
|
|
- 安装后按应用表单中的端口访问 Web UI、SSH 或对应服务。
|
|
|
|
## 端口
|
|
| 变量 | 说明 | 默认值 | 必填 |
|
|
| --- | --- | --- | --- |
|
|
| PANEL_APP_PORT_HTTP | HTTP 端口 | 8000 | 是 |
|
|
|
|
## 数据持久化
|
|
| 变量 | 说明 | 默认值 | 必填 |
|
|
| --- | --- | --- | --- |
|
|
| CONFIG_PATH | 配置文件路径 | ./data/config | 是 |
|
|
| BASE_PATH | 基础路径 | - | 否 |
|
|
| DB_DATA_PATH | 数据库数据目录 | ./data/db | 是 |
|
|
| REDIS_DATA_PATH | Redis 数据目录 | ./data/redis | 是 |
|
|
|
|
升级或迁移前，请在 1Panel 中备份上述数据目录。
|
|
|
|
## 配置项
|
|
| 变量 | 说明 | 默认值 | 必填 |
|
|
| --- | --- | --- | --- |
|
|
| SUPERUSER_EMAIL | 管理员邮箱 | admin@example.com | 是 |
|
|
| SUPERUSER_PASSWORD | 管理员密码 | netbox-change-me | 是 |
|
|
| ALLOWED_HOST | 允许访问主机 | * | 是 |
|
|
| DB_HOST | 数据库主机 | netbox-db | 是 |
|
|
| DB_PORT | 数据库端口 | 5432 | 是 |
|
|
| DB_USER | 数据库用户名 | netbox | 是 |
|
|
| DB_NAME | 数据库名称 | netbox | 是 |
|
|
| DB_PASSWORD | 数据库密码 | netbox-change-me | 是 |
|
|
| REDIS_HOST | Redis 主机 | netbox-redis | 是 |
|
|
| REDIS_PORT | Redis 端口 | 6379 | 是 |
|
|
| REDIS_USERNAME | Redis 用户名 | - | 否 |
|
|
| REDIS_PASSWORD | Redis 密码 | - | 否 |
|
|
| REDIS_DB_TASK | Redis 任务数据库 | 0 | 是 |
|
|
| REDIS_DB_CACHE | Redis 缓存数据库 | 1 | 是 |
|
|
| CSRF_TRUSTED_ORIGINS | CSRF 可信来源 | - | 否 |
|
|
| TIME_ZONE | 时区 | Asia/Shanghai | 是 |
|
|
|
|
说明：如果为 `REDIS_PASSWORD` 设置了值，内置 Redis 会同步启用密码认证；留空则以内网无密码方式运行。
|
|
|
|
## 使用说明
|
|
- 安装完成后，在 1Panel 应用页面查看运行状态、端口和日志。
|
|
- 首次启用前，请按安装表单填写域名、账号、密码、Token、数据目录等参数。
|
|
- 如需对外开放访问，请同步检查防火墙、安全组和反向代理配置。
|
|
|
|
## 参考资料
|
|
- 官网: <https://github.com/netbox-community/netbox>
|
|
- 文档: <https://docs.linuxserver.io/images/docker-netbox/>
|
|
- 源码: <https://github.com/linuxserver/docker-netbox>
|