Ubuntu에서 mkcert로 로컬 HTTPS/WSS 환경 설정하기

Ubuntu 환경에서 mkcert를 사용하면 몇 가지 간단한 명령어로 신뢰할 수 있는 로컬 개발용 인증서를 만들 수 있습니다. 이렇게 만든 인증서는 웹소켓 서버(WSS)에서도 바로 사용 가능합니다.

전체 과정은 ① mkcert 설치, ② 로컬 CA(인증기관) 설치, ③ 인증서 생성 순서로 진행됩니다.

### 1. mkcert 설치하기

먼저 mkcert 실행에 필요한 certutil 라이브러리를 설치한 후, mkcert 바이너리를 다운로드하고 실행 경로에 등록합니다.

Bash

# 1. 패키지 목록 업데이트 및 의존성 설치
sudo apt update
sudo apt install libnss3-tools -y

# 2. mkcert 최신 버전 다운로드 (GitHub)
# 아래 주소는 예시이며, 최신 릴리즈는 GitHub에서 확인하는 것이 좋습니다.
wget -O mkcert-v1.4.4-linux-amd64 https://github.com/FiloSottile/mkcert/releases/download/v1.4.4/mkcert-v1.4.4-linux-amd64

# 3. 실행 권한 부여
chmod +x mkcert-v1.4.4-linux-amd64

# 4. 시스템 어디서든 mkcert 명령어를 쓸 수 있도록 /usr/local/bin 으로 이동
sudo mv mkcert-v1.4.4-linux-amd64 /usr/local/bin/mkcert

### 2. 로컬 인증 기관(CA) 설치

mkcert가 내 PC를 신뢰할 수 있는 인증 기관(CA)으로 등록하도록 설정합니다. 이 과정은 최초 한 번만 실행하면 됩니다.

Bash

mkcert -install

실행하면 다음과 비슷한 메시지가 나타나며, 로컬 CA가 시스템과 브라우저(Firefox 등)의 신뢰 저장소에 설치됩니다.

Created a new local CA 💥
The local CA is now installed in the system trust store! ⚡️
The local CA is now installed in the Firefox trust store (requires browser restart)! 🦊

### 3. 서버용 인증서 생성하기

이제 웹소켓 서버에서 사용할 인증서를 생성합니다. 이때 반드시 클라이언트가 접속할 모든 주소(localhost, 127.0.0.1, 내부 IP 등)를 포함해야 합니다.

ifconfig 또는 ip a 명령어로 자신의 내부 IP 주소를 확인하세요 (예: 192.168.0.100).

Bash

# localhost, 127.0.0.1, 그리고 내부 IP 주소(예: 192.168.0.100)에 대해 유효한 인증서 생성
mkcert localhost 127.0.0.1 192.168.0.100

명령을 실행한 폴더에 2개의 파일이 생성됩니다.

localhost+2.pem: 인증서 파일
localhost+2-key.pem: 개인 키 파일

✅ 이제 이 두 파일을 웹소켓 서버 설정에 적용하면 됩니다. 서버 코드에서 SSL/TLS 관련 설정 부분에 위에서 생성된 pem 파일과 key.pem 파일의 경로를 지정해주면, 브라우저는 이 서버를 신뢰할 수 있는 서버로 인식하여 tls: unknown certificate 오류 없이 WSS 연결이 정상적으로 이루어집니다.

커뮤니티

커뮤니티