Anpassad server
Om GitHub inte passar dina behov kan du vara värd för ett register på valfri HTTP-server. Det enda kravet är att registry.json och blockfilerna är tillgängliga via sina URL:er.
Statisk filserver
Det enklaste alternativet. Lägg din registry.json och blocks/-mapp på valfri statisk värdtjänst:
- Nginx/Apache: visa katalogen direkt
- Vercel/Netlify: distribuera katalogen som en statisk webbplats
- S3/R2/GCS: ladda upp filerna till en bucket med offentlig åtkomst
- CDN: placera filerna bakom Cloudflare, Fastly eller valfri CDN
CLI behöver bara GET åtkomst till filerna. Det finns ingen API, inga dynamiska
rutter och ingen logik på serversidan krävs.
Dynamisk server
Om du vill generera registry.json dynamiskt (e.g. från en databas,
eller lägga till åtkomstkontroll) kan du bygga en enkel API:
GET /registry.json -> returns the registry manifest
GET /blocks/{name}/{file} -> returns the block file content
{file} kan innehålla snedstreck när ett block listar filer i underkataloger
(src/script.js), så filrutten måste matcha nästlade sökvägar.
CLI bryr sig inte om hur dessa slutpunkter implementeras. Den skickar vanliga
GET-förfrågningar och förväntar sig att svarskroppen innehåller filens innehåll.
Exempel: 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);
Exempel: 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
Om CLI körs i en miljö där CORS spelar roll (osannolikt för ett Node.js
CLI, men möjligt för framtida webbaserade verktyg), se till att servern skickar
lämpliga Access-Control-Allow-Origin-headers.
Cachning
CLI cachelagrar hämtade registry.json-filer i minnet under en enskild
kommandokörning. Cachelagringen sparas inte mellan körningar. Om du vill optimera
för stora register kan du lägga till vanliga HTTP-cacheheaders
(Cache-Control, ETag) i serversvaren.
Interna register och företagsregister
För team som vill dela block internt:
- Värdhantera registret på en intern server eller en URL som nås via VPN
- Varje utvecklare lägger till registrets URL i projektets
blocks.json - CLI hämtar från den URL precis som från vilket annat register som helst
Ingen särskild konfiguration behövs. Så länge URL är åtkomlig från utvecklarens dator fungerar det.