openspec: archive fix-trusted-proxies, merge trusted-proxies spec

- docker-compose.yml: GTS_TRUSTED_PROXIES now 10.8.0.4/32,127.0.0.1/32,::1,172.30.0.1/16
- config.yaml: trusted-proxies sync (172.29.0.1/16 -> 172.30.0.1/16, actual docker gw)
- openspec: change fix-trusted-proxies (proposal/specs/design/tasks)
- verified: warning gone (0 matches), external IP 178.176.197.2 in logs, HTTP 200

STATUS.md

@@ -1,34 +1,54 @@
 # GoToSocial — Статус
 
-Обновлено: 2026-09-06 (сессия 2026-09-06_19xx)
+Обновлено: 2026-09-06 (поздний вечер, деплой завершён)
 
 ## Текущее состояние
 
-Проект развёртывания GoToSocial-ноды на social.dedinit.ru оформлен: создан каталог /opt/gotosocial, OpenSpec change deploy-gotosocial (валиден), все рабочие файлы (compose, config, .env, backup.sh, README) готовы и запушены в git. **Сервис ещё НЕ запущен** — это следующий шаг. DNS social.dedinit.ru → 87.242.100.206 (vps02) создан пользователем.
+GoToSocial **запущен и работает** на social.dedinit.ru: контейнер Up, HTTPS 200, админ создан.
+Split-domain работает: аккаунты `@user@dedinit.ru`, хост social.dedinit.ru, apex-webfinger отдаёт JSON.
+Ежедневный cron-бэкап (02:00) активен и проверен.
 
 ## Сделано
 
-- 2026-09-06: исследование развёртывания GoToSocial (доки v0.22.1, split-domain, Docker)
+### Запуск на bigbox (шаг 1)
-- 2026-09-06: каталог /opt/gotosocial, OpenSpec init + change `deploy-gotosocial` (proposal/spec×2/design/tasks), `openspec validate` ✅
+- 2026-09-06: тег образа `0.22.1` (не `v0.22.1` — оригинала не существует), порт `8082:8080`
-- 2026-09-06: docker-compose.yml (v0.22.1, SQLite, порт 8080, volume ./data, net 172.29.0.0/16)
+  (8080 на bigbox занят NetBox!), права `data/` → 1000:1000
-- 2026-09-06: config.yaml (host=social.dedinit.ru, account-domain=dedinit.ru, SMTP Jino, metrics, log json)
+- 2026-09-06: конфиг через `GTS_*` env — docker-образ НЕ читает смонтированный config.yaml
-- 2026-09-06: .env (SMTP-пароль; в git исключён), backup.sh (SQLite VACUUM INTO + медиа, ротация 7д/30д, ЯД), README.md, .gitignore
+  (падал «host must be set»), .cache для Wazero
-- 2026-09-06: git init + commit d385d8b
+- 2026-09-06: админ `estorozhenko` создан/confirmed/promoted; HTTPS LE на social.dedinit.ru ✅
-- 2026-09-06: gitverse репо `kpa39l/gotosocial` создан (API, Bearer+Accept object+json), main запушен
+
-- 2026-09-06: gitea.nixg.ru pull-mirror `estorozhenko/gotosocial` (интервал 8ч), первая синхронизация ✅ (коммит d385d8b)
+### Caddy vps02 (шаг 2)
+- 2026-09-06: Caddyfile: `social.dedinit.ru { reverse_proxy 10.8.0.2:8082 }` + reload
+  (бэкап Caddyfile.bak-1788723018), сертификат LE выпущен сразу, сайт 200
+
+### Split-domain apex Jino (шаг 3)
+- 2026-09-06: .htaccess/mod_rewrite на Jino НЕ работают (проверено) → статический ответ:
+  - `/.well-known/webfinger?resource=...` → Apache 301 → `/webfinger/` → 200 JSON (index.html)
+  - `/.well-known/nodeinfo` → 301 → `/nodeinfo/` → 200 JSON
+  - `/.well-known/host-meta` → 200 XRD (text/xml)
+  - Файлы в `/dedinit.ru/.well-known/` (Jino) + `/opt/dedinit.ru/static/.well-known/` (в git, Hugo копирует)
+
+### Крон бэкапа (шаг 4)
+- 2026-09-06: backup.sh переписан на SQLite Backup API через python3 (sqlite3 CLI нет ни на хосте,
+  ни в контейнере); медиа из data/ (это и есть /gotosocial/storage), SQLite отдельно
+- 2026-09-06: cron `gotosocial-backup-daily` (id 67308da56b6d), daily 02:00, no_agent, deliver local,
+  тихий (пустой stdout при успехе), проверен немедленным запуском (3 бэкапа 19:41-19:42)
+- Локально 7 дней, ЯД 30 дней
+
+### Git
+- 2026-09-06: gotosocial commit d9951b6 запушен на gitverse (56f228a..d9951b6)
+- 2026-09-06: dedinit.ru commit b049cb2 запушен на gitverse (3d2f07b..b049cb2)
 
 ## В работе / Следующие шаги
 
