💾 Archived View for dmntv.ru › notes › raspiagate.gmi captured on 2024-12-17 at 10:05:13. Gemini links have been rewritten to link to archived content

View Raw

More Information

-=-=-=-=-=-=-

Сервер Gemini на Raspberry Pi

(памятка/инструкция, краткое пошаговое руководство)

Raspberry Pi Zero 2W

Установка настройка и запуск Gemini сервера Agate

Заходим на Raspberry Pi (user-name@ip-address)

ssh user@host

Создаем структуру каталогов для файлов сервера и файлов/страничек которые сервер будет отдавать на внешние запросы

(подразумевается что мы находимся в нашей домашней директории)

mkdir gemini gemini/bin gemini/bin/.certs gemini/public

Создаем «индексный» файл

nano gemini/public/index.gmi

Напишем туда что-нибудь типа:

# Hello!
This is my first page in GeminiSpace

Загружаем и распаковываем предварительно скомпилированный двоичный файл. Там разные. Берите нужный.

Agate: Simple Gemini server for static files

Agate: Pre-compiled binary

Команда uname вывоводит информацию о системе.

uname -a выводит полную информацию.

uname -a

uname -m выводит имя аппаратного имени машины.

uname -m

В моем случае, мы получим aarch64

Следовательно:

wget https://github.com/mbrubeck/agate/releases/download/v3.3.11/agate.aarch64-unknown-linux-gnu.gz

Распаковываем его

gunzip agate.aarch64-unknown-linux-gnu.gz

Перемещаем в созданную ранее директорию bin и переименовываем в agate

mv agate.aarch64-unknown-linux-gnu gemini/bin/agate

Даем права на «выполнение» файла

chmod +x gemini/bin/agate

Запускаем сервер с указанием пути до нашей public директории, портом (1965) и именем.

(подставте свои значения)

/home/dmntv/gemini/bin/agate --content /home/dmntv/gemini/public/ --addr [::]:1965 --addr 0.0.0.0:1965 --hostname dmntv.ru --certs /home/dmntv/gemini/bin/.certs --lang ru-RU

Agate сгенерирует ключи и самоподписанные сертификаты для каждого указанного имени хоста и поместит их в директорию .certs Поскольку они самоподписанные, при первом обращении, нам нужно будет подтвердить, что мы им доверяем.

В итоге (в моем случае) вся структкра выглядит примерно так:

/home/dmntv
┗━━ ~/gemini
    ┣━ ~/gemini/bin
    ┃  ┣━ ~/gemini/bin/.certs
    ┃  ┃  ┗━ ~/gemini/bin/.certs/dmntv.ru
    ┃  ┃     ┣━ ~/gemini/bin/.certs/cert.der
    ┃  ┃     ┗━ ~/gemini/bin/.certs/key.der
    ┃  ┗━ ~/gemini/bin/agate
    ┗━ ~/gemini/public
       ┗━ ~/gemini/public/index.gmi

Для настройки автоматического запуска создадим файл в директории /etc/systemd/system/

sudo nano /etc/systemd/system/agate.service

Разместим там следующие иструкции

(Подставляя правильные пути для двоичного файла, публичной директории и директории сертификатов указав нашего пользователя)

[Unit]
Description=agate
After=network.target

[Service]
User=dmntv
Type=simple
ExecStart=/home/dmntv/gemini/bin/agate \
--content /home/dmntv/gemini/public/ \
--addr [::]:1965 \
--addr 0.0.0.0:1965 \
--hostname dmntv.ru  \
--certs /home/dmntv/gemini/bin/.certs \
--lang ru-RU

[Install]
WantedBy=default.target

Управление службами

Запустить службу

sudo systemctl start agate

Остановить службу

sudo systemctl stор agate

Показать состояние службы

sudo systemctl status agate

Добавить службу в автозагрузку

sudo systemctl enable agate

Обновить конфигурацию после внесения изменений

sudo systemctl daemon-reload

Посмотреть полный список всех опций команды systemctl

systemctl --help