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가 적합한지 시나리오별 판단 기준을 제시합니다.

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는 독립 서버 기반 웹 오피스 스위트입니다. 이 차이가 도입 방식, 비용 구조, 개발자 경험 전체를 결정합니다.
오픈소스 웹 오피스의 실제 비용: 라이선스와 TCO를 따져보면
ONLYOFFICE Community Edition은 AGPL v3 오픈소스 라이선스로 배포됩니다. 내부 사용 시에는 무료이지만 SaaS로 서비스하거나 ONLYOFFICE를 포함한 솔루션을 고객에게 제공하면 AGPL v3의 소스 공개 의무가 발생합니다. 무제한 연결, 화이트라벨, 전자서명 등 고급 엔터프라이즈 기능은 유료 상용 에디션에서만 제공됩니다. 여기에 서버 인프라(VM, Docker 호스팅), 운영 인력, 보안 패치 비용이 추가됩니다.
SpreadJS는 개발자 라이선스 기반 상용 제품입니다. 라이선스 비용은 있지만 서버 운영 비용이 없고, 클라이언트에서 직접 실행되므로 사용자가 수만 명으로 늘어나도 서버 스펙을 올릴 필요가 없습니다.

웹 앱에 스프레드시트를 통합하는 방법: 개발자 API 경험 비교
ONLYOFFICE 통합은 Document Server 설치 → API 토큰 발급 → iframe 삽입 → 이벤트 핸들링의 단계를 거칩니다. 네트워크 구성, 방화벽, CORS, 스토리지 연동까지 처리해야 하며, 셀 단위 프로그래밍 제어는 매크로나 플러그인을 별도 개발해야 합니다.
SpreadJS는 CDN 두 줄로 시작합니다.
STEP 1: 라이브러리 참조
STEP 2: HTML 구조
아래 코드가 실행되는 순간 완전한 ERP 구매 현황판이 화면에 나타납니다. 상태별 색상, 집행률 수식, 합계 행까지 — 서버 없이 순수 JavaScript API 호출만으로 구현됩니다.
STEP 3: JavaScript — ERP 구매 현황판 렌더링
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 포함) |

어떤 시나리오에 SpreadJS가 맞고, 언제 ONLYOFFICE를 써야 할까?
기업 도입 결정은 "어떤 시나리오에서 사용하는가"로 귀결됩니다.
SpreadJS가 적합한 경우:
- ✓ ERP·그룹웨어·회계 시스템 내부에 스프레드시트 기능을 직접 내재화할 때
- ✓ 셀 값 변경, 선택, 수식 계산 이벤트를 애플리케이션 로직과 연동해야 할 때
- ✓ xlsx 파일을 서식 그대로 웹에서 열고 편집 후 다시 내보내야 할 때
- ✓ 사용자 수가 많아 서버 스케일 비용을 피하고 싶을 때
- ✓ 화이트라벨 솔루션으로 고객사에 납품하는 SI·솔루션 업체
ONLYOFFICE가 적합한 경우:
- ✓ 사내 클라우드 오피스 포털을 구축하거나 Google Workspace 대체 환경을 만들 때
- ✓ Word·Excel·PowerPoint 전체 오피스 스위트가 필요한 문서 협업 플랫폼
- ✓ 공동 편집(실시간 협업) 기능이 핵심 요구사항일 때
- ✓ 오픈소스 기반의 자체 구축 선호 + AGPL 준수 가능한 내부 시스템
개발자가 자주 묻는 질문
기업 ERP에 엑셀 스프레드시트를 직접 넣으려면 SpreadJS와 ONLYOFFICE 중 무엇을 선택해야 하나요?
ERP 화면 안에 스프레드시트를 임베드하고 셀·수식을 API로 조작해야 한다면 SpreadJS를 선택하세요. ONLYOFFICE는 별도 서버에 오피스 환경을 설치하고 iframe으로 연결하는 방식이라 기존 앱과 긴밀하게 통합하기 어렵습니다.
ONLYOFFICE를 회사 프로젝트에 무료로 사용할 수 있나요? 어떤 경우에 라이선스 비용이 발생하나요?
ONLYOFFICE Community Edition은 AGPL v3 라이선스로 사내 내부 사용만 무료입니다. 고객에게 솔루션을 납품하거나 SaaS로 외부에 제공하면 소스 코드 공개 의무가 발생하고, 무제한 연결·화이트라벨 같은 고급 엔터프라이즈 기능은 별도 상용 에디션이 필요합니다.
React나 Vanilla JS 웹 앱에서 Excel xlsx 파일을 서식 그대로 열고 편집하게 하려면 어떤 라이브러리를 써야 하나요?
SpreadJS를 사용하면 조건부 서식·병합 셀·테마 등 xlsx 서식을 고충실도로 웹에서 그대로 재현할 수 있습니다. 서버 없이 순수 클라이언트 JavaScript로 동작하므로 기존 웹 앱에 별도 백엔드 없이 즉시 통합할 수 있습니다.
SpreadJS는 ONLYOFFICE보다 셀 단위 프로그래밍 제어가 더 자유롭나요? API 차이가 궁금합니다.?
SpreadJS는 셀·행·열·이벤트·수식·서식을 JavaScript API로 완전히 제어할 수 있습니다. ONLYOFFICE는 iframe 기반으로 직접 접근이 제한되어 있어, 세밀한 셀 단위 조작을 하려면 Document Server 플러그인이나 매크로를 별도로 개발해야 합니다.
ONLYOFFICE 같은 오픈소스 웹 오피스를 기업 솔루션에 도입하면 실제로 어떤 제약과 추가 비용이 생기나요?
AGPL v3 라이선스로 인해 솔루션을 외부에 제공하면 전체 소스를 공개해야 합니다. Document Server 운영에는 전용 서버 인프라와 보안 패치를 관리할 인력이 필요하며, 고급 기능을 사용하려면 상용 에디션으로 전환이 불가피합니다.