-- [ ] **Развернуть сервис на bigbox**: `cd /opt/gotosocial && docker compose up -d` + создание админа estorozhenko (нужен пароль от пользователя)
+- [ ] Проверить SMTP-письмо (регистрация/восстановление пароля) — через админку
-- [ ] **Caddy на vps02**: блок `social.dedinit.ru { reverse_proxy 10.8.0.2:8080 }` + reload (нужен доступ vps02)
+- [ ] Мониторинг: пробросить :9464 (метрики уже слушают), job в prometheus.yml, дашборд Grafana
-- [ ] **Split-domain apex**: .well-known редиректы (webfinger/nodeinfo/host-meta) на dedinit.ru (Jino) — подготовить точные правила
+      (инструкция по метрикам GtS получена от пользователя 2026-09-06)
-- [ ] Проверить HTTPS (сертификат LE), webfinger, SMTP-письмо, /metrics
+- [ ] Логи в json-формате при желании (log-format: json) — по умолчанию logfmt
-- [ ] Настроить cron бэкапа (backup.sh готов; расписание ещё нет)
 
 ## Отложено (post-MVP, по решению пользователя)
 
 - Мониторинг бэкапов (метрики в Prometheus + дашборд Grafana)
-- Дашборд Grafana для GtS
 - Импорт из Telegram
 
 ## Как запустить / проверить
@@ -36,20 +56,20 @@
 ```bash
 cd /opt/gotosocial
 docker compose up -d
-curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:8080/     # 200
+curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:8082/     # 200
-curl -s http://127.0.0.1:8080/metrics | grep -E 'go_goroutines|gin_|bun_'
+curl -s http://127.0.0.1:9464/metrics | head                         # метрики (в контейнере)
 curl -s 'https://social.dedinit.ru/.well-known/webfinger?resource=acct:estorozhenko@dedinit.ru'
+curl -s 'https://dedinit.ru/.well-known/webfinger?resource=acct:estorozhenko@dedinit.ru'  # apex JSON
 bash backup.sh && ls -lh backups/
 ```
 
 ## Ключевые артефакты
 
-- /opt/gotosocial/docker-compose.yml, config.yaml, .env, backup.sh, README.md
+- /opt/gotosocial/docker-compose.yml, .env, backup.sh, README.md (config.yaml — reference, НЕ читается образом)
-- /opt/gotosocial/openspec/changes/deploy-gotosocial/ (change)
 - gitverse.ru/kpa39l/gotosocial (истина), gitea.nixg.ru/estorozhenko/gotosocial (зеркало)
+- /opt/dedinit.ru/static/.well-known/ (apex, в git b049cb2)
 
 ## Открытые вопросы
 
-- Пароль админа estorozhenko для первого запуска
+- Пароль админа: создан с паролем из сессии (если менялся — обновить в заметках)
-- Готовность vps02 к правке Caddyfile (нужен SSH)
+- ZFS-бэкапы/другие ротации не требуются (хватает local 7д + ЯД 30д)
-- Точные .well-known редиректы на apex (Jino) — подготовить и применить

backup.sh

@@ -2,35 +2,52 @@
 # =============================================================
 # GoToSocial backup: SQLite consistent + медиа → backups/
 # + копия на Яндекс.Диск (ротация 7 дней локально / 30 на ЯД)
