Linux에 설치하기

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

시작하기 전에

• 패키지 설치와 자동 시작 설정에 사용할 sudo 권한
• 서비스 데이터와 앞으로 업로드할 파일을 저장할 디스크 공간
• 다른 기기에서 접속한다면 서버 포트의 방화벽 설정 권한

스페이스빌더 자체는 sudo 없이 일반 사용자 계정으로 실행합니다.

GPU 서버와 AI 워크스테이션

NVIDIA DGX Spark, ASUS Ascent GX10 같은 GB10 기반 개인용 AI 시스템도 Linux 호스트로 사용할 수 있습니다. 이런 장비는 로컬 AI 모델 실행과 지식 인덱싱처럼 GPU를 쓰는 작업에 적합합니다.

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

Full 간편 설치 (준비 중)

설치 파일 다운로드

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

다운로드한 파일에 실행 권한을 부여합니다. 이 문서의 명령은 파일을 홈 폴더(~)에 둔 경우를 기준으로 합니다.

chmod +x ~/setfn-spacebuilder

필수 라이브러리 설치

스페이스빌더는 이미지 분석과 미리보기 생성에 시스템 라이브러리를 사용합니다. 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 \
  libreoffice pandoc

설치 결과는 다음 명령으로 확인합니다.

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

설치 프로그램 실행

설치 파일을 실행합니다.

./setfn-spacebuilder

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

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

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

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

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

Linux에서는 계속 실행할 프로그램을 systemd 서비스로 등록합니다. 아래 순서대로 진행합니다.

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

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

whoami

realpath ~/setfn-spacebuilder

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

출력된 값은 다음 단계에서 사용하므로 메모해 둡니다.

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

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

sudo nano /etc/systemd/system/setfn-spacebuilder.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/<사용자>/setfn-spacebuilder
Restart=on-failure
RestartSec=5
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target

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

3. 자동 시작 켜기

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

sudo systemctl daemon-reload

sudo systemctl enable --now setfn-spacebuilder

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

systemctl status setfn-spacebuilder

active (running)이 표시되면 자동 시작 설정이 끝난 것입니다. q를 눌러 상태 화면을 닫습니다.

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

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

journalctl -u setfn-spacebuilder -n 100 --no-pager

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

journalctl -u setfn-spacebuilder -f

자동 시작 관리 명령

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

관리자 페이지에 로그인할 수 없을 때 계정이나 접속 제한을 복구하는 방법은 명령어로 서버 관리하기를 참고하세요.