Manual/VirtOn/3.10 네트워크 (Network)
VirtOn DocumentationVersion 1.0사용자 가이드

3.10 네트워크 (Network)

3.10 네트워크 (Network)

네트워크 관리 기능은 서버의 물리적 인터페이스와 가상 머신(VM) 간의 통신 경로를 통합적으로 설정하고 제어하는 도구입니다. 복잡한 리눅스 네트워크 구성을 GUI 환경에서 직관적으로 관리하여 인프라의 통신 안정성을 확보합니다.

네트워크 관리

사용 전 확인사항

구분내용
필요 권한네트워크 인터페이스 생성, 수정, 삭제, 변경 적용은 관리자 권한이 필요한 기능입니다.
영향 범위노드 네트워크 변경은 VirtOn 접속, Proxmox API, VM/CT 통신, 클러스터 링크에 영향을 줄 수 있습니다.
사전 조건대상 노드, 물리 포트, VLAN ID, 게이트웨이, MTU, 브리지 사용 여부를 사전에 확인합니다.
작업 확인변경 후 반드시 Apply Configuration을 실행하고, 노드와 VM/CT 네트워크 연결 상태를 확인합니다.

3.10.1 네트워크 인터페이스 설정

  • 네트워크 인터페이스는 구성되어 있는 클러스터의 첫번 째 노드의 인터페이스 부터 로드 됩니다.
  • 구성되어 있는 클러스터(노드)를 선택 후 해당 노드의 네트워크 인터페이스 목록 조회가 가능합니다.
  • 노드 목록이 안보일 시 로그인 재 확인이 필요합니다.(로그인이 안되어 있을 시 노드 목록을 안보입니다.)

3.10.2 인터페이스 관리 - 새 인터페이스(네트워크) 생성

네트워크 생성 브릿지

3.10.2.1 Bridge 타입

  • 인터페이스 이름
    • 영문, 숫자만 생성 가능합니다.
    • 이름만 입력 후 생성 가능합니다.
  • Bridge 포트 (선택사항)
    • 브릿지에 연결할 물리 포트를 선택합니다.
    • ex) eth0, eno1, ens1
  • IPv4 주소/CIDR (선택사항)
    • IP주소 입력시 CIDR입력 필수 - \*미입력 시 생성 제한합니다.
  • 게이트 웨이 (선택사항)
    • 외부 네트워크 접근 필요 시 설정합니다.
  • 댓글 (선택사항)
    • 사용자의 구분을 위한 Comment(메모)
  • MTU (선택사항)
    • 한번에 보낼 수 있는 데이터 패킷의 최대 크기입니다.
    • 기본값은 1500입니다.
  • 부팅 시 자동 시작 (autostart)
    • 서버 부팅 시 해당 인터페이스를 자동으로 활성화 하는 기능입니다.

공통 입력값 기준

항목입력/선택 기준
인터페이스 이름영문과 숫자만 사용합니다. 중복된 이름은 사용할 수 없습니다.
IPv4 주소/CIDRIP 주소를 입력하는 경우 CIDR을 함께 입력합니다. 예: 192.168.0.10/24
게이트웨이외부 네트워크 통신이 필요한 경우에만 입력합니다. 동일 노드에 중복 기본 게이트웨이가 생기지 않도록 확인합니다.
MTU기본값은 1500입니다. 변경 시 연결된 스위치, NIC, VM 네트워크 설정과 일치해야 합니다.
부팅 시 자동 시작운영에 필요한 인터페이스는 활성화합니다. 테스트용 인터페이스는 운영 영향도를 확인한 뒤 설정합니다.

네트워크 생성 vlan

3.10.2.2 VLAN 타입

  • 인터페이스 이름
    • 영문, 숫자만 생성 가능합니다.
    • 이름만 입력 후 생성 가능합니다.
  • VLAN ID
    • 태그번호 분류 위합니다.
    • 범위: 1~4094
    • 기본값: 1
    • 중복 불가능
  • VLAN Raw Device(필수)
    • VLN이 기반할 물리 포트 입니다.
    • 포트가 활성화 되어야 합니다.
    • 하나의 포트에 여러 VLAN 가능 합니다.
  • IPv4 주소/CIDR (선택사항)
    • IP주소 입력시 CIDR입력 필수 - \*미입력 시 생성 제한 합니다.
  • 게이트 웨이 (선택사항)
    • 외부 네트워크 접근 필요 시 설정합니다.
  • 댓글 (선택사항)
    • 사용자의 구분을 위한 Comment(메모)
  • MTU (선택사항)
    • 한번에 보낼 수 있는 데이터 패킷의 최대 크기입니다.
    • 기본값은 1500 입니다.
  • 부팅 시 자동 시작 (autostart)
    • 서버 부팅 시 해당 인터페이스를 자동으로 활성화 하는 기능입니다.

