# 무료로 WireGuard를 쉽게 설치하고 관리할 수 있는 “WireGuard Easy”, 클라이언트 목록 표시, 생성, 편집, 삭제, 활성화, 비활성화, QR 코드 표시, 설정 파일 다운로드 등이 가능

> https://bookfactory.kr/c/news/11913
> 게시판: 뉴스
> 작성자: tachikoma43
> 작성일: 2026-09-13T20:46:14.628Z

---

VPN의 WireGuard 환경을 직접 구축하면, 사용하는 PC나 스마트폰마다 키와 IP 주소 등을 설정하고, 터미널이 늘 때마다 설정을 관리해야 합니다. 이러한 WireGuard 환경의 도입과 클라이언트 관리를 웹 브라우저에서 한 번에 처리할 수 있는 오픈 소스 툴 “WireGuard Easy”가 공개되었습니다. wg-easy/wg-easy: 가장 쉽고 WireGuard VPN 실행 + 웹 기반 관리 UI입니다. https://github.com/wg-easy/wg-easy◆WireGuard Easy의 이용 방법 및 클라이언트 추가 시, WireGuard Easy의 관리 화면의 클라이언트 목록에서 “새로운 클라이언트”를 클릭합니다.

“이름”에 원하는 이름을 입력하고 “만료일”은 만료일로 날짜를 입력하거나 그대로 비워도 무기한이 됩니다. “클라이언트 생성”을 클릭합니다.

IP가 할당되어 클라이언트가 추가됩니다.

* 클라이언트 측 설정 연결할 클라이언트에서 QR 코드 스캔이 가능한 경우, 클라이언트 목록에서 “QR 코드” 버튼을 클릭합니다.

QR 코드가 생성됩니다.

클라이언트 측 WireGuard 앱을 실행하고 “QR 코드 스캔”을 탭합니다.

카메라가 켜지고 QR코드를 스캔하면 임포트용 폼이 표시되어 “터널명”에 이름을 입력하고 “터널 생성”을 탭합니다.

터널이 추가되면 토글을 켜고 연결합니다.

연결이 완료되면 WireGuard Easy 측의 클라이언트 표시가 연결 상태가 되고, 연결된 이후 시간 및 통신 속도 등이 확인됩니다.

QR코드가 이용 불가능한 PC 등에서는 “다운로드” 버튼을 클릭하여 설정 파일을 저장하고 클라이언트에 전달합니다.

클라이언트 측의 WireGuard의 “파일에서 터널을 임포트”를 클릭합니다.

설정 파일을 읽어들입니다.

터널이 추가되면 “활성화” 버튼을 클릭합니다.

상태가 활성화되면 연결 완료입니다.

WireGuard Easy 측의 클라이언트 표시도 연결 상태가 되고, 연결된 이후 시간 및 통신 속도 등이 확인됩니다.

다음과 같이 키 생성 및 IP 주소 할당과 같은 클라이언트별 설정을 웹 UI에서 간편하게 수행할 수 있습니다. ◆클라이언트를 브라우저에서 관리 각 클라이언트의 경우 다음 작업이 브라우저에서 가능합니다.
- 편집 클라이언트 이름, IP 주소, 허용 IP 주소 등의 설정을 변경할 수 있습니다.
- 더 이상 필요하지 않은 클라이언트를 관리 화면에서 삭제할 수 있습니다.
- 활성화 또는 비활성화된 클라이언트를 다시 VPN에 연결할 수 있는 상태로 만들 수 있습니다.
- 비활성화하여 클라이언트에서 VPN 연결을 일시적으로 중지할 수 있습니다.
- 연결 상태 확인 각 클라이언트가 WireGuard에 연결되어 있는지 확인할 수 있습니다.
- Tx/Rx 통신량 표시 클라이언트별 전송량 Tx와 수신량 Rx를 확인할 수 있습니다.
- 클라이언트별 방화벽 클라이언트마다 VPN을 통해 액세스할 수 있는 IP 주소, 네트워크 및 포트를 제한할 수 있습니다.
- 허용 IP 주소 클라이언트 측에서 VPN을 통해 전송할 IP 주소 또는 네트워크 범위를 지정할 수 있습니다.
- IPv6/CIDR IPv6 주소를 사용할 수 있으며, CIDR 표기법으로 네트워크 범위를 지정할 수 있습니다.
- 2FA 관리 화면에 로그인에 TOTP 방식의 2단계 인증을 추가할 수 있습니다.
- OIDC/OAuth Google 또는 GitHub와 같은 외부 계정을 활용한 인증 설정을 할 수 있습니다.
- Prometheus Prometheus용 메트릭을 출력하고 모니터링 시스템과 연동할 수 있습니다.
- 1회성 링크 클라이언트를 설정한 한 번만 사용할 수 있는 링크를 발행하여 사용자에게 전달할 수 있습니다. ◆WireGuard Easy 구축 방법 이번에는 Google Cloud의 VM 인스턴스에서 Ubuntu에서 Docker가 사용 가능한 환경에 구축합니다. 작업 폴더를 생성하고 이동한 후 docker-compose.yml을 가져옵니다.

컨테이너를 시작합니다.

브라우저에서 서버의 IP 주소의 51821 포트 접속 시 초기 설정 화면이 나타나므로 “계속”을 클릭합니다.

“기존 설정이 있습니까?”라는 질문에 대해 “아니오”를 클릭합니다.

“호스트”에 서버의 IP 주소 또는 호스트 이름을 입력하고, “포트”는 표시되는 포트의 그대로 “계속”을 클릭합니다.

설정 완료 화면이 표시되면 “로그인”을 클릭합니다.

관리 화면이 표시되면 설치 완료입니다.

참고로, 검증 환경에서는 docker-compose.yml의 wg-easy 서비스 내에 있는 environment에 INSECURE=true를 설정함으로써 HTTP 연결도 이용할 수 있지만, 실제 환경에서는 리버스 프록시 등을 이용하여 HTTPS로 접속하도록 설정하는 것이 권장됩니다.

[원문 보기](https://gigazine.net/news/20260913-wireguard-easy/) | 출처: Gigazine