+#
+# Топология: /opt/gotosocial/data  → /gotosocial/storage (контейнер)
+#   data/sqlite.db + media лежат прямо в data/ (storage-маунт)
+# SQLite: Backup API через python3 (sqlite3 CLI не установлен)
+# Тихий: stdout пуст при успехе (для no_agent cron), не-ноль при ошибке
 # =============================================================
 set -euo pipefail
 
 BASE_DIR="/opt/gotosocial"
 DATA_DIR="${BASE_DIR}/data"
 BACKUP_DIR="${BASE_DIR}/backups"
-YANDEX_DIR="/mnt/yandex-disk/backup/gotosocial-backups"
+YANDEX_MOUNT="/mnt/yandex-disk"
+YANDEX_DIR="${YANDEX_MOUNT}/backup/gotosocial-backups"
+STAGE="${BACKUP_DIR}/stage"
 TS="$(date +%Y%m%d_%H%M%S)"
 
-# --- SQLite consistent: VACUUM INTO (не горячая копия файла) ---
-SQLITE_TMP="${BACKUP_DIR}/sqlite-consistent-${TS}.db"
 mkdir -p "${BACKUP_DIR}"
-sqlite3 "${DATA_DIR}/sqlite.db" "VACUUM INTO '${SQLITE_TMP}';"
+rm -rf "${STAGE}" && mkdir -p "${STAGE}"
 
-# --- Сбор архива: consistent db + медиа ---
+# --- Компактный снапшот БД через SQLite Backup API (online, без конфликтов) ---
+python3 - "${DATA_DIR}/sqlite.db" "${STAGE}/sqlite.db" <<'PYEOF'
+import sqlite3, sys
+src, dst = sys.argv[1], sys.argv[2]
+s = sqlite3.connect(src)
+d = sqlite3.connect(dst)
+with d:
+    s.backup(d)
+d.close()
+s.close()
+PYEOF
+
+# --- Медиа копируем в stage (без WAL/SHM, с сохранением структуры) ---
+# Исключаем служебные sqlite-файлы из data/, чтобы не дублировать БД
+(cd "${DATA_DIR}" && tar -cf - --exclude='sqlite.db*' .) | tar -xf - -C "${STAGE}"
+
+# --- Итоговый архив: consistent db + медиа ---
 ARCHIVE="${BACKUP_DIR}/gotosocial_${TS}.tar.gz"
-tar -C "${DATA_DIR}" -czf "${ARCHIVE}" \
+tar -C "${STAGE}" -czf "${ARCHIVE}" .
-  --transform="s|sqlite-consistent-${TS}.db|sqlite.db|" \
-  "${SQLITE_TMP#${DATA_DIR}/}" storage 2>/dev/null \
-  || tar -C "${BACKUP_DIR}" -czf "${ARCHIVE}" "sqlite-consistent-${TS}.db" -C "${DATA_DIR}" storage
-rm -f "${SQLITE_TMP}"
 
 # --- Архив секретов (.env) отдельно ---
 ENV_ARCHIVE="${BACKUP_DIR}/gotosocial_env_${TS}.tar.gz"
 tar -C "${BASE_DIR}" -czf "${ENV_ARCHIVE}" .env
 
 # --- Копия на Яндекс.Диск ---
-if ! mountpoint -q "${YANDEX_DIR%/backup/*}"; then
+if ! mountpoint -q "${YANDEX_MOUNT}"; then
-  echo "ERROR: Яндекс.Диск не примонтирован (${YANDEX_DIR%/backup/*})" >&2
+  echo "ERROR: Яндекс.Диск не примонтирован (${YANDEX_MOUNT})" >&2
   exit 1
 fi
 mkdir -p "${YANDEX_DIR}"
@@ -40,6 +57,7 @@ cp -p "${ARCHIVE}" "${ENV_ARCHIVE}" "${YANDEX_DIR}/"
 find "${BACKUP_DIR}" -maxdepth 1 -type f -name 'gotosocial_*' -mtime +7 -delete
 find "${YANDEX_DIR}" -maxdepth 1 -type f -name 'gotosocial_*' -mtime +30 -delete
 
