{"id":29178373,"url":"https://github.com/karnemorkon/matrix-synapse-installer","last_synced_at":"2026-04-18T17:32:17.839Z","repository":{"id":301558949,"uuid":"1009623993","full_name":"Karnemorkon/matrix-synapse-installer","owner":"Karnemorkon","description":"🚀 Автоматизований скрипт для встановлення Matrix Synapse сервера з підтримкою мостів, моніторингу та резервного копіювання","archived":false,"fork":false,"pushed_at":"2025-06-27T13:26:37.000Z","size":34,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-27T14:24:42.090Z","etag":null,"topics":["automation","bash","docker","installer","matrix","self-hosted","synapse"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Karnemorkon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-27T12:41:48.000Z","updated_at":"2025-06-27T13:25:42.000Z","dependencies_parsed_at":"2025-06-27T14:24:45.903Z","dependency_job_id":"f37de2f7-a503-461e-895c-be0aef0687b2","html_url":"https://github.com/Karnemorkon/matrix-synapse-installer","commit_stats":null,"previous_names":["karnemorkon/matrix-synapse-installer"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Karnemorkon/matrix-synapse-installer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Karnemorkon%2Fmatrix-synapse-installer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Karnemorkon%2Fmatrix-synapse-installer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Karnemorkon%2Fmatrix-synapse-installer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Karnemorkon%2Fmatrix-synapse-installer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Karnemorkon","download_url":"https://codeload.github.com/Karnemorkon/matrix-synapse-installer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Karnemorkon%2Fmatrix-synapse-installer/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263019621,"owners_count":23400934,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","bash","docker","installer","matrix","self-hosted","synapse"],"created_at":"2025-07-01T18:46:10.734Z","updated_at":"2026-04-18T17:32:17.787Z","avatar_url":"https://github.com/Karnemorkon.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 Matrix Synapse Auto Installer v4.0\n\nАвтоматизований інсталятор Matrix Synapse з підтримкою Docker Compose, мостів, моніторингу та веб-інтерфейсу управління.\n\n## ✨ Особливості\n\n- 🐳 **Docker Compose архітектура** - Використання офіційних образів контейнерів\n- 🌐 **Веб-інтерфейс управління** - Зручне управління через браузер\n- 🌉 **Підтримка мостів** - Signal, WhatsApp, Discord інтеграція\n- 📊 **Система моніторингу** - Prometheus, Grafana, Loki, Node Exporter\n- ☁️ **Cloudflare Tunnel** - Безпечний доступ без публічного IP\n- 🔒 **Розширена безпека** - SSL, файрвол, fail2ban, валідація\n- 💾 **Автоматичне резервне копіювання** - Cron-based резервні копії\n- 🧪 **Тестування** - Автоматична перевірка залежностей\n- 📱 **Element Web** - Офіційний Matrix клієнт\n- 🐳 **Portainer** - Візуальне управління контейнерами\n\n## 🏗️ Архітектура\n\n```\nmatrix-synapse-installer/\n├── docker-compose.yml          # Основна конфігурація Docker Compose\n├── install.sh                  # Головний інсталятор\n├── bin/\n│   └── matrix-control.sh       # Скрипт управління сервісами\n├── lib/                        # Модулі інсталятора\n├── web/                        # Веб-інтерфейс управління\n├── docs/                       # Документація\n└── tests/                      # Тести\n```\n\n## 🐳 Офіційні образи контейнерів\n\n- **matrixdotorg/synapse** - Matrix Synapse сервер\n- **postgres:15-alpine** - PostgreSQL база даних\n- **redis:7-alpine** - Redis кеш\n- **nginx:alpine** - Nginx веб-сервер\n- **grafana/grafana** - Grafana дашборди\n- **prom/prometheus** - Prometheus метрики\n- **prom/node-exporter** - Node Exporter\n- **grafana/loki** - Loki логи\n- **grafana/promtail** - Promtail збір логів\n- **cloudflare/cloudflared** - Cloudflare Tunnel\n- **portainer/portainer-ce** - Portainer управління\n- **dock.mau.dev/mautrix/signal** - Signal Bridge\n- **dock.mau.dev/mautrix/whatsapp** - WhatsApp Bridge\n- **dock.mau.dev/mautrix/discord** - Discord Bridge\n\n## 🚀 Швидкий старт\n\n### 1. Клонування репозиторію\n```bash\ngit clone https://github.com/Karnemorkon/matrix-synapse-installer.git\ncd matrix-synapse-installer\n```\n\n### 2. Запуск інсталятора\n```bash\n# Інтерактивне встановлення\n./install.sh\n\n# Або з змінними середовища\nMATRIX_DOMAIN=matrix.example.com ./install.sh\n```\n\n### 3. Управління сервісами\n```bash\n# Запуск всіх сервісів\n./bin/matrix-control.sh start\n\n# Статус сервісів\n./bin/matrix-control.sh status\n\n# Логи конкретного сервісу\n./bin/matrix-control.sh logs synapse\n\n# Оновлення образів\n./bin/matrix-control.sh update\n```\n\n## ⚙️ Конфігурація\n\n### Змінні середовища\n\n| Змінна | Опис | За замовчуванням |\n|--------|------|------------------|\n| `MATRIX_DOMAIN` | Домен для Matrix сервера | `matrix.localhost` |\n| `MATRIX_BASE_DIR` | Базова директорія | `/opt/matrix` |\n| `MATRIX_POSTGRES_PASSWORD` | Пароль PostgreSQL | Генерується |\n| `MATRIX_ALLOW_PUBLIC_REGISTRATION` | Публічна реєстрація | `false` |\n| `MATRIX_ENABLE_FEDERATION` | Федерація | `false` |\n| `MATRIX_INSTALL_ELEMENT` | Element Web | `true` |\n| `MATRIX_INSTALL_BRIDGES` | Мости | `false` |\n| `MATRIX_SETUP_MONITORING` | Моніторинг | `true` |\n| `MATRIX_SETUP_BACKUP` | Резервне копіювання | `true` |\n| `MATRIX_USE_CLOUDFLARE_TUNNEL` | Cloudflare Tunnel | `false` |\n| `MATRIX_CLOUDFLARE_TUNNEL_TOKEN` | Токен Cloudflare | - |\n| `MATRIX_WEB_DASHBOARD_ENABLED` | Веб-інтерфейс | `true` |\n| `MATRIX_WEB_DASHBOARD_PORT` | Порт веб-інтерфейсу | `8081` |\n\n### Профілі Docker Compose\n\n- **Основні сервіси**: `postgres`, `redis`, `synapse`, `nginx`\n- **Моніторинг**: `--profile monitoring`\n- **Мости**: `--profile bridges`\n- **Element Web**: `--profile element`\n- **Cloudflare Tunnel**: `--profile cloudflare`\n- **Portainer**: `--profile portainer`\n\n## 🌐 Доступні сервіси\n\nПісля встановлення будуть доступні:\n\n- **Matrix Synapse**: `http://your-domain:8008`\n- **Element Web**: `https://your-domain`\n- **Веб-інтерфейс**: `http://localhost:8081`\n- **Grafana**: `http://localhost:3000`\n- **Prometheus**: `http://localhost:9090`\n- **Portainer**: `http://localhost:9000`\n- **Loki**: `http://localhost:3100`\n\n## 🔧 Управління\n\n### Основні команди\n```bash\n# Запуск/зупинка\n./bin/matrix-control.sh start\n./bin/matrix-control.sh stop\n./bin/matrix-control.sh restart\n\n# Моніторинг\n./bin/matrix-control.sh status\n./bin/matrix-control.sh logs [сервіс]\n\n# Резервне копіювання\n./bin/matrix-control.sh backup\n./bin/matrix-control.sh restore \u003cфайл\u003e\n\n# Оновлення\n./bin/matrix-control.sh update\n\n# Додаткові сервіси\n./bin/matrix-control.sh monitoring\n./bin/matrix-control.sh bridges\n./bin/matrix-control.sh portainer\n./bin/matrix-control.sh cloudflare\n```\n\n### Docker Compose команди\n```bash\n# Запуск з профілями\ndocker compose --profile monitoring up -d\ndocker compose --profile bridges up -d\ndocker compose --profile portainer up -d\n\n# Перегляд логів\ndocker compose logs -f synapse\ndocker compose logs -f nginx\n\n# Оновлення образів\ndocker compose pull\ndocker compose up -d\n```\n\n## 📚 Документація\n\n- [📖 Детальний гід встановлення](docs/INSTALLATION.md)\n- [🌉 Налаштування мостів](docs/BRIDGES_SETUP.md)\n- [☁️ Cloudflare Tunnel](docs/CLOUDFLARE_TUNNEL.md)\n- [📊 Моніторинг](docs/MONITORING.md)\n- [🔒 Безпека](docs/SECURITY.md)\n- [💾 Резервне копіювання](docs/BACKUP.md)\n- [🌐 Веб-інтерфейс](docs/WEB_DASHBOARD.md)\n- [🧪 Тестування](docs/TESTING.md)\n- [📋 Залежності](docs/DEPENDENCIES.md)\n- [🔧 Виправлення проблем](docs/TROUBLESHOOTING.md)\n- [📈 Покращення](docs/IMPROVEMENTS.md)\n- [📝 Історія змін](docs/CHANGELOG.md)\n\n## 🧪 Тестування\n\n```bash\n# Перевірка залежностей\n./tests/test-dependencies.sh\n\n# Тест встановлення\n./tests/test-installation.sh\n\n# Перевірка конфігурації\n./tests/test-config.sh\n```\n\n## 🔒 Безпека\n\n- ✅ SSL/TLS сертифікати (Let's Encrypt)\n- ✅ Файрвол (UFW)\n- ✅ Захист від атак (fail2ban)\n- ✅ Валідація вхідних даних\n- ✅ Безпечні заголовки HTTP\n- ✅ Обмеження швидкості запитів\n- ✅ Cloudflare Tunnel підтримка\n\n## 🌉 Підтримувані мости\n\n- 📱 **Signal Bridge** - Інтеграція з Signal\n- 💬 **WhatsApp Bridge** - Інтеграція з WhatsApp\n- 🎮 **Discord Bridge** - Інтеграція з Discord\n\n## 📊 Моніторинг\n\n- **Prometheus** - Збір метрик\n- **Grafana** - Візуалізація даних\n- **Node Exporter** - Системні метрики\n- **Loki** - Збір логів\n- **Promtail** - Агент збору логів\n\n## 🤝 Внесок\n\n1. Форкніть репозиторій\n2. Створіть гілку для нової функції (`git checkout -b feature/amazing-feature`)\n3. Зробіть коміт змін (`git commit -m 'Add amazing feature'`)\n4. Запушіть в гілку (`git push origin feature/amazing-feature`)\n5. Відкрийте Pull Request\n\n## 📄 Ліцензія\n\nЦей проект ліцензовано під MIT License - дивіться файл [LICENSE](LICENSE) для деталей.\n\n## 🙏 Подяки\n\n- [Matrix.org](https://matrix.org/) - За Matrix протокол\n- [Element](https://element.io/) - За Element Web клієнт\n- [Docker](https://docker.com/) - За контейнеризацію\n- [Cloudflare](https://cloudflare.com/) - За Cloudflare Tunnel\n- [Grafana](https://grafana.com/) - За моніторинг\n- [Prometheus](https://prometheus.io/) - За метрики\n\n## 📞 Підтримка\n\nЯкщо у вас виникли питання або проблеми:\n\n1. Перевірте [документацію](docs/)\n2. Подивіться [виправлення проблем](docs/TROUBLESHOOTING.md)\n3. Відкрийте [Issue](https://github.com/Karnemorkon/matrix-synapse-installer/issues)\n\n---\n\n**Matrix Synapse Auto Installer v4.0** - Зроблено з ❤️ для спільноти Matrix\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkarnemorkon%2Fmatrix-synapse-installer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkarnemorkon%2Fmatrix-synapse-installer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkarnemorkon%2Fmatrix-synapse-installer/lists"}