SpreadJS 블로그 MESCIUS 기술 블로그 ·

SpreadJS로 웹 앱에 엑셀 스프레드시트 임베드하기: ONLYOFFICE 비교 가이드

웹 앱을 개발하다 보면 '엑셀처럼 동작하는 스프레드시트 화면이 필요해'라는 요구사항을 받게 됩니다. 검색창에 '웹 엑셀 라이브러리'를 입력하면 ONLYOFFICE가 눈에 들어오지만, SpreadJS는 서버 없이 순수 JavaScript만으로 기존 웹 앱 안에 Excel UI를 직접 렌더링하고 셀·수식·이벤트를 API로 완전 제어할 수 있는 프론트엔드 스프레드시트 컴포넌트입니다.

React, Vue, Angular, Vanilla JS 어떤 프레임워크에서도 CDN 한 줄 또는 npm 패키지 하나로 설치하면 엑셀 그리드가 화면에 즉시 렌더링됩니다. 셀 값 읽기·행 삽입·수식 설정·이벤트 바인딩까지 모두 JavaScript API 호출로 처리할 수 있어 ERP, 그룹웨어, BI 대시보드처럼 데이터를 직접 다루는 시스템에 스프레드시트를 내재화할 때 가장 적합합니다.

ONLYOFFICE는 별도 Linux 서버 또는 Docker 컨테이너에 Document Server를 설치하고 iframe으로 앱에 삽입하는 독립형 웹 오피스 스위트입니다. 협업 문서 편집 환경을 빠르게 구축하는 데 강점이 있지만, 기존 앱의 UI 로직과 세밀하게 연동하거나 셀 단위를 프로그래밍 방식으로 조작하려면 별도 플러그인·매크로를 개발해야 합니다.

이 가이드에서는 두 도구의 설계 목적, 라이선스 구조, 개발자 통합 경험, 기능 심도를 항목별로 비교하고, 어떤 프로젝트에 SpreadJS가 적합한지 시나리오별 판단 기준을 제시합니다.

⭐ Key Points
이 글에서 다루는 핵심 내용
01 SpreadJS는 기존 웹 앱에 임베드하는 JS 컴포넌트, ONLYOFFICE는 독립형 웹 오피스 스위트 — 처음부터 설계 목적이 다른 도구입니다
02 ONLYOFFICE는 AGPL v3 라이선스로 외부 서비스 배포 시 소스 공개 의무가 발생하며, 고급 기능은 별도 유료 상용 에디션이 필요합니다
03 SpreadJS는 CDN 한 줄 / npm 한 줄로 기존 앱에 즉시 임베드되며, 셀·행·이벤트를 JavaScript API로 프로그래밍 방식으로 완전 제어할 수 있습니다
04 ERP·그룹웨어 등 기존 앱 안에 스프레드시트를 내재화하고 API로 제어해야 한다면 SpreadJS를, 독립적인 문서 편집 포털 구축이 목표라면 ONLYOFFICE를 선택하세요
SpreadJS로 웹 앱에 엑셀 스프레드시트 임베드하기: ONLYOFFICE 비교 가이드 — 대표 이미지

SpreadJS와 ONLYOFFICE는 왜 다른가? 설계 목적부터 이해하기

ONLYOFFICE와 SpreadJS는 "웹에서 Excel처럼"이라는 공통분모가 있지만 작동 방식이 전혀 다릅니다.

ONLYOFFICE는 독립 서버로 구동되는 웹 오피스 스위트입니다. Docker 컨테이너나 Linux 서버에 Document Server를 설치하고, iframe으로 기존 앱에 삽입합니다. Word·Excel·PowerPoint를 웹에서 편집하는 완결된 오피스 환경을 제공하며, 문서 협업 포털이나 클라우드 오피스 대체 시나리오에 적합합니다.

SpreadJS(스프레드JS) by MESCIUS는 서버 없이 동작하는 순수 JavaScript 스프레드시트 컴포넌트입니다. npm 패키지 하나 또는 CDN 태그 한 줄로 기존 앱 안에 Excel UI를 직접 렌더링하며, 500개 이상의 Excel 호환 수식과 세밀한 API로 셀·행·이벤트·서식을 프로그램으로 완전 제어합니다.

SpreadJS는 ONLYOFFICE와 어떻게 다른가요? SpreadJS는 JavaScript 컴포넌트로 기존 웹 앱에 Excel 기능을 임베드하고, ONLYOFFICE는 독립 서버 기반 웹 오피스 스위트입니다. 이 차이가 도입 방식, 비용 구조, 개발자 경험 전체를 결정합니다.