-echo "OK: ${ARCHIVE}"
+rm -rf "${STAGE}"
-echo "OK: ${ENV_ARCHIVE}"
+
-ls -lh "${ARCHIVE}" "${ENV_ARCHIVE}"
+# Успех — тихо (для no_agent cron)
+exit 0

config.yaml

@@ -11,13 +11,14 @@ protocol: "https"
 bind-address: "0.0.0.0"
 port: 8080
 
-# Caddy на vps02 проксирует через WG (10.8.0.2) — после docker NAT
+# Реверс-прокси: Caddy на vps02 (87.242.100.206) → WireGuard 10.8.0.4 → bigbox 10.8.0.2:8082
-# source IP для контейнера = gateway docker-сети gotosocial (172.29.0.1).
+# → docker-NAT → контейнер (сеть gotosocial_default, шлюз 172.30.0.1).
-# Доверяем ему, чтобы реальный клиентский IP брался из X-Forwarded-For.
+# 10.8.0.4/32 — WG-адрес vps02 (реальный источник от Caddy); 172.30.0.1/16 — шлюз docker-сети.
 trusted-proxies:
+  - "10.8.0.4/32"
   - "127.0.0.1/32"
   - "::1"
-  - "172.29.0.1/16"
+  - "172.30.0.1/16"
 
 # Логи
 log-level: "info"

docker-compose.yml

@@ -1,29 +1,66 @@
 services:
   gotosocial:
     # Фиксированный тег стабильного релиза (обновление — вручную)
-    image: superseriousbusiness/gotosocial:v0.22.1
+    # ВНИМАНИЕ: теги GtS БЕЗ префикса v (0.22.1, не v0.22.1)
+    image: superseriousbusiness/gotosocial:0.22.1
     container_name: gotosocial
     restart: unless-stopped
     # uid/gid пользователя estorozhenko на bigbox
     user: "1000:1000"
     environment:
-      # Окружение процесса GtS (не секреты — в git)
+      # Окружение процесса GtS
       TZ: Europe/Moscow
+      # Docker-образ GtS конфигурируется ТОЛЬКО через GTS_* env
+      # (config.yaml в образе не подхватывается — «host must be set»)
+      # Split-domain: сервер на social.dedinit.ru, аккаунты @user@dedinit.ru
+      GTS_HOST: "social.dedinit.ru"
+      GTS_ACCOUNT_DOMAIN: "dedinit.ru"
+      GTS_PROTOCOL: "https"
+      GTS_BIND_ADDRESS: "0.0.0.0"
+      GTS_PORT: "8080"
+      # SQLite: файл в volume ./data
+      GTS_DB_TYPE: "sqlite"
+      GTS_DB_ADDRESS: "/gotosocial/storage/sqlite.db"
+      # Медиа — локально (./data/storage)
+      GTS_STORAGE_LOCAL_BASE_PATH: "/gotosocial/storage"
+      # Траст reverse proxy (Caddy на vps02 → WG 10.8.0.4 → bigbox 10.8.0.2 → docker NAT 172.30.0.1)
+      # 10.8.0.4/32 — WG-адрес vps02 (реальный источник от Caddy), 172.30.0.1/16 — шлюз docker-сети
+      GTS_TRUSTED_PROXIES: "10.8.0.4/32,127.0.0.1/32,::1,172.30.0.1/16"
+      # Инстанс
+      GTS_INSTANCE_TITLE: "dedinit()"
+      GTS_INSTANCE_DESCRIPTION: "Нода для обычных людей"
+      GTS_INSTANCE_CONTACT_EMAIL: "kpa39l@yandex.ru"
+      # SMTP (Jino) — пароль из .env (GTS_SMTP_PASSWORD)
+      GTS_SMTP_HOST: "smtp.jino.ru"
+      GTS_SMTP_PORT: "587"
+      GTS_SMTP_USERNAME: "social@dedinit.ru"
+      GTS_SMTP_FROM_ADDRESS: "social@dedinit.ru"
+      # Метрики Prometheus (OTEL)
+      GTS_METRICS_ENABLED: "true"
+      GTS_METRICS_AUTH_ENABLED: "false"
+      # Логи
+      GTS_LOG_LEVEL: "info"
+      GTS_LOG_FORMAT: "json"
       # OpenTelemetry → Prometheus (метрики)
       OTEL_METRICS_PRODUCERS: prometheus
       OTEL_METRICS_EXPORTER: prometheus
