WebAssembly(Wasm)웹어셈블리 · WebAssembly
브라우저와 서버의 실행 엔진이 먼저 검증한 뒤 격리된 선형 메모리 안에서 실행하는, 스택 기계용 이식형 바이너리 명령 형식이다. C · C++ · Rust 같은 언어를 컴파일해 만들고, 바깥 능력은 호스트가 import 로 건넨 것만 쓴다.
1요약
- WebAssembly 는 W3C 가 2019년 12월 Core 1.0 을 권고로 정한 스택 기계용 바이너리 형식이고, 그 위에서 브라우저의 C · C++ · Rust 라이브러리와 서버 런타임의 WASI 응용 · 플러그인이 돈다.
- 이것이 없으면 기존 C · C++ 코드를 웹에 올릴 때 JavaScript 텍스트(asm.js)로 바꿔 내려받고 파싱해야 했는데, Wasm 은 적재 때 검증 한 번으로 안전성을 확인한 바이너리를 기계어로 컴파일해 돌린다 — 2.0 에 더한 SIMD 명령만 236개로 그 전 전체 명령 수보다 많다(Wasm 2.0 발표).
- 「Wasm 이 안 돈다」는 어느 경계에서 멈췄는가로 가른다 — CompileError 는 모듈 · 엔진 판, LinkError 는 import 목록, RuntimeError 는 선형 메모리 · trap, 파일 · 소켓 실패는 호스트가 준 권한이다.
2등장 배경
2010년대 초 웹에서 C · C++ 로 쓴 게임 엔진 · 코덱을 돌리려면 브라우저 플러그인을 깔거나 코드를 JavaScript 로 옮겨야 했다. 컴파일러가 JavaScript 의 엄격한 부분 집합(asm.js)을 뽑아 속도는 올렸지만, 결과물이 텍스트라 크기와 파싱 시간이 남았다.
2015년 6월 네 브라우저 엔진 개발자들이 W3C 커뮤니티 그룹에서 «크기와 적재 시간에 맞춘 이식형 형식»을 asm.js 의 다음 단계로 공개했다(Wagner 2015). 2017년 2월 28일 네 브라우저가 JS API · 바이너리 형식 · 참조 인터프리터에 합의해 미리보기를 끝냈고(CG 합의 메일 2017), 2019년 12월 5일 Core 1.0 이 HTML · CSS · JavaScript 다음 «네 번째 웹 언어»로 권고가 됐다(W3C 보도자료 2019).
그 뒤 판은 상시 갱신 방식이다 — 2.0(SIMD 128비트 · 대량 메모리 · 다중 값 · 참조형 · 2025-03 완료 발표)과 3.0(64비트 주소 · 다중 메모리 · GC · 예외 처리 · 꼬리 호출 · 2025-09-17)이 이어졌다. 서버 쪽은 WASI 가 0.1(POSIX 형) → 0.2(2024-01 · 컴포넌트 모델 · WIT) → 0.3(2026-06-11 · 비동기 내장)으로 넓혀, Wasm 은 이제 호스트를 가리지 않는 실행 형식이다(WASI 판 기록).
3쉽게 이해하기 — 표준 기호 조립 설명서와 유리 작업실
부품 공장 설계자가 가구 조립 순서를 어느 나라 작업장에서도 읽히는 표준 기호 설명서 한 부로 적어 보낸다. 작업장의 검수관은 기호가 모두 규격대로인지 먼저 보고, 통과하면 기술자가 유리 작업실 안에서 설명서대로 조립한다. 작업실 안에는 자기 작업대 하나뿐이라, 바깥 공구가 필요하면 창구에 적어 내고 관리인이 허락한 것만 건네받으며, 작업대 밖을 짚는 순간 작업이 멈춘다.
그림 1 · 공장이 쓴 설명서 한 부가 검수를 거쳐 유리 작업실에 들어가고, 바깥 공구는 관리인이 창구로 건넬 때만 쓰며, 작업대 밖을 짚으면 바로 멈춘다.
그림 2 · 같은 신청서를 내도 관리인이 무엇을 건네는가에 따라 할 수 있는 일이 달라지듯, 같은 모듈도 런타임이 준 능력만큼만 파일을 연다.
| 비유 속 역할 | 실제 이름 | 실제로 하는 일 |
|---|---|---|
| 부품 공장 설계자 | 컴파일러(clang · rustc · Emscripten) | 소스 코드를 .wasm 바이너리로 번역한다 |
| 표준 기호 설명서 | 모듈(.wasm) | 형 · 함수 · 메모리 · export · 코드 절을 담은 바이너리 |
| 검수관 | 검증 | 실행 전에 모든 명령의 형을 확인하고 어긋나면 CompileError |
| 유리 작업실 | 인스턴스 · 샌드박스 | 모듈 + 자기 상태 · 호스트 메모리를 직접 보지 못한다 |
| 작업대 | 선형 메모리 | 64 KiB 페이지 단위로 늘리는 바이트 배열 |
| 창구와 관리인 | import · 호스트 | 브라우저는 JS 함수를, 서버 런타임은 WASI 인터페이스를 건넨다 |
| 작업 중지 | trap | 범위 밖 접근 · 0 나누기에서 즉시 멈추고 RuntimeError |
| 어느 나라 작업장 | 엔진(브라우저 · 서버 런타임) | 같은 바이너리를 그 CPU 의 기계어로 컴파일해 돌린다 |
⚠ 비유가 맞지 않는 곳: 검수관은 설명서가 규격대로 적혔는지만 볼 뿐, 기술자가 작업대 위에서 엉뚱한 칸을 덮는 것은 막지 않는다 — Wasm 도 선형 메모리 «안»의 덮어쓰기는 막지 않고 «밖»으로 나가는 것만 막는다. 또 실제 엔진은 설명서를 읽으며 조립하지 않고 먼저 기계어로 컴파일한다.
4구조 — 모듈 · 인스턴스 · 호스트 경계
모듈은 형 · import · 함수 · 테이블 · 메모리 · 전역 · export · 코드 절로 이루어진 바이너리이고, 첫 8바이트는 magic 00 61 73 6d(\0asm)와 판 번호 1 이다(Wasm Core 3.0 바이너리 형식). 엔진은 모듈을 검증 · 컴파일한 뒤 import 를 채워 인스턴스를 만들고, 값 형이 숫자 · 벡터 · 참조뿐이라 문자열은 메모리 주소와 길이 두 숫자로 넘긴다(컴포넌트 모델 문서).
그림 3 · 모듈은 엔진 안에서 검증 · 컴파일을 거쳐 인스턴스가 되고, 인스턴스는 호스트가 import 로 준 것만 쓰고 export 로만 내놓는다.
| 요소 | 역할 | 값 · 근거 |
|---|---|---|
| 함수 · 코드 | 스택 기계 명령 실행 | 값 형 = i32 · i64 · f32 · f64 · v128 · 참조형(Wasm Core 3.0 형) |
| 선형 메모리 | 주소 0부터의 바이트 배열 | 페이지 = 65,536바이트(Core 실행 · 메모리 인스턴스) · 32비트 주소 4 GiB · memory64 이론 16 EB · 브라우저 16 GB 제한(Wasm 3.0 발표) |
| 테이블 | 함수 참조를 담아 간접 호출 | 함수 주소를 메모리 바이트로 두지 않음(MDN Wasm 개념) |
| 전역 | 모듈 전체에서 쓰는 값 | 변경 가능 · 불가를 형에 표시 |
| import | 호스트가 채워야 할 함수 · 메모리 | 이름 두 단계(모듈 · 이름)와 형이 맞아야 연결 · 아니면 LinkError(Wasm JS API) |
| export | 호스트에 내놓는 함수 · 메모리 | JS 쪽에서는 보통 함수 · Memory 객체로 보임(MDN Wasm 개념) |
| 검증 | 실행 전 형 검사 | 실패 = CompileError · WebAssembly.validate = false(Wasm JS API) |
| trap | 실행 중 즉시 중단 | 범위 밖 메모리 접근 · 0 나누기 → RuntimeError(Wasm 보안 문서) |
🔑 Wasm 코어는 파일 · 화면 · 망을 하나도 모른다 — 바깥 능력은 호스트가 import 로 건넨 함수뿐이라, 같은 모듈의 권한은 실행하는 쪽이 정한다(WASI 소개 「능력 기반 샌드박스」).
5동작 — 74바이트 모듈 하나의 적재 · 실행 · trap
직접 실행 — Node.js v24.11.1(V8 13.6) · 바이너리는 아래 텍스트 형식(WAT)을 손으로 인코딩 · 메모리는 최소 1 · 최대 2 페이지로 정한 설명용 모듈이다.
(module
(func (export "add") (param i32 i32) (result i32)
local.get 0 local.get 1 i32.add)
(func (export "load") (param i32) (result i32)
local.get 0 i32.load)
(memory (export "mem") 1 2))
- 이 모듈을 바이너리로 옮기면 74바이트다 — magic · 판 8바이트 뒤에 형 · 함수 · 메모리 · export · 코드 다섯 절이 온다.
WebAssembly.가 true 다. 시험 삼아 add 본문의validate(bytes) i32.add(0x6a) 한 바이트를i64.add(0x7c)로 바꾸면 false 이고,new WebAssembly.은 CompileError 「i64.add[0] expected type i64, found local.get of type i32」로 거부한다.Module() - 정상 모듈을 import 없이 인스턴스로 만들면 export 셋(add · load · mem)이 JS 객체로 보이고,
mem.buffer는 65,536바이트(1 페이지)다. add(2, 3)= 5 ·add(2147483647, 1)= −2147483648 — i32 덧셈은 2^32 로 나눈 나머지라 넘침에도 예외가 없다(Wasm Core 3.0 수치 연산).- JS 가
new Int32Array(mem.로 쓰고buffer) [0] = 42 load(0)이 42 를 읽는다 — 두 쪽이 같은 바이트 배열을 본다. load(65532)는 마지막 4바이트를 읽어 0 이고,load(65533)은 끝을 1바이트 넘어 trap — JS 에는 RuntimeError 「memory access out of bounds」로 온다.mem.grow(1)이 옛 크기 1 을 돌려주고 버퍼가 131,072바이트가 되며, 같은load(65533)이 이제 0 을 읽는다.- 한 번 더
mem.grow(1)하면 최대 2 페이지를 넘어 RangeError 「Maximum memory size exceeded」다(Wasm JS API · Memory.grow).
그림 4 · 형 오류는 인스턴스가 생기기 전에 걸러지고, 범위 밖 주소는 실행 중 trap 으로 멈추며, 메모리 증가는 최대 페이지에서 거부된다.
그림 5 · i32 읽기는 «주소 + 4 ≤ 메모리 크기»일 때만 통과하므로, 같은 65,533번지도 grow 전에는 trap 이고 grow 뒤에는 통과한다.
🔑 검증은 적재 때 한 번, 경계 검사는 접근 때마다다 — 형이 어긋난 코드는 인스턴스가 생기기 전에 CompileError 로, 범위 밖 주소는 실행 중 trap 으로 갈린다.
6비교 — JavaScript · 컨테이너 · 네이티브 실행 파일과의 차이
| 기준 | Wasm 모듈 | JavaScript | 컨테이너 | 네이티브 실행 파일 |
|---|---|---|---|---|
| 배포 형식 | CPU 와 무관한 스택 기계 바이너리 | 소스 텍스트 | 파일 계층을 묶은 이미지 · CPU 별 빌드 | CPU · OS 별 기계어 |
| 격리 단위 | 인스턴스(자기 선형 메모리) | 출처(same-origin) · 권한 정책 | 커널 네임스페이스 · cgroup | 프로세스 · OS 계정 권한 |
| 바깥 접근 | import 로 받은 함수만 | 웹 API · DOM 직접 | 시스템 호출(허용 목록으로 좁힘) | 시스템 호출 전부 |
| 메모리 안전 | 메모리 밖은 trap · 안의 덮어쓰기는 막지 않음 | GC · 경계 검사 | 응용 언어에 따름 | 응용 언어에 따름 |
| 맞는 일 | 계산이 무거운 C · C++ · Rust 코드 · 플러그인 | 화면 · 이벤트 · DOM | 기존 리눅스 응용 전체 | OS 에 붙는 도구 · 드라이버 |
분석화면 조작은 JavaScript 에 두고 계산 핵심만 Wasm 으로 떼며, 파일 시스템 · 프로세스를 그대로 쓰는 기존 서버 응용은 컨테이너가 맞다. 근거는 표의 「바깥 접근」 행 — Wasm 은 DOM 을 직접 만지지 못하고(MDN Wasm 개념) 서버에서도 WASI 가 준 능력만 쓴다(WASI 소개).
7실무 진단 — 적재 · 연결 · 실행 · 권한 경계 가르기
분석오류 이름이 멈춘 단계를 알려 준다. TypeError · CompileError 는 적재, LinkError 는 import 연결, RuntimeError 는 실행 중 trap 이므로(Wasm JS API · Wasm Web API) 이름부터 보고 그 단계의 자료만 대조한다.
| # | 증상 | 의심 원인 | 단계 | 확인 명령 · 자료 | 판정 기준(근거) |
|---|---|---|---|---|---|
| 1 | instantiateStreaming 이 TypeError | 서버가 Content-Type 을 다르게 보냄 | 적재 · HTTP | curl -sI https: | 값이 정확히 application/wasm · 매개 변수 없음(Wasm Web API 2절) |
| 2 | CompileError | 엔진이 모르는 기능(GC · memory64)으로 빌드 · 바이트 손상 | 검증 | wasm-tools validate app. | 기능을 끈 빌드가 통과하면 엔진 판 문제(wasm-tools README) |
| 3 | LinkError | import 이름 · 형 불일치 | 연결 | WebAssembly. | 목록의 모듈 · 이름 · 종류가 import 객체와 같아야 함(Wasm JS API) |
| 4 | RuntimeError 「out of bounds」 | 주소 계산 오류 · 메모리 부족 | 실행 | mem.buffer.byteLength · 브라우저 디버거 | 주소 + 읽는 바이트 > 메모리 크기면 trap(Wasm 보안 문서) |
| 5 | 서버에서 파일 열기 실패 | 런타임이 디렉터리 능력을 주지 않음 | 호스트 권한 | wasmtime run --dir . app. | 지정한 디렉터리를 넣은 뒤 열리면 권한 문제(Wasmtime CLI) |
적재부터 보는 까닭은 응답 형식이 틀리면 모듈이 엔진에 닿지도 않기 때문이다. 그다음 검증 · 연결을 보고, 둘 다 통과했는데 멈추면 그때 실행 중 주소와 메모리 크기를 견준다. 다른 서버 런타임도 디렉터리 능력을 넘기는 옵션이 따로 있으므로 그 런타임 문서에서 같은 기능을 찾는다.
8시험 대비
시험에서는 JavaScript 와 견주어 실행 방식 · 보안 모델을 묻는 정의 · 특징형과, WASI · 컴포넌트 모델로 서버 · 엣지까지 넓어지는 흐름을 묻는 동향 · 발전형이 나올 수 있다. 다른 답안과 차이를 내는 한 가지는 그림 5 의 경계 규칙(주소 + 4 ≤ 메모리 크기)과 오류 이름 셋으로 단계를 가르는 설명이다.
- 개요 — 정의 · W3C Core 1.0(2019-12) → 2.0 · 3.0 상시 갱신 · 스택 기계 바이너리 · 이식 · 안전 · 간결
- 구조 — 그림 3 모듈 · 인스턴스 · 호스트 경계(함수 · 선형 메모리 · 테이블 · 전역 · import · export) + 요소 표
- 실행 흐름 — 그림 4 적재 → 검증 → 인스턴스 → 호출 → trap 순서도(CompileError · RuntimeError · RangeError)
- 보안 모델 — 그림 5 선형 메모리 경계 도표(64 KiB 페이지 · grow · 최대) + 메모리 안 덮어쓰기는 막지 않음
- 비교 · 확장 — JavaScript · 컨테이너 비교표 + WASI 0.1 → 0.2(2024-01) → 0.3(2026-06) · 능력 기반 권한
- 한계 · 과제 — DOM 직접 접근 없음 · 숫자 형 경계(→ 컴포넌트 모델 WIT) · 브라우저 64비트 메모리 16 GB
꼭 쓸 키워드
스택 기계바이너리 형식검증선형 메모리샌드박스trapimportexportWASI컴포넌트 모델
9오해와 사실
- 오해Wasm 은 JavaScript 를 대체하려고 만든 언어다.사실JavaScript 와 함께 쓰는 보완재로 설계됐고, DOM 을 직접 만지지 못해 화면 조작은 JavaScript 접착 코드가 맡는다(MDN Wasm 개념).
- 오해샌드박스 안이므로 C 코드의 버퍼 넘침 걱정이 없다.사실경계 검사는 선형 메모리 영역 단위라, 메모리 안에서 옆 객체를 덮어쓰는 넘침은 그대로 일어난다(Wasm 보안 문서).
- 오해Wasm 은 브라우저 전용 기술이다.사실코어 명세는 호스트를 정하지 않고, 서버 런타임은 WASI 0.3(2026-06) 인터페이스로 CLI · HTTP · 파일 · 소켓을 쓴다(WASI 0.3).
10핵심 정리
| 구분 | 맡는 일 | 정하는 문서 | 실패 신호 | 확인 방법 |
|---|---|---|---|---|
| 코어 명령 | 스택 기계 실행 · 수치 연산 | Wasm Core 3.0 | trap | 브라우저 디버거 |
| 검증 | 적재 전 형 검사 | Wasm Core 3.0 검증 장 | CompileError | WebAssembly.validate · wasm-tools validate |
| 선형 메모리 | 64 KiB 페이지 바이트 배열 | Wasm Core 3.0 실행 장 | 범위 밖 trap · grow 실패 | mem.buffer.byteLength |
| JS API | 브라우저의 Module · Instance · Memory | Wasm JS API | LinkError · RangeError | WebAssembly. |
| Web API | 응답 스트리밍 적재 | Wasm Web API | TypeError(MIME) | curl -sI Content-Type |
| WASI | 서버의 CLI · HTTP · 파일 · 소켓 | WASI 0.3 | 권한 없는 경로 열기 실패 | wasmtime run --dir |
| 컴포넌트 모델 | 문자열 · 레코드 같은 형을 경계에 | 컴포넌트 모델 · WIT | 인터페이스 형 불일치 | wasm-tools component wit |
11참고 문헌
- 먼저 볼 문헌
- ★ WebAssembly Core Specification Release 3.0 (Editor's Draft) — 모듈 구조 · 검증 · 실행 · 선형 메모리 규칙을 원문으로 볼 때
- ★ WebAssembly JavaScript Interface (Editor's Draft) — 브라우저에서 Module · Instance · Memory 와 오류 이름(CompileError · LinkError · RuntimeError)을 볼 때
- ★ WASI 0.3 — 서버 쪽 인터페이스(cli · http · filesystem · sockets)와 비동기 지원을 볼 때
- ★ Security (WebAssembly documentation) — 샌드박스가 막는 것과 막지 않는 것(선형 메모리 안의 덮어쓰기)을 볼 때
- ★ Why the Component Model? — 코어 모듈 경계의 한계(숫자 형만)와 WIT 인터페이스를 볼 때
- 본문 근거
- WebAssembly Core Specification (W3C Recommendation 1.0) — W3C · 2019-12 ·
www.w3.org/TR/wasm-core-1/· 확인 2026-11-14 - World Wide Web Consortium (W3C) brings a new language to the Web as WebAssembly becomes a W3C Recommendation — W3C · 2019-12 ·
www.w3.org/press-releases/2019/wasm/· 확인 2026-11-14 - WebAssembly (blog post) — Luke Wagner · 2015-06 ·
blog.mozilla.org/luke/2015/06/17/webassembly/· 확인 2026-11-14 - WebAssembly consensus and end of Browser Preview (public-webassembly mailing list) — W3C WebAssembly CG · 2017-02 ·
lists.w3.org/Archives/Public/public-webassembly/2017Feb/0002.html· 확인 2026-11-14 - Wasm 2.0 Completed — W3C WebAssembly CG · 2025-03 ·
webassembly.org/news/2025-03-20-wasm-2.0/· 확인 2026-11-14 - Wasm 3.0 Completed — W3C WebAssembly CG · 2025-09 ·
webassembly.org/news/2025-09-17-wasm-3.0/· 확인 2026-11-14 - WASI Releases — WASI Subgroup (W3C WebAssembly CG) · 2026-11 ·
wasi.dev/releases· 확인 2026-11-14 - WASI — WebAssembly System Interface — WASI Subgroup (W3C WebAssembly CG) · 2026-11 ·
wasi.dev/· 확인 2026-11-14 - WebAssembly Web API (Editor's Draft) — W3C WebAssembly Working Group · 2026-11 ·
webassembly.github.io/spec/web-api/· 확인 2026-11-14 - WebAssembly concepts (MDN Web Docs) — MDN · 2026-11 ·
developer.mozilla.org/en-US/docs/WebAssembly/Guides/Concepts· 확인 2026-11-14 - wasm-tools (README) — Bytecode Alliance · 2026-11 ·
github.com/bytecodealliance/wasm-tools· 확인 2026-11-14 - Wasmtime CLI Options — Bytecode Alliance · 2026-11 ·
docs.wasmtime.dev/cli-options.html· 확인 2026-11-14 - Node.js v24 Documentation — OpenJS Foundation · 2026-11 ·
nodejs.org/docs/latest-v24.x/api/· 확인 2026-11-14