PiKVM

항목	내용
제품	KVM-A8
제품 공식문서	링크
OS	V3 Pre-Assembled
OS 공식문서	링크

1. SD 카드에 이미지 굽기

rpi-imager를 사용하면 손쉽게 할 수 있음. 커스텀 이미지 설치하도록 하고 앞서 다운로드 받은 이미지 사용. 사용자지정 옵션은 추가로 지정할 필요 없음.

2. 하드웨어 설치

제품 공식문서 이미지 참고

3. 최초 접속

주소창에 https://pikvm/ 입력. 초기 username과 비밀번호는 모두 admin이고 2FA code는 설정되어 있지 않음. 원격을 사용하려면 KVM 클릭. PiKVM 제어를 수행하려면 Terminal 클릭.

4. 업데이트

Terminal -> 루트 계정 전환(초기 P/W: root) -> pikvm-update

5. 비밀번호 변경

$ su root
$ rw
$ passwd root  # root 비밀번호 변경임
$ kvmd-htpasswd set admin  # 접속 비밀번호 변경임
$ ro

6. 기본 계정명 변경(선택)

$ su root
$ rw
$ kvmd-htpasswd set ${유저명}
$ kvmd-htpasswd del admin 

7. 외부 네트워크 접속 설정

루트 계정 전환 후 쓰기 모드 설정

$ su root
$ rw

패키지 설치가 필요하므로 관련 내용 설정(pacman 사용)

$ pacman -Syu  # 패키지 최신화
$ nano /etc/pacman.d/mirrorlist

# 다음의 내용 수정
# [기존] Server = http://mirror.archlinuxarm.org/$arch/$repo
# [수정] Server = http://de4.mirror.archlinuxarm.org/$arch/$repo

PiKVM 웹 서비스가 정상적으로 실행 중인지 확인

$ systemctl status kvmd

서비스가 실행중이지 않는다면 아래의 명령어로 재실행

$ systemctl restart kvmd

443 포트(HTTPS 보안 접속용 포트) 방화벽 차단 해제 및 해제 상태 영구화

$ iptables -A INPUT -p tcp --dport 443 -j ACCEPT
$ iptables-save > /etc/iptables/iptables.rules
$ systemctl enable iptables
$ systemctl start iptables

HTTPS 접속을 위한 SSL 설정 확인(인증서 설정)

$ pacman -S kvmd-letsencrypt
$ kvmd-letsencrypt

kvmd-letsencrypt가 없다고 나오는 문제가 발생할 수 있는데 이 경우에는

참고로 kvmd-webterm의 sudo 액세스가 불가능하다. 그래서 반드시 su root로 사용해야한다.