+      # Слушать :9464 на всех интерфейсах (иначе только внутри контейнера)
+      OTEL_EXPORTER_PROMETHEUS_HOST: "0.0.0.0"
     env_file:
       - .env
     ports:
-      # Caddy с vps02 → 10.8.0.2:8080 (через WG) → контейнер
+      # Caddy с vps02 → 10.8.0.2:8082 (через WG) → контейнер :8080
-      - "8080:8080"
+      # ВНИМАНИЕ: 8080 на bigbox занят NetBox — GtS наружу на 8082
+      - "8082:8080"
+      # Метрики Prometheus (OTEL :9464) — наружу на 127.0.0.1 (только localhost)
+      - "127.0.0.1:9464:9464"
     volumes:
       # Данные: SQLite + медиа (локальное хранилище)
       - ./data:/gotosocial/storage
-      # Конфиг (read-only, в git)
+      # Кэш Wazero-компиляции (быстрый старт)
-      - ./config.yaml:/gotosocial/config.yaml:ro
+      - ./.cache:/gotosocial/.cache
-    networks:
+      # Конфиг для справки (read-only; рабочий конфиг — env выше)
-      - gotosocial
+      - ./config.yaml:/gotosocial/config.example.yaml:ro
 
 networks:
   gotosocial:

openspec/specs/gotosocial/trusted-proxies/spec.md

@@ -0,0 +1,43 @@
+# gotosocial/trusted-proxies Specification
+
+## Purpose
+Обеспечить корректную работу rate-limiting и федеризации GoToSocial за реверс-прокси:
+инстанс должен доверять реальному адресу прокси и брать клиентский IP из
+`X-Forwarded-For` / `X-Real-IP`, а не видеть все запросы с одного адреса.
+
+## Requirements
+
+### Requirement: Trusted-proxies включает реальный адрес реверс-прокси
+
+- **MUST**: В `docker-compose.yml` (env `GTS_TRUSTED_PROXIES`) и `config.yaml`
+  (`trusted-proxies`) включены:
+  - `10.8.0.4/32` — WireGuard-адрес vps02 (Caddy, реверс-прокси)
+  - `127.0.0.1/32` и `::1` — локальные адреса
+  - `172.30.0.1/16` — шлюз docker-сети gotosocial
+- **MUST**: Рабочим конфигом является env в docker-compose.yml (`GTS_*`);
+  `config.yaml` — reference и держится синхронным
+- **SHOULD**: Предупреждение о trusted-proxies на главной странице инстанса отсутствует
+
+#### Scenario: Предупреждение исчезло
+
+- **GIVEN** инстанс запущен с обновлённым `GTS_TRUSTED_PROXIES`
+- **WHEN** открыть главную страницу `https://social.dedinit.ru/`
+- **THEN** на странице нет текста «Warning! It looks like trusted-proxies is not set correctly»
+
+#### Scenario: Конфиг синхронизирован
+
+- **GIVEN** обновлён docker-compose.yml
+- **WHEN** выполнить `docker compose config | grep TRUSTED`
+- **THEN** в выводе присутствуют `10.8.0.4/32`, `127.0.0.1/32`, `::1`, `172.30.0.1/16`
+
+### Requirement: Rate limiting использует реальный клиентский IP
+
+- **MUST**: После настройки GtS определяет IP клиента из заголовков прокси, а не из
+  source-адреса docker-gateway
+- **SHOULD**: Все внешние запросы к инстансу логируются с реальным IP клиента
+
+#### Scenario: Логи содержат реальный клиентский IP
+
+- **GIVEN** инстанс пересоздан с новой конфигурацией
+- **WHEN** `docker compose logs gotosocial --since 5m | grep -i 'GET /' | tail -5`
+- **THEN** записи содержат IP клиента, отличный от `172.30.x.x` (для внешних запросов)