서버에 SealRoute 설치

사전 요구 사항

• 최소 2 GB RAM과 10 GB 디스크를 갖춘 Linux 호스트(Ubuntu 22.04+ 또는 최신 배포판).
• Docker Engine (24+) 및 Docker Compose v2 플러그인. 다음으로 확인하세요:

  docker --version
  docker compose version

• 공개 도메인(앞단에 HTTPS 포함) 또는 localhost에서 제어하는 포트. 기본 docker-compose.yml은 HOST=your.domain을 설정하면 HTTPS를 자동으로 처리하는 Caddy 리버스 프록시를 함께 제공합니다.
• Aplindo 라이선스. 아래 5단계에서 실행 중인 앱에서 인라인으로 구매할 수도 있습니다.

1단계 - docker-compose 파일 가져오기

작업 디렉터리를 만들고 저장소에서 프로덕션 compose 파일을 가져오세요. 여기에는 이미 SealRoute, Postgres, Caddy가 연결되어 있습니다.

mkdir sealroute && cd sealroute
curl -L https://raw.githubusercontent.com/sealroute/sealroute/main/docker-compose.yml -o docker-compose.yml
curl -L https://raw.githubusercontent.com/sealroute/sealroute/main/deploy.sh         -o deploy.sh
chmod +x deploy.sh

전체 배포 패키지를 복제하려면: git clone https://github.com/sealroute/sealroute.git && cd sealroute. 어느 쪽이든 다음 단계는 동일합니다.

2단계 - 환경 구성

SealRoute는 환경 변수에서 구성을 읽습니다. compose 파일 옆에 .env 파일을 만드세요. 필요한 최소 항목:

# Where the app is reachable from a browser. Use https://your.domain in
# production or http://localhost:3000 for a local trial.
APP_URL=https://your.domain
HOST=your.domain

# Generate with `openssl rand -hex 64` and keep it secret.
SECRET_KEY_BASE=replace-me-with-a-long-random-string

# --- Aplindo licensing ------------------------------------------------------
APLINDO_LICENSE_API_URL=https://license.aplindo.com
APLINDO_LICENSE_PRODUCT_SLUG=SealRoute
APLINDO_LICENSE_DEFAULT_AMOUNT_IDR=5000000.00
APLINDO_LICENSE_HEARTBEAT_SECONDS=3600

선택적 옵션이 포함된 더 완전한 예시는 .env.example에 있습니다.

3단계 - 스택 시작

SealRoute, Postgres, 리버스 프록시를 백그라운드에서 실행하세요:

docker compose up -d

Puma가 tcp://0.0.0.0:3000에서 수신 대기하는 것이 보일 때까지 부팅 로그를 확인하세요:

docker compose logs -f app

첫 부팅 시 데이터베이스 마이그레이션도 실행됩니다. 2 GB 호스트에서는 보통 1분 이내에 완료됩니다.

4단계 - 초기 설정

브라우저에서 앱을 여세요. 아직 사용자가 없으므로 SealRoute는 /setup 페이지로 리디렉션합니다. 여기서 첫 관리자 계정과 계정 메타데이터를 만듭니다.

다음을 입력하세요:

• 이름 / 성 - 첫 관리자로서의 귀하의 이름.
• 이메일 - 관리자 로그인이자 서명 알림이 전송되는 곳입니다.
• 회사명 - 이메일과 서명 페이지에서 서명자에게 표시됩니다.
• 비밀번호 - 최소 8자, 문자와 숫자 혼합을 권장합니다.
• App URL - .env의 APP_URL에서 미리 채워집니다. 이메일의 서명 링크를 생성하는 데 사용됩니다.
• 언어 - 새 제출자를 위한 기본 UI 언어.

제출을 클릭하세요. SealRoute가 계정을 만들고, 로그인시키고, /license 페이지로 리디렉션합니다.

5단계 - 라이선스 구매

자체 호스팅 SealRoute 인스턴스는 로그인 후 화면을 차단 해제하려면 활성 라이선스가 필요합니다. /license 페이지에는 두 개의 카드가 있습니다: 위쪽의 라이선스 구매와 아래쪽의 라이선스 활성화.

라이선스 구매 카드에서 필요한 좌석 수를 설정하세요. 단가는 APLINDO_LICENSE_DEFAULT_AMOUNT_IDR 설정(현재 좌석당 IDR 1.499.000)에서 가져오며, 좌석 수를 변경하면 총액이 자동으로 재계산됩니다.

라이선스 구매를 클릭하세요. SealRoute가 Aplindo 결제 iframe이 포함된 모달을 엽니다. 거기서 결제를 완료하세요. 거래가 성공하면 Aplindo가 입력하신 주소로 라이선스 키를 이메일로 보내며, 동일한 키가 결제 성공 페이지에도 표시됩니다.

6단계 - 라이선스 활성화

성공 페이지 또는 이메일에서 라이선스 키를 복사한 다음 /license의 라이선스 활성화 카드에 붙여넣으세요:

활성화를 클릭하세요. SealRoute가 Aplindo 라이선스 서버를 호출하고, 키를 이 머신에 연결하고, 다시 로드합니다. 상단에 상태 active, 제품 슬러그, 라이선스 ID, 머신 ID, 만료일, 마지막 하트비트 타임스탬프가 표시된 현재 라이선스 카드가 보입니다.

SealRoute는 APLINDO_LICENSE_HEARTBEAT_SECONDS초(기본값: 매시간)마다 Aplindo로 라이선스를 다시 확인하는 하트비트 작업을 예약합니다. 라이선스가 취소되거나 만료되면 다음 하트비트에 반영됩니다.

7단계 - 완료

SealRoute가 이제 완전히 작동합니다. /를 방문하면 첫 업로드를 위해 준비된 빈 문서 템플릿 대시보드에 도착합니다.