Настройка Robust.Cdn

services:
  robust_cdn:
    image: ghcr.io/space-wizards-federation/robust.cdn:2
    container_name: robust_cdn
    user: 1654:1654
    volumes:
      - ./appsettings.json:/app/appsettings.json
      - ./builds:/builds
      - ./manifest:/manifest
      - ./database:/database
    ports:
      - 8080:8080
    restart: unless-stopped

sudo chown -R 1654:1654 builds/ database/ manifest/
sudo chmod -R u+w,g+w builds/ database/ manifest/

git clone https://github.com/space-wizards-federation/Robust.Cdn.git
cd Robust.Cdn
dotnet publish -c Release -r linux-x64 --no-self-contained

/opt/robust_cdn/
├── appsettings.json
├── bin
│   ├── Robust.Cdn
│   ├── Robust.Cdn.dll
    .

# /etc/systemd/system/robust-cdn.service
[Unit]
Description=Robust.Cdn

[Service]
Type=notify
WorkingDirectory=/opt/robust_cdn/
ExecStart=/opt/robust_cdn/bin/Robust.Cdn
User=robust_cdn

[Install]
WantedBy=multi-user.target

{
  // Настройка уровня логирования, можете оставить по умолчанию.
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning",
      "Robust": "Information"
    }
  },

  // Содержит конфигурацию в основном для работы манифеста,
  // но также требуется для операций CDN для настройки доступных форков.
  "Manifest": {
    // Расположение сборок на диске.
    // Пропустите при использовании официальных образов контейнеров.
    "FileDiskPath": "/var/robust-cdn/builds",

    // Файл базы данных, содержащий информацию для функций манифеста сервера.
    // Пропустите при использовании официальных образов контейнеров.
    "DatabaseFileName": "/var/robust-cdn/manifest.db",

    // Набор доступных форков, которые должен обслуживать Robust.Cdn.
    "Forks": {
      // Конфигурация для одного форка. Ключ здесь — это ID форка, который будет использоваться во многих местах.
      // ВЫ ДОЛЖНЫ СДЕЛАТЬ ID ФОРКА ПОЛНОСТЬЮ ГЛОБАЛЬНО УНИКАЛЬНЫМ, ЧТОБЫ ИЗБЕЖАТЬ ПРОБЛЕМ.
      // НЕ ПИШИТЕ ПРОСТО «TEST».
      "test": {
        // Токен, используемый для публикации новых версий в этом форке.
        // ***ВЫ ДОЛЖНЫ ИЗМЕНИТЬ ЕГО НА НОВОЕ УНИКАЛЬНОЕ ЗНАЧЕНИЕ***.
        "UpdateToken": "foobar",

        // Конфигурация для уведомления экземпляров SS14.Watchdog о новых обновлениях. Можно указать несколько.
        "NotifyWatchdogs": [
          {
            // Базовый адрес watchdog.
            "WatchdogUrl": "http://localhost:5000/",

            // Конкретный экземпляр сервера на watchdog для уведомления.
            "Instance": "syndicate_mothership",

            // ApiToken, указанный в конфигурации watchdog для этого экземпляра.
            "ApiToken": "Honk"
          }
        ],

        // Установите в true, чтобы сделать этот форк «приватным».
        // Приватные форки ограничивают доступ к серверным сборкам, что желательно для серверов с секретным контентом.
        // См. ниже для подробностей.
        "Private": false,

        // Комбинации имени пользователя и пароля для доступа к серверным файлам приватных форков.
        // Игнорируется, если не является приватным форком.
        "PrivateUsers": {
          "foobar": "baz"
        },

        // Сколько дней хранить старые файлы сборок.
        "PruneBuildsDays": 90,

        // Понятное человеку отображаемое имя этого форка.
        // Отображается в таких местах, как HTML-страница сборок.
        "DisplayName": "Test Fork",

        // Целевая ссылка на HTML-странице сборок.
        "BuildsPageLink": "https://example.com",

        // Текст ссылки на HTML-странице сборок.
        "BuildsPageLinkText": "Test Fork LINK"
      }
    }
  },

  // Конфигурация в основном для клиентского CDN.
  "Cdn": {
    // Файл базы данных, содержащий информацию для функций манифеста сервера.
    // Пропустите при использовании официальных образов контейнеров.
    "DatabaseFileName": "/var/robust-cdn/content.db",

    // Увеличьте это значение, чтобы снизить использование полосы пропускания для больших загрузок. Большие числа требуют больше CPU.
    "StreamCompressLevel": 5,

    // «Запасной» форк для функции миграции с Robust.Cdn 1.x.
    // Можно пропустить для новых установок.
    "DefaultFork": "test"
  },

  // Корневой URL, по которому ваш сервер Robust.Cdn глобально доступен.
  // Это необходимо для правильной генерации метаданных сборки.
  "BaseUrl": "https://<robust-cdn-url>/",

  // Базовый путь, по которому доступен Robust.Cdn.
  // Следует установить при обратном проксировании Robust.Cdn за подпутьём.
  // См. также примечания ниже.
  "PathBase": "/",

  // Допустимые имена хостов для подключения клиентов к Robust.Cdn.
  // Можете просто оставить как есть.
  "AllowedHosts": "*",

  // Измените порт для привязки Robust.Cdn здесь.
  // Пропустите при использовании официальных образов контейнеров.
  "Urls": "http://localhost:27690/",
}

