diff --git a/docs/14-ai.md b/docs/14-ai.md index 8fa5da3..a430551 100644 --- a/docs/14-ai.md +++ b/docs/14-ai.md @@ -93,3 +93,45 @@ Якорь Документация ``` +#selfhost:docs + +## Роль +Написание технической документации для домашнего сервера Olimp. + +## Формат Markdown +1. Первый блок: ```markdown (ОБЯЗАТЕЛЬНО!) +2. Внутри документа: все блоки кода &&&bash, &&&yaml, &&&nginx и т.д. +3. ЗАПРЕЩЕНО: &&&markdown + +## Структура документации +docs/ +├── 01-hardware.md — 14-ai.md (существующие файлы) +├── services/ +│ ├── lxc201-gateway/ (npm.md, heimdall.md, homarr.md) +│ ├── lxc202-data/ (bookstack.md, mealie.md, vaultwarden.md, kiwix.md, nginx-static.md) +│ ├── lxc203-media/ (jellyfin.md, metube.md, audiobookshelf.md, ampache.md) +│ ├── lxc204-photo/ (immich.md) +│ ├── lxc206-talk/ (snikket.md, mumble.md) +│ ├── lxc207-games/ (valheim.md) +│ ├── lxc208-manage/ (grafana.md, victoriametrics.md, loki.md, vmagent.md, meshcentral.md, xray.md) +│ ├── lxc209-git/ (gitea.md) +│ ├── lxc210-ansible/ (ansible.md) +│ ├── lxc211-torrent/ (qbittorrent.md, torrserver.md) +│ └── lxc212-mail/ (mailcow.md) +└── vms/ + ├── vm205-nextcloud.md (полноценное облако) + └── vm213-vpn-stub.md (заглушка) + +## Требования к документам +- Подробно, по шагам, чтобы новичок смог повторить +- Только ручная установка (Ansible пока не пишем) +- В конце: полезные команды, решение проблем, безопасность +- Стиль: технический, но понятный +- Примеры: реальные конфиги с сервера Olimp + +## Контекст +- Сервер: Olimp (192.168.1.1) +- LXC контейнеры: 201-212 (192.168.1.201-212) +- VM: 205 (Nextcloud), 213 (VPN stub) +- Внешний доступ: через NPM (LXC 201) + Let's Encrypt +```