Hoppscotch: 79,200 GitHub Stars — Postman, Insomnia, Bruno과 비교하는 오픈소스 API 개발 플랫폼 2026

# macOS (Homebrew)
brew install --cask hoppscotch

# Windows (Winget)
winget install Hoppscotch.Hoppscotch

# Linux (Flatpak)
flatpak install flathub io.hoppscotch.Hoppscotch

# 전제 조건 설치 (Debian/Ubuntu)
sudo apt-get install -y python3 g++ build-essential

# CLI 전역 설치
npm i -g @hoppscotch/cli

# 설치 확인
hopp --version
# 출력: 0.31.2

# AIO 이미지 풀
docker pull hoppscotch/hoppscotch:latest

# 환경 파일 생성
cat > .env << 'EOF'
# 데이터베이스
DATABASE_URL=postgresql://postgres:postgres@localhost:5432/hoppscotch

# JWT 시크릿
JWT_SECRET=$(openssl rand -hex 32)
REFRESH_TOKEN_SECRET=$(openssl rand -hex 32)

# 기본 URL
REDIRECT_URL=http://localhost:3000
ADMIN_URL=http://localhost:3100
BACKEND_URL=http://localhost:3170

# 세션 시크릿
SESSION_SECRET=$(openssl rand -hex 32)
EOF

# AIO 컨테이너 실행
docker run -d \
  -p 3000:3000 \
  -p 3100:3100 \
  -p 3170:3170 \
  --env-file .env \
  --restart unless-stopped \
  --name hoppscotch \
  hoppscotch/hoppscotch:latest

# docker-compose.yml
version: "3.8"

services:
  hoppscotch:
    image: hoppscotch/hoppscotch:2026.4.1
    container_name: hoppscotch-app
    ports:
      - "3000:3000"   # 메인 앱
      - "3100:3100"   # 관리 대시보드
      - "3170:3170"   # 백엔드 API
    env_file: .env
    restart: unless-stopped
    depends_on:
      postgres:
        condition: service_healthy
    networks:
      - hoppscotch-net

  postgres:
    image: postgres:16-alpine
    container_name: hoppscotch-db
    environment:
      POSTGRES_DB: hoppscotch
      POSTGRES_USER: hoppscotch
      POSTGRES_PASSWORD: ${DB_PASSWORD:-changeme}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U hoppscotch"]
      interval: 10s
      timeout: 5s
      retries: 5
    networks:
      - hoppscotch-net

volumes:
  postgres_data:
    driver: local

networks:
  hoppscotch-net:
    driver: bridge

docker compose up -d

# 모든 서비스 상태 확인
docker compose ps

# 로그 확인
docker compose logs -f hoppscotch

# .github/workflows/api-tests.yml
name: Hoppscotch CLI로 API 테스트

on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main]

jobs:
  api-test:
    runs-on: ubuntu-latest
    steps:
      - name: 코드 체크아웃
        uses: actions/checkout@v4

      - name: Node.js 설정
        uses: actions/setup-node@v4
        with:
          node-version: "20"
          cache: "npm"

      - name: Hoppscotch CLI 설치
        run: npm i -g @hoppscotch/cli

      - name: CLI 버전 확인
        run: hopp --version

      - name: 테스트 서버 시작
        run: |
          npm run start:test &
          npx wait-on http://localhost:8080 --timeout 30000

      - name: API 컬렉션 테스트 실행
        run: |
          hopp test collections/api-tests.json \
            -e environments/test.json \
            --reporter-junit test-results.xml \
            --delay 500
        env:
          API_BASE_URL: http://localhost:8080

      - name: 테스트 결과 업로드
        uses: actions/upload-artifact@v4
        if: always()
        with:
          name: api-test-results
          path: test-results.xml

// scripts/run-api-tests.js
const { execSync } = require("child_process");
const path = require("path");

const collectionPath = path.join(__dirname, "../collections");
const envPath = path.join(__dirname, "../environments");

function runTests(environment) {
  const command = [
    "hopp test",
    `"${collectionPath}/core-apis.json"`,
    `-e "${envPath}/${environment}.json"`,
    "--reporter-junit",
    `"reports/${environment}-results.xml"`,
  ].join(" ");

  console.log(`${environment}에 대해 테스트 실행 중...`);
  execSync(command, { stdio: "inherit" });
}

// 프로덕션 배포 전 스테이징에서 실행
runTests("staging");

// vite.config.js
import { defineConfig } from "vite";
import vue from "@vitejs/plugin-vue";

export default defineConfig({
  plugins: [vue()],
  server: {
    proxy: {
      "/api": {
        target: process.env.API_BASE_URL || "http://localhost:3170",
        changeOrigin: true,
        rewrite: (path) => path.replace(/^\/api/, ""),
      },
    },
  },
});

// Hoppscotch 사전 요청 스크립트
const token = pw.env.get("AUTH_TOKEN");
const expiry = pw.env.get("TOKEN_EXPIRY");

