VPN 로그인 정보는 무작위로 생성됩니다. [VPN 로그인 정보 확인](#retrieve-vpn-login-details)을 참조하세요.

또는 [Docker 없이 IPsec VPN 설정](https://github.com/hwdsl2/setup-ipsec-vpn)을 할 수도 있습니다. 이 이미지 사용 방법에 대해 자세히 알아보려면 아래 섹션을 읽어보세요.

## 커뮤니티

- 📬 [프로젝트 업데이트 구독](https://selfhostedstack.beehiiv.com/subscribe?utm_campaign=vpn) (월 1–2회 이메일) — 무료 VPN 및 AI 배포 가이드(PDF) 받기
- 💬 [r/selfhostedstack](https://www.reddit.com/r/selfhostedstack/) 커뮤니티에 참여하여 토론하세요
- ⭐ 유용하다고 생각되면 저장소에 별표를 눌러주세요 — 다른 사람들이 발견하는 데 도움이 됩니다

## 요구 사항

- 공용 IP 주소 또는 DNS 이름이 있는 Linux 서버
- Docker 설치
- 방화벽에서 VPN 포트 개방 (UDP 500 및 4500)
- [Podman](https://docs.podman.io)을 사용하여 `docker`에 대한 별칭을 만든 후 이 이미지를 실행할 수도 있습니다

**참고:** 고급 사용자는 [Docker for Mac](https://docs.docker.com/desktop/setup/install/mac-install/)과 함께 macOS에서 이 이미지를 사용할 수 있습니다. IPsec/L2TP 모드를 사용하기 전에 `docker restart ipsec-vpn-server` 명령으로 컨테이너를 한 번 재시작해야 할 수 있습니다. 이 이미지는 Docker for Windows를 지원하지 않습니다.

## 다운로드

[Docker Hub 레지스트리](https://hub.docker.com/r/hwdsl2/ipsec-vpn-server/)에서 신뢰할 수 있는 빌드를 받으세요:```bash
docker pull hwdsl2/ipsec-vpn-server

지원 플랫폼: `linux/amd64`, `linux/arm64` 및 `linux/arm/v7`.

고급 사용자는 GitHub에서 [소스 코드로 빌드](https://gitlab.com/hwdsl2/docker-ipsec-vpn-server/-/blob/master/docs/advanced-usage.md#build-from-source-code)할 수 있습니다.

### 이미지 비교

사전 빌드된 두 가지 이미지를 사용할 수 있습니다. 기본 Alpine 기반 이미지는 약 19MB에 불과합니다.

|                   | Alpine 기반             | Debian 기반                   |
| ----------------- | ------------------------ | ------------------------------ |
| 이미지 이름       | hwdsl2/ipsec-vpn-server  | hwdsl2/ipsec-vpn-server:debian |
| 압축 크기         | ~ 19 MB                  | ~ 62 MB                        |
| 기본 이미지       | Alpine Linux 3.23        | Debian Linux 12                |
| 플랫폼            | amd64, arm64, arm/v7     | amd64, arm64, arm/v7           |
| Libreswan 버전    | 5.4                      | 5.4                            |
| IPsec/L2TP        | ✅                       | ✅                              |
| Cisco IPsec       | ✅                       | ✅                              |
| IKEv2             | ✅                       | ✅                              |

**참고:** Debian 기반 이미지를 사용하려면 이 README의 모든 `hwdsl2/ipsec-vpn-server`를 `hwdsl2/ipsec-vpn-server:debian`으로 바꾸세요. 이 이미지는 현재 Synology NAS 시스템과 호환되지 않습니다.

<details>
<summary>
이전 Libreswan 버전 4를 사용하고 싶습니다.
</summary>

일반적으로 이 프로젝트의 기본 버전인 최신 [Libreswan](https://libreswan.org/) 버전 5를 사용하는 것이 좋습니다. 그러나 이전 Libreswan 버전 4를 사용하려면 소스 코드에서 Docker 이미지를 빌드할 수 있습니다:```bash
git clone https://github.com/hwdsl2/docker-ipsec-vpn-server
cd docker-ipsec-vpn-server
# Specify Libreswan version 4
sed -i 's/SWAN_VER=5\..*/SWAN_VER=4.15/' Dockerfile Dockerfile.debian
# To build Alpine-based image
docker build -t hwdsl2/ipsec-vpn-server .
# To build Debian-based image
docker build -f Dockerfile.debian -t hwdsl2/ipsec-vpn-server:debian .

이렇게 하면 VPN 로그인용 사용자 계정이 생성되며, 여러 기기에서 사용할 수 있습니다[\*](#important-notes). IPsec PSK(사전 공유 키)는 `VPN_IPSEC_PSK` 환경 변수로 지정됩니다. VPN 사용자 이름은 `VPN_USER`에 정의되고, VPN 비밀번호는 `VPN_PASSWORD`로 지정됩니다.

추가 VPN 사용자도 지원되며, 필요에 따라 `env` 파일에 다음과 같이 선언할 수 있습니다. 사용자 이름과 비밀번호는 공백으로 구분해야 하며, 사용자 이름은 중복될 수 없습니다. 모든 VPN 사용자는 동일한 IPsec PSK를 공유합니다.```
VPN_ADDL_USERS=additional_username_1 additional_username_2
VPN_ADDL_PASSWORDS=additional_password_1 additional_password_2

이 명령에서는 `docker run`의 `-v` 옵션을 사용하여 `ikev2-vpn-data`라는 새 [Docker 볼륨](https://docs.docker.com/storage/volumes/)을 생성하고, 이를 컨테이너의 `/etc/ipsec.d`에 마운트합니다. 인증서와 키 같은 IKEv2 관련 데이터는 볼륨에 유지되며, 나중에 Docker 컨테이너를 다시 생성해야 할 때 동일한 볼륨을 다시 지정하기만 하면 됩니다.

이 이미지를 사용할 때는 IKEv2를 활성화하는 것이 좋습니다. 그러나 IKEv2를 활성화하지 않고 IPsec/L2TP 및 IPsec/XAuth("Cisco IPsec") 모드만 사용하여 VPN에 연결하려면 위 `docker run` 명령에서 첫 번째 `-v` 옵션을 제거하세요.

**참고:** 고급 사용자는 [권한 모드 없이 실행](https://gitlab.com/hwdsl2/docker-ipsec-vpn-server/-/blob/master/docs/advanced-usage.md#run-without-privileged-mode)할 수도 있습니다.

### VPN 로그인 정보 가져오기

위 `docker run` 명령에서 `env` 파일을 지정하지 않았다면 `VPN_USER`는 기본적으로 `vpnuser`로 설정되고, `VPN_IPSEC_PSK`와 `VPN_PASSWORD`는 무작위로 생성됩니다. 이를 확인하려면 컨테이너 로그를 확인하세요:```bash
docker logs ipsec-vpn-server

출력에는 IKEv2 모드가 활성화된 경우 해당 모드에 대한 세부 정보도 포함됩니다.

(선택 사항) 생성된 VPN 로그인 세부 정보(있는 경우)를 현재 디렉터리에 백업합니다:```bash
docker cp ipsec-vpn-server:/etc/ipsec.d/vpn-gen.env ./

Example `docker-compose.yml` (이미 포함됨):```yaml
volumes:
  ikev2-vpn-data:

services:
  vpn:
    image: hwdsl2/ipsec-vpn-server
    restart: always
    env_file:
      - ./vpn.env
    ports:
      - "500:500/udp"
      - "4500:4500/udp"
    privileged: true
    hostname: ipsec-vpn-server
    container_name: ipsec-vpn-server
    volumes:
      - ikev2-vpn-data:/etc/ipsec.d
      - /lib/modules:/lib/modules:ro

Docker 이미지가 이미 최신 상태라면, 다음과 같은 출력이 표시됩니다:```
Status: Image is up to date for hwdsl2/ipsec-vpn-server:latest

**참고:** IKEv2 세부 정보를 찾을 수 없다면 컨테이너에서 IKEv2가 활성화되지 않았을 수 있습니다. [Docker 이미지 업데이트](#update-docker-image) 섹션의 지침을 사용하여 Docker 이미지와 컨테이너를 업데이트해 보세요.

IKEv2 설정 중에 IKEv2 클라이언트(기본 이름 `vpnclient`)가 생성되며, 해당 구성은 **컨테이너 내부**의 `/etc/ipsec.d`로 내보내집니다. 구성 파일을 Docker 호스트로 복사하려면:```bash
# Check contents of /etc/ipsec.d in the container
docker exec -it ipsec-vpn-server ls -l /etc/ipsec.d
# Example: Copy a client config file from the container
# to the current directory on the Docker host
docker cp ipsec-vpn-server:/etc/ipsec.d/vpnclient.p12 ./