본문으로 건너뛰기

Remnawave 패널

Remnawave 패널은 Remnawave의 주요 구성 요소입니다. 사용자, 노드, 구독 등을 관리하는 데 사용됩니다.

Docker 설치

아직 설치되지 않았다면 Docker를 설치하세요.

sudo curl -fsSL https://get.docker.com | sh

1단계 – 필요한 파일 다운로드

프로젝트 디렉토리 생성
mkdir /opt/remnawave && cd /opt/remnawave

다음 명령어를 실행하여 docker-compose.yml.env.sample을 다운로드합니다:

docker-compose.yml 파일 받기
curl -o docker-compose.yml https://raw.githubusercontent.com/remnawave/backend/refs/heads/main/docker-compose-prod.yml
.env 파일 받기
curl -o .env https://raw.githubusercontent.com/remnawave/backend/refs/heads/main/.env.sample

2단계 – .env 파일 설정

JWT_AUTH_SECRETJWT_API_TOKENS_SECRET은 인증 및 관련 보안 기능에 사용됩니다.

다음 명령어를 실행하여 비밀 키를 생성합니다:

보안 키 생성
sed -i "s/^JWT_AUTH_SECRET=.*/JWT_AUTH_SECRET=$(openssl rand -hex 64)/" .env && sed -i "s/^JWT_API_TOKENS_SECRET=.*/JWT_API_TOKENS_SECRET=$(openssl rand -hex 64)/" .env
비밀번호 생성
sed -i "s/^METRICS_PASS=.*/METRICS_PASS=$(openssl rand -hex 64)/" .env && sed -i "s/^WEBHOOK_SECRET_HEADER=.*/WEBHOOK_SECRET_HEADER=$(openssl rand -hex 64)/" .env

기본 Postgres 비밀번호를 변경하는 것을 강력히 권장합니다.

Postgres 비밀번호 변경
pw=$(openssl rand -hex 24) && sed -i "s/^POSTGRES_PASSWORD=.*/POSTGRES_PASSWORD=$pw/" .env && sed -i "s|^\(DATABASE_URL=\"postgresql://postgres:\)[^\@]*\(@.*\)|\1$pw\2|" .env

이제 .env 파일을 열고 다음 변수들을 업데이트합니다:

  • FRONT_END_DOMAIN
  • SUB_PUBLIC_DOMAIN

FRONT_END_DOMAIN은 패널에 접근할 수 있는 도메인 이름입니다. 여기에 도메인 이름을 입력하세요.
예: panel.yourdomain.com

SUB_PUBLIC_DOMAIN – 지금은 패널 도메인을 입력하고 끝에 /api/sub를 추가하세요.
예: panel.yourdomain.com/api/sub

환경 변수에 대한 자세한 내용

환경 변수에 대한 자세한 내용은 환경 변수 페이지를 참조하세요.

3단계 – 컨테이너 시작

다음 명령어를 실행하여 컨테이너를 시작합니다:

컨테이너 시작
docker compose up -d && docker compose logs -f -t

몇 초 후, 다음과 유사한 출력이 표시됩니다:

Remnawave 패널

다음 단계

위험

Remnawave 패널을 올바르게 실행하려면 리버스 프록시가 필요합니다.

서비스를 공개 인터넷에 노출하지 마세요. Remnawave 서비스에는 127.0.0.1만 사용하세요.

이제 리버스 프록시 설치를 진행할 수 있습니다.