Мой блог // Цифровой архив

Мысли, проекты и технические заметки

Показать записи с тегом: #md-blog Показать все ×

Изначально настройка моего блога планировалась как чисто IPv6-проект через WireGuard, так как всё это работает на домашнем сервере (кстати, бесплатные IPv6-адреса можно получить на route64.org). Чтобы повысить доступность, я добавил внешний IPv4-прокси (спасибо @Larvitz).

При этом сразу возникли проблемы с SSL: так как изначально и A-, и AAAA-записи шли через прокси, проверка Let's Encrypt на моем сервере завершалась ошибкой.

Решение: «IPv6-хак»

Решение заключалось в том, чтобы явно направить AAAA-запись напрямую на WireGuard-IP моего сервера, вместо того чтобы также пропускать её через прокси.

  • Домен: blog.burningboard.org
  • A-запись (прокси): 194.28.98.217
  • AAAA-запись (сервер): 2a11:6c7:f05:a8::2 (WireGuard)

Благодаря этой прямой AAAA-записи на мой WireGuard-IP, Let’s Encrypt по-прежнему обращается к моему серверу напрямую через IPv6 (так как AAAA-запись имеет приоритет по умолчанию) и выпускает SSL-сертификат. IPv4-трафик передается мне прокси-сервером в зашифрованном виде.

Финальная конфигурация

Чтобы взаимодействие работало без сбоев, нам пришлось подправить конфигурацию серверов Caddy:

1. На моем сервере (NixOS, blog.nix)

Чтобы реальные IP-адреса посетителей доходили корректно и не перезаписывались IP-адресом прокси, его необходимо пометить как доверенный:

services.caddy.globalConfig = ''
  servers {
      trusted_proxies static 2a06:9801:1c:1000::10
  }
'';

2. На внешнем прокси (Caddy)

Чтобы прокси корректно обращался к моему серверу по HTTPS, он должен передавать имя хоста (SNI):

reverse_proxy [https://[2a11:6c7:f05:a8::2]:443](https://[2a11:6c7:f05:a8::2]:443) {
    header_up Host {host}
    transport http {
        tls_server_name blog.burningboard.org
    }
}

Теперь блог доступен через IPv4 и IPv6, надежно зашифрован, а мой домашний IP при этом остается приватным! 🚀

Самое важное: привычные Markdown-файлы остаются основой — я просто большой фанат этого простого решения. Но «под капотом» многое изменилось:

Я немного подкрутил настройки:

📂 MD-файлы: Структура блога остается простой и базируется на Markdown.

🌍 Глобальнее, чем когда-либо: теперь мой блог поддерживает перевод на 43 языка. Да, включая клингонский! 🖖 (Qapla'!)

Планировался полностью автоматический перевод в реальном времени на основе определения языка в браузере. Спойлер: это сработало лишь частично. Становится ясно: ИИ впечатляет, но он еще не совсем «там», где нам хотелось бы.

Решение: теперь я просто заранее перевожу каждый пост на все заданные языки, что также гораздо лучше для поисковых систем (SEO). Если автоматическое определение вдруг не сработает, вы можете вручную выбрать предпочтительный язык с помощью иконки глобуса — выбор будет просто сохранен в cookie.

Переводы теперь выполняются с помощью Gemini 3 Flash, что дает удивительно хорошие результаты. Однако за ИИ нужно внимательно следить: при первом массовом прогоне ошибочно были переведены и теги, что, конечно, не планировалось.

Код по-прежнему доступен (если интересно, просто напишите мне) 👍 Но учтите, что теперь системе требуется собственный API-ключ Gemini 🔑.

Я без лишних раздумий перевел свой блог с WriteFreely на собственную разработку: MD-Blog (MD, разумеется, означает Markdown). Поводом послужило неудачное обновление старой системы, но в итоге это стало идеальным стимулом для того, чтобы радикально все упростить и получить полный контроль над дизайном.

Основой являются простые Markdown-файлы в папке data/, которые преобразуются в современный HTML во время выполнения. Результат работает молниеносно, не требует базы данных и благодаря собственной дизайн-системе (включая темную тему) теперь выглядит именно так, как я себе и представлял. Даже современная кнопка «Поделиться в Mastodon» теперь встроена напрямую.

Если вам интересен код или эта лаконичная архитектура, свяжитесь со мной через Mastodon!