if (!token || Date.now() > Number(expiry)) {
  const res = await pw.api.post("https://auth.example.com/oauth/token", {
    body: JSON.stringify({
      client_id: pw.env.get("CLIENT_ID"),
      client_secret: pw.env.get("CLIENT_SECRET"),
      grant_type: "client_credentials",
    }),
    headers: {
      "Content-Type": "application/json",
    },
  });

  const data = JSON.parse(res.body);
  pw.env.set("AUTH_TOKEN", data.access_token);
  pw.env.set("TOKEN_EXPIRY", String(Date.now() + data.expires_in * 1000));
}

// 현재 요청에 토큰 적용
pw.headers.set("Authorization", `Bearer ${pw.env.get("AUTH_TOKEN")}`);

// Hoppscotch 테스트 스크립트
pw.test("상태 코드가 200이다", () => {
  pw.expect(pw.response.status).toBe(200);
});

pw.test("응답에 올바른 Content-Type이 있다", () => {
  pw.expect(pw.response.headers["content-type"]).toInclude("application/json");
});

pw.test("응답 본문에 사용자 ID가 포함된다", () => {
  const json = pw.response.json();
  pw.expect(json).toHaveProperty("id");
  pw.expect(json.id).toBeGreaterThan(0);
});

pw.test("응답 시간이 허용 범위 내이다", () => {
  pw.expect(pw.response.time).toBeLessThan(500);
});

# 동시성 설정으로 컬렉션 실행
hopp test load-test-collection.json \
  --iteration-count 100 \
  --delay 100 \
  --env production.json

# 추가 분석을 위한 JSON 결과 난폭
hopp test api-collection.json \
  --reporter-json results.json

# Jenkins/GitLab 통합을 위한 JUnit XML 생성
hopp test api-collection.json \
  --reporter-junit junit-report.xml

# 암호학적으로 안전한 시크릿 생성
JWT_SECRET=$(openssl rand -hex 64)
REFRESH_TOKEN_SECRET=$(openssl rand -hex 64)
SESSION_SECRET=$(openssl rand -hex 64)

# .env에 프로덕션 값으로 업데이트
cat >> .env << EOF
# 보안
JWT_SECRET=${JWT_SECRET}
REFRESH_TOKEN_SECRET=${REFRESH_TOKEN_SECRET}
SESSION_SECRET=${SESSION_SECRET}
TOKEN_SALT_COMPLEXITY=10

# 속도 제한 (리버스 프록시 뒤에 있는 경우)
RATE_LIMIT_TTL=60
RATE_LIMIT_MAX=100

# CORS (도메인으로 제한)
ALLOWED_ORIGINS=https://api.yourcompany.com
EOF

# /etc/nginx/sites-available/hoppscotch
server {
    listen 443 ssl http2;
    server_name api-tools.yourcompany.com;

    ssl_certificate /etc/letsencrypt/live/yourcompany.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/yourcompany.com/privkey.pem;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

server {
    listen 443 ssl http2;
    server_name hoppscotch-admin.yourcompany.com;

    ssl_certificate /etc/letsencrypt/live/yourcompany.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/yourcompany.com/privkey.pem;

    location / {
        proxy_pass http://localhost:3100;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

# docker-compose.monitoring.yml
version: "3.8"

services:
  prometheus:
    image: prom/prometheus:latest
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml
      - prometheus_data:/prometheus
    ports:
      - "9090:9090"
    networks:
      - hoppscotch-net

  grafana:
    image: grafana/grafana:latest
    ports:
      - "3001:3000"
    volumes:
      - grafana_data:/var/lib/grafana
    networks:
      - hoppscotch-net

volumes:
  prometheus_data:
  grafana_data:

networks:
  hoppscotch-net:
    external: true

#!/bin/bash
# backup-hoppscotch.sh - cron으로 매일 실행

BACKUP_DIR="/backups/hoppscotch"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
DB_CONTAINER="hoppscotch-db"
DB_NAME="hoppscotch"
DB_USER="hoppscotch"

mkdir -p "${BACKUP_DIR}"

# PostgreSQL 덤프
docker exec ${DB_CONTAINER} pg_dump \
  -U ${DB_USER} \
  -d ${DB_NAME} \
  -F custom \
  -f "/tmp/hoppscotch_${TIMESTAMP}.dump"

# 컨테이너에서 호스트로 복사
docker cp "${DB_CONTAINER}:/tmp/hoppscotch_${TIMESTAMP}.dump" \
  "${BACKUP_DIR}/hoppscotch_${TIMESTAMP}.dump"

# 압축 및 암호화
gzip "${BACKUP_DIR}/hoppscotch_${TIMESTAMP}.dump"

# 최근 14일만 유지
find "${BACKUP_DIR}" -name "hoppscotch_*.dump.gz" -mtime +14 -delete

echo "백업 완료: hoppscotch_${TIMESTAMP}.dump.gz"