본문으로 건너뛰기

사용자 지정 서버

GitHub이 요구 사항에 맞지 않으면 모든 HTTP 서버에서 레지스트리를 호스팅할 수 있습니다. registry.json와 블록 파일에 URL로 접근할 수 있으면 됩니다.

정적 파일 서버

가장 간단한 방법입니다. registry.json과 blocks/ 폴더를 정적 호스팅 서비스에 올리면 됩니다:

  • Nginx/Apache: 디렉터리를 직접 제공합니다
  • Vercel/Netlify: 디렉터리를 정적 사이트로 배포합니다
  • S3/R2/GCS: 공개 액세스가 가능한 버킷에 파일을 업로드합니다
  • CDN: Cloudflare, Fastly 또는 원하는 CDN 뒤에 파일을 둡니다

CLI에는 파일에 대한 GET 접근 권한만 있으면 됩니다. API도, 동적 라우트도, 서버 측 로직도 필요하지 않습니다.

동적 서버

registry.json를 동적으로 생성하고 싶다면(e.g. 데이터베이스에서 가져오거나 액세스 제어를 추가하려는 경우), 간단한 API를 만들 수 있습니다:

코드
GET /registry.json          -> returns the registry manifest
GET /blocks/{name}/{file}   -> returns the block file content

블록에서 하위 디렉터리의 파일을 나열하면 {file}에 슬래시가 포함될 수 있으므로(src/script.js), 파일 경로가 중첩 경로와 일치해야 합니다.

CLI는 이러한 엔드포인트의 구현 방식을 신경 쓰지 않습니다. 일반 GET 요청을 보내고 응답 본문이 파일 콘텐츠라고 가정합니다.

예: Express

JavaScript
const express = require('express');
const path = require('path');

const app = express();

app.get('/registry.json', (req, res) => {
  res.sendFile(path.join(__dirname, 'registry.json'));
});

app.use('/blocks', express.static(path.join(__dirname, 'blocks')));

app.listen(3000);

예: PHP

PHP
<?php
$path = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);

if ($path === '/registry.json') {
    header('Content-Type: application/json');
    readfile(__DIR__ . '/registry.json');
    exit;
}

if (preg_match('#^/blocks/([^/]+)/(.+)$#', $path, $matches)) {
    $file = __DIR__ . '/blocks/' . $matches[1] . '/' . $matches[2];
    if (file_exists($file)) {
        readfile($file);
        exit;
    }
}

http_response_code(404);

CORS

CLI가 CORS가 중요한 환경(Node.js CLI에서는 가능성이 낮지만 향후 웹 기반 도구에서는 가능함)에서 실행된다면, 서버가 적절한 Access-Control-Allow-Origin 헤더를 보내도록 하세요.

캐싱

CLI는 한 번의 명령 실행 중 가져온 registry.json 파일을 메모리에 캐시합니다. 실행 간에 캐시를 유지하지 않습니다. 대규모 레지스트리를 최적화하려면 서버 응답에 표준 HTTP 캐싱 헤더(Cache-Control, ETag)를 추가하세요.

내부/기업 레지스트리

블록을 내부적으로 공유하려는 팀의 경우:

  1. 내부 서버나 VPN으로 액세스할 수 있는 URL에 레지스트리를 호스팅합니다.
  2. 각 개발자가 프로젝트의 blocks.json에 레지스트리 URL를 추가합니다.
  3. CLI는 다른 레지스트리와 마찬가지로 해당 URL에서 가져옵니다.

특별한 설정은 필요하지 않습니다. URL에 개발자의 컴퓨터에서 접근할 수 있기만 하면 작동합니다.