네트워크/인프라

도메인, HTTPS, 네트워크 설정

도메인 연결과 HTTPS는 대부분 고객사 네트워크(DNS/프록시) 영역입니다.
PRISM 서버에서 따로 손댈 것은 거의 없습니다 - 아래에서 경우별로 정리했습니다.

도메인으로 접속

PRISM은 IP로도 도메인으로도 접속됩니다.
도메인은 제품 설정이 아니라 DNS(네트워크)에서 서버 IP로 연결하면 그대로 열립니다.

먼저 알아두기 PRISM 안에 도메인을 등록하는 설정은 없습니다. DNS에서 도메인 → 서버 IP만 연결해 두면, IP로 접속하던 것과 똑같이 도메인으로도 열립니다. 제품에서 추가로 조정할 것은 없습니다.

도메인으로 안 열릴 때 - 확인 순서

아래 순서로 보면 어디서 막혔는지 바로 좁혀집니다.

IP로는 열리나요?

http://<서버IP>:8200 로 접속해 봅니다. IP로는 열리면 도메인 이름이 아직 IP로 연결 안 된 상태(아래 2, 3번). IP로도 안 열리면 네트워크/방화벽 문제(도메인과 무관).

도메인이 IP로 풀리나요?

접속하는 PC에서 아래를 실행합니다. 나오는 IP가 PRISM 서버 IP와 같아야 합니다. 다르거나 안 나오면 DNS 등록이 아직 반영 전이거나 오타입니다.

$ nslookup 회사도메인.co.kr

사내 프록시를 쓰나요?

nslookup/ping 은 되는데 브라우저만 안 되면 사내 프록시가 원인일 가능성이 큽니다. 프록시가 내부 서버 도메인을 외부로 내보내 "주소를 못 찾음"이 됩니다. 이 경우 프록시 예외 목록에 해당 도메인(또는 서버 IP)을 추가하면 됩니다.

HTTPS(SSL)

HTTPS는 두 갈래입니다. 앞단에 리버스 프록시가 있으면 PRISM은 http로 두고, 없이 직접 노출되면 PRISM에서 SSL을 켭니다.

대부분은 이 경우 사내 환경은 보통 앞단 리버스 프록시(로드밸런서)가 HTTPS를 처리합니다. 이 경우 PRISM은 http로 두면 되고, 인증서를 넣을 필요가 없습니다. 사용자는 프록시까지 https로, 프록시에서 PRISM까지는 사내망 http로 연결됩니다.

사용자브라우저 (https)

리버스 프록시인증서/SSL 여기서 처리

PRISM 서버http 그대로 (변경 없음)

접속 로그에 실제 사용자 IP 남기기 앞단에 리버스 프록시(로드밸런서)를 두면 접속 로그에 프록시 주소만 찍힐 수 있습니다. 설치할 때 --trusted-proxies=<프록시 IP 대역> 을 지정하면 실제 접속자 IP가 로그에 기록됩니다. Podman 을 일반 계정으로 운영(rootless)하는 환경은 대부분 앞단 프록시 뒤에 두게 되므로 함께 지정해 두면 좋습니다.

우리 환경에 맞는 설정

환경	PRISM 설정	인증서
앞단 리버스 프록시 있음	http 그대로 (변경 없음)	프록시가 처리
프록시 없이 직접 노출 + https 필요	PRISM에서 SSL 켜기	PRISM 서버에 인증서
http로 충분	변경 없음	불필요

Podman(RHEL)으로 설치한 경우 Podman 을 관리자 권한 없이 일반 계정으로 운영(rootless)하면 80·443 같은 낮은 번호 포트를 서버가 직접 열 수 없습니다. 그래서 Podman rootless 환경은 HTTPS를 PRISM에서 직접 켜지 않고, 위 그림처럼 앞단 리버스 프록시에서 처리하는 것을 권장합니다(PRISM은 http 8200 그대로 두면 됩니다). 앞단 프록시가 없어 PRISM에서 꼭 직접 HTTPS를 써야 한다면 인증서 포트를 --ssl-port 로 1024 이상으로 지정하세요. Docker로 설치한 경우에는 이 제약이 없습니다.

PRISM에서 직접 HTTPS 켜기 - 두 경우

경우 A: 처음 설치부터 HTTPS - 설치 명령에 --ssl + 도메인 + 인증서 경로를 추가합니다.

# Docker - 관리자 권한(sudo)
$ sudo ./install.sh --llm-url=http://<LLM서버IP>:<포트>/v1 \
       --ssl --domain=회사도메인.co.kr --cert-path=/인증서폴더
# Podman(RHEL) - sudo 없이 일반 계정, 인증서 포트는 1024 이상
$ ./install.sh --llm-url=http://<LLM서버IP>:<포트>/v1 \
       --ssl --ssl-port=<1024 이상 포트> --domain=회사도메인.co.kr --cert-path=/인증서폴더

