Файлы · 3dbc6b6eb856ecf02117ad6993b515a73355a386 · AlexRUS1234 / Khrazhevnik · Mos.Hub

# /etc/apt/sources.list.d/khrazhevnik.list
deb http://<хражевник>:29202/apt/debian stable main
docker pull git.alexrus1234.ru/alexrus1234/khrazhevnik:latest   # основной
docker pull ghcr.io/alexrus1234/khrazhevnik:latest
docker pull docker.io/alexrus1234/khrazhevnik:latest
# 1. Quadlet — в пользовательский путь генератора systemd.
mkdir -p ~/.config/containers/systemd
cp deploy/quadlet/khrazhevnik.container ~/.config/containers/systemd/

# 2. JWT-секрет — Podman Secret (не светится в env и `systemctl show`).
podman secret create jwt-secret "$(openssl rand -hex 32)"

# 3. Каталог данных: контейнер работает под UID 65534 (nobody).
sudo mkdir -p /var/lib/khrazhevnik
sudo chown 65534:65534 /var/lib/khrazhevnik

# 4. Старт.
systemctl --user daemon-reload
systemctl --user start khrazhevnik.service
curl -s http://localhost:29202/healthz   # → ok
# Первый админ (один раз, пока таблица users пуста).
curl -s -X POST http://127.0.0.1:30202/api/v1/setup \
  -H 'Content-Type: application/json' \
  -d '{"username":"admin","password":"<пароль>"}'

# Логин → JWT; регистрируем кеш-прокси Debian.
TOKEN=$(curl -s -X POST http://127.0.0.1:30202/api/v1/auth/login \
  -H 'Content-Type: application/json' \
  -d '{"username":"admin","password":"<пароль>"}' | jq -r .token)

curl -s -X POST http://127.0.0.1:30202/api/v1/remotes \
  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"name":"debian","ecosystem":"apt","base_url":"https://deb.debian.org/debian","mode":"proxy","enabled":true}'
podman exec khrazhevnik /khrazhevnik -add-remote apt/debian=https://deb.debian.org/debian
echo 'deb http://<хражевник>:29202/apt/debian stable main' \
  > /etc/apt/sources.list.d/khrazhevnik.list
apt-get update && apt-get install hello
# Web UI и серверная часть в порядке, используемом CI:
make web-build
make build        # исполняемый файл bin/khrazhevnik
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 \
  go build -trimpath -ldflags="-s -w \
  -X main.Version=1.0.0" \
  -o khrazhevnik ./cmd/khrazhevnik
[server]
public_listen = ":29202"        # раздача пакетов + /healthz
admin_listen  = ":30202"        # /api/v1, /metrics, /ui

[storage]
driver = "fs"                   # fs | s3
[storage.fs]
path = "/var/lib/khrazhevnik/store"
[storage.s3]
endpoint = "" ; region = "" ; bucket = "" ; path_style = true

[database]
driver = "sqlite"               # sqlite | postgres | mariadb
dsn    = "/var/lib/khrazhevnik/khrazhevnik.db"

[auth]
jwt_secret   = ""               # НЕ в проде-файле: env/file (обязателен)
session_ttl  = "8h"
setup_token  = ""               # опц. защита bootstrap первого админа

[cache]
stale_if_error  = true
max_object_size = "20GiB"
negative_ttl_404 = "5m" ; negative_ttl_5xx = "30s"

[mirror]
workers = 4 ; interval_jitter = "10m"

[publish]
max_object_size    = "1GiB"     # лимит одного загружаемого объекта
default_quota_bytes = "5GiB"    # квота нового репо (0 = без лимита)
default_quota_files = 10000

[signing]
keys_dir = "/var/lib/khrazhevnik/keys"   # ed25519-ключ инстанса
# passphrase = ""              # опц.: env KHRZ_SIGNING__PASSPHRASE

[metrics]
enabled = true

[ecosystem.apt]                 # apt | rpm-md | pacman | apk | nix;
enabled = true                  # секция нужна только для переопределения
.
├── cmd/khrazhevnik/          # Точка входа: main.go (~40 строк), wire.go —
│                            # единственная склейка (compile-time реестр)
├── internal/
│   ├── core/
│   │   ├── port/             # Контракты: Storage, Ecosystem, Catalog*, Signer, Clock, Rand, HTTP
│   │   ├── domain/           # Модели + типизированные ошибки (только stdlib)
│   │   ├── config/           # Слои: defaults → TOML → env KHRZ_* (+file://-секреты)
│   │   ├── dbtalk/           # Шим SQL-диалектов каталога (placeholder/upsert)
│   │   ├── engine/           # Usecase-логика: cache, mirror, publish, auth
│   │   ├── registry/         # Compile-time реестр модулей
│   │   └── web/              # chi-роутеры, middleware, TaskRegistry, embed SPA
│   ├── mod/                  # Модули (регистрируются в init()): ecosystem/
│   │                        # {apt, rpmmmd, pacman, apk, nix}, storage/{fs, s3},
│   │                        # db/{sqlite, postgres, mariadb}, sign/{openpgp, ed25519}
│   ├── testutil/             # Общие test doubles (FixedClock, FakeStorage, …)
│   └── contract/             # Контрактные suite каталога/хранилища (integration)
├── migrations/<driver>/      # Embedded goose-миграции (по каталогу на СУБД)
├── web/                      # Vue 3 + Vite + TypeScript SPA (бандл → core/web/assets)
├── deploy/                   # Containerfile (node → golang → scratch) + quadlet/
├── bench/                    # Нагрузочные сценарии k6 + сэмплеры CPU/RAM (методика — docs/func/ru/benchmarks.md)
├── test/                     # integration/ (in-process + binary-smoke), smoke/
├── docs/                     # ARCHITECTURE/SPECIFICATION/TESTING/ROADMAP/HISTORY; func/ru/
└── .forgejo/workflows/       # CI: сборка, тесты, e2e, OCI
Хражевник — кеш-прокси и зеркало linux-репозиториев
Copyright (C) 2026  AlexRus1234

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.