Remove obsolete files and scripts related to the BGP server setup, including .gitignore, Dockerfile, and various documentation files. Update docker-compose.yml to streamline the configuration for the FRRouting BGP server. This cleanup enhances project maintainability and focuses on the current implementation.
This commit is contained in:
-324
@@ -1,324 +0,0 @@
|
||||
# Быстрый старт BGP Server (FRR)
|
||||
|
||||
Этот документ поможет вам быстро запустить BGP сервер на базе FRR для раздачи префиксов.
|
||||
|
||||
## Предварительные требования
|
||||
|
||||
- Docker Desktop для Windows
|
||||
- PowerShell
|
||||
- RouterOS 7.14+ (для клиентской стороны)
|
||||
|
||||
## Шаг 1: Подготовка файлов
|
||||
|
||||
### Создание файла с префиксами
|
||||
|
||||
Создайте файл `data/prefixes.txt` с вашими префиксами:
|
||||
|
||||
```
|
||||
# Основные префиксы
|
||||
192.168.1.0/24
|
||||
192.168.2.0/24
|
||||
10.0.0.0/8
|
||||
172.16.0.0/12
|
||||
|
||||
# Дополнительные префиксы
|
||||
203.0.113.0/24
|
||||
198.51.100.0/24
|
||||
```
|
||||
|
||||
### Создание дополнительного файла (опционально)
|
||||
|
||||
Создайте файл `data/additional_prefixes.txt` для дополнительных префиксов:
|
||||
|
||||
```
|
||||
# Дополнительные префиксы
|
||||
192.168.100.0/24
|
||||
192.168.200.0/24
|
||||
```
|
||||
|
||||
## Шаг 2: Запуск сервера
|
||||
|
||||
### Вариант A: Использование PowerShell скрипта (рекомендуется)
|
||||
|
||||
```powershell
|
||||
# Запуск с автоматической сборкой образа
|
||||
.\scripts\start-server.ps1 -Build
|
||||
|
||||
# Или запуск без пересборки
|
||||
.\scripts\start-server.ps1
|
||||
```
|
||||
|
||||
### Вариант B: Использование Docker Compose
|
||||
|
||||
```powershell
|
||||
# Сборка и запуск
|
||||
docker-compose up -d --build
|
||||
|
||||
# Или только запуск
|
||||
docker-compose up -d
|
||||
```
|
||||
|
||||
### Вариант C: Ручной запуск
|
||||
|
||||
```powershell
|
||||
# Сборка образа
|
||||
docker build -t bgp-server-frr .
|
||||
|
||||
# Запуск контейнера
|
||||
docker run -d \
|
||||
--name bgp-server \
|
||||
--restart unless-stopped \
|
||||
-p 179:179 \
|
||||
-v ${PWD}/data:/app/data:ro \
|
||||
-v ${PWD}/logs:/app/logs \
|
||||
--cap-add NET_ADMIN \
|
||||
--privileged \
|
||||
bgp-server-frr
|
||||
```
|
||||
|
||||
## Шаг 3: Проверка работы
|
||||
|
||||
### Проверка статуса контейнера
|
||||
|
||||
```powershell
|
||||
# Статус контейнера
|
||||
docker ps
|
||||
|
||||
# Логи контейнера
|
||||
docker logs bgp-server
|
||||
```
|
||||
|
||||
### Проверка FRR
|
||||
|
||||
```powershell
|
||||
# Версия FRR
|
||||
docker exec bgp-server vtysh -c "show version"
|
||||
|
||||
# Статус BGP
|
||||
docker exec bgp-server vtysh -c "show ip bgp summary"
|
||||
|
||||
# Анонсированные маршруты
|
||||
docker exec bgp-server vtysh -c "show ip bgp"
|
||||
```
|
||||
|
||||
### Проверка загруженных префиксов
|
||||
|
||||
```powershell
|
||||
# Логи загрузки префиксов
|
||||
docker exec bgp-server tail -f /app/logs/prefixes.log
|
||||
|
||||
# Тестирование загрузки
|
||||
docker exec bgp-server python3 /app/scripts/load_prefixes.py --test
|
||||
```
|
||||
|
||||
## Шаг 4: Настройка RouterOS
|
||||
|
||||
### Базовая настройка BGP
|
||||
|
||||
```routeros
|
||||
# Создание BGP экземпляра
|
||||
/routing bgp instance
|
||||
add name=bgp-server as=65001 router-id=192.168.0.254
|
||||
|
||||
# Настройка BGP сети
|
||||
/routing bgp network
|
||||
add network=192.168.0.0/24
|
||||
|
||||
# Настройка BGP пира
|
||||
/routing bgp peer
|
||||
add name=bgp-server remote-address=192.168.100.99 remote-as=65000 instance=bgp-server
|
||||
|
||||
# Включение BGP
|
||||
/routing bgp instance set bgp-server disabled=no
|
||||
```
|
||||
|
||||
### Проверка BGP сессии
|
||||
|
||||
```routeros
|
||||
# Статус BGP
|
||||
/routing bgp peer print
|
||||
|
||||
# Полученные маршруты
|
||||
/routing bgp route print
|
||||
```
|
||||
|
||||
## Шаг 5: Мониторинг
|
||||
|
||||
### Просмотр логов
|
||||
|
||||
```powershell
|
||||
# Логи FRR
|
||||
docker exec bgp-server tail -f /app/logs/frr.log
|
||||
|
||||
# Логи загрузки префиксов
|
||||
docker exec bgp-server tail -f /app/logs/prefixes.log
|
||||
|
||||
# Логи мониторинга
|
||||
docker exec bgp-server tail -f /app/logs/monitor.log
|
||||
```
|
||||
|
||||
### Статус системы
|
||||
|
||||
```powershell
|
||||
# Статус в JSON формате
|
||||
docker exec bgp-server cat /app/logs/status.json
|
||||
|
||||
# Запуск мониторинга
|
||||
docker exec bgp-server python3 /app/scripts/monitor.py
|
||||
```
|
||||
|
||||
### Команды vtysh
|
||||
|
||||
```powershell
|
||||
# Подключение к FRR CLI
|
||||
docker exec -it bgp-server vtysh
|
||||
|
||||
# Полезные команды внутри vtysh:
|
||||
show ip bgp summary # Сводка BGP
|
||||
show ip bgp # Все BGP маршруты
|
||||
show ip route # Таблица маршрутизации
|
||||
show interface # Интерфейсы
|
||||
show running-config # Конфигурация
|
||||
```
|
||||
|
||||
## Управление
|
||||
|
||||
### Остановка сервера
|
||||
|
||||
```powershell
|
||||
# Остановка с сохранением контейнера
|
||||
.\scripts\stop-server.ps1
|
||||
|
||||
# Остановка с удалением контейнера
|
||||
.\scripts\stop-server.ps1 -Force
|
||||
```
|
||||
|
||||
### Перезагрузка префиксов
|
||||
|
||||
```powershell
|
||||
# Перезагрузка без перезапуска сервера
|
||||
docker exec bgp-server python3 /app/scripts/reload_prefixes.py
|
||||
```
|
||||
|
||||
### Обновление контейнера
|
||||
|
||||
```powershell
|
||||
# Обновление с пересборкой
|
||||
.\scripts\update-container.ps1 -Force
|
||||
```
|
||||
|
||||
## Диагностика
|
||||
|
||||
### Проблема: Контейнер не запускается
|
||||
|
||||
```powershell
|
||||
# Проверка логов
|
||||
docker logs bgp-server
|
||||
|
||||
# Проверка портов
|
||||
netstat -an | findstr :179
|
||||
|
||||
# Проверка Docker
|
||||
docker system info
|
||||
```
|
||||
|
||||
### Проблема: BGP сессия не устанавливается
|
||||
|
||||
```powershell
|
||||
# Проверка сетевой связности
|
||||
docker exec bgp-server ping 192.168.0.254
|
||||
|
||||
# Проверка конфигурации FRR
|
||||
docker exec bgp-server vtysh -c "show running-config"
|
||||
|
||||
# Проверка статуса BGP
|
||||
docker exec bgp-server vtysh -c "show ip bgp summary"
|
||||
```
|
||||
|
||||
### Проблема: Префиксы не анонсируются
|
||||
|
||||
```powershell
|
||||
# Проверка файлов префиксов
|
||||
docker exec bgp-server cat /app/data/prefixes.txt
|
||||
|
||||
# Проверка логов загрузки
|
||||
docker exec bgp-server tail -f /app/logs/prefixes.log
|
||||
|
||||
# Проверка статических маршрутов
|
||||
docker exec bgp-server vtysh -c "show ip route static"
|
||||
```
|
||||
|
||||
## Настройка переменных окружения
|
||||
|
||||
Вы можете настроить BGP параметры через переменные окружения:
|
||||
|
||||
```powershell
|
||||
# Запуск с кастомными настройками
|
||||
docker run -d \
|
||||
--name bgp-server \
|
||||
-p 179:179 \
|
||||
-v ${PWD}/data:/app/data:ro \
|
||||
-v ${PWD}/logs:/app/logs \
|
||||
-e BGP_LOCAL_AS=65000 \
|
||||
-e BGP_ROUTER_ID=192.168.100.99 \
|
||||
-e BGP_NEIGHBOR_IP=192.168.0.254 \
|
||||
-e BGP_NEIGHBOR_AS=65001 \
|
||||
-e BGP_HOLD_TIME=90 \
|
||||
-e BGP_KEEPALIVE=30 \
|
||||
--cap-add NET_ADMIN \
|
||||
--privileged \
|
||||
bgp-server-frr
|
||||
```
|
||||
|
||||
## Полезные команды
|
||||
|
||||
### Мониторинг в реальном времени
|
||||
|
||||
```powershell
|
||||
# Логи в реальном времени
|
||||
docker logs -f bgp-server
|
||||
|
||||
# Статус BGP каждые 5 секунд
|
||||
while ($true) {
|
||||
docker exec bgp-server vtysh -c "show ip bgp summary"
|
||||
Start-Sleep 5
|
||||
Clear-Host
|
||||
}
|
||||
```
|
||||
|
||||
### Резервное копирование
|
||||
|
||||
```powershell
|
||||
# Копирование файлов префиксов
|
||||
Copy-Item data/prefixes.txt data/prefixes.txt.backup
|
||||
|
||||
# Экспорт конфигурации FRR
|
||||
docker exec bgp-server vtysh -c "show running-config" > frr-config.backup
|
||||
```
|
||||
|
||||
### Очистка
|
||||
|
||||
```powershell
|
||||
# Остановка и удаление контейнера
|
||||
docker stop bgp-server
|
||||
docker rm bgp-server
|
||||
|
||||
# Удаление образа
|
||||
docker rmi bgp-server-frr
|
||||
|
||||
# Очистка логов
|
||||
Remove-Item logs/* -Recurse -Force
|
||||
```
|
||||
|
||||
## Следующие шаги
|
||||
|
||||
1. **Настройка мониторинга**: Настройте алерты для критических событий
|
||||
2. **Резервное копирование**: Настройте автоматическое резервное копирование конфигурации
|
||||
3. **Безопасность**: Настройте firewall и аутентификацию BGP
|
||||
4. **Масштабирование**: Рассмотрите использование нескольких экземпляров для высокой доступности
|
||||
|
||||
## Поддержка
|
||||
|
||||
- Документация FRR: https://frrouting.org/
|
||||
- GitHub проекта: https://github.com/FRRouting/frr
|
||||
- Сообщество: https://lists.frrouting.org/
|
||||
Reference in New Issue
Block a user