텔레그램 봇 배포와 호스팅: VPS, Docker, 서버리스
텔레그램 봇 배포란 봇 코드를 항상 켜져 있고 api.telegram.org에 접속할 수 있는 머신에서 실행하는 것입니다. 그다음 업데이트를 받는 방식을 고릅니다. 도메인 없이 어느 서버에서나 동작하는 getUpdates 롱 폴링과, 공개 HTTPS URL이 필요한 웹훅 중 하나입니다. 폴링 봇에는 systemd를 쓰는 소형 VPS나 Docker 컨테이너가 일반적이고, 웹훅 봇에는 Cloudflare Workers 같은 서버리스 플랫폼이 잘 맞습니다. 이 글에서는 각 방식을 바로 복사해 쓸 수 있는 설정과 함께 소개하고, 로그, 자동 재시작, 출시 체크리스트도 다룹니다.
서버에서 폴링과 웹훅 선택하기
업데이트를 받는 방법은 서로 배타적인 두 가지이며, 어느 쪽이든 전달되지 않은 업데이트는 텔레그램이 최대 24시간만 보관합니다. 어떤 방식을 고르느냐에 따라 텔레그램 봇 호스팅에 필요한 조건이 달라집니다.
롱 폴링 (getUpdates) | 웹훅 (setWebhook) | |
|---|---|---|
| 네트워크 | 외부로 나가는 HTTPS만 필요, NAT 뒤에서도 동작 | 공개 HTTPS URL, 포트 443·80·88·8443, IPv4 |
| 프로세스 | 계속 실행되는 루프 | HTTP 핸들러, 서버리스 가능 |
| 인스턴스 | 토큰당 정확히 하나 | URL 하나 뒤에 여러 개 가능 |
| 잘 맞는 환경 | VPS, Docker, 홈 서버 | 리버스 프록시를 둔 VPS, Cloudflare Workers, AWS Lambda, Vercel |
지금 폴링이 잘 동작한다면 그대로 두어도 됩니다. 텔레그램 공식 웹훅 가이드도 getUpdates를 쓰는 데 아무 문제가 없다고 설명합니다. 플랫폼이 웹훅을 요구하거나 여러 인스턴스로 부하를 나누고 싶을 때 웹훅으로 옮기십시오.
배포용 폴링 봇 코드
운영 환경용 코드에는 세 가지가 필요합니다. 토큰을 환경 변수에서 읽고, 로그를 stdout으로 출력하며, 네트워크 오류가 나도 종료되지 않고 버티는 것입니다. 다음 에코 봇은 이 세 가지를 모두 갖추고 있고, 웹훅이 설정되어 있으면 getUpdates가 동작하지 않으므로 시작할 때 deleteWebhook을 호출합니다.
import logging
import os
import time
import requests
logging.basicConfig(level=logging.INFO, format="%(asctime)s %(levelname)s %(message)s")
log = logging.getLogger("bot")
TOKEN = os.environ["BOT_TOKEN"] # 토큰은 절대 코드에 직접 쓰지 않음
API = f"https://api.telegram.org/bot{TOKEN}"
def call(method, **params):
data = requests.post(f"{API}/{method}", json=params, timeout=40).json()
if not data["ok"]:
raise RuntimeError(f"{method}: {data['error_code']} {data['description']}")
return data["result"]
def main():
call("deleteWebhook") # 폴링과 웹훅은 동시에 쓸 수 없음
log.info("started as @%s", call("getMe")["username"])
offset = 0
while True:
try:
updates = call("getUpdates", offset=offset, timeout=30)
except Exception:
log.exception("getUpdates failed, retrying in 5 s")
time.sleep(5)
continue
for update in updates:
offset = update["update_id"] + 1
msg = update.get("message")
if msg and "text" in msg:
try:
call("sendMessage", chat_id=msg["chat"]["id"], text="에코: " + msg["text"])
except Exception:
log.exception("update %s failed", update["update_id"])
if __name__ == "__main__":
main()const TOKEN = process.env.BOT_TOKEN; // 토큰은 절대 코드에 직접 쓰지 않음
if (!TOKEN) throw new Error("BOT_TOKEN is not set");
const API = `https://api.telegram.org/bot${TOKEN}`;
const log = (...args) => console.log(new Date().toISOString(), ...args);
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
async function call(method, params = {}) {
const res = await fetch(`${API}/${method}`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(params),
signal: AbortSignal.timeout(40_000),
});
const data = await res.json();
if (!data.ok) throw new Error(`${method}: ${data.error_code} ${data.description}`);
return data.result;
}
await call("deleteWebhook"); // 폴링과 웹훅은 동시에 쓸 수 없음
log("started as @" + (await call("getMe")).username);
let offset = 0;
while (true) {
let updates;
try {
updates = await call("getUpdates", { offset, timeout: 30 });
} catch (err) {
log("getUpdates failed, retrying in 5 s:", err.message);
await sleep(5000);
continue;
}
for (const update of updates) {
offset = update.update_id + 1;
const msg = update.message;
if (!msg?.text) continue;
try {
await call("sendMessage", { chat_id: msg.chat.id, text: "에코: " + msg.text });
} catch (err) {
log(`update ${update.update_id} failed:`, err.message);
}
}
}bot.py(requirements.txt에 requests 추가) 또는 bot.mjs(Node.js 18 이상, 의존성 없음)로 저장합니다. 라이브러리 목록의 프레임워크를 쓰면 루프를 대신 처리해 주지만, 아래 배포 절차는 똑같습니다.
VPS에서 systemd로 텔레그램 봇 실행하기
VPS는 일반 리눅스 머신과 같습니다. systemd가 부팅할 때 봇을 시작하고, 비정상 종료되면 다시 시작하도록 설정합니다.
- 로그인 권한이 없는 사용자를 만들고 코드를
/opt/mybot에 복사합니다. Python이라면 그 안에 가상 환경을 만들고 의존성을 설치합니다. - 토큰을
/etc/mybot.env에BOT_TOKEN=123456789:AAEexampleTokenReplaceWithYours한 줄로 넣고chmod 600으로 접근을 제한합니다. - 유닛 파일
/etc/systemd/system/mybot.service를 만듭니다.
[Unit]
Description=Telegram bot
After=network-online.target
Wants=network-online.target
[Service]
User=mybot
WorkingDirectory=/opt/mybot
EnvironmentFile=/etc/mybot.env
ExecStart=/opt/mybot/.venv/bin/python -u bot.py
# Node.js: ExecStart=/usr/bin/node bot.mjs
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target
서비스를 활성화하고 로그를 확인합니다.
sudo systemctl daemon-reload
sudo systemctl enable --now mybot
journalctl -u mybot -f # 실시간 로그
sudo systemctl restart mybot # 코드 업데이트 후
같은 VPS에서 웹훅을 쓰려면 봇을 로컬 포트의 HTTP 서버로 실행하고, 앞단에 nginx나 Caddy를 두어 443 포트에서 TLS를 처리하게 합니다. secret token 검증이 들어간 핸들러는 텔레그램 웹훅 설정 가이드에 있습니다.
Docker로 텔레그램 봇 배포하기
컨테이너에는 런타임과 의존성이 함께 들어가므로 노트북에서든 어떤 Docker 호스트에서든 봇이 똑같이 동작합니다. Python 봇용 Dockerfile은 다음과 같습니다.
FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY bot.py .
CMD ["python", "-u", "bot.py"]
# Node.js: FROM node:22-slim, COPY bot.mjs ., CMD ["node", "bot.mjs"]
이미지를 빌드하고 실행합니다. 토큰은 이미지에 넣지 말고 실행 시점에 전달합니다.
docker build -t mybot .
docker run -d --name mybot --restart unless-stopped --env-file .env mybot
docker logs -f mybot
--restart unless-stopped는 비정상 종료나 호스트 재부팅 후 봇을 다시 띄워 줍니다. .env는 Git과 이미지에서 모두 제외하십시오(.dockerignore에 추가). 폴링 봇을 다시 배포할 때는 새 컨테이너를 시작하기 전에 이전 컨테이너를 멈춰야 합니다. 같은 토큰으로 두 컨테이너가 폴링하면 getUpdates가 409 Conflict로 실패합니다.
서버리스: Cloudflare Workers에서 텔레그램 봇 실행하기
서버리스 플랫폼은 요청이 들어올 때만 코드를 실행하므로 웹훅 모드가 필요합니다. Cloudflare Workers의 기본 workers.dev 주소는 이미 443 포트에서 HTTPS를 제공합니다. 다음 Worker는 secret token 헤더를 확인하고 즉시 응답한 뒤, ctx.waitUntil로 나머지 작업을 백그라운드에서 마칩니다.
// worker.js: "npx wrangler deploy"로 배포
export default {
async fetch(request, env, ctx) {
const url = new URL(request.url);
if (request.method !== "POST" || url.pathname !== "/telegram/webhook") {
return new Response("Not found", { status: 404 });
}
const enc = new TextEncoder();
const received = enc.encode(request.headers.get("X-Telegram-Bot-Api-Secret-Token") ?? "");
const expected = enc.encode(env.WEBHOOK_SECRET);
if (received.byteLength !== expected.byteLength ||
!crypto.subtle.timingSafeEqual(received, expected)) {
return new Response("Forbidden", { status: 403 });
}
const update = await request.json();
ctx.waitUntil(handleUpdate(update, env)); // 200은 바로 반환하고 작업은 계속
return new Response("OK");
},
};
async function handleUpdate(update, env) {
const msg = update.message;
if (!msg?.text) return;
const res = await fetch(`https://api.telegram.org/bot${env.BOT_TOKEN}/sendMessage`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ chat_id: msg.chat.id, text: "에코: " + msg.text }),
});
if (!res.ok) console.error("sendMessage failed", res.status, await res.text());
}
두 값을 Worker 시크릿으로 저장하고 배포한 다음, 같은 시크릿으로 Worker URL을 등록합니다.
npx wrangler secret put BOT_TOKEN
npx wrangler secret put WEBHOOK_SECRET
npx wrangler deploy
curl -X POST "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/setWebhook" \
-H "Content-Type: application/json" \
-d '{"url": "https://mybot.example.workers.dev/telegram/webhook", "secret_token": "replace-with-your-random-secret"}'
Bot API Tester의 setWebhook에서 값을 채워 호출해도 됩니다. AWS Lambda(HTTPS 함수 URL이나 API 게이트웨이 뒤)와 Vercel 함수에서도 같은 패턴을 씁니다. JSON 본문을 파싱하고, 헤더를 검증하고, 2XX를 빨리 반환하면 됩니다. 플랫폼마다 함수와 백그라운드 작업의 실행 시간에 제한이 있으므로 오래 걸리는 작업은 큐로 넘기십시오. 텔레그램은 2XX가 아닌 응답을 모두 재시도하므로, 시간 초과나 오류로 끝난 함수는 같은 업데이트를 다시 받게 됩니다.
무료 또는 저렴하게 텔레그램 봇 호스팅하기
- 서버리스 무료 플랜: 트래픽이 많지 않고 핸들러가 짧은 웹훅 봇에 적합합니다.
- 소형 VPS: 가장 유연합니다. 폴링과 웹훅, 어떤 언어든 가능하고 봇 옆에 데이터베이스도 둘 수 있습니다.
- 홈 서버나 싱글 보드 컴퓨터: 들어오는 연결이 필요 없는 폴링이라면 동작합니다. 가동률은 전원과 인터넷 상태에 달려 있습니다.
- 컨테이너 플랫폼: 프로세스를 계속 실행해 주는 곳이라면 폴링 봇을 올릴 수 있습니다. 유휴 앱을 절전 상태로 만들지 않는지 확인하십시오.
호스팅과 무관한 웹훅 요구 사항
- HTTPS만 허용, TLS 1.2 이상, 도메인과 일치하고 전체 체인을 포함한 인증서 또는
certificate로 업로드한 자체 서명 인증서. - 포트 443, 80, 88, 8443, IPv4(웹훅은 IPv6 미지원), 리디렉션 불가.
- 요청은
149.154.160.0/20과91.108.4.0/22대역에서 오며, 텔레그램은 이 대역이 바뀔 수 있다고 안내합니다. secret_token(1~256자,A-Z a-z 0-9 _ -)을 설정하고X-Telegram-Bot-Api-Secret-Token헤더를 검증합니다.
배포할 때마다 Bot API Tester의 getWebhookInfo를 열어 보십시오. pending_update_count가 늘어나거나 최근 last_error_message가 있다면 텔레그램이 업데이트를 전달하지 못하고 있다는 뜻입니다.
환경 변수, 로그, 재시작
- 토큰: 환경 변수나 시크릿 저장소에만 두고 Git, 이미지, 클라이언트 코드에는 절대 넣지 않습니다. 유출되면 텔레그램 봇 토큰 가이드에 따라 폐기하고 서버의 값을 바꿉니다.
- 로그: stdout/stderr로 출력하고 journald, Docker, 플랫폼이 수집하게 합니다. 요청 URL 전체에는 토큰이 들어 있으므로 그대로 로그에 남기지 마십시오.
- 재시작: 프로세스 관리자(
Restart=always,--restart unless-stopped)가 비정상 종료를 처리합니다. 텔레그램은 업데이트 확인 상태를 서버 쪽에 저장합니다. 더 큰offset으로getUpdates를 호출하면 확인된 것으로 처리되므로, 재시작 후에는 확인되지 않은 업데이트만 받습니다. 종료 직전의 마지막 묶음은 두 번 올 수 있으니 중요한 처리라면update_id로 중복을 걸러 내십시오. - 속도 제한:
429 Too Many Requests를 받으면retry_after초만큼 기다립니다. 자세한 내용은 텔레그램 Bot API 제한을 참고하십시오.
텔레그램 봇 배포 체크리스트
- 토큰을 환경 변수나 시크릿에서 읽고, 서버에서
getMe가 성공합니다. - 토큰당 폴링 인스턴스는 정확히 하나이거나,
secret_token을 설정한 웹훅을 씁니다. 둘을 동시에 쓰지 않습니다. - 비정상 종료와 재부팅 후 프로세스가 자동으로 다시 시작됩니다.
- 로그가 수집되고, 로그에 토큰이 남지 않습니다.
- 업데이트 하나에서 난 오류는 로그로 남기고 전체를 멈추지 않으며, 웹훅 핸들러는 2XX를 빨리 반환합니다.
- 웹훅이라면
getWebhookInfo에 올바른 URL이 보이고 최근 오류가 없습니다. - 실험에는 운영 토큰이 아닌 별도의 테스트 봇이나 텔레그램 테스트 서버를 사용합니다.
배포 문제 해결
| 증상 | 원인과 해결 |
|---|---|
409 Conflict: terminated by other getUpdates request | 토큰 하나로 인스턴스 두 개가 폴링 중입니다(이전 컨테이너, 노트북 등). 하나만 남기고 모두 멈춥니다. |
활성 웹훅을 언급하는 409 Conflict | 웹훅이 아직 설정되어 있습니다. 폴링 전에 deleteWebhook을 호출합니다. |
401 Unauthorized | 토큰 변수가 비어 있거나, 오타가 있거나, 폐기된 토큰입니다. getMe로 확인합니다. |
| 로컬에서는 되는데 서버에서는 반응이 없음 | api.telegram.org로 나가는 HTTPS가 차단되었거나 환경 변수 파일이 로드되지 않았습니다. 로그를 확인합니다. |
| 웹훅 봇이 아무것도 받지 못함 | getWebhookInfo의 last_error_message를 확인합니다. TLS 문제, 잘못된 포트, 시크릿 불일치로 인한 403, 핸들러 오류 등이 원인입니다. |
봇이 처음이라면 텔레그램 봇 만들기부터 진행한 뒤 다시 돌아와 배포해 보십시오.
자주 묻는 질문
텔레그램 봇은 어디에 호스팅할 수 있나요?
외부로 HTTPS 요청을 보낼 수 있는 곳이면 어디든 됩니다. VPS, Docker 호스트, 집에 있는 서버, 서버리스 플랫폼 모두 가능합니다. getUpdates를 쓰는 봇은 공개 주소가 필요 없고, 웹훅 봇은 443, 80, 88, 8443 포트의 공개 HTTPS URL이 필요합니다.
배포한 봇은 폴링과 웹훅 중 무엇을 써야 하나요?
둘 다 운영 환경에서 쓸 수 있습니다. VPS나 Docker에서는 도메인과 인증서가 필요 없는 getUpdates 롱 폴링이 가장 간단합니다. 요청이 들어올 때만 코드를 실행하는 서버리스 플랫폼에서는 웹훅이 필수입니다.
봇을 배포한 뒤 409 Conflict가 발생하는 이유는 무엇인가요?
웹훅이 아직 설정된 상태에서 getUpdates로 폴링하고 있거나(deleteWebhook 호출), 배포 중의 이전 컨테이너와 새 컨테이너 또는 노트북과 서버처럼 봇 두 개가 동시에 폴링하고 있기 때문입니다. 토큰 하나당 폴링 인스턴스는 정확히 하나만 실행하십시오.
텔레그램 봇을 24시간 실행하려면 어떻게 하나요?
장애나 재부팅 후 자동으로 다시 시작해 주는 프로세스 관리자 아래에서 실행합니다. VPS라면 Restart=always를 지정한 systemd 서비스, Docker라면 --restart unless-stopped 옵션을 씁니다. 로그는 stdout으로 출력하고 journalctl이나 docker logs로 확인합니다.
Cloudflare Workers에서 텔레그램 봇을 실행할 수 있나요?
네, 웹훅 모드라면 가능합니다. Worker가 업데이트를 POST 요청으로 받아 X-Telegram-Bot-Api-Secret-Token 헤더를 확인하고 fetch로 Bot API를 호출합니다. workers.dev HTTPS 주소를 setWebhook으로 등록하면 되며, 롱 폴링 루프는 이 모델에 맞지 않습니다.
서버에서 봇 토큰은 어디에 보관해야 하나요?
봇 사용자만 읽을 수 있는 파일에서 불러오는 환경 변수나 플랫폼의 시크릿 저장소(예: Worker 시크릿)에 보관합니다. 토큰을 Git에 커밋하거나 Docker 이미지에 넣어서는 안 되며, 유출되면 @BotFather에서 폐기하십시오.
관련 가이드
텔레그램 봇 만들기: @BotFather로 생성하고 첫 메시지 보내기
텔레그램 봇 만들기 가이드입니다. @BotFather의 /newbot으로 봇을 생성하고 토큰을 getMe로 확인한 뒤, getUpdates와 sendMessage로 첫 메시지를 보내는 과정을 curl과 Python 예제로 설명합니다.
텔레그램 봇 API 10.0~10.5 변경 사항: 봇 설정, 위젯, 리치 메시지, 임시 메시지, 게스트 모드
텔레그램 봇 API 10.0~10.5의 새 기능을 정리했습니다. setMySettings와 BotFullInfo, HTML 위젯, 리치·임시 메시지, 게스트 모드를 JSON 예제와 함께 설명합니다.
텔레그램 봇 API 오류 총정리: 오류별 의미와 해결 방법
텔레그램 봇 API 오류를 코드별로 정리했습니다. 400 chat not found, 403 bot was blocked by the user, 409 Conflict, 429 retry_after의 원인과 해결, 처리 코드까지 다룹니다.
텔레그램 봇 API 제한 총정리: 전송 속도, 429 오류, 파일 크기, 메시지 길이
텔레그램 봇 API 전송 제한을 정리했습니다. 초당 30건, 채팅당 초당 1건, 그룹 분당 20건 기준과 429 retry_after 처리, 파일 크기·메시지 길이 제한까지 다룹니다.
텔레그램 봇 명령어 가이드: setMyCommands, 명령어 스코프, /start 딥링크
텔레그램 봇 명령어 설정 방법: @BotFather /setcommands, 스코프·언어별 setMyCommands, /start 딥링크 파라미터, 그룹의 /cmd@bot 처리를 예제로 설명합니다.
텔레그램 봇 키보드: 인라인 키보드, 콜백 버튼, 리플라이 키보드
텔레그램 봇 버튼 만드는 법을 정리했습니다. callback_data 인라인 키보드, answerCallbackQuery, 버튼을 누른 뒤 메시지 수정, 리플라이 키보드와 ForceReply까지 다룹니다.
n8n 텔레그램 연동 가이드: 봇 연결, 워크플로 트리거, 메시지 보내기
n8n 텔레그램 연동 방법: 봇 토큰을 Access Token으로 등록하고, 공개 HTTPS로 Telegram Trigger 웹훅을 받고, chat id로 메시지를 보내며 자주 나는 오류를 해결합니다.
텔레그램 봇 API로 메시지 보내기: sendMessage 사용법과 예제
텔레그램 봇 API 메시지 보내기 가이드입니다. sendMessage를 curl·Python·JavaScript로 호출하는 예제, HTML·MarkdownV2 서식, 인라인 버튼, 그룹·채널 전송, 400·403·429 오류 해결법을 정리했습니다.
텔레그램 봇 토큰: 발급부터 확인, 폐기, 안전한 보관까지
텔레그램 봇 토큰을 @BotFather에서 발급받는 법, 기존 봇의 토큰 찾기, getMe로 유효성 확인, 유출 시 폐기 방법을 정리했습니다. n8n·AI 비서 연동에 필요한 bot token과 chat id도 안내합니다.
텔레그램 웹훅 설정 가이드: setWebhook, secret_token, getWebhookInfo
텔레그램 봇 웹훅 설정 방법을 단계별로 정리했습니다. setWebhook 파라미터, secret_token 헤더 검증 코드, getWebhookInfo 상태 확인, deleteWebhook으로 되돌리기, 409·HTTPS 오류 해결까지 다룹니다.
텔레그램 chat id 확인방법: 개인, 그룹, 채널, 토픽별 chat id 찾기
텔레그램 chat id 확인방법을 개인 채팅, 그룹, 슈퍼그룹, 채널, 포럼 토픽별로 정리했습니다. getUpdates로 chat id를 찾는 법, -100으로 시작하는 ID의 의미, 결과가 비어 있을 때 해결법까지 설명합니다.
텔레그램 인라인 봇 가이드: 인라인 모드 활성화와 인라인 쿼리 응답
텔레그램 인라인 봇 만드는 법: @BotFather나 setMySettings로 인라인 모드를 켜고 inline_query에 answerInlineQuery로 답하는 과정을 Python·JS 예제로 설명합니다.
텔레그램 스타 결제 봇 가이드: 인보이스, 결제 전 확인, 환불, 구독
텔레그램 봇에서 스타(Stars) 결제 받는 법: XTR sendInvoice, pre_checkout_query, successful_payment, 환불, 구독까지 Python·JS 코드로 설명합니다.
텔레그램 테스트 서버: 텔레그램 봇 테스트 환경에서 봇을 테스트하는 방법
텔레그램 테스트 서버 사용법을 정리했습니다. 테스트 환경 로그인, 테스트용 봇 만들기, /test/ 주소로 Bot API 호출하기, Bot API Tester의 TEST 스위치까지 다룹니다.
텔레그램 웹사이트 위젯: 로그인 위젯, 게시물 임베드, 댓글, 공유 버튼
웹사이트에 텔레그램을 붙이는 방법을 정리했습니다. 새 Telegram Login(OIDC), 기존 로그인 위젯과 hash 검증 코드, 게시물 임베드, 댓글, 공유 버튼까지 다룹니다.
TelegramWidget JavaScript API: 텔레그램 위젯 API 레퍼런스와 오류 코드, 제한
텔레그램 위젯의 TelegramWidget JavaScript API를 정리했습니다. 속성, request(), 이벤트, 오류 코드, CSS 변수, widget_query와 answerWidgetQuery, 모든 제한값까지 담았습니다.
텔레그램 위젯 예제: HTML과 Python 봇 코드 전체 공개
바로 실행할 수 있는 텔레그램 위젯 예제 모음입니다. 정적 주문 카드, widget_query 카운터, 실시간 공유 투표, 브라우저 미리보기까지 HTML과 Python 코드로 설명합니다.
텔레그램 위젯 가이드: 봇 메시지 안에서 동작하는 HTML 위젯
Bot API 10.4에 추가된 텔레그램 위젯의 개념, sendWidget 사용법, chat_data와 public_data, 현재 사용 가능한 범위와 Mini App과의 차이를 정리했습니다.
텔레그램 미니앱 테스트 가이드: 브라우저 목 모드부터 실제 텔레그램까지
텔레그램 미니앱 테스트 방법을 단계별로 정리했습니다. 브라우저 목(mock) 모드, HTTPS 터널로 localhost 열기, 테스트 환경, 플랫폼별 DevTools, initData 검증까지 다룹니다.