⭐ IMPORTANT
"어느 것이 더 좋은가"가 아닌 "어느 것이 내 시나리오에 맞는가"가 올바른 질문입니다. 독립 오피스 환경이 목표라면 ONLYOFFICE, 기존 앱 안에 스프레드시트를 내재화하려면 SpreadJS가 적합합니다.

오픈소스 웹 오피스의 실제 비용: 라이선스와 TCO를 따져보면

ONLYOFFICE Community Edition은 AGPL v3 오픈소스 라이선스로 배포됩니다. 내부 사용 시에는 무료이지만 SaaS로 서비스하거나 ONLYOFFICE를 포함한 솔루션을 고객에게 제공하면 AGPL v3의 소스 공개 의무가 발생합니다. 무제한 연결, 화이트라벨, 전자서명 등 고급 엔터프라이즈 기능은 유료 상용 에디션에서만 제공됩니다. 여기에 서버 인프라(VM, Docker 호스팅), 운영 인력, 보안 패치 비용이 추가됩니다.

SpreadJS는 개발자 라이선스 기반 상용 제품입니다. 라이선스 비용은 있지만 서버 운영 비용이 없고, 클라이언트에서 직접 실행되므로 사용자가 수만 명으로 늘어나도 서버 스펙을 올릴 필요가 없습니다.

↗
500+
Excel 호환 수식
xlsx 함수 엔진 내장
↗
0원
서버 인프라 비용
클라이언트 전용 실행
↗
1줄
CDN 설치
즉시 기존 앱에 임베드
ⓘ NOTE
ONLYOFFICE의 실제 비용은 소프트웨어 가격보다 서버 운영·라이선스 준수·운영 인력 비용에 있습니다. SpreadJS의 비용은 라이선스 + 개발 공수이며 운영 인프라 비용은 제로입니다. 장기 TCO는 트래픽·사용자 규모가 커질수록 SpreadJS에 유리해집니다.
오픈소스 웹 오피스의 실제 비용: 라이선스와 TCO를 따져보면 — SpreadJS 개념도

웹 앱에 스프레드시트를 통합하는 방법: 개발자 API 경험 비교

ONLYOFFICE 통합은 Document Server 설치 → API 토큰 발급 → iframe 삽입 → 이벤트 핸들링의 단계를 거칩니다. 네트워크 구성, 방화벽, CORS, 스토리지 연동까지 처리해야 하며, 셀 단위 프로그래밍 제어는 매크로나 플러그인을 별도 개발해야 합니다.

SpreadJS는 CDN 두 줄로 시작합니다.

STEP 1: 라이브러리 참조

STEP 2: HTML 구조

아래 코드가 실행되는 순간 완전한 ERP 구매 현황판이 화면에 나타납니다. 상태별 색상, 집행률 수식, 합계 행까지 — 서버 없이 순수 JavaScript API 호출만으로 구현됩니다.

STEP 3: JavaScript — ERP 구매 현황판 렌더링

실행 결과
💡 TIP
위 데모에서 주목할 점은 backColor , foreColor , formatter , setFormula 를 셀 단위로 자유롭게 조합할 수 있다는 것입니다. ONLYOFFICE에서 동일한 결과를 내려면 Document Server의 매크로 API를 별도 개발해야 합니다.

xlsx 서식 보존과 수식 엔진, 이벤트 API를 어떻게 구현하나?

SpreadJS는 500개 이상의 Excel 호환 수식을 지원하며 xlsx 포맷 서식을 고충실도로 보존합니다. 조건부 서식, 셀 병합, 테마, 피벗 테이블, 차트까지 Excel 파일을 열었을 때의 모습 그대로 웹에서 재현됩니다.

비교 항목 SpreadJS ONLYOFFICE
아키텍처 클라이언트 전용 JS 컴포넌트 서버 + iframe 임베드
설치 방법 npm / CDN Docker/Linux Document Server
라이선스 상용 (개발자 라이선스) AGPL v3(Community) / 상용(Enterprise)
SaaS 배포 시 라이선스 비용만 소스 공개 의무 또는 상용 라이선스
xlsx 서식 보존 고충실도 일반 수준
수식 지원 수 500개 이상 대부분의 기본 수식
셀 단위 API 제어 ✓ 완전 제어 제한적 (매크로/플러그인 필요)
커스텀 셀 타입 ✓ ✗
서버 인프라 비용 없음 VM/컨테이너 필요
기존 앱 통합 완전 임베드 iframe 방식
실시간 협업 별도 구현 필요 기본 지원
독립 오피스 환경 해당 없음 ✓ (Word·Excel·PPT 포함)
⚠ WARNING
ONLYOFFICE의 iframe 방식은 기존 앱의 CSS·이벤트 버블링과 충돌할 수 있습니다. 특히 모달·팝업·키보드 단축키 충돌 이슈가 복잡한 SPA 환경에서 자주 보고됩니다.
xlsx 서식 보존과 수식 엔진, 이벤트 API를 어떻게 구현하나? — SpreadJS 개념도

