Linux에 설치하기

SetFN 스페이스빌더를 Linux 호스트에서 직접 실행하는 방법을 안내합니다. 아래 예시는 Ubuntu 계열 배포판을 기준으로 하며, 다른 배포판에서는 패키지 이름과 설치 명령이 다를 수 있습니다.

시작하기 전에

• 필수 라이브러리를 처음 설치할 때만 sudo 권한 필요
• 서비스 데이터와 향후 업로드할 파일을 저장할 충분한 디스크 공간
• 다른 기기에서 접속할 경우 서버 포트에 대한 방화벽 접근 권한

스페이스빌더 실행에는 sudo 권한이 필요하지 않습니다. 일반 사용자 계정으로 실행하세요.

GPU 서버와 AI 워크스테이션

일반 Linux PC와 서버뿐 아니라 NVIDIA DGX Spark, ASUS Ascent GX10, Dell Pro Max with GB10, HP ZGX Nano AI Station, Lenovo ThinkStation PGX, MSI EdgeXpert 같은 GB10 기반 개인용 AI 시스템도 Linux 호스트로 활용할 수 있습니다. 이러한 장비는 로컬 AI 모델 실행과 지식 인덱싱처럼 GPU를 사용하는 작업에 적합합니다.

장비마다 CPU 아키텍처와 Linux 배포판, NVIDIA 드라이버, AI 런타임 지원 범위가 다릅니다. 설치하기 전에 스페이스빌더 설치 파일과 사용할 AI 런타임이 해당 환경을 지원하는지 확인하세요.

Full 간편 설치 (준비 중)

설치 파일 다운로드

다운로드 페이지에서 Linux 설치 파일을 다운로드합니다.

다운로드한 파일에 실행 권한을 부여합니다.

chmod +x ~/SetFnSpaceBuilder

필수 라이브러리 설치

스페이스빌더는 이미지 분석과 미리보기 생성을 위해 컴퓨터에 설치된 프로그램(라이브러리)을 함께 사용합니다. Ubuntu 24.04 이상에서는 다음 패키지를 먼저 설치하세요.

sudo apt update
sudo apt install -y \
  libvips42t64 libvips-tools \
  libheif1 libheif-plugin-libde265 \
  libglib2.0-0

권장 기능 패키지 설치

스페이스빌더 서버는 업로드된 파일의 OCR, PDF 분석, 문서 미리보기와 형식 변환도 직접 처리합니다. 다음 패키지가 없어도 서버의 기본 기능은 실행되지만, 관련 파일을 처리할 때 일부 기능이 제한되거나 사용할 수 있는 변환 엔진이 줄어듭니다.

OCR과 문서 변환 기능을 모두 사용하려면 다음 패키지를 함께 설치하는 것을 권장합니다.

sudo apt install -y \
  tesseract-ocr tesseract-ocr-kor tesseract-ocr-jpn \
  poppler-utils mupdf-tools \
  libreoffice pandoc

설치 상태는 다음 명령으로 확인할 수 있습니다.

vips --version
vips list classes | grep -i heif
tesseract --version
tesseract --list-langs
pdftotext -v
mutool -v
libreoffice --version
pandoc --version

설치 프로그램 실행

설치 파일을 실행합니다.

./SetFnSpaceBuilder

설치 프로그램은 기본적으로 18510 포트에서 초기 설정 페이지를 엽니다. 해당 포트를 다른 프로그램이 사용 중이면 사용 가능한 다음 포트를 자동으로 선택하므로, 항상 터미널에 출력된 주소로 접속하세요.

브라우저에 초기 설정 페이지가 열리면 이용 약관을 확인하고 동의한 뒤 관리자 계정과 서비스 환경을 구성합니다. 자세한 입력 항목과 주의사항은 초기 설정에서 확인하세요.

컴퓨터를 켤 때 자동으로 시작하기

초기 설정을 마쳤다면 스페이스빌더가 항상 실행되도록 자동 시작을 설정하는 것을 권장합니다. 자동 시작을 설정하면 다음과 같이 동작합니다.

• 실행한 터미널을 닫아도 스페이스빌더가 계속 작동합니다.
• 컴퓨터를 끄고 다시 켜도 스페이스빌더가 자동으로 시작됩니다.
• 스페이스빌더가 오류로 종료되면 자동으로 다시 시작됩니다.

Linux에서는 항상 실행할 프로그램을 systemd라는 기본 관리 기능에 등록합니다. 아래 명령을 순서대로 따라 하면 됩니다.

1. 내 사용자 이름과 파일 위치 확인

다음 두 명령을 한 줄씩 실행합니다.

whoami

realpath ~/SetFnSpaceBuilder

• whoami는 현재 로그인한 사용자 이름을 보여줍니다.
• realpath는 스페이스빌더 실행 파일의 정확한 위치를 보여줍니다.

출력된 내용은 다음 단계에서 사용하므로 메모해 두세요.

2. 자동 시작 설정 파일 만들기

스페이스빌더가 현재 터미널에서 실행 중이라면, Ctrl+C를 눌러 먼저 종료합니다. 다음 명령으로 자동 시작 설정 파일을 엽니다.

sudo nano /etc/systemd/system/setfn-space-builder.service

다음 내용을 붙여 넣습니다. 모든 <사용자>를 1단계에서 확인한 사용자 이름으로 바꾸고, ExecStart에는 확인한 실행 파일 위치를 입력하세요.

[Unit]
Description=SetFN SpaceBuilder
Wants=network-online.target
After=network-online.target

[Service]
Type=simple
User=<사용자>
WorkingDirectory=/home/<사용자>
Environment=HOME=/home/<사용자>
ExecStart=/home/<사용자>/SetFnSpaceBuilder
Restart=on-failure
RestartSec=5
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target

nano에서는 Ctrl+O, Enter를 눌러 저장한 뒤 Ctrl+X로 종료합니다.

3. 자동 시작 켜기

다음 명령을 한 줄씩 실행합니다. 첫 번째 명령은 작성한 설정을 Linux에 알리고, 두 번째 명령은 스페이스빌더를 지금 시작하면서 다음 부팅부터 자동으로 시작되게 합니다.

sudo systemctl daemon-reload

sudo systemctl enable --now setfn-space-builder

정상적으로 실행되었는지 확인합니다.

systemctl status setfn-space-builder

화면에 active (running)이 표시되면 자동 시작 설정이 완료된 것입니다. q를 눌러 상태 화면을 닫을 수 있습니다.

4. 실행되지 않을 때 원인 확인

active (running)이 표시되지 않거나 스페이스빌더에 접속할 수 없다면 다음 명령으로 최근 기록을 확인합니다.

journalctl -u setfn-space-builder -n 100 --no-pager

실행 과정을 실시간으로 확인하려면 다음 명령을 사용합니다. 확인을 마치면 Ctrl+C로 종료합니다.

journalctl -u setfn-space-builder -f

자동 시작 관리 명령

자동 시작 설정 파일의 내용을 수정했다면 sudo systemctl daemon-reload를 실행한 뒤 스페이스빌더를 다시 시작해야 변경 내용이 적용됩니다.