reticulum meshchat
v1.16.0
Простое приложение для сетевой связи сетей, работающее на сетевом стеке Reticulum.
Вы можете скачать последнюю версию для Windows, Mac и Linux со страницы релизов.
В качестве альтернативы, вы можете загрузить источник и запустить его вручную из командной строки.
Смотрите "Как его использовать?" Раздел ниже о том, как это сделать.
После того, как вы скачали, установили и запустили ретикулум Meshchat, есть несколько вещей, которые вам нужно сделать, чтобы начать общение с другими людьми в сети.
Создать личность
В сети ретикулум любой может иметь любое количество личностей. Вы можете использовать свое настоящее имя, или вы можете решить быть полностью анонимным. Выбор твой.
Идентификация ретикулума является государственной/частной ключевой парой. Вы управляете частным ключом, используемым для генерации адресов назначения, контента шифрования и доказываете получение данных с невозможными подтверждениями доставки.
Ваш общедоступный ключ совпадает с сетью, когда вы отправляете объявление, и позволяет другим в сети автоматически обнаружить маршрут к месту назначения, которому вы управляете.
В настоящее время Reticulum Meshchat генерирует новую личность в первый раз, когда вы запустите его. Будущее обновление позволит вам создавать и управлять несколькими идентификаторами.
На данный момент, если вы хотите изменить или сбросить свою личность, вы можете получить доступ к файлу идентификации по адресу ~/.reticulum-meshchat/identity .
Настройте свое отображаемое имя
Следующее, что вы должны сделать, - это установить отображаемое имя. Ваше отображающее имя - это то, что все остальные в сети увидят при поиске кого -то для общения из списка сверстников.
Вы можете сделать это в разделе My Identity в левом нижнем углу. Введите новое отображаемое имя, а затем нажмите « Save .
Отправить объявление
При использовании сети Reticulum, чтобы быть контактным, вам необходимо отправить Announce . Вы можете отправлять объявление так часто или нечасто, как вам нравится.
Отправка объявления позволяет другим коллегам в сети открыть для себя следующую часть по всей сети, которую должны принять их пакеты, чтобы получить пункт назначения, которым управляет ваша личность.
Если вы никогда не отправляете объявление, вы будете невидимым, и никто никогда не сможет отправить вам что -либо.
Когда вы переезжаете через сеть и изменяете точки входа, такие как переход из вашей домашней сети Wi -Fi, к подключению к порту Ethernet в локальной библиотеке или даже взорвание горы и использование RNODE по радио LORA, другие коллеги в сети будут знать только предыдущий путь к вашим направлениям.
Чтобы позволить им обнаружить новый путь, который должен принять их пакеты, вы должны отправить объявление.
Откройте для себя сверстников и начните отправлять сообщения
В сети ретикулума вы можете управлять неограниченным количеством адресов назначения. Одним из них может быть адрес доставки LXMF.
Ваша идентификация ретикулума позволяет вам иметь адрес LXMF. Думайте об адресе LXMF как о вашем собственном, безопасном, сквозном зашифрованном, некомпрофтируемом, адресам электронной почты, маршрутированным через сеть сетки.
Когда кто -то еще в сети объявляет о себе (более конкретно, их адрес LXMF), он появится на вкладке Peers.
Вы можете нажать на любой из этих обнаруженных коллег, чтобы открыть интерфейс обмена сообщениями. Отсюда вы можете отправлять текстовые сообщения, файлы и встроенные изображения. Если они ответят, их сообщения тоже появятся.
Помимо возможности объявить о своем адресе LXMF и открыть для себя другие, Reticulum Meshchat также может обнаружить Nomad Network узлы, размещенные другими пользователями. На вкладке Nodes вы можете исследовать страницы и загружать файлы, которые они могут публично обмениваться в сети.
Планируется будущее обновление, которое позволит вам размещать свой собственный узел и обмениваться страницами и файлами с другими коллегами в сети. На данный момент вы можете использовать официальный клиент Nomad Network для этого.
Помните, что чтобы подключиться к другим одноранговым или узлам, они должны объявить в сети. Так что не забудьте объявить, если вы хотите, чтобы вас обнаружили!
Настройка дополнительных сетевых интерфейсов
Тодо: Этот раздел еще не написан. На данный момент вы можете проверить официальную документацию для настройки интерфейсов в файле конфигурации Reticulum. Этот файл расположен по адресу
~/.reticulum/config
Рекомендуется загрузить автономное приложение.
Если вы не хотите, или релиз недоступен для вашего устройства, вам нужно будет;
meshchat.py . # clone repo
git clone https://github.com/liamcottle/reticulum-meshchat
cd reticulum-meshchat
# install nodejs deps
# if you want to build electron binaries, remove "--omit=dev"
# if you're using termux, add "--ignore-scripts" to fix error with esbuild
npm install --omit=dev
# build frontend vue components
npm run build-frontend
# install python deps
pip install -r requirements.txt
# run meshchat
python meshchat.py
Примечание: теперь вы должны иметь доступ к веб -интерфейсу по адресу http: // localhost: 8000
Для полного списка параметров командной строки вы можете запустить;
python meshchat.py --help
usage: meshchat.py [-h] [--host [HOST]] [--port [PORT]] [--headless] [--identity-file IDENTITY_FILE] [--identity-base64 IDENTITY_BASE64] [--generate-identity-file GENERATE_IDENTITY_FILE] [--generate-identity-base64]
[--reticulum-config-dir RETICULUM_CONFIG_DIR] [--storage-dir STORAGE_DIR]
ReticulumMeshChat
options:
-h, --help show this help message and exit
--host [HOST] The address the web server should listen on.
--port [PORT] The port the web server should listen on.
--headless Web browser will not automatically launch when this flag is passed.
--identity-file IDENTITY_FILE
Path to a Reticulum Identity file to use as your LXMF address.
--identity-base64 IDENTITY_BASE64
A base64 encoded Reticulum Identity to use as your LXMF address.
--generate-identity-file GENERATE_IDENTITY_FILE
Generates and saves a new Reticulum Identity to the provided file path and then exits.
--generate-identity-base64
Outputs a randomly generated Reticulum Identity as base64 and then exits.
--reticulum-config-dir RETICULUM_CONFIG_DIR
Path to a Reticulum config directory for the RNS stack to use (e.g: ~/.reticulum)
--storage-dir STORAGE_DIR
Path to a directory for storing databases and config files (default: ./storage)
Можно работать на Android из Source, используя Termux. Вам нужно будет установить несколько дополнительных зависимостей и внести изменения в requirements.txt .
pkg upgrade
pkg install git
pkg install nodejs-lts
pkg install python-pip
pkg install rust
pkg install binutils
pkg install build-essential
Теперь вы должны быть в состоянии следовать инструкциям «Как использовать его» выше.
Прежде чем запустить pip install -r requirements.txt , вам нужно будет прокомментировать зависимость cx_freeze . Он не смог опираться на мой планшет Android, и на самом деле не требуется для работы из источника.
nano requirements.txt
Убедитесь, что строка cx_freeze обновляется до #cx_freeze
Примечание: строительное колесо для криптографии может занять некоторое время на Android.
После того, как Meshchat работает через Termux, откройте свой любимый веб -браузер Android и перейдите на http: // localhost: 8000
Примечание.
AutoInterfaceпо умолчанию может не работать на вашем устройстве Android. Вам нужно будет настроить другой интерфейс, такой какTCPClientInterface.
В первый раз, когда вы запускаете это приложение, новая идентификация ретикулума генерируется и сохраняется для storage/identity .
Если вы хотите использовать существующую идентичность;
storage/identity с помощью другого файла идентификации. Чтобы использовать пользовательский файл удостоверения личности, предоставьте аргумент --identity-file за которым следует путь к вашему пользовательскому файлу идентификации.
python meshchat.py --identity-file ./custom_identity_file
Если вы хотите создать новую личность, вы можете использовать утилиту RNID, предоставленную Reticulum.
rnid --generate ./new_identity_file
Если у вас нет доступа к команде rnid , вы можете использовать следующее:
python meshchat.py --generate-identity-file ./new_identity_file
В качестве альтернативы, вы можете предоставить кодированный личный ключ BASE64, как и так;
python meshchat.py --identity-base64 "GCN6mMhVemdNIK/fw97C1zvU17qjQPFTXRBotVckeGmoOwQIF8VOjXwNNem3CUOJZCQQpJuc/4U94VSsC39Phw=="
Примечание. Это случайно сгенерированная идентичность, например, цели. Не используйте его, это было просочилось!
Изображение Docker автоматически создается Github Daisions и может быть загружено из реестра контейнеров Github.
docker pull ghcr.io/liamcottle/reticulum-meshchat:master
Кроме того, доступен пример Docker-Compose.yml.
Пример автоматически генерирует новый файл конфигурации ретикулума в томе meshchat-config . База данных Meshchat также хранится в этом томе.
Sticulum Meshchat может быть запущен из источника через командную строку, как объяснено выше, или в качестве автономного приложения.
Чтобы запустить в качестве автономного приложения, нам необходимо составить сценарий Python и зависимости для исполняемого файла с CxFreeze, а затем создать электронное приложение, которое включает в себя связанный браузер, который может взаимодействовать с выполненным исполняемым Python.
Это позволяет запустить все приложение, дважды щелкнув один файл без необходимости, чтобы пользователь мог бы вручную установить Python, а также запустить какие -либо команды в приложении командной строки.
Чтобы построить .exe при запуске в Windows или .dmg при запуске на Mac запустите следующее;
pip install -r requirements.txt
npm install
npm run dist
Примечание. Cxfreeze поддерживает только создание исполняемого файла для текущей платформы. Вам понадобится Mac для создания Mac и компьютер Windows для создания для Windows.
После завершения вы должны иметь .exe или .dmg в папке dist .
Обычно я запускаю следующие команды для работы над проектом локально.
Установить зависимости
pip install -r requirements.txt
npm install
Создать и запустить электронное приложение
npm run electron
или; Создайте и запустите сервер Meshchat
npm run build-frontend
python3 meshchat.py --headless
Я строю приложение Vite каждый раз без горячей перезагрузки, так как Meshchat ожидает все через свой собственный порт, а не порт сервера Vite. Я попытаюсь исправить это в будущем.
Маршрутизатор LXMF
Грань