경우 B: 이미 http로 쓰던 걸 나중에 HTTPS로 - 다시 설치하지 않습니다. SSL만 켜는 스크립트로 전환합니다. 데이터는 그대로 두고 웹서버만 잠깐 다시 떠서(수 초 순단) 적용됩니다.

# Docker - 관리자 권한(sudo)
$ sudo ./enable_ssl.sh --domain=회사도메인.co.kr --cert-path=/인증서폴더
# Podman(RHEL) - sudo 없이 일반 계정
$ ./enable_ssl.sh --domain=회사도메인.co.kr --cert-path=/인증서폴더

버전 안내 enable_ssl.sh 는 2026년 7월 6일(월) 이후 릴리즈 버전부터 들어 있습니다. 최초 설치 버전이 그 전이라면 아래 두 파일을 내려받아 서버의 한 폴더에 함께 둔 뒤, 그 폴더에서 sudo bash enable_ssl.sh --domain=회사도메인.co.kr --cert-path=/인증서폴더 를 실행하세요(Podman(RHEL) 환경은 앞의 sudo 를 빼고 일반 계정으로 실행합니다). 두 파일이 같은 폴더에 있어야 합니다(enable_ssl.sh 가 setup_ssl.sh 를 자동으로 부릅니다).

enable_ssl.sh 받기 setup_ssl.sh 받기

인증서/자체서명 인증서 없이 켜면(자체서명, self-signed) 브라우저가 "안전하지 않음" 경고를 표시합니다. 연결은 되지만, 정식 운영은 --cert-path 로 정식 인증서를 넣어 경고를 없애세요. 인증서는 도메인 이름으로 발급되므로 접속할 도메인과 일치해야 합니다.

포트 변경

기본 접속 포트는 8200(HTTP), HTTPS는 443입니다. 바꾸려면 설치 명령에 --port(HTTP), --ssl-port(HTTPS)를 추가합니다.

$ sudo ./install.sh --llm-url=http://<LLM서버IP>:<포트>/v1 --port=8300

Podman(RHEL) - 낮은 번호 포트 제한 위 예시는 Docker 기준(sudo)입니다. Podman(RHEL) 환경은 앞의 sudo 를 빼고 일반 계정으로 실행하며, 기본 접속 포트 8200 은 Docker·Podman 모두 그대로 쓸 수 있습니다. 다만 Podman 을 일반 계정으로 운영(rootless)하는 경우 80·443처럼 1024보다 낮은 포트는 지정할 수 없습니다. --port · --ssl-port 에는 1024 이상 값을 넣고, 80·443으로 보이게 하려면 앞단 프록시나 방화벽 포트 전달을 이용하세요. Docker로 설치한 경우에는 이 제약이 없습니다.

방화벽 바꾼 포트(또는 8200, 443)는 서버 방화벽에서 인바운드 허용이 되어 있어야 외부에서 접속됩니다. 사내 방화벽/로드밸런서를 함께 쓰는 경우 그쪽에도 같은 포트를 열어야 합니다.

자주 묻는 질문

도메인은 PRISM 어디에서 설정하나요?

설정할 곳이 없습니다. 도메인은 제품이 아니라 고객사 DNS에서 서버 IP로 연결합니다. 연결해 두면 PRISM은 그대로 도메인으로 열립니다.

http인데 도메인 접속이 안 됩니다.

HTTP면 인증서(HTTPS)와는 무관합니다. 대부분 도메인 → IP 변환(DNS) 문제입니다. 위 확인 순서대로 nslookup 으로 도메인이 서버 IP로 풀리는지 보세요. 풀리는데 브라우저만 안 되면 사내 프록시가 원인입니다.

HTTPS로 바꾸려면 다시 설치해야 하나요?

아니요. 데이터를 지우고 새로 까는 재설치가 아닙니다. enable_ssl.sh 로 SSL만 켜면 됩니다(데이터 보존, 웹서버만 잠깐 재기동). 앞단에 리버스 프록시가 있으면 그것조차 필요 없이 http로 두면 됩니다. 단, enable_ssl.sh 는 2026년 7월 6일(월) 이후 릴리즈 버전부터 들어 있습니다. 최초 설치 버전이 그 전이라면 위 HTTPS 켜기 안내에서 enable_ssl.sh, setup_ssl.sh 두 파일을 내려받아 서버 한 폴더에 함께 두고 실행하면 됩니다.

리버스 프록시 뒤인데 공유 링크가 http로 나옵니다.

프록시 뒤에서는 PRISM이 자신이 https로 보이는지 모를 수 있습니다. 관리자 설정에서 외부 주소를 https://도메인 으로 한 번 지정하면 공유 링크가 그 주소를 따라갑니다.

함께 보면 좋은 문서

설치/다운로드는 설치 안내에서, 설치 전 방화벽/사양 준비는 준비사항 체크리스트, 설치 직후 점검은 정상동작 확인 가이드에서 확인하세요.

설치 안내 준비사항 체크리스트 정상동작 확인