Skip to main content

빠른 시작

이 가이드는 stable v2.1.2 기준으로 빈 서버에서 실제 원격 SSH 성공까지 따라갑니다.

만들게 될 구조

시작 전 준비

  • 인터넷 공인 진입점으로 접근 가능한 Linux/systemd 서버
  • 등록할 Linux/systemd 클라이언트
  • 클라이언트에 이미 존재하는 SSH 계정
  • 서버 측 방화벽/NAT 규칙
  • 설치를 위한 sudo/root 권한
처음 구성한다면 Ubuntu 24.04 x86_64가 가장 명확한 real-validated baseline입니다.
고정 공인 IP나 별도 Linux 서버가 없다면 먼저 OCI 무료티어 서버 준비를 따라 OCI Always Free 대상 VM + Reserved Public IPv4를 준비할 수 있습니다.

Direct 기본 네트워크

FRP Auto Deploy는 AWS/OCI 보안 정책, 외부 방화벽/NAT, UFW/firewalld/iptables를 자동 변경하지 않습니다.

1. 서버 설치

서버가 방화벽/NAT 뒤라면 방화벽 & NAT를 먼저 확인하세요.

2. 서버 상태 확인

필요한 서비스가 active이고 doctor가 blocking 구성/신뢰 오류를 보고하지 않을 때 다음 단계로 진행하세요.

3. 클라이언트 등록 생성

가장 쉬운 방식

CLI 안에서:

SSH 프로필을 명시해서 생성

aella원격 Linux 클라이언트에 이미 존재하는 SSH 계정으로 바꾸세요.

4. 원격 클라이언트에서 생성된 명령 실행

서버가 출력한 정확한 명령을 그대로 원격 사용자에게 비공개 채널로 전달하고 한 번 실행합니다.

5. 클라이언트 확인

6. 서버에서 등록과 포트 확인

SSH 서비스에 배정된 public port를 확인합니다.

7. 실제 SSH 접속

Public hostname을 설정했다면:

성공 기준

  • show clients에 CLIENT ID가 보임
  • SSH 서비스에 public port가 배정됨
  • client show status가 정상
  • 외부 방화벽/NAT가 해당 published port를 허용
  • ssh -p ...가 실제 target SSH에 도달

안 되면

먼저 서버와 클라이언트 양쪽에서 frpctl doctor를 실행하고 문제 해결을 따라가세요. Registry, identity, PKI, generated FRP config를 먼저 수동 수정하지 마세요.

다음 단계

마지막 수정일 2026년 9월 7일