네트워크 생성 본드

3.10.2.3 Bond 타입

  • 인터페이스 이름
    • 영문, 숫자만 생성 가능합니다.
    • 이름만 입력 후 생성 가능합니다.
  • Slaves (선택사항)
    • Bond에 포함할 물리 포트들
    • 최소 2개 필요
    • 공백으로 구분: "eth0 eth1" 또는 "eth0 eth1 eth2”
    • 한 포트는 한 인터페이스만 사용 가능합니다.
  • Bond Mode (선택사항)
    • Active-Backup: 안정성 우선 (권장)
      • 스위치 설정 불필요
      • 간단한 구성
    • 802.3ad (LACP): 성능 우선
      • 스위치가 LACP를 지원해야 합니다.
      • 대역폭 증가
      • 고성능 네트워크용
  • IPv4 주소/CIDR (선택사항)
    • IP주소 입력시 CIDR입력 필수 - \*미입력 시 생성 제한합니다.
  • 게이트 웨이 (선택사항)
    • 외부 네트워크 접근 필요 시 설정합니다.
  • 댓글 (선택사항)
    • 사용자의 구분을 위한 Comment(메모) 입니다.
  • MTU (선택사항)
    • 한번에 보낼 수 있는 데이터 패킷의 최대 크기입니다.
    • 기본값은 1500입니다.
  • 부팅 시 자동 시작 (autostart)
    • 서버 부팅 시 해당 인터페이스를 자동으로 활성화 하는 기능입니다.

3.10.2.4 변경 적용 - Apply Configuration [ 🔄 변경 적용 ]

네트워크 비활성화

  • 네트워크 생성시 비활성화 상태로 표시됩니다.

네트워크 변경 적용

네트워크 변경 적용

  • 네트워크 활성화
    • 변경 적용 버튼 클릭 시 변경 적용중이 표시됩니다.

네트워크 활성화

  • 활성화된 네트워크 상태 표시 변경
  • 변경 적용이 실패하면 최근 수정한 인터페이스 설정, IP/CIDR 형식, 브리지 포트, VLAN Raw Device, Bond Slaves 값을 확인합니다.

3.10.2.5 네트워크 수정 - Edit

네트워크 수정

  • 각 네트워크 인터페이스 우측에 수정, 삭제 버튼이 있습니다.

네트워크 수정

  • 해당 네트워크의 수정버튼을 클릭하면 설정되어있는 네트워크의 정보를 불러옵니다. ex)vmbrtest3
  • IPv4 적용 예시
    1. 수정할 정보 입력합니다.

네트워크 수정

  1. 수정 버튼 클릭 시 변경 적용중이 표시됩니다.

네트워크 수정

  1. 수정된 네트워크의 정보를 확인합니다.

네트워크 수정


3.10.2.6 네트워크 삭제 - Remove 🗑️

  1. 해당 네트워크의 삭제버튼 클릭 시 확인 알림창이 표시 됩니다.

네트워크 삭제

  1. 삭제 버튼 클릭시 해당 네트워크 인터페이스 삭제 중으로 표시됩니다.

네트워크 삭제

  1. 네트워크 인터페이스 목록을 확인합니다.

네트워크 삭제

3.10.3 문제 해결 방법

증상확인 항목조치 방법
노드 목록이 보이지 않음로그인 세션, Proxmox API 연결다시 로그인하고 API 연결 상태를 확인합니다.
Bridge 생성 실패이름 형식, 포트 중복, CIDR 형식영문/숫자 이름을 사용하고 물리 포트가 다른 인터페이스에서 사용 중인지 확인합니다.
VLAN 생성 실패VLAN ID, Raw Device 상태VLAN ID가 1~4094 범위인지 확인하고 기반 포트가 활성 상태인지 확인합니다.
Bond 생성 실패Slaves 개수, 포트 중복, 스위치 설정최소 2개 이상의 물리 포트를 지정하고 LACP 사용 시 스위치 설정을 확인합니다.
변경 적용 후 접속 장애게이트웨이, 브리지, IP 충돌콘솔 또는 Host Shell로 접속해 네트워크 설정을 되돌리고 충돌 IP를 제거합니다.
삭제 실패사용 중인 VM/CT, 클러스터 링크해당 인터페이스를 사용하는 VM/CT와 클러스터 네트워크를 먼저 확인합니다.