Прошло некоторое время от начала моих экспериментов с хостингом простых сайтов в IPFS. Запустил я свой IPFS клиент под Windows и у меня есть теперь что дополнить к предыдущей статье "Публикуем сайт в межпланетной файловой системе IPFS"
- Решение проблемы c utf-8 в консоли Windows XP.
- Своя страница 404
- Корректная загрузка сайта с разных URL
Напомню: InterPlanetary File System — это новая децентрализованная сеть обмена файлами (HTTP-сервер, Content Delivery Network). О ней я начал рассказ в статье "Межпланетная файловая система IPFS".
Перед стартом
Необходимо создать ярлык на ipfs.cmd файл в свойствах которого поменять шрифт на Lucida Console. Это даст возможность переключиться на UTF-8.
Запуск IPFS под Windows
Хочется видеть какие запросы приходят к нашему клиенту. Используем командный файл. Он настроит вывод консоли, переменные и при помощи findstr или grep отфильтрует вывод IPFS клиента.
Для Windows 7 и новее
Файл: ipfs.cmd
rem Переключаем на UTF-8 (>= Windows 7)
chcp 65001
rem Выключаем цветной лог который не работает в консоли Windows
SET IPFS_LOGGING_FMT=nocolor
rem |-D - включает режим DEBUG в котором в консоль выводится информация о работе клиента
rem |listening - покажет открытые порты
rem |namesys - покажет процесс разрешения домена
rem |path - покажет конечный путь куда обращается клиент
ipfs.exe daemon -D 2>&1|findstr "listening namesys path" 2>nul
pauseДля Windows XP
В Windows XP есть особенность что попытавшись переключить на utf-8 в командном файле выполнение сразу завершается. Методом проб и ошибок мне удалось переключить кодировку в командном файле.
start "utf-8" /B cmd /C chcp 65001
Но оказалось команда должна отработать во время работы программы. И надо вернуть кодировку по завершении команды.
После того как я "открыл" способ переключения нашёл другие решения.
chcp 65001 | ipfs daemon & chcp 1251
Таким образом переключение на utf-8 выполняется во время работы ipfs. А когда работа ipfs заканчивается кодировка переключается на win1251 и bat файл продолжает работу.
Нам понадобится Grep for Windows. Findstr вырубается при включенном UTF-8 от первой строки в которой присутствуют символы кириллицы. Ну и отображает за место них точки.
Файл: ipfs.cmd
rem Выключаем цветной лог который не работает в консоли Windows
SET IPFS_LOGGING_FMT=nocolor
rem |Переключаем на UTF-8 (Windows XP)
rem |-D - включает режим DEBUG в котором в консоль выводится информация о работе клиента
rem |listening - покажет открытые порты
rem |namesys - покажет процесс разрешения домена
rem |path - покажет конечный путь куда обращается клиент
chcp 65001|ipfs.exe daemon -D 2>&1|grep "listening\|namesys\|path" 2>nul & chcp 1251
pause404 Not Found
Страница с ошибкой 404 отображается на сайте обычно когда файл или директория с таким именем не найдены на сервере. Теперь для создания страницы 404 в IPFS есть два способа.
ipfs-404.html
Новая версия IPFS если целевой файл не найден теперь ищет от директории в которой файл не найден до корневой директории файл ipfs-404.html и выводит его содержимое.
Теперь для того чтобы задать свою страницу 404 всему сайту достаточно добавить в корень сайта файл с именем ipfs-404.html и содержимым которое необходимо на странице 404.
manifest.appcache
В старой версии IPFS нет настраиваемой страницы 404. Мы её можем имитировать при помощи appcache.
Файл: manifest.appcache
CACHE MANIFEST
# 2017-03-29 v1.0
# Записываем в кеш 404.html
CACHE:
404.html
# Назначаем её ответом в случае получения 404 от сервера
FALLBACK:
/ 404.html
# Разрешаем всё остальное грузить с сервера
NETWORK:
*При использовании appcache нельзя устанавливать заголовок Expiries для страниц на которых объявлен manifest.appcache и ресурсов указанных в манифесте в разделе CACHE. При обновлении файла manifest.appcache Firefox "обновляет" файлы указанные в манифесте из собственного кэша чем оставит старые файлы с обновлённым манифестом.
На страницах нельзя указывать в теге base <base href="https://домен/" /> который ведёт на другой домен. Firefox дополняет путь к файлу манифеста значением свойства href тега base и блокирует загрузку manifest.appcache если он на другом домене или протоколе (http -> https).
Другие нюансы: "Основные ловушки при использовании кэша в HTML5-приложениях"
URL Относительные пути к ресурсам
Внешние ресурсы страницы должны быть указаны относительными путями. Содержимое сайта в IPFS может быть загружено с множества разных url разной степени вложенности.
http://домен/страница.html
http://ipfs.io/ipns/домен/страница.html
http://ipfs.io/ipns/мультихеш_публичного_ключа/страница.html
http://ipfs.io/ipfs/мультихеш_каталога/страница.html
и даже так
http://ipfs.io/ipfs/мультихеш_файлаДля последнего случая лучше включать css и js в страницу. Либо включить скрипт который обработает данный случай и выставит правильные ссылки на ресурсы и страницы.
Также вместо "ipfs.io" или домена в адресе может быть:
localhost:8080127.0.0.1:8080[::1]:8080
и так далее.
В итоге у нас получится такая страница.
Файл: index.html
<!doctype html>
<!-- Используем относительный путь в manifest -->
<html manifest="manifest.appcache">
<head>
<meta charset="utf-8" />
<title>Мой сайт</title>
<script>
if (window.location.hash.substr(1,8) == "magnet:?"){
var magnet = document.location.hash.substr(9)
// Используем относительный путь в скриптах
setTimeout(function() {window.location.replace("magnet-converter/#magnet:?"+magnet);}, 0);
}
</script>
</head>
<body>
<!-- Используем относительные пути в href -->
<a href="magnet-converter/">magnet converter</a>
<a href="gravity/gravity.svg">gravity</a>
<a href="https://github.com/ivan386?tab=repositories">All projects</a>
<!-- Используем относительные пути в src -->
<img src="imgs/stars-static.svg" style="display: block; width: 100%" />
</body>
</html>IPFS как зеркало
Не обязательно использовать IPFS клиент как HTTP-сервер. Можно использовать любой HTTP-сервер который будет отдавать содержимое сайта если у посетителя не установлен IPFS клиент. В IPFS можно загрузить зеркало этого сайта.
Заключение
Рассказал что вспомнил. Надеюсь это не мало. Есть идея по реализации дедупликации и ускорения классического интернета за счёт IPFS. Надеюсь рассказать об этом в будущих статьях с рабочими примерами.
Мои релизы клиента IPFS с исправлениями на GitHub:
- Совместимость с punycode.
- Etag для всех GET запросов.
- Правильное определение скрытых файлов в Windows.
