Opensophy: что нового на 22 сентября?

Opensophy Hub в архиве, да здравствует os.docs

Ранее, когда я создавал инициатива Hub, это была статическая платформа для документации и контента с админ-панелью. От этой идеи пришлось отказаться по следующим причинам:

1. Проект ради эксперимента. Изначально он создавался не для использования другими пользователями, а в целом для моих целей и эксперимента (статья на е).

2. ui-треш и неопределённость. Я долго думал над дизайном, никак не мог определиться, вечно экспериментировал — и получил хорошую критику от пользователей, включая от а :)

3. Не docs-as-code, а бургер. Админ-панель плюс сама философия проекта — то, что он должен быть docs-as-code, — плохо сочетались.

Что из этого вышло?

Поскольку мне всё же нужна была норм платформа для документации — чтобы она имела больше автоматизации, была по-настоящему docs-as-code, да ещё и с сохранением системы [N];[C];[A] (быстрое разработка путей / название и slug страницы), — я создал на базе этого минимальный шаблон os.docs, взяв всё самое лучшее.

1. Я сменил стек с React на Svelte в пользу того, что он, по моему мнению, проще и оказался производительнее.

2. Единый красивый оформление ui (скрин). Прокачал в этом навыки, вдохновляясь системами документации других проектов, — думаю, получилось идеально!)

3. Автоматизация SEO/GEO — в отличие от Hub, где приходилось делать это вручную, теперь всё на автомате.

4. Отказался от админ-панели в пользу docs-as-code — решил, что она вообще не нужна в моём случае, т. к. раньше она была доступна только через IDE. Поэтому для упрощения работы и безопасности сделал всё «правильно» с точки зрения современных проектов.

Шаблон доступен в open-source. Ссылка: github.com/opensophy-projects/docs

Сам инициатива hub больше не поддерживается и в архиве.

ui Набор модулей

Когда-то я хотел сделать реестр библиотек (статья на е), но ещё раз подтвердил своё «одно но».

Несмотря на то что многие сервисы предоставляют компоненты как open-source, у некоторых из них есть платные компоненты (что можно понять — таким образом авторы получают доход от сервиса). Однако есть один момент, в связи с которого я скоро верну свою ui-библиотеку в интернет (она будет доступна по адресу пользовательский интерфейс.opensophy.com).

В чём проблема и зачем я хочу это сделать? В первую очередь это будет архив компонентов, который всегда будет открыт и бесплатен. Возможно, возникнет вопрос: зачем? Дело в том, что я стартовал замечать, как некоторые компоненты, которые раньше были бесплатными и считались open-source, теперь требуют либо регистрации в системе автора, либо покупки. Следовательно иметь собственный реестр, где все эти компоненты будут сохранены и всегда доступны другим, кажется мне хорошей идеей — даже если эти компоненты уже где-то встречались.

И вашему вниманию я представляю open-source библиотеку Svelte-компонентов (под React их и так множество, а вот под Svelte — мало!). На данный момент доступно 40+ компонентов, планируется пополнять до 50–100. Сама библиотека на момент написания новости доступна на главном сайте: opensophy.com/components/overview

Обновление os.mtls — средство для быстрого создания и управления mTLS-сертификатами для Traefik

Не так давно я открыл для себя технологию mTLS, и знаете, это оч крутая вещь для homelab! Но есть проблемы.

1. Не все прокси поддерживают полное управление mTLS. И так случилось, что именно под мой стек с Traefik нет полноценной поддержки.

2. Не всегда это удобно и просто.

На эту тему я писал 2 статьи про mTLS: «Руководство» и «mTLS на практике», где обсуждались его применение и модели атак, которые я нашёл на сам протокол, а равным образом моя проблема и решение. А подход было достаточно простеньким для моего сценария — один bash-скрипт для полноценного управления и решения проблемы Traefik (в Traefik из «коробки» действительно отсутствует проверка отзыва клиентских сертификатов — CRL или OCSP — для mTLS: если отозвать сертификат клиента, он продолжит успешно проходить аутентификацию, пока не истечёт его срок действия). Можно сказать, что стоило бы поставить Service Mesh, но мне это не особо подходило.

Так вот, что принесло само апдейт:

В V2 я добавил множество функций, которые потенциально могли нарушить безопасность, — от них я отказался и остановился на stable-версии (она же последняя), которая сильно улучшает защита скрипта: доступ только от root, бэкапы, аудит и небольшой функционал в CLI, в том числе создание своих пресетов путей. Проект тоже open-source и доступен каждому, кто занимается homelab’ом и хочет с минимальными усилиями получить крутую защита. Инфо на сайте opensophy.com/mtls либо в репозитории github.com/opensophy-projects/mtls. Буду рад идеям, как усовершенствовать сценарий.

И один из главных проектов этого года для меня — форк Dokploy. Инициатива пока имеет закрытый репозиторий, но доступ к нему можно получить по запросу. ( Он скоро будет доступен в open-source формате просто на текущий момент я изучаю как мне его лучше открыть чтобы не упираться в Githubовские ограничения CI/CD.)

Что такое Dokploy и почему я решил его форкнуть?

Если вкратце — это система для управления серверами и деплоя приложений: развернуть можно почти всё что угодно — Docker Compose, Nixpacks, Buildpacks или свой Dockerfile. Она была идеальной, но многие пользователи, как и я, стартовали искать альтернативы после внедрения «enterprise»-функций, в связи с чего open-source-версия начала захламляться функционалом, который недоступен, а заодно почему-то была удалена локализация на многие другие языки. Мой форк предоставляет цельный доступ к этим «enterprise»-функциям, почти полностью русифицированный интерфейс, а самое главное — усовершенствование безопасности: я заметил, что в проекте достаточно множество старых зависимостей, а также несколько багов, которые пришлось исправлять в достаточно зрелых функциях. Скрины того, как теперь выглядит интерфейс и вся система, можете посмотреть на сайте: opensophy.com/dokploy. Одновременно функционал всё ещё соответствует докам и обновляется из upstream, из-за чего кое-где можно увидеть текст на английском в интерфейсе — такое бывает, если я не до конца проследил за всеми изменениями. Начиная с v0.30.2 оболочку был целиком русским, сейчас, сейчас в v0.30.6, есть некоторые промахи в некритичных местах, где я забыл сделать перевод.

Поэтому если есть те, кто пользуется Dokploy и не хочет этих ограничений, — предлагаю оценить мою версию. Кстати, я планирую добавить туда и управление mTLS (хотя и сомневаюсь, создавать это или нет — напишите в комментариях, стоит ли. Сомневаюсь в связи с того, что это не относится к платформе, и, возможно, лучше оставить это отдельным проектом os.mtls в пользу безопасности).

На этом пока всё?

Не совсем. Я продолжаю вести публичный эксперимент по борьбе с псориазом и пока могу поделиться анонсом, что, кажется, нашёл причину появления этого псориаза(конкретно у меня). Свою позицию на этот счёт вы сможете ознакомиться во 2-й части статьи, которая по планам должна выйти в конце декабря (хоть и планировалось в конце осени, но мои гипотезы должны ещё подтвердиться, а лечение — вполне долгое, как и его изучение). Подробности о том, что за эксперимент — в статье на е.