# gzip JSON-ответы.
gzip on;
gzip_types application/json;

location / {
    # Увеличенный максимальный размер тела для multi-request публикаций. Не обязателен для одноэтапных публикаций.
    client_max_body_size 512m;

    # Не буферизировать тела запросов внутри nginx, особенно важно для multi-request публикаций.
    proxy_request_buffering off;
    # Отключить буферизацию исходящих ответов.
    proxy_buffering         off;
    # Обеспечить возможность потоковой передачи запросов и ответов через HTTP 1.1.
    proxy_http_version      1.1;
    # Увеличенный тайм-аут чтения для избежания тайм-аутов на API эндпоинте публикации.
    # Не является строго необходимым для multi-request публикаций, но не помешает.
    proxy_read_timeout      120s;

    # Стандартная конфигурация обратного прокси.
    proxy_set_header   Host $http_host;
    proxy_set_header   X-Real-IP $remote_addr;
    proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header   X-Forwarded-Proto $scheme;

    # Обновите порт здесь.
    proxy_pass         http://localhost:8080;
}

# Увеличенный максимальный размер тела для multi-request публикаций.
request_body {
    max_size 512MB
}

# Обновите порт здесь.
reverse_proxy localhost:8080 {
    flush_interval -1
}

# Сжатие JSON-ответов.
encode zstd gzip {
    match header Content-Type application/json*
}

UpdateType: "Manifest"
Updates:
  # Замените на ваш собственный URL Robust.Cdn и ID форка.
  ManifestUrl: "https://<robust-cdn-url>/fork/<fork>/manifest"

"BaseUrl": "https://example.com/cdn/",
"PathBase": "/cdn/",

# Обратите внимание на завершающий слеш!
# плохо
proxy_pass http://127.0.0.1:8080/;
# хорошо
proxy_pass http://127.0.0.1:8080;

UpdateType: "Manifest"
Updates:
  # Замените на ваш собственный URL Robust.Cdn и ID форка.
  ManifestUrl: "https://<robust-cdn-url>/fork/<fork>/manifest"
  Authentication:
    Username: foobar
    Password: baz

/var/robust-cdn/builds
├── wizards
│   ├── 02030cfa0ed6511ec5527c5b7d1f8bcd46fe1435
│   │   ├── SS14.Client.zip
│   │   ├── SS14.Server_linux-arm64.zip
│   │   ├── SS14.Server_linux-x64.zip
│   │   ├── SS14.Server_osx-x64.zip
│   │   └── SS14.Server_win-x64.zip
│   ├── 021d39be2876f991c5fd6e663760a921d29ac694
│   │   ├── SS14.Client.zip
│   │   ├── SS14.Server_linux-arm64.zip

#!/usr/bin/env python3

import sqlite3
import json
import re

from datetime import datetime, timezone
from dateutil import parser as dateparser

JSON_FILE = "manifest.json"
DB_FILE = "manifest.db"
FORK_NAME = "wizards"

def main():
    data = json.loads(open(JSON_FILE, "r").read())
    db = sqlite3.connect(DB_FILE)
    cur = db.cursor()

    cur.execute("SELECT Id FROM Fork WHERE Name = ?", (FORK_NAME,))
    fork_id = cur.fetchone()[0]

    for name, build in data["builds"].items():
        time = dateparser.parse(build["time"])
        time = time.astimezone(timezone.utc)

        cur.execute(
            "INSERT INTO ForkVersion (Name, ForkId, PublishedTime, ClientFileName, ClientSha256, Available, EngineVersion) VALUES (?, ?, ?, ?, ?, TRUE, '')",
            (name, fork_id, time, file_name(build["client"]["url"]), bytes.fromhex(build["client"]["sha256"])))
        version_id = cur.lastrowid

        for rid, server in build["server"].items():
            cur.execute(
                "INSERT INTO ForkVersionServerBuild (ForkVersionId, Platform, FileName, Sha256) VALUES (?, ?, ?, ?)",
                (version_id, rid, file_name(server["url"]), bytes.fromhex(server["sha256"])))

    db.commit()


def file_name(url: str) -> str:
    return url.split("/")[-1]

main()

{
  "version": "<version>",
  "engineVersion": "<engine version>",
  "archive": "<builds archive URL>"
}

{
  "version": "<version>",
  "engineVersion": "<engine version>"
}

{
  "version": "<version>"
}