Ваш обліковий запис Parlons, що працює онлайн на машині, яка ніколи не засинає, а керуєте ним ви зі свого телефона.

Цей посібник охоплює:

• Parlons Cloud для Android («Портал»), версія 0.2.90 (пакет Android com.eurobuddha.parlons.cloud, Android 9 або новіший).
• Parlons Cloud — програму-хост, з якою він зв'язується, версія 0.11.124 (parlons-cloud-0.11.124.jar). Вона запускає один обліковий запис на вашій власній машині або одразу багато облікових записів як службу parlons-tenants (--tenants <dir>).

Обидві програми можна завантажити на сторінці випусків: https://github.com/eurobuddha/maxima/releases.

SHA-256 файлу parlons-cloud-0.11.124.jar:

0ae833429b641393f93b427695784b534e8a2a06a7194eba74e57aed4f19b231

Частина A — для тих, хто користується обліковим записом через застосунок «Портал». Частина B — для тих, хто розміщує облікові записи. Кожне завдання описано пронумерованими кроками. Написи, які ви бачите на екрані, виділено жирним. Команди, які ви вводите, наведено в блоках коду.

Супутні посібники: Посібник з Parlons! — для повного застосунку Parlons!, і Посібник з Parlons Node — для Parlons Node (повного вузла Minima з вбудованим обліковим записом Parlons).

1Для чого потрібен Портал

Обліковий запис Parlons — це невелика програма, яка тримає вашу ідентичність онлайн. Вона зберігає ваші контакти й історію чатів, отримує повідомлення, коли ваш телефон вимкнено, і дає змогу кожному під'єднаному пристрою бачити ту саму розмову. Їй потрібна машина, яка постійно ввімкнена й має вихідний доступ до інтернету.

Android-застосунок Parlons Cloud (у цьому посібнику — «Портал») — це вікно до такого облікового запису. Він не має власної ідентичності для чату. Під час під'єднання він створює лише власний ключ пристрою, а далі керує обліковим записом через наскрізно зашифрований транспорт Parlons. На першому екрані застосунку сказано так:

Хто ним користується

• Ті, хто запускає власний обліковий запис на Raspberry Pi, Mac mini, домашньому сервері чи VPS (частина B, розділи 19 і 20) і хоче мати його на телефоні Android.
• Ті, хто запускає Parlons Node (повний вузол Minima з вбудованим Parlons). Parlons Node також запускає обліковий запис Parlons, тож Портал під'єднується до нього так само. Власники вузлів отримують у застосунку додаткові інструменти (розділ 12).
• Ті, хто має розміщений обліковий запис. Хтось інший запускає хост, який тримає онлайн багато облікових записів, по одному на людину (частина B, розділ 21). Оператор хоста дає вам запрошення, і ви за ним під'єднуєтеся до власного облікового запису.

На iPhone ту саму роботу виконує застосунок Parlons; він під'єднується до тих самих видів облікових записів за тим самим запрошенням. Повний застосунок Parlons! для Android інший: він зберігає ідентичність на самому телефоні й не під'єднується до облікового запису (розділ 15).

Що таке обліковий запис і що таке орендар

Що хост може, а чого не може

• Він не може читати ваші повідомлення під час передавання, як і чиїсь інші: усе між пристроями запечатано наскрізним шифруванням.
• Він може читати те, що зберігається на цій машині. Ваш обліковий запис тримає там історію чатів і ключі, тож оператор має до них такий самий доступ, який мали б ви на власній машині. Обирайте хост, якому довіряєте так, як довірили б людині свою поштову скриньку. Або запустіть власний (частина B).

2Терміни цього посібника

Повний глосарій наведено в кінці (розділ 33). Кілька слів, потрібних одразу:

• Адреса: постійна адреса вашого облікового запису. Починається з MAX#, має кілька сотень символів і ніколи не змінюється. Діліться нею — так люди можуть з вами зв'язатися. У цьому посібнику адреса ніколи не скорочується, і ви теж цього не робіть: завжди копіюйте її повністю.
• Код під'єднання: одноразовий код у форматі ABCD-EFGH-JKLM (три групи по чотири символи). Спрацьовує один раз. Створення нового коду замінює старий.
• Запрошення: адреса й код під'єднання в одному рядку: адреса, потім ?code=, потім код. Один QR-код запрошення під'єднує телефон.
• Пристрій: усе, що під'єднано до облікового запису (телефон, команда parlons у терміналі, власна вебпанель хоста). У кожного свій ключ, і його доступ можна відкликати, не змінюючи ідентичності облікового запису.

Частина A. Користування обліковим записом через застосунок «Портал»

3Установлення застосунку

Як установити застосунок

1. На телефоні Android відкрийте https://github.com/eurobuddha/maxima/releases і знайдіть випуск із тегом portal-v0.2.90.
2. Завантажте прикріплений до нього APK: parlons-cloud-portal-0.2.90-release.apk.
3. Відкрийте завантажений файл. Якщо Android попросить, дозвольте браузеру чи файловому менеджеру встановлювати застосунки, а потім торкніться Установити.
4. Відкрийте Parlons Cloud. Перший екран має заголовок Запустіть Parlons у хмарі. Перейдіть до розділу 4, щоб під'єднати його.

Застосунку потрібен Android 9 або новіший. Він запитує такі дозволи, коли вони вперше знадобляться: камера (сканування QR-кодів, відеодзвінки, фото), мікрофон (голосові повідомлення й дзвінки), сповіщення та робота у фоновому режимі.

Як оновити застосунок

1. Завантажте новіший parlons-cloud-portal-<version>-release.apk зі сторінки випусків.
2. Відкрийте його й торкніться Установити. Android установить його поверх старого.
3. Відкрийте Parlons Cloud. Під'єднання зберігається, тож застосунок одразу відкриває ваш обліковий запис.

Як видалити застосунок

Застосунок не використовує хмарне резервне копіювання Android, тому видалення стирає ключ пристрою цього телефона. Сам обліковий запис не зачіпається.

1. На іншому під'єднаному пристрої відкрийте Вузол → Під'єднані пристрої і торкніться Відкликати поруч із цим телефоном (розділ 9).
2. Видаліть Parlons Cloud у налаштуваннях застосунків Android.
3. Щоб пізніше знову користуватися телефоном, установіть застосунок і під'єднайте його новим кодом (розділ 10).

4Під'єднання застосунку до облікового запису

