3. Proxmox 연결
목차 · 이전: 서버 설치 · 다음: Host 설치
서버를 Proxmox VE에 연결하면 QEMU VM 목록을 자동으로 가져옵니다. 사용자에게 보여 줄 VM은 그다음에 따로 배정합니다.
목표: ToTBVDI 관리자 웹의 데스크톱에서 Windows VM을 찾습니다. 내 PC 브라우저에 ToTBVDI 관리자 웹과 Proxmox 웹을 각각 열어 두세요.
| 열어 둘 화면 | 이 장에서 하는 일 |
|---|---|
| ToTBVDI 관리자 웹 | 설정 명령어 복사 → 연결정보 붙여넣기 |
| Proxmox 웹의 노드 Shell | 전용 연동 계정 만들기 |
이 장의 명령은 Proxmox 노드의 Shell에 입력합니다. 앞 장에서 사용한 Linux 서버 터미널이나 Windows VM 콘솔과 구분하세요.
위 그림은 연결을 마친 뒤의 예시입니다. 처음에는 연결 설정 화면이 보입니다.
1단계. 설정 명령어 복사
- ToTBVDI 관리자 웹에 로그인하세요.
- 설정을 여세요.
- Proxmox 연동을 여세요.
- 명령어 복사를 누르세요.
- Proxmox 웹에서 VM을 관리하는 노드를 선택하세요.
- 노드의 Shell을 여세요.
- root Shell에 복사한 명령어를 붙여넣으세요.
- Enter를 누르세요.
명령어는 현재 ToTBVDI 서버에서 설정 스크립트를 받습니다. 문서의 예시 명령보다 관리자 웹에 표시된 명령어를 사용하세요.
Proxmox의 왼쪽 목록에서 Datacenter 아래의 서버 이름이 노드입니다. 그 아래 Windows VM을 고르면 노드의 Shell 대신 VM의 Console이 나오므로 위치를 다시 확인하세요.
2단계. 전용 API 계정 만들기
- Shell이 묻는 VM 관리용 Proxmox 웹 주소를 확인하세요.
- 자동으로 찾은 주소가 다르면 평소 사용하는 Proxmox 관리 주소를 입력하세요.
- 새 연동 아이디를 입력하세요.
- 화면에 나온 생성 내용과 권한을 확인하세요.
- 생성하려면
y를 입력하세요. - 새 연동 계정의 비밀번호를 입력하세요.
- 같은 비밀번호를 다시 입력하세요.
비밀번호를 입력해도 화면에는 글자가 보이지 않습니다.
아이디에는 totbvdi- 접두사가 자동으로 붙습니다.
새 연동 아이디는 ToTBVDI 서버가 Proxmox에 접속할 때 쓸 전용 이름입니다. 이미 사용하는 Proxmox 관리자 아이디와 다른 새 이름을 정하세요.
Proxmox 주소와 ToTBVDI 주소는 서로 다릅니다. VM을 관리하는 Proxmox 주소를 입력하세요.
스크립트는 전용 사용자와 API 토큰을 만듭니다. 기존 계정을 덮어쓰거나 VM 전원·구성을 바꾸지는 않습니다.
3단계. 연결정보 붙여넣기
- Shell 출력에서
TOTBVDI-CONNECTION-V1:부터END-TOTBVDI-CONNECTION까지 복사하세요. - ToTBVDI의 Proxmox 연동 화면으로 돌아오세요.
- 연결정보 붙여넣기 칸에 전체 블록을 붙여넣으세요.
- 연결하기를 누르세요.
- 위쪽의 연결 상태를 확인하세요.
- 데스크톱을 여세요.
- 가져온 VM 목록을 확인하세요.
연결정보에는 비밀 API 토큰이 들어 있습니다. 게시판·채팅에 올리거나 스크린샷에 포함하지 마세요.
전체 QEMU VM이 VM ID 순서로 표시됩니다. 템플릿과 LXC 컨테이너는 제외됩니다.
VM을 하나씩 등록하거나 가져올 필요는 없습니다. VM 생성·삭제는 Proxmox에서 진행하세요.
완료 확인: 연동 화면에 연결됨이 보이고, 데스크톱에 원하는 VM이 보입니다. 목록에 VM이 있어도 Host 설치와 사용자 배정은 아직 별도로 해야 합니다.
VM이 보이면 4장: Host 설치로 이동하세요.
연결이 안 될 때
| 확인할 것 | 다음 행동 |
|---|---|
| 관리 주소 | 브라우저에서 쓰는 Proxmox 주소와 포트를 확인하세요. |
| 서버에서의 접근 | 브로커 컨테이너가 Proxmox 주소에 접속할 수 있는지 확인하세요. |
| 인증서 이름 | 주소와 인증서의 이름이 일치하는지 확인하세요. |
| 사설 CA | 설정 스크립트가 출력한 CA가 연결정보에 포함됐는지 확인하세요. |
인증서 검증을 끄는 대신 주소와 인증서를 맞추세요. 직접 구성한 토큰이 있다면 연결정보 직접 입력을 사용할 수 있습니다.
나중에 할 일: 토큰 유효기간 확인과 갱신
처음 만든 전용 계정과 토큰의 유효기간은 365일입니다. Proxmox 연동 위쪽에서 만료일과 남은 일수를 확인할 수 있습니다.
- 토큰 갱신을 누르세요.
- 화면에 나온 갱신 명령어를 복사하세요.
- Proxmox 노드의 root Shell에서 명령어를 실행하세요.
- Shell에 표시된 갱신 내용을 확인하세요.
- 갱신하려면
y를 입력하세요. - 출력된
TOTBVDI-RENEWAL-V1:블록을 갱신 창에 붙여넣으세요. - 갱신 확인을 누르세요.
갱신은 기존 계정과 토큰을 이어 씁니다. 비밀번호나 토큰 Secret을 새로 입력할 필요는 없습니다.
자세히: 전용 계정의 권한
전용 계정은 /vms 아래의 현재·미래 VM에 상속 권한을 받습니다.
VM 조회, 전원 관리, 긴급 콘솔, 사운드카드 추가에 필요한 권한을 사용합니다.
이 Proxmox 권한과 ToTBVDI 사용자 배정은 별개입니다. 일반 사용자는 ToTBVDI에서 배정받은 VM만 사용할 수 있습니다.