사용자 지정 서버
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
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
$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)를 추가하세요.
내부/기업 레지스트리
블록을 내부적으로 공유하려는 팀의 경우:
- 내부 서버나 VPN으로 액세스할 수 있는 URL에 레지스트리를 호스팅합니다.
- 각 개발자가 프로젝트의
blocks.json에 레지스트리 URL를 추가합니다. - CLI는 다른 레지스트리와 마찬가지로 해당 URL에서 가져옵니다.
특별한 설정은 필요하지 않습니다. URL에 개발자의 컴퓨터에서 접근할 수 있기만 하면 작동합니다.