Вам потрібне запрошення (або адреса плюс код під'єднання) з одного з таких місць:

Як під'єднатися за запрошенням

1. Відкрийте Parlons Cloud. Перший екран має заголовок Запустіть Parlons у хмарі.
2. Зробіть одне з такого:
   • Торкніться Сканувати QR-код під'єднання і наведіть камеру на QR-код запрошення. Застосунок заповнить обидва поля й покаже Адресу й код під'єднання відскановано.
   • Або вставте повне запрошення в поле Адреса облікового запису або запрошення для під'єднання. Коли ви торкнетеся Підключитися й під'єднати, частину з кодом буде перенесено в поле Код під'єднання.
   • Або вставте лише адресу в перше поле, а код (наприклад, ABCD-EFGH-JKLM) введіть у Код під'єднання.
3. Торкніться Підключитися й під'єднати.
4. У рядку стану з'явиться Під'єднання до мережі…, потім Обліковий запис знайдено — під'єднання….
5. З дійсним кодом застосунок одразу відкриває ваш обліковий запис. Код тепер використано. Жодному іншому пристрою не потрібно його схвалювати.

Застосунок запам'ятовує введену адресу, тож після невдалої спроби її не доведеться вводити знову.

Як під'єднатися без коду

Скористайтеся цим, коли маєте адресу, але не маєте коду. Цей телефон має схвалити інший, уже під'єднаний пристрій.

1. Вставте повну адресу MAX# у Адреса облікового запису або запрошення для під'єднання.
2. Залиште Код під'єднання порожнім.
3. Торкніться Підключитися й під'єднати. Обліковий запис поставить цей телефон у список очікування. Застосунок покаже:

   Запит на під'єднання надіслано. Підтвердьте його з уже під'єднаного пристрою, а потім відкрийте знову.

   а під цим — ключ цього пристрою.

4. На вже під'єднаному пристрої схваліть новий телефон. Скористайтеся одним зі способів:
   • У Порталі: Вузол → Очікують підтвердження, потім Схвалити поруч із ключем.
   • У терміналі з командою parlons:

     parlons approve <key>

   • У вебпанелі: Пристрої, потім Схвалити під Очікування схвалення.
5. На новому телефоні знову відкрийте Parlons Cloud і ще раз торкніться Підключитися й під'єднати.

Якщо під'єднання не вдається

Як прочитати примітку про налаштування сервера

1. На першому екрані торкніться Ви тут уперше? Налаштуйте сервер облікового запису ▸. Відкриється коротка примітка про запуск власного сервера облікового запису. У ній показано команду розгортання та розташування повного посібника (cloud/SETUP.md у репозиторії).
2. Торкніться будь-якого сірого блоку, щоб скопіювати його текст. Застосунок покаже Скопійовано.
3. Торкніться Налаштуйте сервер облікового запису ▾, щоб знову згорнути примітку.

Частина B цього посібника охоплює те саме докладніше.

Як змінити мову застосунку

1. Відкрийте список мов:
   • На першому екрані торкніться Змінити мову вгорі.
   • Після під'єднання відкрийте Більше → Налаштування і торкніться верхньої кнопки з написом English · 简体中文 · Русский · Українська.
2. Торкніться потрібної мови. Список закриється, і застосунок перемкне мову. Вибір діє лише на цьому пристрої.

5Головний екран

Після під'єднання застосунок відкривається на чотирьох вкладках: Чати, Контакти, Гаманець і Вузол. Гортайте або торкайтеся, щоб переходити між ними.

Верхня панель

• Parlons Cloud і версія застосунку.
• Індикатор стану показує, чи може застосунок зв'язатися з вашим обліковим записом:
  • зелений, у мережі · N хостів (або N нових, коли є непрочитані повідомлення): обліковий запис доступний;
  • Підключення…: застосунок ще намагається з'єднатися;
  • червоний, недоступно: обліковий запис не відповів.
• Пошук шукає в повідомленнях, контактах і групах вашого облікового запису. Пошук виконується в самому обліковому записі, тож охоплює все, що там зберігається, а не лише те, що бачив цей телефон.
• Тема перемикає по колу Світла → Темна → Системна. Коротке повідомлення підтверджує новий вибір.
• Більше відкриває меню облікового запису:

Як шукати в обліковому записі

1. Торкніться Пошук на верхній панелі.
2. Введіть запит у Пошук повідомлень…. Результати з'являться під Контакти та групи і Повідомлення. Нічого не знайдено. означає, що збігів немає.
3. Торкніться результату, щоб відкрити цей чат. Торкніться Назад, щоб вийти з пошуку.

Як змінити тему

1. Торкніться Тема на верхній панелі. Кожне торкання переходить до наступного варіанта: Світла, Темна, Системна.
2. Коротке повідомлення на кшталт Тема: Темна підтверджує вибір.

Як скопіювати адресу облікового запису

1. Торкніться Більше → Копіювати адресу облікового запису.
2. Застосунок покаже Адресу облікового запису скопійовано. У буфері обміну — повна адреса MAX#.

Як від'єднати цей телефон

1. Торкніться Більше → Від'єднати цей пристрій.
2. Діалог Від'єднати цей пристрій? пояснює, що цей телефон більше не керуватиме вашим хмарним обліковим записом.
3. Торкніться Від'єднати. Застосунок повернеться до першого екрана.
4. На іншому під'єднаному пристрої відкличте запис цього телефона (розділ 9). Доки ви цього не зробите, обліковий запис і далі показуватиме його як під'єднаний пристрій.

Від'єднати цей пристрій лише скасовує під'єднання на цьому телефоні. Ваш обліковий запис та його ідентичність залишаються на вузлі. Інші пристрої продовжують працювати, а цей телефон можна знову під'єднати новим кодом.

6Чати

Вкладка Чати показує ваші розмови, найновіші вгорі, з лічильниками непрочитаних.

Поки чатів немає, на вкладці написано: Розмов поки немає. Додайте контакт на вкладці «Контакти», а потім напишіть йому.

Як відкрити або знайти чат

1. Відкрийте вкладку Чати.
2. Щоб звузити список, введіть частину імені в поле пошуку вгорі.
3. Торкніться чату, щоб відкрити його.

Як створити групу

Спершу вам потрібен хоча б один контакт. Інакше застосунок скаже Спочатку додайте контакти — групі потрібні учасники.

1. На вкладці Чати торкніться кнопки Нова група.
2. Введіть назву в Назва групи.
3. Позначте принаймні одного учасника.
4. Торкніться Створити. Застосунок покаже Групу створено, і група з'явиться в списку.

Якщо торкнутися Створити без назви чи без учасника, застосунок скаже Назвіть групу та виберіть хоча б одного учасника.

Як позначити чат прочитаним або очистити його

1. На вкладці Чати утримуйте палець на чаті.
2. Торкніться Позначити прочитаним (показується, коли є непрочитані повідомлення). Застосунок покаже Позначено прочитаним.
3. Або торкніться Очистити повідомлення. З'явиться діалог Очистити цей чат?. Торкніться Очистити, щоб підтвердити. Застосунок покаже Чат очищено.

Очищення видаляє повідомлення лише з вашого облікового запису. Воно не відкликає надіслані повідомлення й не виводить вас із групи, і скасувати його неможливо.

Усередині чату

Підзаголовок — у вашому хмарному акаунті: повідомлення живуть в обліковому записі, а цей екран лише показує їх.

Як надіслати повідомлення

1. Введіть текст у поле повідомлення внизу.
2. Торкніться кнопки надсилання (коли є текст, на ній стрілка).

Як надіслати голосове повідомлення

1. Залиште поле повідомлення порожнім. На кнопці надсилання буде мікрофон.
2. Торкніться мікрофона. Відкриється діалог Голосове повідомлення з таймером і максимальною тривалістю.
3. Говоріть.
4. Торкніться Надіслати, щоб надіслати, або Скасувати, щоб відкинути запис. Занадто коротко — потримайте трохи довше означає, що запис був надто коротким.

Голосове повідомлення можна також почати через Прикріпити → Голосове повідомлення.

Як надіслати фото або файл

1. Торкніться Прикріпити.
2. Виберіть одне:
   • Медіатека: виберіть фото. Діалог Надіслати фото дає змогу Додайте підпис…. Торкніться Надіслати.
   • Приватний файл: відкриється засіб вибору файлів Android. Виберіть файл, щоб надіслати його в цей чат.
   • Передавання файлів: відкриває список передавань файлів у цьому чаті.
3. Щоб натомість зробити нове фото, торкніться кнопки камери біля поля повідомлення.

Як зателефонувати контакту

1. Відкрийте чат віч-на-віч.
2. Торкніться Голосовий дзвінок або Відеодзвінок на верхній панелі чату.
3. Дозвольте доступ до мікрофона (і камери, для відео), коли застосунок уперше попросить.
4. Під час дзвінка використовуйте Вимкнути мікрофон, Гучномовець, Змінити (перемкнути камеру) і Завершити.

Дзвінки можливі лише віч-на-віч. Як відповідати на дзвінок, описано в розділі 14.

Як переглянути відомості про контакт або групу

1. Торкніться кнопки інформації на верхній панелі чату.
2. Для контакту діалог показує його програмне забезпечення, коли його востаннє бачили в мережі, публічний ключ, адреси та платіжну адресу. Копіювати ключ копіює ключ повністю.
3. Для групи діалог Група показує учасників. Якщо ви адміністратор групи, торкніться Змінити учасників, позначте або зніміть позначки з контактів і торкніться Зберегти. Застосунок покаже Групу оновлено.

Як виконати дію з одним повідомленням

1. Утримуйте палець на повідомленні.
2. Виберіть одне:
   • Копіювати повідомлення (або Копіювати підпис на фото, Копіювати адресу контакту на надісланій адресі).
   • Зберегти фото або Поділитися фото на зображенні. Збережено у Фото підтверджує збереження.
   • Копіювати ідентифікатор транзакції на платежі.
   • Інформація відкриває Інформація про повідомлення: коли його надіслано й коли воно надійшло, його стан (Надсилання…, Надіслано (ретранслятор прийняв), Доставлено, Прочитано, Не вдалося надіслати) і, для платежів, ідентифікатор транзакції.

Позначки означають те саме, що й у кожному застосунку Parlons:

Як повторно надіслати недоставлене повідомлення

Якщо ваш обліковий запис не зміг зв'язатися з контактом за жодною відомою йому адресою, невдале повідомлення позначається ✗.

1. Торкніться невдалого повідомлення. Діалог Повідомлення не доставлено пояснює, що ваш вузол не зміг зв'язатися з контактом.
2. Торкніться Перепідключити (або Не зараз, щоб залишити як є). Застосунок покаже Перепідключення… і запитає в каталозі поточну адресу контакту.
3. Знайдено нову адресу — незабаром надішлемо повторно означає, що невдалі повідомлення буде надіслано повторно автоматично. Адреса не змінилася — можливо, контакт просто не в мережі означає, що контакт, імовірно, не в мережі; повідомлення чекають у вихідних.

Оплата контакту в чаті

1. У чаті віч-на-віч торкніться Прикріпити → Надіслати платіж. Діалог Надіслати платіж ім'я повідомляє: Оплачено з гаманця вашого хмарного акаунта.
2. Виберіть Minima або MxUSD. MxUSD — це токен Minima, прив'язаний до долара, ідентифікатор токена 0x7D39745FBD29049BE29850B55A18BF550E4D442F930F86266E34193D89042A90.
3. Введіть суму (поле називається Сума (MINIMA) або Сума (MxUSD)) і, за бажанням, Коментар (необов'язково).
4. Торкніться Надіслати. Застосунок покаже Платіж формується на вашому вузлі….

Платіж формується й підписується на машині, де працює ваш обліковий запис, а не на телефоні. Облікові записи лише для чату не можуть платити (розділ 8).

Якщо платіж показує ⚠ не підтверджено — перевірте баланс, перш ніж платити знову, перевірте вкладку «Гаманець», перш ніж надсилати його вдруге.

Для MxUSD потрібен оновлений хост. Перед платежем у MxUSD Портал 0.2.90 запитує хост облікового запису, чи враховує той ідентифікатор токена. Хост, який не може цього довести, проігнорував би токен і заплатив би ту саму суму в MINIMA, тому застосунок відмовляється надсилати й показує:

Нічого не надсилається. Попросіть того, хто керує хостом, оновити його до однієї з названих версій, а потім спробуйте ще раз. На платежі в Minima це не впливає.

7Контакти

Вкладка Контакти складається з трьох частин.

Адреса вашого облікового запису. Повна адреса MAX# з кнопками Копіювати, Показати QR і Поділитися адресою. Поділіться нею, щоб люди могли з вами зв'язатися — вона однакова на всіх пристроях. Поки обліковий запис ще під'єднується, тут показано (визначення…).

Ваші контакти. Із заголовком Контакти · N і полем Пошук контактів над списком. Торкніться контакту, щоб побачити відомості: Програмне забезпечення, Востаннє в мережі (або Зараз у мережі), Публічний ключ, його Адреси та Платіжна адреса (MINIMA), якщо контакт її опублікував. Звідти:

• Повідомлення відкриває чат.
• Більше пропонує Перейменувати, Перепідключитися зараз і Видалити контакт (кроки нижче).

Додавання контакту. Поле та кнопка Сканувати QR під Додавання контакту.

Як поділитися своєю адресою

1. Відкрийте Контакти.
2. Під Адреса вашого облікового запису торкніться одного з варіантів:
   • Копіювати: застосунок покаже Адресу скопійовано. Вставте її в повідомлення для людини.
   • Показати QR: дайте людині відсканувати QR-код з вашого екрана.
   • Поділитися адресою: відкриється меню «Поділитися» Android. Виберіть застосунок, яким надіслати адресу.

Як додати контакт

1. Відкрийте Контакти і прокрутіть до Додавання контакту.
2. Внесіть адресу людини в поле одним зі способів:
   • Вставте повну адресу. Вона починається з MAX# або починається з Mx і закінчується на @host:port.
   • Торкніться Сканувати QR і наведіть камеру на QR-код адреси.
3. Торкніться Додати. Застосунок покаже Додавання…, потім Контакт додано.

Додавання — це рукостискання: ваш обліковий запис представляється за адресою людини, а вона відповідає своєю. Якщо додати не вдалося, застосунок покаже Не вдалося додати: … з причиною, наприклад цей обліковий запис зараз недоступний — перевірте, чи він у мережі, або відскануйте адресу ще раз. Якщо текст узагалі не є адресою, буде сказано Це не схоже на адресу Parlons — вона має починатися з Mx… або MAX#….

Як перейменувати контакт

1. Відкрийте Контакти і торкніться контакту.
2. Торкніться Більше → Перейменувати.
3. У Перейменувати контакт введіть нове ім'я в Ім'я для цього контакту.
4. Торкніться Перейменувати. Застосунок покаже Перейменовано. Ім'я діє лише у вашому обліковому записі.

Як перепідключитися до контакту

1. Відкрийте Контакти і торкніться контакту.
2. Торкніться Більше → Перепідключитися зараз. Застосунок покаже перепідключення….
3. Знайдено нову адресу — перепідключено означає, що знайдено нову адресу контакту. Адреса не змінилася — можливо, контакт просто не в мережі означає, що нічого не змінилося.

Як видалити контакт

1. Відкрийте Контакти і торкніться контакту.
2. Торкніться Більше → Видалити контакт.
3. Діалог запитує Видалити ім'я? і пояснює: Ваша адреса залишиться в цієї людини, і вона й надалі зможе вам писати. Це лише прибирає її з вашого списку.
4. Торкніться Видалити. Застосунок покаже Видалено.

8Гаманець

Що показує вкладка Гаманець, залежить від виду облікового запису, до якого ви під'єднані.

Обліковий запис лише для чату

На вкладці написано Акаунт лише для чату: Цей розміщений акаунт включає чат, дзвінки й файли. Гаманець і керування хостом вимкнено. Більше тут нічого робити.

Обліковий запис Parlons Cloud (власний сервер або орендар на хості parlons-tenants)

Обліковий запис має власний гаманець. Його ключі виводяться із сід-фрази облікового запису й зберігаються на машині, де працює обліковий запис. Підписання відбувається там.

Що показує вкладка:

• Загальний баланс: MINIMA · гаманець вашого акаунта, з N доступно до надсилання · ключі живуть на вашому хмарному вузлі.
• Адреса отримання: адреса Minima облікового запису з кнопками Копіювати і Показати QR.
• Токени на цій адресі, кожен зі своїм ідентифікатором токена.
• Ключ підпису: Використано підписів: N / M. Кожен ключ підписує фіксовану кількість разів.
• Надіслати, Від'єднати гаманець на цей телефон… та Історія.

Як отримати кошти

1. Відкрийте Гаманець.
2. Під Адреса отримання торкніться Копіювати (застосунок покаже Адресу скопійовано) або Показати QR.
3. Передайте повну адресу відправникові або дайте йому відсканувати QR-код.

Як скопіювати ідентифікатор токена

1. Відкрийте Гаманець і знайдіть токен під Токени.
2. Торкніться його. Застосунок покаже ID токена скопійовано. У буфері обміну — повний ідентифікатор токена.

Як надіслати Minima або MxUSD

1. Відкрийте Гаманець і торкніться Надіслати.
2. Введіть одержувача в Адреса Mx… або 0x… або торкніться Сканувати QR, щоб відсканувати адресу.
3. Виберіть Minima або MxUSD.
4. Введіть суму (Сума (MINIMA) або Сума (MxUSD)) і торкніться Продовжити.
5. Прочитайте підтвердження Надіслати сума токен?. У ньому показано повну адресу й сказано: Це підписує й транслює справжню транзакцію, і її неможливо скасувати.
6. Торкніться Підписати й надіслати. У стані з'явиться Підписання на вашому вузлі…, потім Трансляція через …, потім Надіслано.

Якщо не вдалося, застосунок покаже Не вдалося надіслати: … з причиною. Для MxUSD на хості, який не може довести, що враховує ідентифікатор токена, причина така: Хост цього облікового запису застарий для надсилання MxUSD — оновіть його (Parlons Node 0.2.135+, Parlons Cloud 0.11.121+, minimaCore Desktop 0.18.21+). Нічого не надсилається; попросіть оператора хоста оновити його (розділ 6).

Як переглянути минулий платіж

1. Відкрийте Гаманець і прокрутіть до Історія. Там перелічено платежі, які цей телефон бачив, поки був під'єднаний (надіслані й отримані), найновіші вгорі.
2. Торкніться платежу. Діалог покаже суму, другу сторону, час, коментар та ідентифікатор транзакції.
3. Торкніться Копіювати ID транзакції, щоб скопіювати повний ідентифікатор транзакції.

Як задати лічильник використаних підписів

Робіть це, лише якщо ця сід-фраза підписувала транзакції на іншому пристрої. Лічильник можна лише збільшувати. Якщо задати його занадто малим, можна повторно використати одноразовий ключ і розкрити його.

1. Відкрийте Гаманець і під Ключ підпису торкніться Встановити кількість використаних підписів….
2. Введіть нове значення в Нова кількість використаних (> поточна) і торкніться Продовжити.
3. Прочитайте Збільшити до N?. Там попереджено, що цю дію не можна скасувати.
4. Торкніться Збільшити лічильник. Застосунок покаже Оновлення лічильника…, потім Лічильник збільшено.

Як від'єднати гаманець на цей телефон

Від'єднати гаманець на цей телефон… переказує усі доступні до надсилання кошти на гаманець, сід-фраза якого живе на цьому телефоні, у застосунку Minima Core. Ваша хмарна ідентичність залишається. Сервер зберігає перегляд нової адреси лише для спостереження.

1. Спершу встановіть Minima Core: Більше → Налаштування → Minima Core на цьому телефоні → Отримати Minima Core. Без нього застосунок покаже Потрібен Minima Core.
2. У Minima Core відкрийте Гаманець → Отримати й скопіюйте свою адресу.
3. У Parlons Cloud відкрийте Гаманець і торкніться Від'єднати гаманець на цей телефон….
4. Вставте адресу в Адреса Mx… з Minima Core і торкніться Продовжити.
5. Прочитайте Перевести сума MINIMA?. Там показано повну адресу й сказано, що після цього хмара лише спостерігатиме за нею.
6. Торкніться Перевести й від'єднати. Усі доступні до надсилання кошти буде переказано на цю адресу однією транзакцією.

Якщо застосунок каже Зараз нічого надіслати — спершу синхронізуйте або дочекайтеся підтверджень, зачекайте й спробуйте ще раз.

Обліковий запис Parlons Node

Гаманцем облікового запису є власний гаманець Minima вузла.

• Баланс · увесь гаманець: MINIMA · доступно до надсилання, з усіх адрес гаманця вашого вузла, з підтвердженими, заблокованими й непідтвердженими сумами та іншими токенами вузла.
• Відкрити гаманець відкриває повний гаманець: баланси зі значками токенів, галерея NFT, надсилання (швидке або з керуванням монетами), отримання з QR-кодом, усі монети, історія в блокчейні та карбування. Усе працює на вашому вузлі й підписується там.
• Пересинхронізувати гаманець на нову фразу… переводить гаманець вузла на нову фразу з 24 слів.

Як відкрити повний гаманець вузла

1. Відкрийте Гаманець.
2. Торкніться Відкрити гаманець. Відкриється повний гаманець із власними вкладками для балансів, надсилання, отримання, монет, історії й карбування.

Як пересинхронізувати гаманець вузла на нову фразу

Скористайтеся цим, коли ключі підпису вузла вичерпано або коли вам потрібна нова сід-фраза. Ваша ідентичність, під'єднані пристрої й контакти залишаються. Кошти на старій фразі залишаються на старій фразі, тож спершу перекажіть їх.

1. Відкрийте Гаманець і торкніться Пересинхронізувати гаманець на нову фразу….
2. Введіть нову фразу в 24 слова через пробіл. Будь-що, крім 24 слів, дає Це не 24 слова.
3. Торкніться Пересинхронізувати. Застосунок покаже Пересинхронізацію розпочато — вузол перезапуститься приблизно за хвилину; той самий акаунт, нова адреса гаманця.
4. Зачекайте приблизно хвилину. Застосунок перепідключиться сам.

Якщо згодом на вкладці написано Остання пересинхронізація НЕ пройшла — гаманець не змінено, далі вказано причину. Старий гаманець і далі використовується.

Адреса лише для спостереження

Якщо обліковий запис не має власної адреси гаманця, вкладка пропонує Гаманець лише для перегляду. Ваші ключі витрачання ніколи не залишають пристрій; вузол може спостерігати, але ніколи не витрачати.

1. Відкрийте Гаманець.
2. Введіть адресу Mx… у Адреса отримання Mx….
3. Торкніться Встановити адресу спостереження. Застосунок покаже Встановлення…, потім Адресу спостереження встановлено.
4. Тепер вкладка показує баланс цієї адреси лише для читання.

9Вузол

Вкладка Вузол — це пульт керування обліковим записом. Потягніть униз або знову відкрийте вкладку, щоб оновити її.

Згори вниз:

1. Ваше ім'я. Як ви відображаєтеся у списках контактів, на кожному пристрої. Торкніться Змінити, введіть нове ім'я (наприклад, eurobuddha) і збережіть. Показується вашим контактам і буде зараз повторно оголошено всім їм.
2. Стан. Завжди ввімкнено — у мережі (або Вузол недоступний), з Час роботи, Підключені ретранслятори і Поштова скринька. На старішому хості картка повідомляє Оновіть вузол до parlons-cloud 0.4.1+, щоб бачити повний стан.
3. Чому вузол на VPS — найкращий вибір. Нагадування про те, що обліковий запис робить для вас: Завжди ввімкнено, Один обліковий запис на всіх пристроях і чи є він ретранслятором (Ви — ретранслятор, з кількістю вузлів мережі, або Ретранслятор вимкнено).
4. Постійна адреса. Адреса, що ніколи не змінюється — знаходить вас на будь-якому пристрої. Копіювати і Показати QR.
5. Розміщені облікові записи (лише коли цей обліковий запис керує хостом): Керувати розміщеними обліковими записами (розділ 11).
6. Інструменти вузла і Транспорт і хости (лише коли хост надає консоль вузла, як це робить Parlons Node): Відкрити Terminal IDE і Відкрити панель керування (розділ 12).
7. Під'єднані пристрої (N). Кожен пристрій, який може керувати обліковим записом. Цей телефон позначено цей пристрій; інші показано як під'єднано. Торкніться Відкликати, щоб відключити пристрій. Він втратить доступ до вашого облікового запису. Ваша ідентичність НЕ змінюється — інші пристрої продовжують працювати. Цю дію не можна скасувати (для повторного під'єднання знадобиться новий код). Тут також з'являється власна вебпанель хоста як локальний пристрій; відкликання її доступу блокує панель.
8. Очікують підтвердження (N). Пристрої, що попросили під'єднання без коду (Пристрій хоче під'єднатися). Торкайтеся Схвалити, лише якщо впізнаєте ключ.
9. Під'єднати мій інший пристрій (розділ 10), з нагадуванням про те, що означає під'єднання пристрою.

Якщо обліковий запис не відповідає, вкладка показує Не вдається зв'язатися з вашим вузлом. і причину.

Як задати ім'я облікового запису

1. Відкрийте Вузол або торкніться Більше → Задати назву облікового запису.
2. Під Ваше ім'я торкніться Змінити.
3. Введіть нове ім'я (наприклад, eurobuddha). У діалозі сказано: Показується вашим контактам і буде зараз повторно оголошено всім їм.
4. Торкніться Задати. Застосунок покаже Ім'я встановлено — оголошуємо вашим контактам….

Як скопіювати або показати постійну адресу

1. Відкрийте Вузол і знайдіть Постійна адреса.
2. Торкніться Копіювати, щоб скопіювати повну адресу MAX#, або Показати QR, щоб показати її як QR-код.

Як відкликати доступ під'єднаного пристрою

1. Відкрийте Вузол і прокрутіть до Під'єднані пристрої (N).
2. Знайдіть пристрій. Цей телефон позначено цей пристрій.
3. Торкніться Відкликати.
4. Прочитайте Відкликати доступ цього пристрою? і торкніться Відкликати. Застосунок покаже Відкликано.

Пристрій одразу втрачає доступ. Ваша ідентичність не змінюється, інші пристрої продовжують працювати. Щоб повернутися, пристрою знадобиться новий код. Відкликання доступу власної вебпанелі хоста блокує панель (розділ 24).

Як схвалити пристрій, що попросив під'єднання

1. Відкрийте Вузол і прокрутіть до Очікують підтвердження (N). Кожен запис має вигляд Пристрій хоче під'єднатися з ключем.
2. Порівняйте ключ із тим, який показує новий пристрій (розділ 4, «Як під'єднатися без коду»).
3. Торкайтеся Схвалити, лише якщо ключі збігаються. Застосунок покаже Схвалено.

10Додавання інших пристроїв: запрошення власника

Під'єднання пристрою дає йому повне керування цим обліковим записом: його чатами, контактами і, якщо є, гаманцем. Діліться запрошенням для пристрою лише з тим, хто має керувати цим обліковим записом. Щоб запросити друга, натомість створіть окремий розміщений обліковий запис (розділ 11).

З Порталу

1. Відкрийте Вузол і торкніться Під'єднати мій інший пристрій.
2. Що буде далі, залежить від хоста:
   • Хости без служби пароля адміністратора (орендар на хості parlons-tenants або гостьовий обліковий запис): новий код створюється одразу.
   • Хости зі службою пароля адміністратора (окремий обліковий запис parlons-cloud, Parlons Node 0.2.118 або новіший і настільні застосунки-вузли): застосунок запитує Запросити пристрій. Введіть пароль адміністратора, щоб надати іншому пристрою доступ до цього облікового запису власника й терміналу Minima. Залиште поле порожнім, щоб створити окремий розміщений обліковий запис для друга.
     • Введіть пароль адміністратора й торкніться Продовжити, щоб створити запрошення власника.
     • Залиште поле порожнім і торкніться Продовжити, щоб натомість відкрити керування розміщеними обліковими записами (або, якщо розміщення не налаштовано, Розміщення на цьому сервері ще не ввімкнено).
3. Застосунок покаже Створено новий код під'єднання з одноразовим кодом і повним запрошенням. Торкніться Копіювати запрошення або QR, щоб показати його як QR-код, який відсканує новий пристрій.

Пароль перевіряється на сервері й ніколи не зберігається на телефоні. Неправильний пароль ніколи не видає коду. Після невдалої спроби зачекайте кілька секунд, перш ніж пробувати знову (Зачекайте кілька секунд, перш ніж знову вводити пароль адміністратора). Якщо пароль адміністратора ще не задано, сервер відповідає Задайте пароль адміністратора на сторінці Parlons Devices у застосунку-хості. Для сервера з командним рядком використайте: sudo parlons-pair --set-admin-password (у розділі 23 пояснено, як задати його на кожному виді хоста).

Без пароля адміністратора: схвалення

Пристрій завжди можна додати й без коду. Для схвалення пароль адміністратора не потрібен.

1. На новому пристрої під'єднайтеся з порожнім полем Код під'єднання (розділ 4, «Як під'єднатися без коду»).
2. На вже під'єднаному пристрої відкрийте Вузол → Очікують підтвердження (N).
3. Торкніться Схвалити поруч із ключем нового пристрою.
4. На новому пристрої ще раз торкніться Підключитися й під'єднати.

Із сервера

Див. розділ 23: sudo parlons-pair --admin на Parlons Node, parlons newcode в обліковому записі, установленому однорядковим інсталятором, або Пристрої → Новий код підключення у вебпанелі на будь-якому хості з панеллю.

Як відключити загублений або замінений телефон

Відкликання нічого не змінює у вашій ідентичності.

1. На будь-якому іншому під'єднаному пристрої відкрийте Вузол → Під'єднані пристрої (N).
2. Знайдіть загублений телефон і торкніться Відкликати, потім ще раз Відкликати для підтвердження.

Або з термінала з командою parlons:

1. Виведіть список пристроїв із повними ключами:

   parlons devices

2. Відкличте доступ загубленого телефона за його повним ключем:

   parlons revoke <key>

11Розміщення друзів: гостьові запрошення

Якщо ваш обліковий запис керує хостом, на вкладці «Вузол» є картка Розміщені облікові записи: Розміщуйте друзів на цьому сервері. Кожна людина отримує власний обліковий запис і запрошення без доступу до вашого облікового запису чи терміналу Minima. Так власник створює облікові записи для людей, які не запускатимуть сервер.

Тут з'являються два види хостів:

Як розмістити друга

1. Відкрийте Вузол → Керувати розміщеними обліковими записами. З'явиться список із заголовком Розміщені облікові записи (N/ліміт) або Служба розміщення не в мережі.
2. Лише для вбудованого розміщення: уперше торкніться Параметри розміщення → Увімкнути розміщення. Діалог Увімкнути розміщення? пояснює: Ваш комп'ютер зберігатиме ключі й повідомлення гостьових облікових записів і має залишатися ввімкненим. Спочатку встановіть пароль адміністратора на сторінці Parlons Devices у застосунку хоста. Торкніться Увімкнути. Розміщення не можна ввімкнути, доки не задано пароль адміністратора (розділ 23). За кілька секунд торкніться Оновити (Розміщення запускається. Оновіть за кілька секунд.).
3. Торкніться Створити обліковий запис. Під Розмістити друга введіть назву облікового запису (наприклад, alice) і торкніться Створити. Назва — від 1 до 64 літер, цифр, крапок, підкреслень або дефісів і починається з літери чи цифри.
4. Торкайтеся Оновити, доки обліковий запис не покаже працює. Його стан змінюється від запускається до працює (або повторна спроба, якщо запуск не вдався).
5. Торкніться облікового запису, потім Показати запрошення. Діалог Запрошення для ім'я показує повне запрошення. Це запрошення під'єднує пристрій до облікового запису ім'я. Тримайте його в таємниці, доки його не використано. Торкніться Копіювати запрошення і надішліть його приватно або дайте відсканувати.
6. Ваш друг установлює Parlons Cloud (Android) або Parlons (iPhone), сканує чи вставляє запрошення й торкається Підключитися й під'єднати. Дійсний код під'єднує одразу. Запрошення друга не дає доступу до вашого облікового запису.

Як призупинити або відновити розміщений обліковий запис

1. Відкрийте Вузол → Керувати розміщеними обліковими записами.
2. Торкніться облікового запису.
3. Торкніться Призупинити обліковий запис. Діалог Призупинити ім'я? повідомляє: Їхній обліковий запис вийде з мережі. Його ідентичність і чати буде збережено. Торкніться Призупинити.
4. Щоб повернути його, торкніться облікового запису, потім Відновити обліковий запис. Діалог Відновити ім'я? повідомляє: Їхній обліковий запис знову підключиться на цьому сервері. Торкніться Продовжити.
5. Торкніться Оновити, щоб побачити новий стан.

Як зупинити вбудоване розміщення

1. Відкрийте Вузол → Керувати розміщеними обліковими записами.
2. Торкніться Параметри розміщення → Зупинити розміщення.
3. Діалог Зупинити розміщення? повідомляє: Усі гостьові облікові записи вийдуть із мережі. Їхні ідентичності та чати буде збережено. Торкніться Зупинити.

Щоб знову його запустити, виконайте крок 2 з «Як розмістити друга».

Ліміт ураховує й призупинені облікові записи. Коли його досягнуто, створення ще одного завершується повідомленням Hosting limit reached (10 accounts) («досягнуто ліміту розміщення: 10 облікових записів») або іншим лімітом, який використовує хост.

Гість може керувати власним обліковим записом і під'єднувати власні інші пристрої. Він також може будь-коли створити резервну копію всього облікового запису й перейти до іншого хоста (розділ 16).

12Інструменти вузла: Terminal IDE і панель керування

Ці дві картки з'являються, лише коли обліковий запис працює на хості, що надає консоль вузла, тобто на Parlons Node. Звичайний обліковий запис parlons-cloud їх не має; керуйте його ретрансляторами й каталогом через вебпанель або команду parlons (розділи 24 і 26).

Відкрити Terminal IDE

Повний командний рядок Minima ВАШОГО вузла, а також IDE для скриптів KISS і робоче місце для ручних транзакцій - кожна команда виконується на вузлі через цей під'єднаний канал, вивід повний і доступний для копіювання. Екран Terminal IDE має чотири вкладки: Термінал, Скрипти, Транзакції і Журнали. Кожну команду записано в журнал вузла як виконану під'єднаним пристроєм. Команда quit відхиляється; перезапускайте вузол на сервері.

Як виконати команду Minima на вашому вузлі

1. Відкрийте Вузол і під Інструменти вузла торкніться Відкрити Terminal IDE.
2. На вкладці Термінал введіть команду в команда…, наприклад:

   balance

3. Торкніться Виконати. Повний вивід з'явиться вище.
4. Кнопками Попередня команда і Наступна команда переходьте між виконаними командами. Утримуйте кнопку обраного, щоб зберегти команду.
5. Щоб зберегти вивід, відкрийте меню й виберіть Скопіювати весь вивід, Виділити й скопіювати вивід або Експортувати сесію…. Очистити термінал очищає екран.

Як читати журнал вузла

1. У Terminal IDE відкрийте вкладку Журнали.
2. Прокручуйте журнал. Його зчитано з вашого вузла через під'єднаний канал.

Відкрити панель керування

Хости, досяжність, статистика ретранслятора, MLS/розташування та журнал подій наживо — усе, чим користується оператор VPS. Екран Панель керування вузлом містить:

• Стан: версія, час роботи, контакти, поштова скринька, вихідні, публічний ретранслятор і його Перевірка ретранслятора (перевірено — ретранслює на цей вузол, під'єднано, перевірка… або не підключено), Пряма досяжність і Пряма адреса, якщо вона є.
• Ретранслятор (ви передаєте трафік для мережі): під'єднані клієнти, ретрансльовані повідомлення, збережені блоби, вузли мережі.
• Хости: ретранслятори, до яких під'єднано обліковий запис. Від'єднати прибирає один із них. Щоб додати, введіть host:port (наприклад, relay.example.com:9501) або вставте текст QR-коду ретранслятора, потім Додати й підключитися. Перемикач Обліковий запис використовує вбудований список ретрансляторів вмикає або вимикає список, що постачається разом із програмою; його не можна вимкнути, доки у вас немає власного ретранслятора.
• Розташування (MLS): де визначається ваша постійна адреса. Закріпити назавжди (або Закріпити знову), Зняти закріплення, Опублікувати повторно і Копіювати постійну адресу. Закріплено — контакти завжди знаходять вас за постійною адресою.
• Журнал подій з кнопками Очистити і Оновити.

Як додати ретранслятор до облікового запису

1. Відкрийте Вузол → Відкрити панель керування.
2. Під Хости введіть host:port (наприклад, relay.example.com:9501) або вставте текст QR-коду ретранслятора.
3. Торкніться Додати й підключитися. Застосунок покаже Підключення…, і ретранслятор з'явиться в списку.

Як від'єднати ретранслятор

1. Відкрийте Вузол → Відкрити панель керування.
2. Під Хости торкніться Від'єднати поруч із ретранслятором. Застосунок покаже Від'єднання….

Як увімкнути або вимкнути вбудований список ретрансляторів

1. Відкрийте Вузол → Відкрити панель керування.
2. Під Хости перемкніть Обліковий запис використовує вбудований список ретрансляторів. Перш ніж вимкнути його, потрібно додати власний ретранслятор.

Як закріпити постійну адресу

1. Відкрийте Вузол → Відкрити панель керування і знайдіть Розташування (MLS).
2. Торкніться Закріпити назавжди (або Закріпити знову, якщо закріплення вже є). Застосунок покаже Постійну адресу закріплено.
3. Копіювати постійну адресу копіює повну адресу.
4. Щоб скасувати, торкніться Зняти закріплення. Щоб негайно знову розіслати свій запис у каталозі, торкніться Опублікувати повторно.

Як читати й очищати журнал подій

1. Відкрийте Вузол → Відкрити панель керування і прокрутіть до Журнал подій.
2. Торкніться Оновити, щоб побачити найновіші рядки, або Очистити, щоб очистити журнал.

13Довідник налаштувань

Відкрийте Більше → Налаштування.

Як увімкнути або вимкнути звіти про прочитання

1. Відкрийте Більше → Налаштування.
2. Під Ваш обліковий запис перемкніть Надсилати звіти про прочитання. Налаштування зберігається у вашому обліковому записі, тож діє з усіх пристроїв.

Як заблокувати застосунок

1. Спершу налаштуйте відбиток пальця або блокування екрана в налаштуваннях Android. Інакше застосунок скаже Спочатку налаштуйте відбиток пальця або блокування екрана в налаштуваннях телефону.
2. Відкрийте Більше → Налаштування.
3. Під Конфіденційність і безпека увімкніть Блокування застосунку.
4. Відтепер під час відкриття застосунку з'являється Розблокувати Parlons Cloud. Скористайтеся відбитком пальця або PIN-кодом пристрою.

Щоб приховати застосунок від знімків і запису екрана, поки його заблоковано, вимкніть Дозволити показ екрана в тому самому розділі.

Як вимкнути сигнал повідомлень

1. Відкрийте Більше → Налаштування.
2. Під Сповіщення вимкніть Звук повідомлення. Нові повідомлення й далі надходять зі сповіщенням і вібрацією, але без сигналу.

Як змінити мелодію дзвінка та сповіщення про дзвінки на заблокованому екрані

1. Відкрийте Більше → Налаштування.
2. Під Сповіщення торкніться Налаштування вхідних дзвінків. Відкриються налаштування самого Android.
3. Виберіть мелодію та вібрацію й дозвольте повноекранні сповіщення на заблокованому екрані.

Як тримати застосунок підключеним у фоновому режимі

1. Відкрийте Більше → Налаштування і прокрутіть до Цей пристрій.
2. Торкніться Працювати у фоновому режимі. Android запитає, чи дозволити застосунку ігнорувати оптимізацію батареї.
3. Дозвольте. Пункт зникне, щойно застосунок буде виведено з-під оптимізації.
4. Щоб перевірити канали сповіщень, торкніться Налаштування сповіщень у тому самому розділі.

Як відкрити або встановити Minima Core

1. Відкрийте Більше → Налаштування і знайдіть Minima Core на цьому телефоні.
2. Якщо Minima Core установлено, на картці написано Minima Core встановлено ✓. Торкніться Відкрити Minima Core.
3. Якщо ні, торкніться Отримати Minima Core, щоб установити його.

Як задати ретранслятори, з яких починає цей телефон

Це ретранслятори, якими телефон користується, щоб знайти обліковий запис (власні ретранслятори облікового запису задаються в самому обліковому записі, розділ 12 або 24).

1. Торкніться Ретранслятори, з яких починає цей телефон. У списку кожен ретранслятор позначено як вбудований або ваш.
2. Щоб додати ретранслятор, введіть host:port або вставте текст QR-коду ретранслятора й торкніться Додати. Або торкніться Сканувати QR-код ретранслятора. Текст QR-коду ретранслятора починається з parlons-relay:.
3. Прибрати видаляє ваш власний ретранслятор. Потрібно залишити принаймні один; якщо прибрати останній власний, знову ввімкнеться вбудований список.
4. Використовувати вбудовані ретранслятори (список, що постачається із застосунком) вмикає або вимикає вбудований список. Перш ніж вимкнути його, потрібно додати власний ретранслятор.
5. Скинути повертає до вбудованого списку. Готово закриває діалог.

Зміни набувають чинності під час наступного перепідключення.

14Сповіщення, дзвінки та постійне з'єднання

Застосунок підтримує постійне зашифроване з'єднання з вашим обліковим записом як службу переднього плану Android, щоб повідомлення надходили зі сповіщеннями, а дзвінки дзвонили. Його постійне сповіщення — Підключено до вашого хмарного облікового запису. Після перезапуску телефона застосунок перепідключається сам, якщо пристрій під'єднано.

Канали сповіщень Android:

Дзвінки. Голосові й відеодзвінки — лише віч-на-віч. Аудіо й відео зашифровано між двома пристроями. Застосунок уперше запитує доступ до мікрофона (і камери, для відео).

Як відповісти на дзвінок

1. Вхідний дзвінок показує Вхідний дзвінок Parlons (або Вхідний відеодзвінок Parlons), на весь екран на заблокованому екрані, якщо Android це дозволяє.
2. Торкніться Відповісти, щоб прийняти, або Відхилити, щоб відмовитися.
3. Під час дзвінка використовуйте Вимкнути мікрофон / Увімкнути мікрофон, Гучномовець / Динамік, Змінити (перемкнути камеру, лише відео) і Завершити.

Як зателефонувати, див. розділ 6, «Як зателефонувати контакту».

Якщо повідомлення надходять із запізненням

1. Відкрийте Більше → Налаштування → Цей пристрій і торкніться Працювати у фоновому режимі, якщо цей пункт показано (розділ 13).
2. Переконайтеся, що Android дозволяє сповіщення застосунку (Налаштування сповіщень у тому самому розділі).
3. Перевірте індикатор стану. На ньому має бути у мережі · N хостів.
4. Якщо на індикаторі недоступно, можливо, зупинено сам обліковий запис (розділ 17).

15Використання облікового запису з інших застосунків Parlons

Одним обліковим записом можна керувати з кількох місць одночасно. Кожне з них — окремий під'єднаний пристрій із власним ключем.

• iPhone: застосунок Parlons (поки недоступний). Коли його випустять: відскануйте або вставте запрошення того самого виду; він під'єднується до облікового запису так само, як Портал. Кожному наступному пристрою потрібен власний новий код.
• Браузер на машині, де працює обліковий запис: вебпанель. Вона схожа на застосунок Parlons! (заголовок Parlons!, вкладки «Чати», «Контакти», «Пристрої», «Вузол», «Налаштування») і працює як локальний пристрій облікового запису (розділ 24).
• Термінал: команда parlons. Установлюється однорядковим інсталятором. parlons chats, parlons send <contact key> hello та інші команди з розділу 26 керують обліковим записом так само, як телефон.
• minimaCore Desktop і minimaDesk вбудовують ту саму панель на своїй сторінці Parlons для облікового запису, який запускає їхній вузол.

Повний застосунок Parlons! для Android не є клієнтом. Він зберігає власну ідентичність на телефоні й не під'єднується до облікового запису. Проте ідентичність можна переносити між ними: резервна копія, створена з вашого хмарного облікового запису (Створити резервну копію облікового запису…), відновлюється в застосунку Parlons! (ідентичність і контакти). Ніколи не запускайте одну ідентичність у двох місцях одночасно (розділ 16).

Як під'єднати iPhone до того самого облікового запису

Застосунок для iPhone поки недоступний. Ось кроки на час, коли його випустять.

1. На вже під'єднаному пристрої відкрийте Вузол → Під'єднати мій інший пристрій і створіть нове запрошення (розділ 10).
2. На iPhone відкрийте застосунок Parlons.
3. Торкніться Сканувати QR акаунта і відскануйте запрошення або вставте його.
4. Завершіть під'єднання в застосунку для iPhone. Дійсний код під'єднує одразу.

Ваш обліковий запис і застосунки інших людей. Будь-хто, хто користується будь-яким застосунком Parlons або класичним вузлом Minima з Maxima, може додати вашу адресу MAX# як контакт і писати вам.

16Резервні копії, відновлення та перенесення

Ваші 24 слова

Кожен обліковий запис — це 24 слова. Адреса облікового запису виводиться з них, тож ті самі слова будь-де дають ту саму адресу. Вони також є гаманцем Minima: будь-хто, хто їх прочитає, може витратити все, що на них зберігається.

Як побачити свої 24 слова

1. Переконайтеся, що ніхто не бачить вашого екрана.
2. Відкрийте Більше → Налаштування і під Ключі й резервна копія торкніться Показати сід-фразу.
3. Діалог Показати сід-фразу? попереджає: Ця фраза керує вашою ідентичністю Parlons. Вона може відрізнятися від фрази гаманця сервера. Переконайтеся, що ніхто не дивиться. Вона передається на цей телефон зашифрованим каналом. Торкніться Показати.
4. З'являться Ваші 24 слова. Запишіть їх на папері.
5. Торкніться Закрити. Якщо натомість торкнутися Копіювати, застосунок скаже Скопійовано — буфер обміну очиститься через 60 с.

Фраза ідентичності й фраза гаманця можуть відрізнятися, наприклад після Пересинхронізувати гаманець на нову фразу… на Parlons Node або після імпорту ідентичності. Бережіть обидві.

Запишіть слова на папері й зберігайте папір офлайн. Ніколи не фотографуйте їх, не надсилайте електронною поштою і не вставляйте в чат.

Як створити резервну копію всього облікового запису

1. Відкрийте Більше → Налаштування і під Ключі й резервна копія торкніться Створити резервну копію облікового запису….
2. У Резервне копіювання облікового запису введіть парольну фразу в Парольна фраза (щонайменше 6 символів) і ще раз у Повторіть парольну фразу. Її НЕМОЖЛИВО відновити, якщо ви її втратите.
3. Торкніться Створити резервну копію.
4. Застосунок покаже Створення зашифрованої резервної копії…, а потім запитає, куди зберегти файл .pbk.
5. Збережіть його в надійному місці. Резервну копію збережено підтверджує збереження. (Якщо надто довго не вибирати місце, застосунок скаже Термін дії резервної копії минув — експортуйте ще раз.)

Пакет шифрується вашою парольною фразою, перш ніж залишити вузол. Він містить ідентичність, під'єднані пристрої, налаштування, контакти й історію чатів у тому самому форматі .pbk, який читає застосунок для телефона. Медіафайли й вміст приватних файлів не входять. У терміналі той самий файл створює parlons backup <file.pbk>.

Як відновити обліковий запис на власній машині

1. Створіть резервну копію (вище) або візьміть наявну.
2. На машині, де працюватиме обліковий запис, відновіть пакет у порожню папку даних за допомогою --restore до запуску облікового запису. Точні команди наведено в розділі 19, «Перенесення облікового запису на іншу машину».
3. Назавжди зупиніть стару копію.

Адреса не змінюється, тож кожен під'єднаний пристрій перепідключиться сам.

Як імпортувати ідентичність на Parlons Node із застосунку

Для цього потрібен Parlons Node 0.2.117 або новіший. На інших хостах застосунок скаже Оновіть Parlons Node до версії 0.2.117 або новішої, щоб імпортувати з цього застосунку.

1. Спершу зупиніть ідентичність на її початковому пристрої або сервері.
2. Відкрийте Більше → Налаштування і під Ключі й резервна копія торкніться Імпортувати ідентичність або резервну копію….
3. Виберіть, що імпортувати:
   • введіть Фраза відновлення; або
   • виберіть Власна фраза (Minima anyphrase) для нестандартної фрази (кожен пробіл і кожна велика літера зберігаються); або
   • торкніться Вибрати резервну копію .pbk натомість…, виберіть файл і введіть його Пароль резервної копії.
4. Торкніться Переглянути імпорт. Перевірте нову адресу.
5. Позначте Я зупинив цю ідентичність на її початковому пристрої чи сервері.
6. Торкніться Імпортувати й перезапустити. Сервер перезапуститься (Сервер перезапускається. Перепідключення до імпортованої ідентичності…), і застосунок перепідключиться (Ідентичність імпортовано й підключено).

Це замінює ідентичність Parlons, контакти й чати сервера. Його гаманець Minima і фраза гаманця не змінюються. Попередній обліковий запис зберігається на сервері для відновлення. Якщо з'єднання обірветься, знову відкрийте екран і торкніться Продовжити / перевірити імпорт. Скасувати підготовлений імпорт скасовує імпорт до підтвердження. Ваша фраза ніколи не зберігається на телефоні.

Одна ідентичність — одне місце

Запускайте кожну ідентичність лише в одному місці одночасно. Дві копії плутають ваших контактів і можуть повторно використати ключі гаманця, які ніколи не можна використовувати повторно. Переносьте, а не копіюйте: назавжди зупиніть стару копію, перш ніж запускати нову.

Як піти від хоста

Піти можна будь-коли. Ваша адреса не змінюється, тож ваші контакти й під'єднані пристрої продовжать працювати.

1. Створіть резервну копію всього облікового запису (вище) і збережіть парольну фразу.
2. Попросіть хост призупинити стару копію (розділ 22, «Призупинення та відновлення»), щоб ідентичність ніколи не працювала у двох місцях.
3. Відновіть пакет на власній машині й запустіть його (розділ 19, «Перенесення облікового запису на іншу машину»).
4. Перевірте, що ваш телефон перепідключився до нової копії.
5. Попросіть хост назавжди видалити стару копію.

17Усунення несправностей для власників облікових записів

Де шукати журнали: Вузол → Відкрити панель керування → Журнал подій (Parlons Node); в інших випадках зверніться до того, хто керує машиною (розділ 30).

Частина B. Розміщення облікових записів

18Який хост вам потрібен?

Кожному хосту потрібна машина, яка постійно ввімкнена й має вихідний доступ до інтернету. Окремому обліковому запису не потрібні ні домен, ні сертифікат TLS, ні зворотний проксі. Вхідні порти потрібні, лише якщо хост також запускає ретранслятор для інших.

19Один обліковий запис на власній машині: однорядкові інсталятори

Як установити на Mac, Linux, Raspberry Pi або VPS

1. Відкрийте термінал на машині, де працюватиме обліковий запис.
2. Вставте це й натисніть Enter:

   curl -fsSL https://raw.githubusercontent.com/eurobuddha/maxima/main/ops/get-parlons-cloud.sh | bash

3. Зачекайте, доки завершаться п'ять кроків. Останній екран покаже вашу адресу, QR-код запрошення й текст запрошення.
4. На телефоні під'єднайте Портал за цим запрошенням (розділ 4).
5. Одразу створіть резервну копію сід-фрази (нижче).

Як установити на Windows 10 або 11

1. Відкрийте PowerShell.
2. Вставте це й натисніть Enter:

   irm https://raw.githubusercontent.com/eurobuddha/maxima/main/ops/get-parlons-cloud.ps1 | iex

3. Зачекайте завершення, потім під'єднайте телефон за виведеним запрошенням (розділ 4).
4. Створіть резервну копію сід-фрази з C:\Users\<you>\.parlons\seed.txt (нижче).

Скрипт для Windows сам про себе повідомляє, що автори ще не перевірили його на машині з Windows. Повідомляйте про будь-які проблеми.

Що робить інсталятор

Інсталятор:

1. установлює Java 11 або новішу, якщо її немає (Homebrew на Mac, apt, dnf, apk або pacman на Linux, winget на Windows), а також qrencode, де це можливо;
2. завантажує найновіший випуск parlons-cloud з GitHub і перевіряє його контрольну суму SHA-256;
3. реєструє службу, яка переживає перезавантаження: агент launchd на Mac, користувацький модуль systemd (з linger) або системний модуль на Linux, заплановане завдання з назвою Parlons Cloud на Windows;
4. запускає обліковий запис, під'єднує цей термінал як перший пристрій і створює новий код;
5. виводить адресу облікового запису, запрошення для вашого телефона (текстом і QR-кодом) і команду parlons.

Завершується це так (адресу й запрошення виведено повністю):

  Your Parlons account is running (Parlons Cloud 0.11.124).

  Address (share it; it never changes):
  <the full MAX# address>

  Pair your phone: open the Parlons Cloud app, tap Scan account QR, point it at this:
  <a QR code, drawn in the terminal>
  or paste the invite (the code half works once):
  <the full invite>

  BACK UP YOUR SEED NOW:  ~/.parlons/seed.txt  -  it is your identity AND a wallet.

У тексті інсталятора написано Scan account QR — це напис застосунку для iPhone. В Android-Порталі кнопка називається Сканувати QR-код під'єднання.

Параметри

За замовчуванням обліковий запис працює з --relay-port 9501 --no-direct: він ретранслює для інших на порту 9501, а на Linux інсталятор відкриває 9501 в ufw, якщо ufw активний. Якщо 9501 недоступний ззовні, нічого не ламається: обліковий запис і далі працює через мережу ретрансляторів, просто не передає чужих повідомлень. З --no-relay він узагалі не відкриває вхідних портів. Його вебпанель слухає на 127.0.0.1:9587 (розділ 24).

Як зробити ваш ретранслятор доступним для інших

1. Установіть як зазвичай; ретранслятор увімкнено за замовчуванням.
2. Переконайтеся, що TCP-порт 9501 доступний з інтернету: дозвольте його в брандмауері вашого хмарного провайдера або переадресуйте на домашньому роутері.
3. На Linux інсталятор відкриває 9501 в ufw, якщо ufw активний.
4. Перевірте порт з іншої машини (розділ 28).

Як установити без ретранслятора

curl -fsSL https://raw.githubusercontent.com/eurobuddha/maxima/main/ops/get-parlons-cloud.sh | bash -s -- --no-relay

На Windows завантажте get-parlons-cloud.ps1 і виконайте .\get-parlons-cloud.ps1 -NoRelay.

Як використати іншу папку даних або розмір купи

1. Задайте змінну перед bash:

   curl -fsSL https://raw.githubusercontent.com/eurobuddha/maxima/main/ops/get-parlons-cloud.sh | PARLONS_DATA=/srv/parlons PARLONS_HEAP=512m bash

2. Використовуйте ті самі змінні під час кожного наступного запуску інсталятора, щоб він знаходив ту саму папку.

Як оновити

1. Виконайте:

   parlons update

   Або знову виконайте команду встановлення. На Windows знову виконайте команду встановлення.

2. Інсталятор завантажує найновіший випуск, перевіряє його SHA-256 і перезапускає обліковий запис.
3. Перевірте, що він знову працює:

   parlons status

Як видалити службу й зберегти дані

1. Виконайте:

   parlons uninstall

   На Windows виконайте .\get-parlons-cloud.ps1 -Uninstall.

2. Службу буде зупинено й видалено. Дані облікового запису залишаються в папці даних.

Щодня

Щоб видалити сам обліковий запис (ідентичність, чати, сід-фразу), деінсталятор пропонує вам самостійно видалити папку даних і ~/.parlons-client. Спершу створіть резервну копію: видалення сід-фрази видаляє ідентичність і всі кошти, що на ній зберігаються.

Резервна копія сід-фрази

~/.parlons/seed.txt (на Windows C:\Users\<you>\.parlons\seed.txt) містить 24 слова. Інсталятор ніколи їх не виводить.

1. Переконайтеся, що ніхто не бачить вашого екрана.
2. Покажіть слова:

   cat ~/.parlons/seed.txt

   Або з будь-якого під'єднаного термінала: parlons seed.

3. Перепишіть їх на папір. Зберігайте папір у надійному місці й офлайн.
4. Очистіть термінал.

Перенесення облікового запису на іншу машину

1. На старій машині: parlons backup my-account.pbk, виберіть парольну фразу.
2. Скопіюйте файл на нову машину.
3. На новій машині відновіть його до запуску інсталятора, у папку, яку використовуватиме інсталятор:

   mkdir -p ~/.parlons
   curl -fsSL -o ~/parlons-cloud.jar "$(curl -fsSL https://api.github.com/repos/eurobuddha/maxima/releases | grep -oE 'https://github.com/[^"]+/cloud-v[^"]+/parlons-cloud-[0-9.]+\.jar' | head -1)"
   java -jar ~/parlons-cloud.jar --data ~/.parlons --restore my-account.pbk
   curl -fsSL https://raw.githubusercontent.com/eurobuddha/maxima/main/ops/get-parlons-cloud.sh | bash

   --restore запитує парольну фразу в консолі й відмовляється працювати поверх наявної ідентичності. Він виводить, що відновив (ім'я, контакти, лічильники використання ключів, під'єднані пристрої та записи чатів).

4. Назавжди зупиніть стару машину: виконайте там parlons uninstall і зберігайте її дані лише як холодну резервну копію.

Під'єднані пристрої перепідключаться самі, бо адреса та сама.

20Один обліковий запис на VPS: deploy-parlons-cloud.sh

Як розгорнути обліковий запис на VPS

1. На власному комп'ютері отримайте копію репозиторію.
2. Зберіть jar або покладіть випущений parlons-cloud-0.11.124.jar у dist/:

   ./gradlew :cloud:fatJar

3. Переконайтеся, що можете підключитися до VPS через SSH як root без запиту пароля.
4. Запустіть скрипт розгортання:

   ops/deploy-parlons-cloud.sh root@vps.example.com --port 9501 --name "My account"

5. Наприкінці скрипт виведе адресу облікового запису й одноразовий код під'єднання. Під'єднайте ними телефон (розділ 4).
6. Один раз прочитайте сід-фразу й збережіть її офлайн:

   ssh root@vps.example.com 'cat /var/lib/maxima/seed.txt'

7. Дозвольте порт ретранслятора в брандмауері вашого хмарного провайдера й перевірте його з іншої машини (розділ 28).

Щоб пізніше оновити, знову виконайте ту саму команду. Установлення й оновлення — одна й та сама операція.

Параметри

--port N (порт ретранслятора, за замовчуванням 9501), --name "…" (ім'я для показу), --jar FILE (за замовчуванням найновіший dist/parlons-cloud-*.jar), --heap 256m, --memmax 1024M, --blob 1024 (сховище медіа ретранслятора в MB), --peers h:p,h:p (вузли mesh-мережі для ретранслятора).

Скрипт ідемпотентний: установлення й оновлення — та сама команда. По черзі він:

1. установлює Java без графічного інтерфейсу, якщо на сервері її немає;
2. створює непривілейованого користувача maxima і /var/lib/maxima (режим 700);
3. вивантажує jar у /opt/maxima, перевіряє його SHA-256 і лише після цього спрямовує на нього символьне посилання parlons-cloud.jar;
4. записує захищений parlons-cloud.service (ізольований, з обмеженням пам'яті, фільтрацією seccomp і заблокованими адресами хмарних метаданих), що запускає --data /var/lib/maxima --relay-port <port> --no-direct --blobstore <MB>;
5. відкриває порт ретранслятора в ufw або firewalld, якщо один із них активний;
6. запускає службу й перевіряє, що вона слухає;
7. виводить адресу облікового запису й одноразовий код під'єднання.

Він ніколи не виводить сід-фразу. Прочитайте її один раз через SSH, як у кроці 6 вище.

Якщо скрипт не вивів адреси чи коду

1. Підключіться до VPS через SSH.
2. Знайдіть адресу в журналі:

   journalctl -u parlons-cloud | grep 'permanent address' | tail -1

3. Якщо пристрій уже під'єднано, початкового коду на диску немає. Створіть новий код з під'єднаного пристрою (розділ 10).

Ручне встановлення (чотири команди, мінімальний модуль) описано в cloud/SETUP.md. Зверніть увагу: коли обліковий запис працює під systemd, його вивід — це журнал, і програма навмисно ніколи не виводить туди нову сід-фразу; запустіть її один раз на передньому плані, якщо хочете побачити слова під час першого запуску, або прочитайте seed.txt пізніше.

21Багато облікових записів: служба parlons-tenants

Хост із багатьма обліковими записами тримає по одному постійно ввімкненому обліковому запису в кожній папці одного каталогу, усі в одному процесі. Він для людей, які не запускатимуть власний сервер: користувача iPhone, друга, рецензента. Кожен орендар має власну ідентичність, пристрої, чат і резервну копію й може будь-коли піти, забравши зашифрований пакет.

Як установити хост орендарів

Вам потрібна Linux-машина, яка постійно ввімкнена (512 MB RAM вистачає приблизно на десять облікових записів), і репозиторій на власному комп'ютері.

1. На власному комп'ютері зберіть jar (./gradlew :cloud:fatJar) або покладіть parlons-cloud-0.11.124.jar у dist/.
2. Переконайтеся, що можете підключитися до сервера через SSH як root за ключем (скрипт запускає SSH у пакетному режимі, тож не може відповісти на запит пароля).
3. Виконайте:

   ops/deploy-parlons-tenants.sh root@your.box

4. Зачекайте, доки скрипт перевірить, що хост працює й опитує орендарів.
5. Скопіюйте /etc/parlons-tenants.env із сервера в надійне офлайн-сховище, окремо від резервних копій даних:

   scp root@your.box:/etc/parlons-tenants.env ./parlons-tenants.env.backup

6. Створіть першого орендаря (розділ 22).

Параметри

Скрипт:

1. установлює Java без графічного інтерфейсу, якщо її немає;
2. створює користувача maxima і каталог орендарів (режим 700);
3. вивантажує jar у /opt/maxima, перевіряє його SHA-256 і спрямовує на нього parlons-cloud.jar;
4. один раз записує файл парольної фрази розблокування /etc/parlons-tenants.env (лише для root, випадкове значення PARLONS_UNLOCK=) і захищений parlons-tenants.service;
5. перезапускає службу й перевіряє, що хост працює й опитує орендарів.

Модуль запускає:

/usr/bin/java -Xmx<heap> -jar /opt/maxima/parlons-cloud.jar \
    --tenants /var/lib/parlons-tenants --no-relay --no-direct --panel-port 9597 --unlock env

Тож за замовчуванням хост не відкриває жодного вхідного порту (він під'єднується до мережі ретрансляторів лише вихідними з'єднаннями) і може працювати поруч із Parlons Node на тому самому сервері. Нові орендарі створюються із зашифрованими сід-фразами (seed.enc), бо діє парольна фраза розблокування.

Створіть резервну копію /etc/parlons-tenants.env. Кожен seed.enc зашифровано нею. Без неї зашифровану сід-фразу неможливо відкрити.

З Parlons Node: --manage-from-node

Скористайтеся цим, коли на сервері вже працює Parlons Node (0.2.118 або новіший) і його власник має керувати гостями з Порталу.

1. Перевірте, що на сервері встановлено parlons-node. Без нього скрипт відмовляється працювати.
2. Виконайте:

   ops/deploy-parlons-tenants.sh root@your.box --jar dist/parlons-cloud-0.11.124.jar --manage-from-node

3. Зачекайте, доки обидві служби перезапустяться.
4. У Порталі, під'єднаному до вузла, відкрийте Вузол і перевірте, що з'явилася картка Розміщені облікові записи з Керувати розміщеними обліковими записами.

Скрипт додає файл доповнення /etc/systemd/system/parlons-node.service.d/hosted-accounts.conf (задає PARLONS_HOSTED_DIR як каталог орендарів і дозволяє вузлу писати туди), а потім перезапускає parlons-node. Наявний командний рядок і дані вузла зберігаються. Скрипт відмовляється працювати, якщо parlons-node не встановлено. Після цього власник може керувати гостями з Порталу: Вузол → Розміщені облікові записи → Керувати розміщеними обліковими записами (розділ 11), а із сервера — за допомогою sudo parlons-pair --guest <name> (розділ 23).

Вебпанелі для орендарів

deploy-parlons-tenants.sh записує в модуль --panel-port 9597. Кожен орендар отримує власну loopback-вебпанель: перший запущений займає 9597, наступний 9598 і так далі, у порядку запуску. Діапазон починається вище за 9587, бо Parlons Node на тому самому сервері вже займає 127.0.0.1:9587, типовий порт панелі.

У старіших модулях був --no-panel, тож їхні орендарі не мали панелі.

Як дати орендарям панелі на старішому модулі

1. Повторно запустіть скрипт розгортання. Він перепише модуль із --panel-port 9597:

   ops/deploy-parlons-tenants.sh root@your.box

2. Або відредагуйте модуль вручну на сервері. Спершу збережіть копію:

   cp /etc/systemd/system/parlons-tenants.service /etc/systemd/system/parlons-tenants.service.before-panels
   systemctl edit --full parlons-tenants

   У ExecStart замініть --no-panel на --panel-port 9597. Потім:

   systemctl daemon-reload && systemctl restart parlons-tenants

Як дізнатися порт панелі орендаря

1. На сервері прочитайте panel.txt орендаря:

   sudo cat /var/lib/parlons-tenants/alice/panel.txt

2. Використовуйте цей порт. Не вгадуйте: номери видаються послідовно й не використовуються повторно, поки хост працює, тож призупинений і відновлений орендар повертається на наступному номері.

Якщо порт панелі зайнятий, панель цього орендаря не запускається (у журналі буде web panel could NOT start on 127.0.0.1:<port>). Сам обліковий запис працює далі. Повторний запуск deploy-parlons-tenants.sh перезаписує модуль, тож будь-які ручні зміни буде втрачено, і їх доведеться внести знову.

Як відкрити панель орендаря зі свого комп'ютера, описано в розділі 24.

Місткість

Кожен орендар під'єднується приблизно до трьох ретрансляторів мережі з однієї IP-адреси хоста, а ретранслятори обмежують кількість незареєстрованих з'єднань з однієї IP-адреси (за замовчуванням 32). Розраховуйте приблизно на десять орендарів на хост. Типовий ліміт створення розміщених облікових записів — десять, зокрема призупинені (-Dparlons.hosted.limit=<n> змінює його).

22Створення, призупинення та видалення орендарів

Створення

Як створити орендаря зі свого комп'ютера

1. Виберіть назву: від 1 до 64 символів — літери, цифри, ., _ і -, починається з літери чи цифри.
2. Виконайте:

   ops/tenant-new.sh root@your.box alice

   Додайте --dir <path>, якщо ви не використовували типовий каталог орендарів.

3. Зачекайте. Скрипт запускає на сервері parlons-cloud --tenant-new від імені користувача maxima. Він виводить waiting for hosted account alice to connect… і до 60 секунд чекає, доки запущений хост запустить новий обліковий запис.
4. Скопіюйте виведене запрошення й надішліть його приватно користувачеві облікового запису або перетворіть на QR-код будь-яким генератором QR.

Він виводить повністю:

  address:   <the full MAX# address>
  pair code: <XXXX-XXXX-XXXX>   (one-time)
  invite:    <the full invite>
  A valid invite pairs immediately. Share it only with this account's user.

Нові облікові записи запускаються протягом п'яти секунд; більше нічого не перезапускається.

Як створити орендаря безпосередньо на сервері

1. Підключіться до сервера через SSH як root.
2. Виконайте:

   runuser -u maxima -- java -jar /opt/maxima/parlons-cloud.jar --tenant-new /var/lib/parlons-tenants alice

3. Надішліть виведене запрошення приватно користувачеві облікового запису.

Інші способи створити орендаря: sudo parlons-pair --guest alice на Parlons Node з --manage-from-node (розділ 23) або Портал власника (розділ 11).

Призупинення та відновлення

Призупинені облікові записи зберігають ідентичність і чати. Призупинити обліковий запис / Відновити обліковий запис у Порталі власника робить те саме.

Як призупинити орендаря

1. Підключіться до сервера через SSH.
2. Створіть файл .stop орендаря:

   touch /var/lib/parlons-tenants/alice/.stop

3. Протягом п'яти секунд журнал покаже tenant alice: stopped (.stop).

Як відновити орендаря

1. Видаліть файл .stop:

   rm /var/lib/parlons-tenants/alice/.stop

2. Протягом п'яти секунд журнал покаже hot-add: alice, і орендар знову запуститься.

Нове запрошення для наявного орендаря

Поточне запрошення орендаря лежить у /var/lib/parlons-tenants/<name>/invite.txt, поки є невикористаний код (pair-code.txt). Після використання обидва файли видаляються.

Як видати нове запрошення для орендаря

Скористайтеся одним зі способів:

1. Зі свого комп'ютера. Знову виконайте команду створення для наявної назви:

   ops/tenant-new.sh root@your.box alice

   Для наявної папки вона не замінює ідентичність. Вона повторно видає невикористаний код або створює новий.

2. З власного пристрою орендаря. Орендар відкриває у своєму Порталі Вузол → Під'єднати мій інший пристрій. Орендарі на хості parlons-tenants не мають пароля адміністратора, тож код створюється одразу.
3. З Порталу власника (з --manage-from-node): Вузол → Керувати розміщеними обліковими записами, торкніться облікового запису, потім Показати запрошення.

Як прочитати невикористане запрошення на сервері

1. Підключіться до сервера через SSH.
2. Виконайте:

   sudo cat /var/lib/parlons-tenants/alice/invite.txt

   Якщо файлу немає, код уже використано. Видайте нове запрошення (вище).

Відновлення орендаря з резервної копії

Хост запускає будь-яку нову папку протягом п'яти секунд, а папка без сід-фрази отримує нову ідентичність. --restore записує seed.txt останнім. Тому відновлюйте в проміжну папку поза каталогом орендарів, а потім переміщуйте її туди.

1. Скопіюйте файл .pbk на сервер туди, де користувач maxima може його прочитати.
2. Виберіть назву орендаря, якої ще немає. Використовуйте проміжний шлях на тій самій файловій системі, що й каталог орендарів.
3. В інтерактивному сеансі SSH (--restore запитує парольну фразу в консолі) виконайте:

   sudo install -d -o maxima -g maxima -m 700 /var/lib/parlons-restore-alice
   sudo runuser -u maxima -- java -jar /opt/maxima/parlons-cloud.jar --data /var/lib/parlons-restore-alice --restore /path/alice.pbk

4. Введіть парольну фразу резервної копії, коли її запитають. Команда виведе, що відновлено.
5. Перемістіть папку:

   sudo mv /var/lib/parlons-restore-alice /var/lib/parlons-tenants/alice

6. Протягом п'яти секунд хост запустить її з відновленою ідентичністю.

Відновлений seed.txt зберігається відкритим текстом (режим 0600). Щоб зашифрувати його, виконайте наступну процедуру.

Шифрування наявних відкритих сід-фраз

1. Переконайтеся, що ніхто не бачить вашого екрана, а потім прочитайте парольну фразу розблокування. Ви введете її на кроці 3:

   sudo grep PARLONS_UNLOCK /etc/parlons-tenants.env

2. Зупиніть хост:

   systemctl stop parlons-tenants

3. В інтерактивному сеансі SSH запустіть шифрування й, коли запитають, введіть ту саму парольну фразу, що й PARLONS_UNLOCK:

   sudo runuser -u maxima -- java -jar /opt/maxima/parlons-cloud.jar --tenants /var/lib/parlons-tenants --unlock prompt --encrypt-seeds

4. Знову запустіть хост:

   systemctl start parlons-tenants

Кожен seed.txt стає seed.enc. Кожен перевіряється, перш ніж буде видалено його відкритий текст.

Видалення орендаря

Команди видалення немає. Папка орендаря містить ключі облікового запису: поводьтеся з нею як із гаманцем.

1. Призупиніть орендаря (touch /var/lib/parlons-tenants/alice/.stop).
2. Переконайтеся, що людина має свою резервну копію або що обліковий запис їй більше не потрібен.
3. Перемістіть папку з каталогу орендарів:

   sudo mv /var/lib/parlons-tenants/alice /var/lib/parlons-removed-alice

4. Зберігайте її як холодну резервну копію або зітріть, коли будете певні.

23Запрошення власника та гостьові запрошення із сервера

Пароль адміністратора для під'єднання

Запрошення власника (коди, що дають повне керування обліковим записом власника) захищено паролем адміністратора для під'єднання на хостах зі службою пароля: окремий обліковий запис parlons-cloud, Parlons Node 0.2.118 або новіший і настільні застосунки-вузли. Гостьовим запрошенням він ніколи не потрібен.

• Він має містити від 10 до 1024 символів.
• Хост зберігає лише перевірювач (зашифрований за допомогою scrypt і AES-GCM) у .admin-pairing-password у папці даних облікового запису; сам пароль він ніколи не зберігає.
• Після кожної спроби хост чекає дві секунди, перш ніж прийняти наступну.
• Задати чи змінити його можна лише локально: у вебпанелі хоста, на сторінці Parlons Devices настільних застосунків або в командному рядку. Віддаленого скидання пароля немає.
• Наявні пристрої власника залишаються власниками, коли ви його додаєте.

Як задати пароль адміністратора на Parlons Node

1. Відкрийте інтерактивний сеанс SSH на сервері вузла.
2. Виконайте:

   sudo parlons-pair --set-admin-password

3. На Admin password (Enter for a guest invitation): введіть новий пароль (від 10 до 1024 символів). На Confirm admin password: введіть його ще раз.
4. Команда виведе Admin pairing password saved. («Пароль адміністратора для під'єднання збережено»).

Без інтерактивного термінала вона зупиняється з повідомленням Use an interactive SSH terminal (ssh -t) for the admin password («Для пароля адміністратора використайте інтерактивний термінал SSH (ssh -t)»).

Як задати пароль адміністратора у вебпанелі

1. Відкрийте вебпанель облікового запису (розділ 24).
2. Відкрийте Пристрої і знайдіть Установити пароль адміністратора (або Змінити пароль адміністратора, якщо його вже задано).
3. Щоб змінити наявний пароль, введіть його в Поточний пароль.
4. Введіть новий пароль у Новий пароль і ще раз у Підтвердьте новий пароль. Він має містити щонайменше 10 символів.
5. Натисніть Зберегти пароль. Панель підтвердить: Пароль адміністратора збережено. Тепер можна створити запрошення власника.

Як задати пароль адміністратора в командному рядку

1. Відкрийте інтерактивний термінал на машині, де працює обліковий запис.
2. Для облікового запису, розгорнутого через deploy-parlons-cloud.sh, виконайте:

   sudo runuser -u maxima -- java -cp /opt/maxima/parlons-cloud.jar com.eurobuddha.maxima.cloud.AdminPairingPassword set /var/lib/maxima

   Для облікового запису, установленого однорядковим інсталятором, виконайте від свого імені:

   java -cp ~/.parlons/bin/parlons-cloud.jar com.eurobuddha.maxima.cloud.AdminPairingPassword set ~/.parlons

3. Двічі введіть пароль. Команда виведе Admin pairing password saved.

У настільних застосунках-вузлах задавайте його на сторінці Parlons Devices застосунку.

sudo parlons-pair

parlons-pair установлюється разом із Parlons Node і показує те саме запрошення, що й вкладка «Вузол» застосунку.

Змінні середовища для перевизначення: PARLONS_HOSTED_DIR, PARLONS_NODE_JAR (за замовчуванням /opt/maxima/parlons-node.jar), PARLONS_CLOUD_JAR (за замовчуванням /opt/maxima/parlons-cloud.jar).

Вона виводить повну адресу MAX#, одноразовий код, QR-код (якщо встановлено qrencode) і повне запрошення. Якщо невикористаного коду немає, вона про це повідомляє; запустіть її ще раз, щоб отримати новий. Використані коди ніколи не відновлюються зі старих журналів чи застарілих файлів.

Як створити запрошення власника на Parlons Node

1. Відкрийте інтерактивний сеанс SSH на сервері вузла.
2. Виконайте:

   sudo parlons-pair --admin

3. Введіть пароль адміністратора на запит Admin password (Enter for a guest invitation):. Неправильний пароль виводить Incorrect admin password («Неправильний пароль адміністратора») і ніколи не видає коду.
4. Відскануйте виведений QR-код Порталом (Сканувати QR-код під'єднання) або вставте повне запрошення (розділ 4).

Як створити гостьове запрошення на Parlons Node

Для цього потрібна служба розміщених облікових записів (--manage-from-node, розділ 21).

1. Відкрийте сеанс SSH на сервері вузла.
2. Виконайте, вказавши назву облікового запису гостя:

   sudo parlons-pair --guest alice

3. Команда створить розміщений обліковий запис alice (або використає наявний) і виведе його запрошення.
4. Надішліть запрошення цій людині приватно.

Запуск sudo parlons-pair без параметрів запитує пароль адміністратора. Введіть його для запрошення власника. Або натомість натисніть Enter, потім введіть ім'я гостя на Hosted account name: для гостьового запрошення.

Звідки ще беруться запрошення

Як створити запрошення власника командою parlons

1. У терміналі, де parlons під'єднано до облікового запису, виконайте:

   parlons newcode

2. Якщо хост має пароль адміністратора, команда запитає його в консолі через Admin password:. Введіть його. Пароль ніколи не передається в командному рядку.
3. Команда виведе рядки code : і invite :. Відскануйте або вставте запрошення в застосунку Parlons Cloud. Частина з кодом спрацьовує один раз.

Для запиту потрібна інтерактивна консоль. Якщо запустити команду без неї (наприклад, зі скрипта), вона завершиться помилкою Admin password required for an owner-account invitation («Для запрошення в обліковий запис власника потрібен пароль адміністратора»).

24Локальна вебпанель

Кожен хост облікового запису надає вебпанель і API для свого облікового запису лише на loopback-адресі: http://127.0.0.1:<port>/. Типовий порт — 9587. Це той самий інтерфейс, що й на під'єднаному телефоні, але в браузері на тій самій машині й без під'єднання через мережу.

Як її відкрити

Посилання один раз виконує вхід у браузері. Обліковий запис одразу записує наступне невикористане посилання в panel-ticket.txt. Якщо відкрити використане посилання, ви побачите This link has been used or has expired («Це посилання вже використано або термін його дії минув»).

Як відкрити панель на машині, де працює обліковий запис

1. У терміналі на цій машині виконайте:

   parlons panel

   Команда відкриє браузер з одноразовим посиланням.

2. Або самостійно відкрийте посилання, збережене в <data>/panel-ticket.txt (наприклад, ~/.parlons/panel-ticket.txt).

Під'єднаний пристрій на іншій машині теж може попросити в облікового запису посилання, дійсне 60 секунд. parlons panel робить саме це, коли папка облікового запису розташована не на тій самій машині.

Як відкрити панель на сервері зі свого комп'ютера

Панель відхиляє будь-який Host, крім 127.0.0.1:<port> або localhost:<port>. Тому використовуйте SSH-тунель з однаковим номером порту на обох кінцях.

1. Дізнайтеся порт. Окремий обліковий запис використовує 9587. Для орендаря прочитайте його panel.txt (розділ 21).
2. На своєму комп'ютері відкрийте тунель і залиште його працювати:

   ssh -L 9587:127.0.0.1:9587 root@your.box

   Для першого орендаря на сервері з вузлом натомість використовуйте 9597 на обох кінцях:

   ssh -L 9597:127.0.0.1:9597 root@your.box

3. У цьому сеансі SSH виведіть одноразове посилання. Для окремого облікового запису, розгорнутого через deploy-parlons-cloud.sh:

   sudo cat /var/lib/maxima/panel-ticket.txt

   Для орендаря:

   sudo cat /var/lib/parlons-tenants/alice/panel-ticket.txt

4. Скопіюйте посилання й відкрийте його в браузері на своєму комп'ютері.

Що вона показує

На панелі заголовка написано Parlons! з версією та Працює на Maxima, є індикатор стану й кнопки «Тема», «Пошук» і «Більше». Вкладки:

• Чати: розмови, лічильники непрочитаних, пошук, нова група, перегляд чату з фото, голосовими повідомленнями, файлами й дзвінками.
• Контакти: додавання, ваша адреса та QR-код, перейменування, визначення адреси, видалення, відомості.
• Пристрої:
  • Підключити власний пристрій: Це дає доступ до цього облікового запису. Щоб запросити когось в окремий обліковий запис, скористайтеся розділом «Розміщені облікові записи» нижче. Новий код підключення показує запрошення як QR-код і як текст, з кнопкою копіювання. Якщо хост має пароль адміністратора, над нею з'являється поле Пароль адміністратора, а кнопка лишається неактивною, доки пароль не задано.
  • Установити пароль адміністратора / Змінити пароль адміністратора (лише хости зі службою пароля): «Поточний пароль», «Новий пароль», «Підтвердьте новий пароль» (щонайменше 10 символів), Зберегти пароль.
  • Розміщені облікові записи (коли обліковий запис керує хостом): Увімкнути розміщення / Зупинити розміщення, Оновити, поле Назва облікового запису з Створити обліковий запис і рядок для кожного облікового запису з його станом, Показати запрошення і Призупинити / Продовжити. Запрошення показується як QR-код і повний текст із Копіювати запрошення орендаря.
  • Пристрої: кожен під'єднаний пристрій із повним ключем і Відкликати; пристрої в Очікування схвалення з Схвалити. Сама панель значиться як цей комп'ютер.
• Вузол: обліковий запис (ім'я, версія, час роботи, під'єднані ретранслятори, вузли мережі, під'єднані пристрої, поштова скринька/вихідні, постійна адреса повністю), Ваш ретранслятор, довідка Переадресація портів, коли працює ретранслятор, Ретранслятори (додати host:port або текст QR-коду ретранслятора, від'єднати, Використовувати вбудований список ретрансляторів), Якір каталогу (Закріпити найкращий ретранслятор, Очистити, Опублікувати повторно) і Журнал.
• Налаштування: «Мова», «Профіль» (Ваше ім'я), «Підключені застосунки» (minimaDocs), «Конфіденційність» (Звіти про прочитання), «Вигляд» і Ця панель (Відкрити в браузері, Вийти).

Завдання в панелі

Як під'єднати власний пристрій з панелі

1. Натисніть Пристрої.
2. Під Підключити власний пристрій введіть Пароль адміністратора, якщо поле показано.
3. Натисніть Новий код підключення. Панель покаже Новий код створено і запрошення як QR-код і як текст.
4. Відскануйте QR-код Порталом (Сканувати QR-код під'єднання) або натисніть кнопку копіювання й вставте запрошення на новому пристрої.

Як схвалити або відкликати пристрій у панелі

1. Натисніть Пристрої.
2. Під Очікування схвалення натисніть Схвалити поруч із пристроєм, який ви впізнаєте. Панель покаже Схвалено.
3. Щоб відключити пристрій, натисніть Відкликати поруч із ним і підтвердьте Відкликати цей пристрій? Він втратить доступ до облікового запису. Панель покаже Відкликано.

Як розмістити друга з панелі

1. Натисніть Пристрої і прокрутіть до Розміщені облікові записи.
2. Лише для вбудованого розміщення: натисніть Увімкнути розміщення і підтвердьте. Спершу задайте пароль адміністратора.
3. Введіть назву в Назва облікового запису (наприклад, alice) і натисніть Створити обліковий запис. Панель повідомить: Обліковий запис створено. Оновіть за кілька секунд, а коли він запрацює, виберіть «Показати запрошення».
4. Натискайте Оновити, доки стан облікового запису не стане працює.
5. Натисніть Показати запрошення. Запрошення показується як QR-код і повний текст.
6. Натисніть Копіювати запрошення орендаря і надішліть його цій людині приватно.

Щоб призупинити обліковий запис, натисніть Призупинити в його рядку й підтвердьте. Продовжити повертає його. Зупинити розміщення виводить з мережі всі вбудовані гостьові облікові записи; їхні ідентичності й чати зберігаються.

Як додати або видалити ретранслятор у панелі

1. Натисніть Вузол і прокрутіть до Ретранслятори.
2. Введіть у поле host:port (наприклад, relay.example.com:9501) або вставте текст QR-коду ретранслятора й натисніть Додати.
3. Щоб видалити один із власних ретрансляторів, натисніть Видалити в його рядку. Панель покаже Від'єднано.
4. Перемкніть Використовувати вбудований список ретрансляторів, щоб увімкнути або вимкнути вбудований список.

Як закріпити якір каталогу в панелі

1. Натисніть Вузол і прокрутіть до Якір каталогу.
2. Натисніть Закріпити найкращий ретранслятор. Рядок нижче покаже закріплено: … із ретранслятором.
3. Очистити знімає закріплення. Опублікувати повторно негайно знову розсилає ваш запис у каталозі.

Як вийти з панелі в браузері

1. Натисніть Налаштування і прокрутіть до Ця панель.
2. Натисніть Вийти. Щоб повернутися, відкрийте нове одноразове посилання.

Чого вона не робить

Сід-фраза, резервне копіювання, надсилання з гаманця, платежі, консоль вузла й розміщення NFT у панелі недоступні. Cookie на комп'ютері — слабший захист, ніж телефон у вашій руці; усе це лишається на під'єднаних телефонах і в командному рядку.

Безпека панелі

• Вона слухає лише на 127.0.0.1.
• Квиток перетворюється на сесійний cookie з HttpOnly і SameSite=Strict (неактивні сесії завершуються через сім днів).
• Запити зі стороннім Host (DNS rebinding) або стороннім Origin відхиляються; викликати можна лише методи облікового запису з дозволеного списку.
• Для облікового запису панель — це локальний пристрій. Відкликання доступу цей комп'ютер з будь-якого телефона блокує панель. Щоб знову ввімкнути відкликану панель, зупиніть обліковий запис, видаліть <data>/local-device.key і знову запустіть його.
• Будь-хто, хто може прочитати panel-ticket.txt, може відкрити панель. Файл має режим 0600; залиште так.

--no-panel вимикає її. --panel-port <n> переносить на інший порт.

25Довідник параметрів командного рядка

java -jar parlons-cloud-0.11.124.jar [options]. Усі параметри, які приймає програма:

Окремий обліковий запис

Хост із багатьма обліковими записами

Змінні середовища та системні властивості

Типові порти коротко

26Команда parlons

Однорядковий інсталятор установлює parlons. Це окремий під'єднаний пристрій (його ключ зберігається в ~/.parlons-client), тож він може керувати обліковим записом на цій машині чи будь-якій іншій.

Команди служби (обліковий запис цього комп'ютера): start, stop, restart, log [n], update, uninstall.

Команди облікового запису:

Запустіть parlons без аргументів, щоб побачити список.

Як керувати обліковим записом з іншої машини

Команда parlons на будь-якій машині може керувати будь-яким обліковим записом після під'єднання.

1. Установіть parlons на цій машині однорядковим інсталятором (розділ 19) або скористайтеся вже встановленим.
2. Спрямуйте його на обліковий запис, використовуючи повну адресу MAX#:

   parlons connect <account MAX#>

   Команда виведе account saved. next: parlons pair <code>.

3. Під'єднайте його новим кодом з під'єднаного пристрою (розділ 10):

   parlons pair ABCD-EFGH-JKLM

   Команда виведе paired ✓ — this device can now drive your account.

4. Або виконайте parlons pair без коду. Команда виведе pairing requested. Approve it from an already-paired device: і точний рядок parlons approve <key>, який треба виконати на під'єднаному пристрої.
5. Перевірте, що все працює:

   parlons status

Як читати й надсилати повідомлення з термінала

1. Виведіть список чатів (ім'я, останнє повідомлення, кількість непрочитаних):

   parlons chats

2. Знайдіть повний ключ контакту:

   parlons contacts

3. Прочитайте одну розмову:

   parlons read <peer key>

4. Надішліть повідомлення:

   parlons send <peer key> hello

Як заплатити контакту з термінала

1. Знайдіть ключ контакту за допомогою parlons contacts.
2. Заплатіть йому з гаманця облікового запису (сума в MINIMA, коментар необов'язковий):

   parlons pay <key> 1.5 lunch

3. Команда виведе payment building on your node ✓ (watch the chat bubble). Команда pay надсилає лише Minima. MxUSD надсилайте з Порталу.

27Файли в каталозі даних

Каталог окремого облікового запису (~/.parlons, /var/lib/maxima) і кожна папка орендаря мають однакову структуру. Файли, позначені як секретні, мусять зберігати режим 0600 і ніколи не потрапляти в журнали, не вставлятися й не передаватися.

Каталог орендарів також містить .host-status.json — сигнал активності хоста (які орендарі працюють або дають збій), що оновлюється кожні п'ять секунд.

28Порти, брандмауери, TLS і зворотні проксі

• Окремому обліковому запису не потрібен вхідний порт, домен чи сертифікат. Він з'єднується з мережею через ретранслятори, а телефони з'єднуються з ним через власний зашифрований транспорт Parlons, а не через вебпорт. Однорядковий інсталятор (без --relay) і хост орендарів обидва працюють з --no-relay --no-direct.
• Щоб інші могли дістатися вашого ретранслятора (увімкнено за замовчуванням; --no-relay вимикає його), TCP 9501 (або ваш --port) має бути доступним з інтернету. Скрипти відкривають його в ufw або firewalld, якщо ті активні. Брандмауер у консолі хмарного провайдера (Hetzner Cloud Firewall, Vultr Firewall Group, група безпеки AWS) теж має його дозволяти; це звична причина ситуації «телефон підключається, але під'єднання нестабільне». Перевірте з іншої машини, а не із самого сервера:

  nc -z -G 5 vps.example.com 9501 && echo reachable

• Порт ретранслятора — не HTTP. Він працює безпосередньо за мережевим протоколом Maxima. Не ставте його за зворотний HTTP-проксі чи термінатор TLS; клієнти під'єднуються до нього звичайним TCP, а повідомлення всередині вже запечатано наскрізним шифруванням.
• Вебпанель ніколи не можна відкривати назовні. Вона прив'язана до 127.0.0.1 і відхиляє запити, у яких Host не є її власним loopback-джерелом, тож зворотний проксі під доменним іменем отримає wrong host. Відкривайте її через SSH-тунель (розділ 24).
• Брандмауери з правилами для вихідного трафіку. Хосту потрібен вихідний TCP до ретрансляторів, до яких він під'єднується. Серверу із забороною вихідного трафіку за замовчуванням потрібні правила для них.

Як відкрити й перевірити порт ретранслятора

Потрібно лише тоді, коли хост запускає ретранслятор.

1. На сервері дозвольте порт у його власному брандмауері. Скрипти роблять це, якщо активний ufw або firewalld. Вручну для ufw:

   ufw allow 9501/tcp

   Для firewalld:

   firewall-cmd --permanent --add-port=9501/tcp && firewall-cmd --reload

2. У консолі вашого хмарного провайдера також дозвольте вхідний TCP 9501 у його брандмауері.
3. З іншої машини (не із самого сервера) перевірте:

   nc -z -G 5 vps.example.com 9501 && echo reachable

4. reachable означає, що порт відкрито. Відсутність виводу означає, що щось його досі блокує.

(TLS-фронти в мережі обслуговують інші речі, що працюють на Parlons Node, як-от шлюз гаманця й ретранслятор DEX; вони не є частиною хоста Parlons Cloud.)

29Оновлення та відкат

Кожне встановлення тримає jar із версією поруч зі сталим символьним посиланням, тож відкат — це одна зміна посилання.

Як перевірити завантажений jar

1. Завантажте parlons-cloud-0.11.124.jar з випуску cloud-v0.11.124.
2. Обчисліть його SHA-256. На Mac:

   shasum -a 256 parlons-cloud-0.11.124.jar

   На Linux:

   sha256sum parlons-cloud-0.11.124.jar

3. Порівняйте з опублікованим значенням. Воно має збігатися точно:

   0ae833429b641393f93b427695784b534e8a2a06a7194eba74e57aed4f19b231

Інсталятор і скрипти розгортання перевіряють SHA-256 за вас і відхиляють невідповідність.

Як оновити хост орендарів

1. Створіть резервні копії /etc/parlons-tenants.env і каталогів даних.
2. Якщо ви редагували модуль, збережіть копію:

   cp /etc/systemd/system/parlons-tenants.service /etc/systemd/system/parlons-tenants.service.before-0.11.124

3. Зі свого комп'ютера повторно запустіть скрипт розгортання з новим jar:

   ops/deploy-parlons-tenants.sh root@your.box --jar dist/parlons-cloud-0.11.124.jar

   Знову додайте --manage-from-node, якщо використовували його. Скрипт зберігає /etc/parlons-tenants.env. Він перезаписує модуль із --panel-port 9597, тож повторно внесіть будь-які інші власні зміни.

4. Перевірте службу:

   systemctl is-active parlons-tenants
   journalctl -u parlons-tenants | grep 'multi-account host' | tail -1

   У рядку має бути Parlons Cloud 0.11.124.

5. Перевірте, що кожен орендар звітує (розділ 30).

Як виконати відкат

1. На сервері (або в ~/.parlons/bin для облікового запису з інсталятора) перегляньте, які jar-файли з версіями ще лишилися:

   ls /opt/maxima/parlons-cloud-*.jar

2. Спрямуйте символьне посилання на старіший і перезапустіть, використавши рядок для вашого виду хоста з таблиці вище. Наприклад, на хості орендарів:

   ln -sf parlons-cloud-0.11.122.jar /opt/maxima/parlons-cloud.jar && systemctl restart parlons-tenants

3. Перевірте версію в журналі, як у кроці 4 вище.

Застосунок «Портал» оновлюється незалежно: установіть новіший APK поверх старого (розділ 3).

30Журнали

Як стежити за журналом

1. Виберіть команду для вашого хоста з таблиці вище. Наприклад, на хості орендарів:

   journalctl -u parlons-tenants -f

2. Щоб бачити лише одного орендаря, відфільтруйте за його тегом:

   journalctl -u parlons-tenants | grep 'parlons-cloud/alice'

3. Натисніть Ctrl+C, щоб припинити стеження.

Корисні рядки:

• Parlons Cloud 0.11.124 multi-account host: N tenant(s) under <dir>: хост запустився.
• tenant <name>: <Mx identity> (seed encrypted at rest): орендар запустився.
• hot-add: <name>: підхоплено нову папку.
• tenant <name>: stopped (.stop) / parked (.stop present): орендаря призупинено.
• tenant <name>: failed to start (…), retry in 60 s.
• web panel could NOT start on 127.0.0.1:<port>: ….

Програма ніколи не записує сід-фразу в журнал: під systemd новостворена сід-фраза не виводиться; програма пропонує один раз прочитати seed.txt через SSH. Коди під'єднання записуються лише в pair-code.txt і ніколи не потрапляють у журнал. Проте, коли шукаєте в журналах чи файлах модулів, відфільтровуйте все, що згадує сід-фрази (… | grep -v seed), і перевіряйте журнал, перш ніж кудись його вставляти.

31Примітки щодо безпеки для операторів

• Файли сід-фраз — це гаманці. seed.txt і seed.enc — це ідентичності і гаманці Minima, з яких можна витрачати кошти. Ніколи не виводьте їх у журнал, звернення до підтримки, чат чи знімок екрана. Ніколи не копіюйте їх на машину, якій вони не потрібні. Нову сід-фразу читайте один раз через SSH і зберігайте офлайн.
• Одна сід-фраза — один хост, завжди. Дві запущені копії однієї ідентичності рано чи пізно повторно використають одноразовий ключ підпису. Щоб перенести обліковий запис, відновіть його пакет на новому хості й назавжди зупиніть старий.
• Оператор може читати те, що зберігає хост. Постійно ввімкнений обліковий запис мусить тримати ключ у пам'яті, щоб діяти від імені власника. Шифрування на диску (seed.enc) захищає образи дисків і резервні копії, але не від людини, яка запускає процес. Скажіть про це своїм гостям; сторінки посібника теж про це кажуть.
• Вбудоване розміщення чатів зберігає сід-фрази гостей як приватні файли (режим 0600, відкритим текстом) у папці власника hosted-chat/. Для захисту на випадок крадіжки диска використовуйте шифрування диска комп'ютера. Пароль адміністратора не шифрує гостьові облікові записи.
• Парольна фраза розблокування в /etc/parlons-tenants.env доступна лише root. Зберігайте її резервну копію окремо від даних: втрата робить кожен seed.enc нечитабельним; витік разом із резервною копією даних зводить шифрування нанівець.
• Запрошення — це ключі до облікового запису, доки їх не використано. pair-code.txt і invite.txt дають змогу першій людині, яка ними скористається, під'єднати пристрій. Надсилайте запрошення приватно, під'єднуйтеся без зволікань, а якщо запрошення могло витекти, створіть новий код (він замінює старий) або відкличте доступ пристрою, який ним скористався.
• Пароль адміністратора захищає лише запрошення власника. Будь-хто з повним доступом SSH або доступом до термінала власника на сервері однаково керує сервером.
• Квиток панелі надає браузеру сесію як локального пристрою цього облікового запису. Тримайте panel-ticket.txt у таємниці й не відкривайте порт панелі назовні.
• Захищені модулі. Скрипти розгортання запускають хост від імені непривілейованого користувача maxima, з NoNewPrivileges, без capabilities, зі списком дозволених системних викликів, ProtectSystem=strict, приватним /tmp, UMask=0077, заблокованим діапазоном адрес хмарних метаданих і обмеженням пам'яті. Зберігайте це, якщо пишете власний модуль.
• Ніколи не скорочуйте ідентифікатори в усьому, що ви створюєте чи пересилаєте навколо цих хостів: адреси, ключі, коди й ідентифікатори транзакцій завжди потрібно показувати й копіювати повністю.

32Усунення несправностей для операторів

Покрокові рішення

Порт ретранслятора 9501 уже зайнятий

1. З'ясуйте, що його займає:

   sudo ss -ltnp | grep ':9501'

2. Якщо це Parlons Node або інший ретранслятор, залиште його. Натомість запускайте цей обліковий запис без власного ретранслятора: для однорядкового інсталятора виконайте parlons uninstall і встановіть знову з --no-relay. Для написаного вручну модуля замініть --relay-port 9501 на --no-relay.
3. Або дайте цьому обліковому запису вільний порт через --relay-port <n> (з deploy-parlons-cloud.sh — --port <n>) і відкрийте натомість цей порт (розділ 28).
4. Перезапустіть службу й перевірте журнал (розділ 30).

Вебпанель не змогла запуститися

1. У журналі написано web panel could NOT start on 127.0.0.1:<port>. З'ясуйте, що займає порт:

   sudo ss -ltnp | grep ':9587'

2. Виберіть вільний loopback-порт. На сервері з Parlons Node використовуйте 9597 або вище.
3. На хості deploy-parlons-cloud.sh відредагуйте ExecStart модуля й додайте --panel-port 9597 (або --no-panel, щоб працювати без панелі). На хості орендарів модуль уже має --panel-port 9597; якщо 9597 зайнятий, виберіть там інший перший порт.

   systemctl edit --full parlons-cloud
   systemctl daemon-reload && systemctl restart parlons-cloud

4. Тим часом обліковий запис працює й без панелі.

Зашифровані сід-фрази не відкриваються (seed.enc needs --unlock або PARLONS_UNLOCK is not set)

1. Перевірте, що файл розблокування існує й не порожній, не виводячи його вмісту:

   sudo test -s /etc/parlons-tenants.env && echo present

2. Якщо його немає, відновіть його з офлайн-копії в /etc/parlons-tenants.env, власник root, режим 600:

   sudo install -o root -g root -m 600 ./parlons-tenants.env.backup /etc/parlons-tenants.env

3. Перевірте, що модуль має EnvironmentFile=/etc/parlons-tenants.env і --unlock env:

   systemctl cat parlons-tenants | grep -E 'EnvironmentFile|--unlock'

4. Перезапустіть:

   systemctl restart parlons-tenants

Без початкової парольної фрази зашифровану сід-фразу неможливо відкрити. Натомість відновіть орендаря з його резервної копії (розділ 22).

Немає запрошення через 60 секунд після tenant-new

1. Перевірте, чи працює хост:

   systemctl status parlons-tenants

2. Якщо його зупинено, запустіть його командою systemctl start parlons-tenants.
3. Перевірте журнал для орендаря (journalctl -u parlons-tenants | grep 'parlons-cloud/alice').
4. Знову виконайте ops/tenant-new.sh root@your.box alice. Для наявної папки ідентичність не замінюється.

Служба розміщених облікових записів офлайн

1. На сервері запустіть хост орендарів:

   systemctl start parlons-tenants

2. Зачекайте кілька секунд, доки він запише сигнал активності (.host-status.json у каталозі орендарів).
3. У Порталі відкрийте Вузол → Керувати розміщеними обліковими записами і торкніться Оновити.

Орендар отримав нову ідентичність після відновлення

1. Призупиніть неочікуваного орендаря:

   touch /var/lib/parlons-tenants/alice/.stop

2. Перемістіть його папку з каталогу орендарів і тримайте її окремо, доки не переконаєтеся, що до неї ніхто не під'єднався.
3. Знову відновіть пакет через проміжну папку, а потім перемістіть її (розділ 22, «Відновлення орендаря з резервної копії»).

Для будь-яких інших проблем створіть issue на GitHub проєкту, вказавши версію, що ви очікували, що сталося, і відповідні рядки журналу (попередньо перевірені на наявність секретів).

33Глосарій