NAS에 설치¶

TrueNAS SCALE¶

Corvus는 TrueNAS 앱 카탈로그의 Community 트레인에 있습니다.

포트는 기본값을 쓰거나 바꿉니다.

항목	기본값	용도
Admin Console Port	30553	관리 콘솔 (처음에는 자체 서명 인증서의 HTTPS)
HTTP Port	30554	사이트의 HTTP 접속과 Let's Encrypt HTTP 인증
HTTPS Port	30555	사이트의 HTTPS 접속

TrueNAS 웹 화면이 이미 80과 443을 쓰기 때문에 앱은 다른 포트를 씁니다.

Data Storage에서 데이터 위치를 고릅니다. 데이터베이스, 인증서, 암호화 키가 들어 있으니 다른 앱 데이터처럼 이 데이터셋을 백업하세요.
앱이 시작되면 Apps 화면에서 앱의 로그를 열고 setup_token이 있는 줄을 찾습니다. 토큰을 직접 정하려면 설치 전에 Additional Environment Variables에 CORVUS_SETUP_TOKEN(12자 이상)을 넣으세요.
https://<TrueNAS-IP>:30553을 열고 인증서 경고를 넘긴 뒤 토큰을 넣고 관리자 계정을 만듭니다. 이어서 첫 프록시 호스트를 만들어 보세요.

공유기에서 80 → 30554, 443 → 30555로 TrueNAS 주소에 포트 포워딩하세요. 그러면 방문자와 Let's Encrypt가 평소 포트로 Corvus에 닿습니다. 80 포트를 열 수 없다면 인증서는 DNS 인증으로 받으세요.

콘솔 포트(30553)는 인터넷에 열지 마세요. 콘솔 보호를 참고하세요.

카탈로그에 새 Corvus 버전이 올라오면 TrueNAS가 앱 업데이트를 표시합니다. 데이터는 시작할 때 자동으로 옮겨집니다.

Corvus는 Community Applications(Apps 탭)에 있습니다.

포트는 기본값을 쓰거나 바꿉니다.

포트	기본값	용도
관리 콘솔	9443	콘솔(HTTPS, 처음에는 자체 서명 인증서)
HTTP	1880	사이트의 HTTP 접속과 Let's Encrypt HTTP 인증
HTTPS	18443	사이트의 HTTPS 접속

Unraid 웹 화면이 보통 80과 443을 쓰기 때문에 템플릿은 다른 포트를 씁니다. 80/443을 그대로 쓰려면 컨테이너에 별도 IP를 주세요(Network Type을 br0 또는 사용자 지정 네트워크로).

데이터는 /mnt/user/appdata/corvus에 저장되고 소유자는 nobody:users(PUID 99, PGID 100)입니다. 데이터베이스, 인증서, 암호화 키가 들어 있으니 다른 앱 데이터처럼 백업하세요.
설정 토큰을 직접 정하려면 처음 시작하기 전에 Setup Token(12자 이상)을 입력합니다. 비워 두면 컨테이너 Logs에서 setup_token이 있는 줄을 찾으세요.
컨테이너 메뉴의 WebUI(또는 https://<unraid-ip>:9443)를 열고 인증서 경고를 수락한 뒤 토큰을 입력하고 관리자 계정을 만듭니다.

인터넷에서 사이트에 접속하려면 공유기에서 80 → 1880, 443 → 18443으로 포워딩하세요. 콘솔 포트는 인터넷에 열지 마세요. 업데이트는 다른 컨테이너처럼 Docker 탭에 표시됩니다.

Docker Compose를 쓸 수 있는 NAS(Synology Container Manager, QNAP Container Station 등)라면 일반 설치 방법을 그대로 쓰면 됩니다. 주의할 점:

NAS가 이미 80/443을 쓰는 경우. Corvus를 다른 포트(예: 8080:80, 8443:443)로 열고 공유기에서 80/443을 그 포트로 포워딩하거나, NAS 화면의 포트를 바꾸세요.
폴더 권한. PUID/PGID를 데이터 폴더 주인인 NAS 사용자로 맞추세요(환경 변수 참고).
설정 토큰은 컨테이너 로그에 있습니다. CORVUS_SETUP_TOKEN으로 직접 정할 수도 있습니다.

여기 없는 NAS에서 쓰고 계신다면 이슈 #94에 경험을 남겨 주세요.