MaxKB는 회사 문서를 질의응답 입구로 바꿔 주는 오픈소스 시스템입니다. 제품 매뉴얼, 사내 규정, 도움말 문서를 넣으면 직원이나 고객이 그대로 질문하고, 시스템이 관련 조각을 검색해 대형 모델이 답을 구성합니다. 중국어 화면, 간단한 설치, 로컬 모델 연결이 가능해 검색 코드를 짤 팀을 먼저 꾸리지 않아도 시작할 수 있다는 점이 퍼진 이유입니다.
공식 저장소 정보
플랫폼은 GitHub, 조직 이름은 1Panel-dev, 프로젝트 이름은 MaxKB이며, 서버 패널 1Panel을 만든 FIT2CLOUD(飞致云)가 유지보수합니다. 라이선스는 GPLv3입니다. 기술 구성은 저장소에 명시돼 있습니다. 프런트엔드는 Vue.js, 백엔드는 Python과 Django, 프레임워크 층은 LangChain, 데이터베이스는 PostgreSQL에 pgvector 확장입니다. 커뮤니티판 외에 기업용 판이 있으며 일부 고급 기능은 커뮤니티판에 없으므로, 필요한 기능이 어느 판에 있는지 먼저 확인해야 합니다.
수고를 덜어 주는 부분
가장 큰 장점은 설치입니다. 공식 Docker 명령 한 줄로 서비스를 올릴 수 있고, 1Panel 앱스토어에서도 설치할 수 있습니다. 문서를 올리면 분할과 벡터화가 자동으로 이뤄지고, 질의응답 화면과 외부 사이트에 붙이는 창도 준비돼 있어 코드 없이 동작하는 지식베이스 질의응답을 기존 사이트나 내부 시스템에 붙일 수 있습니다. 모델은 고정되지 않아 클라우드 각사의 인터페이스도, Ollama 등으로 로컬에서 돌리는 오픈 모델도 연결할 수 있어, 사내 자료를 밖으로 내보낼 수 없는 경우 이 길이 통합니다. 워크플로우 구성도 들어 있어 조건 판단과 도구 호출을 앞뒤에 붙일 수도 있습니다.
배포 비용과 진짜 함정
첫 번째 계산서는 소프트웨어 본체가 아니라 모델에서 나옵니다. 본체는 무료지만 답의 질은 연결한 대화 모델과 임베딩 모델이 결정합니다. 클라우드 인터페이스는 호출 비용이 계속 들고, 로컬 모델은 실제로 돌릴 그래픽 카드가 필요하며, 문서량이 많으면 첫 벡터화에서 한도와 시간을 소모합니다. 둘째, 문서 품질이 상한을 정합니다. 스캔본 PDF, 서식이 깨진 표, 신구 버전이 섞인 규정을 넣으면 답이 모호해지거나 서로 모순됩니다. 공개 전 문서 정리와 버전 분리는 생략할 수 없는 수작업입니다. 셋째, 커뮤니티판과 기업용 판의 경계를 일찍 파악하세요. 권한, 감사, 동시 접속처럼 기업이 실제로 신경 쓰는 기능이 기업용 판에만 있다면, 업무가 의존하기 시작한 뒤의 이전은 처음에 평가하는 것보다 훨씬 비쌉니다. 넷째, 운영은 홍보만큼 제로가 아닙니다. 컨테이너 업데이트, 데이터베이스 백업, 공개한 질의응답 입구를 노리는 악의적 질문에 대한 대비가 필요하고, 프롬프트 인젝션과 권한 분리는 직접 챙겨야 합니다.
맞는 쪽은 문서가 비교적 정돈돼 있고 부서 안에서 먼저 효과를 검증하려는 중소 팀, 그리고 자료를 내부망 밖으로 낼 수 없어 서버를 직접 유지할 의사가 있는 조직입니다. 맞지 않는 쪽은 문서가 엉망인데 아무도 정리하지 않으면서 설치만으로 정확해지길 바라는 팀, 그리고 답의 품질을 핵심 상품으로 파는 제품 쪽입니다. 후자는 검색과 평가 과정을 직접 쥐어야 해서 범용 박스형 방안의 천장에 금방 닿습니다.
