Skip to content

Справочник параметров сервера и сети ​

Секции server, webrtc и logging в файле config.yaml управляют сетевыми слушателями, шифрованием, CORS и выводом логов.


1. Полный блок настроек сервера ​

yaml
server:
  # Сетевой интерфейс для прослушивания (0.0.0.0 — все интерфейсы)
  host: "0.0.0.0"
  
  # Основной порт HTTP / REST / WHEP / HLS
  port: 8080
  
  # Префикс пути URL (для reverse proxy подпутей, например /ruseon)
  base_path: ""

  # Настройки TLS / HTTPS
  tls:
    enabled: false
    cert_file: "/etc/ruseon/certs/fullchain.pem"
    key_file: "/etc/ruseon/certs/privkey.pem"
    min_version: "TLS1.3" # варианты: TLS1.2, TLS1.3

  # Настройки CORS
  cors:
    allowed_origins:
      - "http://localhost:3000"
      - "https://portal.company.com"
    allowed_methods:
      - "GET"
      - "POST"
      - "PUT"
      - "DELETE"
      - "OPTIONS"
    allowed_headers:
      - "Authorization"
      - "Content-Type"
      - "Range"

# Настройки WebRTC и WHEP
webrtc:
  # Внешний публичный IP-адрес для клиентов в SDP-ответах
  public_ip: "203.0.113.50"
  
  # Диапазон UDP-портов для передачи медиаданных ICE
  port_range_start: 50000
  port_range_end: 50100
  
  # Серверы STUN и TURN для прохождения NAT
  stun_servers:
    - "stun:stun.l.google.com:19302"
  turn_servers:
    - url: "turn:turn.example.com:3478"
      username: "ruseon_user"
      credential: "secret_password"

# Настройки структурированного логирования
logging:
  # Формат: "json" (production) или "console" (разработка)
  format: "json"
  
  # Уровень логов: trace, debug, info, warn, error, fatal
  level: "info"
  
  # Включение исходного файла и строки в логах
  caller: false

2. Таблица параметров сервера ​

КлючТипПо умолчаниюОписание
server.hoststring"0.0.0.0"IP-адрес интерфейса для привязки сокетов
server.portinteger8080Основной TCP-порт HTTP, REST API, WHEP и HLS
server.tls.enabledbooleanfalseВключение встроенного шифрования TLS
webrtc.public_ipstring""Внешний IP сервера для WebRTC ICE-кандидатов
webrtc.port_range_startinteger50000Начало диапазона портов UDP медиа
webrtc.port_range_endinteger50100Конец диапазона портов UDP медиа
logging.levelstring"info"Минимальный уровень логов (trace, debug, info, warn, error)

Связанная документация ​

Released under the MIT License.