Към съдържанието

Персонализиран сървър

Ако 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. Хоствайте регистъра на вътрешен сървър или на URL с достъп през VPN
  2. Всеки разработчик добавя регистъра URL към blocks.json на проекта си
  3. CLI извлича данни от този URL, както от всеки друг регистър

Не е необходима специална настройка. Достатъчно е URL да е достъпен от машината на разработчика.