Персонализиран сървър
Ако 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) към отговорите на сървъра си.
Вътрешни/корпоративни регистри
За екипи, които искат да споделят блокове вътрешно:
- Хоствайте регистъра на вътрешен сървър или на URL с достъп през VPN
- Всеки разработчик добавя регистъра URL към
blocks.jsonна проекта си - CLI извлича данни от този URL, както от всеки друг регистър
Не е необходима специална настройка. Достатъчно е URL да е достъпен от машината на разработчика.