mirror of
https://github.com/openvk/openvk
synced 2024-11-11 01:19:53 +03:00
677e147688
* Kubernetes deployment * Update kubernetes deployment * Fix rewrite module load * Fix mysql-primary bootstrap * Fix mysql init-db apply order * Fix init-db.sql permissions * Fix MySQL missing *.sql import * Switch from MySQL to MariaDB * [skip ci] Example deployment update * Set root app in chandler configmap * Update missing php extension in base images * Update missing dependency in apache image * Remove default site configuration * [skip ci] Split Kubernetes deployments by type * Explicitly set persistent volume for openvk storage * [skip ci] Add README for Kubernetes * Replace old docker(-compose) files w/ new ones * Add README for docker usage * [skip ci] Update README.md and README_RU.md * [skip ci] Fix eventdb DB name * [skip ci] Kubernetes configmap: missing namespace * [skip ci] Fix typo * [skip ci] Ignore chandler.yml * [skip ci] Missing /var/log/openvk volume * [skip ci] Workaround for Docker <=20.10.6 * [skip ci] Handle permissions for apache2 * [skip ci] Initial Kafka support * [skip ci] Kafka values for Kubernetes
97 lines
8.5 KiB
Markdown
97 lines
8.5 KiB
Markdown
# <img align="right" src="https://github.com/openvk/openvk/raw/master/Web/static/img/logo_shadow.png" alt="openvk" title="openvk" width="15%">OpenVK
|
||
|
||
_[English](README.md)_
|
||
|
||
**OpenVK** - это попытка создать простую CMS, которая ~~косплеит~~ имитирует старый ВКонтакте. На данный момент представленный здесь исходный код проекта пока не является стабильным.
|
||
|
||
ВКонтакте принадлежит Павлу Дурову и VK Group.
|
||
|
||
Честно говоря, мы даже не знаем, работает ли она вообще. Однако, эта версия поддерживается, и мы будем рады принять ваши сообщения об ошибках [в нашем баг-трекере](https://github.com/openvk/openvk/projects/1). Вы также можете отправлять их через [вкладку "Помощь"](https://openvk.su/support?act=new) (для этого вам понадобится учетная запись OVK).
|
||
|
||
## Когда выйдет релизная версия?
|
||
|
||
Мы выпустим OpenVK, как только он будет готов. На данный момент Вы можете:
|
||
* Склонировать master ветку репозитория командой `git clone` (используйте `git pull` для обновления)
|
||
* Взять готовую сборку OpenVK из [GitHub Actions](https://nightly.link/openvk/archive/workflows/nightly/master/OpenVK%20Archive.zip)
|
||
|
||
## Инстанции
|
||
|
||
* **[openvk.su](https://openvk.su/)**
|
||
* **[openvk.uk](https://openvk.uk)** - официальное зеркало openvk.su (<https://t.me/openvk/1609>)
|
||
* **[openvk.co](http://openvk.co)** - ещё одно официальное зеркало openvk.su без TLS (<https://t.me/openvk/1654>)
|
||
* [social.fetbuk.ru](http://social.fetbuk.ru/)
|
||
* [vepurovk.xyz](http://vepurovk.xyz/)
|
||
|
||
## Могу ли я создать свою собственную инстанцию OpenVK?
|
||
|
||
Да! И всегда пожалуйста.
|
||
|
||
Однако, OVK использует Chandler Application Server. Это программное обеспечение требует расширений, которые могут быть не предоставлены вашим хостинг-провайдером (а именно, sodium и yaml. эти расширения доступны на большинстве хостингов ISPManager).
|
||
|
||
Если вы хотите, вы можете добавить вашу инстанцию в список выше, чтобы люди могли зарегистрироваться там.
|
||
|
||
### Процедура установки
|
||
|
||
1. Установите PHP 7.4, веб-сервер, Composer, Node.js, Yarn и [Chandler](https://github.com/openvk/chandler)
|
||
|
||
* PHP 8 еще **не** тестировался, поэтому не стоит ожидать, что он будет работать (UPD: он не работает).
|
||
|
||
2. Установите MySQL-совместимую базу данных.
|
||
|
||
* Мы рекомендуем использовать Persona Server, но любая MySQL-совместимая база данных должна работать
|
||
* Сервер должен поддерживать хотя бы MySQL 5.6, рекомендуется использовать MySQL 8.0+.
|
||
* Поддержка для MySQL 4.1+ находится в процессе, а пока замените `utf8mb4` и `utf8mb4_unicode_520_ci` на `utf8` и `utf8_unicode_ci` в SQL-файлах, соответственно.
|
||
|
||
3. Установите [commitcaptcha](https://github.com/openvk/commitcaptcha) и OpenVK в качестве расширений Chandler:
|
||
|
||
```bash
|
||
git clone https://github.com/openvk/openvk /path/to/chandler/extensions/available/openvk
|
||
git clone https://github.com/openvk/commitcaptcha /path/to/chandler/extensions/available/commitcaptcha
|
||
```
|
||
|
||
4. И включите их:
|
||
|
||
```bash
|
||
ln -s /path/to/chandler/extensions/available/commitcaptcha /path/to/chandler/extensions/enabled/
|
||
ln -s /path/to/chandler/extensions/available/openvk /path/to/chandler/extensions/enabled/
|
||
```
|
||
|
||
5. Импортируйте `install/init-static-db.sql` в **ту же базу данных**, в которую вы установили Chandler, и импортируйте все SQL файлы из папки `install/sqls` в **ту же базу данных**
|
||
6. Импортируйте `install/init-event-db.sql` в **отдельную базу данных** (Яндекс.Clickhouse также может быть использован, настоятельно рекомендуется)
|
||
7. Скопируйте `openvk-example.yml` в `openvk.yml` и измените параметры под свои нужды
|
||
8. Запустите `composer install` в директории OpenVK
|
||
9. Запустите `composer install` в директории commitcaptcha
|
||
10. Перейдите в `Web/static/js` и выполните `yarn install`
|
||
11. Установите `openvk` в качестве корневого приложения в файле `chandler.yml`
|
||
|
||
После этого вы можете войти как системный администратор в саму сеть (регистрация не требуется):
|
||
|
||
* **Логин**: `admin@localhost.localdomain6`
|
||
* **Пароль**: `admin`
|
||
* Перед использованием встроенной учетной записи рекомендуется сменить пароль или отключить её.
|
||
|
||
💡Запутались? Полное руководство по установке доступно [здесь](https://docs.openvk.su/openvk_engine/centos8_installation/) (CentOS 8 [и](https://almalinux.org/ru/) [семейство](https://yum.oracle.com/oracle-linux-isos.html)).
|
||
|
||
# Установка в Docker/Kubernetes
|
||
Подробные иструкции можно найти в `install/automated/docker/README.md` и `install/automated/kubernetes/README.md` соответственно.
|
||
|
||
### Если мой сайт использует OpenVK, должен ли я публиковать его исходные тексты?
|
||
|
||
Это зависит от обстоятельств. Вы можете оставить исходные тексты при себе, если не планируете распространять бинарники вашего сайта. Если программное обеспечение вашего сайта должно распространяться, оно может оставаться не-OSS при условии, что OpenVK не используется в качестве основного приложения и не модифицируется. Если вы модифицировали OpenVK для своих нужд или ваша работа основана на нем и вы планируете ее распространять, то вы должны лицензировать ее на условиях любой совместимой с LGPL лицензии (например, OSL, GPL, LGPL и т.д.).
|
||
|
||
## Где я могу получить помощь?
|
||
|
||
Вы можете связаться с нами через:
|
||
|
||
* [Баг-трекер](https://github.com/openvk/openvk/projects/1)
|
||
* [Помощь в OVK](https://openvk.su/support?act=new)
|
||
* Telegram-чат: Перейдите на [наш канал](https://t.me/openvk) и откройте обсуждение в меню нашего канала.
|
||
* [Reddit](https://www.reddit.com/r/openvk/)
|
||
* [Обсуждения](https://github.com/openvk/openvk/discussions)
|
||
* Чат в Matrix: #ovk:matrix.org
|
||
|
||
**Внимание**: баг-трекер, форум, телеграм- и matrix-чат являются публичными местами, и жалобы в OVK обслуживается волонтерами. Если вам нужно сообщить о чем-то, что не должно быть раскрыто широкой публике (например, сообщение об уязвимости), пожалуйста, свяжитесь с нами напрямую по этому адресу: **openvk [собака] tutanota [точка] com**.
|
||
|
||
<a href="https://codeberg.org/OpenVK/openvk">
|
||
<img alt="Get it on Codeberg" src="https://codeberg.org/Codeberg/GetItOnCodeberg/media/branch/main/get-it-on-blue-on-white.png" height="60">
|
||
</a>
|