어떤 시나리오에 SpreadJS가 맞고, 언제 ONLYOFFICE를 써야 할까?

기업 도입 결정은 "어떤 시나리오에서 사용하는가"로 귀결됩니다.

SpreadJS가 적합한 경우:

  • ✓ ERP·그룹웨어·회계 시스템 내부에 스프레드시트 기능을 직접 내재화할 때
  • ✓ 셀 값 변경, 선택, 수식 계산 이벤트를 애플리케이션 로직과 연동해야 할 때
  • ✓ xlsx 파일을 서식 그대로 웹에서 열고 편집 후 다시 내보내야 할 때
  • ✓ 사용자 수가 많아 서버 스케일 비용을 피하고 싶을 때
  • ✓ 화이트라벨 솔루션으로 고객사에 납품하는 SI·솔루션 업체

ONLYOFFICE가 적합한 경우:

  • ✓ 사내 클라우드 오피스 포털을 구축하거나 Google Workspace 대체 환경을 만들 때
  • ✓ Word·Excel·PowerPoint 전체 오피스 스위트가 필요한 문서 협업 플랫폼
  • ✓ 공동 편집(실시간 협업) 기능이 핵심 요구사항일 때
  • ✓ 오픈소스 기반의 자체 구축 선호 + AGPL 준수 가능한 내부 시스템
⭐ BEST PRACTICE
많은 기업이 두 제품을 동시에 활용합니다. 사내 문서 협업은 ONLYOFFICE, ERP·BI 내 스프레드시트 기능은 SpreadJS로 역할을 분리하면 각 제품의 강점을 최대한 활용할 수 있습니다.

개발자가 자주 묻는 질문

Q01

기업 ERP에 엑셀 스프레드시트를 직접 넣으려면 SpreadJS와 ONLYOFFICE 중 무엇을 선택해야 하나요?

ERP 화면 안에 스프레드시트를 임베드하고 셀·수식을 API로 조작해야 한다면 SpreadJS를 선택하세요. ONLYOFFICE는 별도 서버에 오피스 환경을 설치하고 iframe으로 연결하는 방식이라 기존 앱과 긴밀하게 통합하기 어렵습니다.

Q02

ONLYOFFICE를 회사 프로젝트에 무료로 사용할 수 있나요? 어떤 경우에 라이선스 비용이 발생하나요?

ONLYOFFICE Community Edition은 AGPL v3 라이선스로 사내 내부 사용만 무료입니다. 고객에게 솔루션을 납품하거나 SaaS로 외부에 제공하면 소스 코드 공개 의무가 발생하고, 무제한 연결·화이트라벨 같은 고급 엔터프라이즈 기능은 별도 상용 에디션이 필요합니다.

Q03

React나 Vanilla JS 웹 앱에서 Excel xlsx 파일을 서식 그대로 열고 편집하게 하려면 어떤 라이브러리를 써야 하나요?

SpreadJS를 사용하면 조건부 서식·병합 셀·테마 등 xlsx 서식을 고충실도로 웹에서 그대로 재현할 수 있습니다. 서버 없이 순수 클라이언트 JavaScript로 동작하므로 기존 웹 앱에 별도 백엔드 없이 즉시 통합할 수 있습니다.

Q04

SpreadJS는 ONLYOFFICE보다 셀 단위 프로그래밍 제어가 더 자유롭나요? API 차이가 궁금합니다.?

SpreadJS는 셀·행·열·이벤트·수식·서식을 JavaScript API로 완전히 제어할 수 있습니다. ONLYOFFICE는 iframe 기반으로 직접 접근이 제한되어 있어, 세밀한 셀 단위 조작을 하려면 Document Server 플러그인이나 매크로를 별도로 개발해야 합니다.

Q05

ONLYOFFICE 같은 오픈소스 웹 오피스를 기업 솔루션에 도입하면 실제로 어떤 제약과 추가 비용이 생기나요?

AGPL v3 라이선스로 인해 솔루션을 외부에 제공하면 전체 소스를 공개해야 합니다. Document Server 운영에는 전용 서버 인프라와 보안 패치를 관리할 인력이 필요하며, 고급 기능을 사용하려면 상용 에디션으로 전환이 불가피합니다.

MESCIUS SpreadJS

지금 바로 SpreadJS 를 무료로 체험해 보세요

30일 무료 체험판으로 모든 기능을 직접 확인하세요.

SpreadJS 무료 체험판 다운로드