add agate-virtual-host-usage-examples.gmi

This commit is contained in:
postscriptum 2025-11-19 00:01:00 +02:00
parent 86cf7914d8
commit fc3aa74ccf
3 changed files with 57 additions and 1 deletions

View file

@ -0,0 +1,47 @@
# Специфіка роботи з віртуальними хостами Agate
Давно користуюсь цим сервером, але тільки недавно второпав його нюанси. Зокрема, як направляти трафік з різних віртуальних хостів (доменів) на спільну теку без створення символічних посилань. Це зручно, якщо хостити капсулу на різні мережі - I2P, Yggdrasil, тощо.
## Сценарії
Наведені нижче приклади - актуальні для Agate v3.3.19
### Мульти-домен на спільну теку
Це зручно, якщо наприклад, домен має декілька аліасів для спільного контенту:
* ps.i2p - домен для користувачів мережі I2P
* ps.ygg - домен для користувачів мережі Yggdrasil
Для цього, достатньо не вказувати аргумент(и) `--hostname`:
``` bash
agate --content /path/to/content
```
* /path/to/content - тека для ps.i2p, ps.ygg
### Мульти-домен на однойменну теку
Якщо вказати більше одного аргумента `--hostname` для кожного з доменів, то сервер шукатиме відповідну для хоста теку в локації `--content`:
``` bash
agate --content /path/to/content\
--hostname ps.i2p\
--hostname ps.ygg
```
* /path/to/content/ps.i2p - шлях для `--hostname ps.i2p`
* /path/to/content/ps.ygg - шлях для `--hostname ps.ygg`
### Маршрутизація без DNS
В оверлейних IPv6 мережах типу Yggdrasil, використання DNS є другорядним і перевага надається URL на базі статичного IP. На момент допису, такої підтримки сервер Agate не має. Можливо, знайду час на доопрацювання, а в якості тимчасового рішення - можу порадити сервер gmid (clang)
=> gmid-server-for-gemini-protocol.gmi Gmid - багатофункціональний сервер для Gemini
## Посилання
=> https://github.com/mbrubeck/agate/blob/master/README.md#virtual-hosts Офіційна документація
### Дивіться також
=> i2p-capsule-in-gemini-space-with-agate.gmi Публікація капсули Gemini в I2P на прикладі сервера Agate

View file

@ -116,4 +116,12 @@ WantedBy=multi-user.target
Після цього, можна відкрити адресу в браузері, наприклад:
=> gemini://shxxkkrws2m6qowjse5jpgmu64vzupnnhxrhdzrn6fr6m7ynddbq.b32.i2p
=> gemini://shxxkkrws2m6qowjse5jpgmu64vzupnnhxrhdzrn6fr6m7ynddbq.b32.i2p
## Посилання
=> https://devzone.org.ua/post/publikatsiia-kapsuly-gemini-v-i2p-na-prykladi-servera-agate Веб-адаптація цього матеріалу з коментарями на DevZone
### Дивіться також
=> agate-virtual-host-usage-examples.gmi Специфіка роботи з віртуальними хостами Agate

View file

@ -12,6 +12,7 @@
### Нотатки
=> agate-virtual-host-usage-examples.gmi 2025-11-19 Специфіка роботи з віртуальними хостами Agate
=> custom-proxy-option-per-server-in-the-halloy-irc.gmi 2025-11-18 Реалізував опцію вибіркового проксі в IRC-клієнті Halloy
=> soju-irc-bouncer-setup.gmi 2025-11-17 Встановлення та базове налаштування IRC-баунсера soju
=> radicle-is-decentralized-p2p-git-dvcs.gmi 2025-11-16 Radicle: децентралізований P2P хостинг Git/DVCS