설치가 끝났으면 브라우저로 서버 주소에 들어가요. 온프렘 판은 첫 화면이 바로 로그인이에요.
온프렘 판 로그인 — Google 로그인은 없고 이메일·비밀번호만 써요.
1. 서버 관리자로 가입
「계정 만들기」에서 설치할 때 --admin으로 적은 이메일로 가입해요. 그 이메일은 라이선스가 아직 없어도 가입할 수 있고, 가입 즉시 서버 관리자 권한이 붙어요. 다른 사람은 라이선스 좌석 안에서만 가입돼요.
가입하면 내 브레인 화면으로 들어와요. 오른쪽 위 「슈퍼어드민」이 서버 관리 입구예요.
관리자를 더 두려면 서버의
.env에서WB_SITE_ADMINS=admin@corp.local,ops@corp.local처럼 쉼표로 이어 적고docker compose up -d를 하세요. 해당 이메일로 이미 가입돼 있으면 다음 로그인부터 관리자가 돼요.
2. 관리 › 온프렘
오른쪽 위 슈퍼어드민 → 온프렘으로 들어가면 서버 상태가 한 화면에 모여 있어요.
온프렘 서버 관리 — 라이선스, 구성 요소, LLM 연결, 외부 통신 허용 목록, 최근 차단된 통신 순서예요.
라이선스
라이선스 칸 — 상태(정상·유예·만료)·만료일·좌석 사용량이 보여요. 새 라이선스는 여기 붙여넣기만 하면 즉시 적용돼요(재시작 없음).
- 정상이면 아무것도 안 해도 돼요. 유예는 만료 뒤 14일 동안 경고만 띄우는 상태, 만료는 새 가입·문서 가져오기·AI 답변이 멈춘 상태예요. 문서 열람·검색·편집은 어떤 상태에서도 계속돼요.
- 좌석은 사람 계정 수예요. 꽉 차면 새 가입이 막혀요. 안 쓰는 계정을 정리하거나 좌석을 늘려 주세요.
- 문서 파서 라이선스는 파일이에요. 바꿀 땐
license/license.json을 교체하고docker compose restart docparser.
구성 요소
구성 요소 — 문서 파서와 임베딩 서버가 「연결됨」이어야 문서 가져오기가 돼요. LLM은 연결하기 전엔 「연결 안 함」이 정상이에요.
「응답 없음」이 보이면 docker compose ps로 컨테이너 상태를 확인하고, docker compose logs docparser(또는 embedder)로 로그를 보세요. 문서 파서는 첫 부팅에 1~2분, 임베딩 서버는 모델을 읽는 데 30초~2분쯤 걸려요.
외부 통신 허용 목록
온프렘 판은 기본으로 외부에 연결을 열지 않아요. 사설망(10.x·172.16~31.x·192.168.x)·루프백·같은 compose 안의 서비스 이름은 늘 허용되고, 그 밖의 호스트는 여기 적은 것만 나가요(한 줄에 하나, *.corp.example.com 같은 와일드카드 가능). 차단된 시도는 맨 아래 「최근 차단된 외부 통신」에 남아요.
- URL 가져오기를 허용할 사내 웹 호스트 — 사내 위키·게시판 주소를 문서로 가져오려면 그 호스트를 여기 적어요. 사설 IP 주소라면 적지 않아도 돼요.