> For the complete documentation index, see [llms.txt](https://docs.goodcrypto.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goodcrypto.app/goodcryptox-uk/goodcryptox-3.0/readme/set-up-on-a-server.md).

# Встановлення goodcryptoX на сервер

Сервер запускає goodcryptoX цілодобово: налаштуй із комп'ютера чи телефона або перенеси інсталяцію з Mac одним файлом.

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

Підійде будь-який провайдер. Поки рекомендуємо Hostinger: зі знайдених варіантів його найлегше налаштувати, і ціна помірна. Нижче — екрани Hostinger за кроками; ті самі дії підійдуть для AWS, DigitalOcean, Google Cloud, Azure та будь-якого іншого хмарного провайдера.

[**Розгорнути на Hostinger**](https://www.hostinger.com/docker-hosting?compose_url=https://raw.githubusercontent.com/GoodCryptoApp/gcx/main/compose.yaml\&REFERRALCODE=HBDNPMHGJLZB)

Швидкий шлях: відкрий посилання, створи акаунт Hostinger, обери тариф і дотримуйся екранів. Наприкінці goodcryptoX налаштується на новому сервері сам, без вставлення команд. Заверши в тому самому браузері, де відкрито посилання. Якщо щось піде не так, інструкція нижче робить те саме вручну.

*За цим посиланням ти отримуєш знижку 20% на першу покупку, а goodcryptoX — частку від неї. Можна зайти на Hostinger без посилання чи обрати іншого провайдера.*

## Оренда сервера <a href="#rent-a-server" id="rent-a-server"></a>

Що потрібно: створити акаунт Hostinger, орендувати сервер, встановити goodcryptoX і підключити браузер на комп'ютері та телефон. Ось як це зробити за кроками.

Екрани Hostinger станом на жовтень 2026 року:

**1. Реєстрація.** Картка знадобиться лише під час оплати, за кілька екранів.

**2. VPS › Налаштувати VPS**

<figure><img src="https://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-38aa5d1c8d69ce3fea27b1d23be9814e0607beec%2F01-vps-page.webp?alt=media" alt="Сторінка VPS, стрілка на «Налаштувати VPS»" width="563"><figcaption></figcaption></figure>

**3. Розташування.** Обери найближче місто, потім **Далі**.

<figure><img src="https://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-fa113e868c66fdf3a3db74d607c29c4919a43d68%2F02-location.webp?alt=media" alt="Вибір розташування сервера, стрілка на «Далі»" width="563"><figcaption></figcaption></figure>

**4. Що встановити.** Відкрий **Застосунки** або знайди «Docker».

<figure><img src="https://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-b80255526231264fbbb66d2a504934dce0a1b5f1%2F03-choose-what-to-install.webp?alt=media" alt="Вибір встановлення, стрілка на «Застосунки»" width="563"><figcaption></figcaption></figure>

Обери звичайну плитку **Docker**, без Traefik, Docker Registry чи Dockge.

<figure><img src="https://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-9b6dfd53ca522c9aa49a6d4ab8d67a4762f89aea%2F04-docker-search.webp?alt=media" alt="Пошук Docker, стрілка на плитку Docker" width="563"><figcaption></figcaption></figure>

На картці написано «Встановлено в Ubuntu 24.04»: натисни **Обрати**.

<figure><img src="https://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-23f7a871be764d6320958c6b2f8386bcd6e43792%2F05-docker-select.webp?alt=media" alt="Картка Docker, стрілка на «Обрати»" width="563"><figcaption></figcaption></figure>

**5. Пароль root.** Натисни **Згенерувати** та збережи пароль у менеджері паролів: він відкриває доступ до сервера. Пропусти SSH-ключ.

<figure><img src="https://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-5c6ba4e6c3b3d2cb26c861180c5700774517968c%2F06-root-password.webp?alt=media" alt="Захист доступу VPS, стрілка на «Згенерувати»" width="563"><figcaption></figcaption></figure>

**6. Додаткові функції.** Залиш обидва прапорці порожніми, потім **Далі**.

<figure><img src="https://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-3f986addd8b40794dff95e85a929a6ce108f640c%2F07-additional-features.webp?alt=media" alt="Додаткові функції, стрілка на «Далі»" width="563"><figcaption></figcaption></figure>

**7. Тариф.** KVM 1 достатньо для goodcryptoX: натисни **Обрати**.

<figure><img src="https://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-340977a7ad685328509fa705c71eecf12550c765%2F08-plan.webp?alt=media" alt="Тарифи, стрілка на «Обрати» у KVM 1" width="563"><figcaption></figcaption></figure>

**8. Період оплати.** Ціну обираєш ти. На 18 жовтня 2026 року KVM 1 коштував $6,49 на місяць за оплати на 24 місяці, $6,99 на 12 місяців і $9,99 на 1 місяць, плюс податок. Ціни змінюються — дивись умови:

* Низька ціна діє лише в перший період, з оплатою наперед.
* Потім 12 і 24 місяці поновлюються за звичайною ціною ($11,99 на місяць на той день), 1 місяць — за повною ($19,49 на місяць).
* Період можна змінити пізніше за звичайною ціною, без стартової знижки.
* Хочеш спробувати? Візьми 1 місяць. Залишаєшся? Одразу бери 12 або 24 місяці. Якщо сервер на 1 місяць підійшов, орендуй новий на 12 або 24 місяці, [перенеси туди goodcryptoX](https://docs.goodcrypto.app/goodcryptox-uk/goodcryptox-3.0/readme/moving-goodcryptox.md#from-one-server-to-another) та скасуй старий до поновлення.
* Для нової покупки діє 30-денна гарантія повернення грошей.

<figure><img src="https://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-9871a3e853d43a044d56e10078b47427db0c5b4c%2F09-billing-period.webp?alt=media" alt="Період оплати, стрілка на 24 місяці" width="563"><figcaption></figcaption></figure>

<figure><img src="https://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-6af7e90b53a1c1f216f16cb870aea379699176af%2F09b-billing-1-month.webp?alt=media" alt="Оплата за 1 місяць із поновленням за повною ціною" width="563"><figcaption></figcaption></figure>

**9. Оплата.** Hostinger налаштує сервер приблизно за 5 хвилин і надішле лист, коли він буде готовий.

**10. Готово.** Натисни **Керування VPS**. Пропусти безкоштовний домен: goodcryptoX він не потрібен.

<figure><img src="https://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-74cd99ecc60de9b692d2ece5befcda9e17bf290c%2F11-ready.webp?alt=media" alt="Готово, стрілка на «Керування VPS»" width="563"><figcaption></figcaption></figure>

**11. Огляд.** З'явиться коротке опитування: натисни **Пропустити**. Потім **Docker manager** на картці Docker.

<figure><img src="https://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-106ebc9e276deee724e17a0edfc7fdf098891494%2F13-overview-clean.webp?alt=media" alt="Огляд VPS, стрілка на Docker manager" width="563"><figcaption></figcaption></figure>

<details>

<summary>В іншого провайдера</summary>

Орендуй невеликий сервер з Ubuntu та Docker, від 2 GB пам'яті, у найближчому регіоні. Багато провайдерів пропонують готове встановлення Ubuntu з Docker.

</details>

## Запуск goodcryptoX <a href="#start-goodcryptox" id="start-goodcryptox"></a>

**12. Compose › Compose from URL — за посиланням**

<figure><img src="https://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-cbbd312f6d8085c1c4e4060ba6c5018458778640%2F15-docker-manager.webp?alt=media" alt="Docker Manager, стрілка на Compose" width="563"><figcaption></figcaption></figure>

<figure><img src="https://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-f78d8bfd93a506fa7db821902183cf1cb3cd7ac9%2F16-compose-menu.webp?alt=media" alt="Меню Compose, стрілка на Compose from URL" width="563"><figcaption></figcaption></figure>

**13. Посилання й ім'я.** Встав посилання (Compose-файл goodcryptoX на GitHub з останнім образом), назви застосунок `gcx` і натисни **Deploy**.

```
https://raw.githubusercontent.com/GoodCryptoApp/gcx/main/compose.yaml
```

<figure><img src="https://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-c5639bb955ce701dbacfd5d76afa19150d2e1af6%2F17b-compose-from-url-filled.webp?alt=media" alt="Заповнений Compose from URL, стрілка на Deploy" width="563"><figcaption></figcaption></figure>

**14. Працює.** За хвилину-дві у `gcx` з'явиться **Працює**. Hostinger може запропонувати ввімкнути HTTPS через Traefik для твоїх застосунків Docker: goodcryptoX це не потрібно, оскільки панель не відкриває жодного порту в інтернет; закрий пропозицію.

<figure><img src="https://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-9113469ff32d1c7e626325323e1b3753c7de9f48%2F19-running.webp?alt=media" alt="Застосунки Docker: gcx, стан роботи, стрілки на Terminal і меню рядка" width="563"><figcaption></figcaption></figure>

<details>

<summary>Якщо не вдається</summary>

Ще два способи.

Текст файлу. У Hostinger обери **Compose › Compose manually** і встав текст у вкладку **.yaml editor**, ім'я — `gcx`. В іншій Docker-панелі створи проєкт вручну та встав текст.

```yaml
services:
  gcx:
    image: ghcr.io/goodcryptoapp/gcx:latest
    container_name: gcx
    network_mode: host
    init: true
    restart: unless-stopped
    stop_grace_period: 60s
    volumes: [gcx-data:/data, gcx-secret:/secret]
  updater:
    image: ghcr.io/goodcryptoapp/gcx:latest
    container_name: gcx-updater
    entrypoint: [gcx, updater]
    user: "0:0"
    network_mode: none
    init: true
    restart: unless-stopped
    volumes: [/var/run/docker.sock:/var/run/docker.sock, /root/.docker:/docker:ro, gcx-data:/data]
volumes:
  gcx-data: {name: gcx-data}
  gcx-secret: {name: gcx-secret}
```

Термінал. Відкрий вебконсоль провайдера або підключись через `ssh root@<your server's address>` з комп'ютера й виконай рядок на сервері (з `sudo` перед кожним `docker`, де потрібно); журнал з'явиться в тому самому вікні:

```
curl -fsSLo compose.yaml https://github.com/GoodCryptoApp/gcx/releases/latest/download/compose.yaml && docker compose up -d && docker logs -f gcx
```

</details>

## Вхід <a href="#sign-in" id="sign-in"></a>

**15. Журнал.** У рядку `gcx` відкрий меню **⋮** (стрілка праворуч на зображенні вище), потім **View logs** і вкладку **Журнали**.

**16. Посилання.** Під час першого запуску в перших рядках журналу з'явиться посилання: виділи та скопіюй.

<figure><img src="https://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-f463bf2ab9a2f140bd93fe39d4bc38e16b337d18%2F22-logs-link.webp?alt=media" alt="Журнал першого запуску, стрілка на посилання" width="563"><figcaption></figcaption></figure>

**17. Відкрий.** Встав посилання в браузер на комп'ютері та створи ключ доступу з Touch ID, Face ID чи способом розблокування комп'ютера. goodcryptoX відкриється на my.goodcrypto.app — тепер це адреса входу на цьому пристрої. Ключ доступу, збережений в iCloud чи Google, працює на інших пристроях із тим самим акаунтом; решта додаються через Налаштування › Пристрої › **Додати пристрій**. Потім додай телефон із панелі: Налаштування › Пристрої › **Додати пристрій** покаже QR-код для сканування ([Підключення телефона чи іншого комп'ютера](#add-a-phone-or-another-computer)).

Посилання одноразове: припиняє працювати, щойно пристрій його використає. Воно також спливає за 10 хвилин; для нового натисни **Restart** у меню рядка. Якщо my.goodcrypto.app показує «Не в мережі з», 10 хвилин дії посилання минули, а жоден пристрій ще не сполучено: отримай нове посилання й відкрий його протягом 10 хвилин. Посилання — це ключ: нікому не передавай і нікуди більше не вставляй.

На тому самому пристрої відкривай панель із закладки чи значка на головному екрані та входь через Face ID або Touch ID, без посилання й коду. Це ключ доступу, створений під час підключення. Блок **Налаштуй goodcryptoX** на Дашборді проведе далі: акаунти біржі, потім Telegram-бот.

<details>

<summary>Від чого залежить my.goodcrypto.app</summary>

Сервер тримає одне вихідне з'єднання з ретранслятором goodcryptoX, а my.goodcrypto.app звертається до сервера через нього: через інтернет, без прямого підключення. Усі дані зашифровані між браузером і сервером; ретранслятор лише пересилає їх і не може нічого прочитати чи зберегти. Тому якщо ретранслятор зникне, ця адреса припинить працювати. Сам goodcryptoX продовжить працювати й торгувати на сервері. Тоді використовуй тунель у розгортаному блоці нижче — йому нічого від нас не потрібно.

</details>

<details>

<summary>Якщо не вдається</summary>

Щоб натомість відсканувати код телефоном або отримати нове посилання іншим способом, відкрий термінал контейнера (у Hostinger — **Terminal** у рядку `gcx`) та виконай `gcx pair` (в інших середовищах — `docker exec gcx gcx pair`); термінал намалює код, який можна сканувати.

Або підключись до goodcryptoX через тунель. На комп'ютері відкрий Термінал (PowerShell у Windows) та виконай рядок з адресою сервера (у Hostinger — після **IPv4** на сторінці огляду):

```
ssh -N -L 8128:127.0.0.1:8128 root@<your server's address>
```

Під час першого підключення відповідай `yes`, потім введи пароль сервера (у Hostinger — root-пароль із кроку 5). Більше нічого не з'явиться — так і має бути: залиш вікно відкритим на час роботи з goodcryptoX. Потім виконай `gcx open --print` у терміналі контейнера (в інших середовищах — `docker exec gcx gcx open --print`) і протягом 60 секунд відкрий виведене посилання в браузері. goodcryptoX відкриється на `http://localhost:8128/gcx`. Якщо в журналі порт відрізняється від 8128, підстав його в обидві частини рядка та в адресу. Через тунель також працює Увійти через Binance.

</details>

## Підключення телефона чи іншого комп'ютера <a href="#add-a-phone-or-another-computer" id="add-a-phone-or-another-computer"></a>

Після підключення телефона комп'ютер не потрібен: усім можна керувати з телефона.

Новий телефон чи комп'ютер додається з уже підключеного пристрою: Налаштування › Пристрої › **Додати пристрій** ([Доступ із телефона](https://docs.goodcrypto.app/goodcryptox-uk/goodcryptox-3.0/readme/phone-access.md)).

Лише втрата всіх пристроїв вимагає повернення до сервера: у Hostinger відкрий **Terminal** у рядку `gcx` та виконай `gcx pair` для нового посилання (в інших середовищах — `docker exec gcx gcx pair`). Це і є відновлення: скидання поштою немає, адже акаунта в нас немає.

## У власній мережі <a href="#on-your-own-network" id="on-your-own-network"></a>

Якщо сервер стоїть удома, goodcryptoX можна відкрити з ноутбука чи телефона без ретранслятора: увімкни **Підключатися напряму вдома** у Налаштування › Пристрої або виконай `gcx network on` у Terminal контейнера (в іншому терміналі — `docker exec gcx gcx network on`). Ця можливість вимкнена, доки ти її не ввімкнеш. Файл compose вище змінювати не потрібно: він використовує мережу самого пристрою, тому ввімкнення перемикача дозволяє порту відповідати на адресах пристрою, решта не змінюється; брандмауер перед сервером має пропускати цей порт. Щоб узагалі не звертатися до нашого ретранслятора, задай `GCX_PHONE_RELAY: ""` для сервісу `gcx` до першого запуску. Кроки й дії в разі втрати пристрою — у розділі [Домашня мережа](#your-home-network).

Орендований сервер — не домашня мережа: його адреси доступні з інтернету. Залиш перемикач вимкненим і користуйся ретранслятором або тунелем.

## Оновлення та резервні копії <a href="#updates-and-backups" id="updates-and-backups"></a>

goodcryptoX оновлюється на сервері сам: нова версія встановлюється у спокійний момент, як на Mac, після завершення поточних дій. Налаштування › Загальні › Встановлення показує версію; кнопка **Оновити** встановлює нову одразу, якщо не хочеш чекати.

<details>

<summary>Якщо не вдається</summary>

У Hostinger обери **Оновити** у меню рядка `gcx`; в інших середовищах виконай `docker compose pull && docker compose up -d` у папці з `compose.yaml`.

</details>

goodcryptoX зберігає дані у двох томах Docker: `gcx-data` та `gcx-secret`. Копіюй їх разом: сам `gcx-data` не зможе відкрити ключі.

## Безкоштовні та недорогі сервери <a href="#free-and-low-cost-servers" id="free-and-low-cost-servers"></a>

goodcryptoX працює на недорогих і навіть безкоштовних серверах. В Arm-сервера Oracle Cloud Always Free достатньо пам'яті, але вільні ресурси буває складно отримати, а маловикористовуваний сервер Oracle може вилучити. Варіант підійде, якщо акаунт Oracle вже є; новачку найлегше налаштувати Hostinger — зі знайдених нами варіантів.

### Безкоштовний Oracle Cloud Always Free <a href="#oracle-cloud-always-free" id="oracle-cloud-always-free"></a>

Обери **Ampere A1**, **Ubuntu**, **1 OCPU та 2 GB пам'яті**. Образ Docker goodcryptoX працює на Arm та Intel/AMD з однаковими командами. Не обирай безкоштовний AMD micro: 1 GB пам'яті замало для Ubuntu та goodcryptoX разом.

[Поточний безкоштовний ліміт](https://docs.oracle.com/en-us/iaas/Content/FreeTier/freetier_topic-Always_Free_Resources.htm) Oracle, перевірений 22 жовтня 2026 року, покриває цей сервер; перед створенням перевір позначку безкоштовності та розрахунок вартості. Обмежений у часі пробний кредит — інша пропозиція.

Перед вибором Oracle:

* Для реєстрації потрібна кредитна чи відповідна дебетова картка; можливе тимчасове блокування коштів. Якщо перевірка не проходить, [звернись до Oracle](https://www.oracle.com/cloud/free/faq/).
* Уважно обирай [домашній регіон](https://docs.oracle.com/en-us/iaas/Content/Identity/Tasks/managingregions.htm): безкоштовні сервери мають бути в ньому, змінити його не можна.
* Якщо безкоштовних серверів немає, спробуй інший домен доступності в тому самому регіоні або повтори пізніше.
* Oracle може вилучити маловикористовуваний сервер, навіть запущений; [копіюй обидва томи goodcryptoX](#updates-and-backups) та очікуй перерв.
* Перехід на платний план зберігає безкоштовний ліміт, але дозволяє плату за перевищення; не переходь лише заради захисту від вилучення.
* Oracle може [призупинити чи закрити акаунт після 30 днів бездіяльності](https://www.oracle.com/cloud/free/faq/); регулярно перевіряй повідомлення та сервер.

### Налаштування Oracle <a href="#oracle-setup" id="oracle-setup"></a>

Кроки ґрунтуються на документації Oracle; покроковий розбір і знімки екрана очікують перевіреного акаунта Oracle.

**1. Вхід.** Відкрий [Oracle Cloud](https://cloud.oracle.com/) зі своїм хмарним акаунтом. Новий акаунт створюється зі [сторінки Oracle Free Tier](https://www.oracle.com/cloud/free/).

**2. Створення сервера.** Дотримуйся [інструкції Oracle для Linux-сервера](https://docs.oracle.com/en-us/iaas/Content/Compute/tutorials/first-linux-instance/overview.htm): **Compute › Instances › Create instance**. Обери Ubuntu, потім конфігурацію **VM.Standard.A1.Flex** з **1 OCPU та 2 GB**. Залиш завантажувальний диск у безкоштовному ліміті та збережи SSH-ключ, коли Oracle запропонує. Приватний ключ відкриває сервер: тримай його в таємниці.

**3. Перевірка мережі.** Серверу потрібні публічна адреса й доступ SSH. Дозволь SSH (TCP 22) зі своєї публічної IP-адреси. Додаткові вхідні порти goodcryptoX не потрібні: використовуй приватний тунель нижче або посилання з розділу [Вхід](#sign-in). Не відкривай порт 8128 в інтернет.

**4. Підключення.** На комп'ютері відкрий Термінал або PowerShell у Windows. Заміни два заповнювачі на файл збереженого ключа та публічну адресу сервера. У macOS або Linux спочатку виконай `chmod 400 <your-private-key-file>`; у Windows використовуй [інструкцію Oracle щодо прав ключа](https://docs.oracle.com/en-us/iaas/Content/Compute/tutorials/first-linux-instance/overview.htm):

```
ssh -i <your-private-key-file> ubuntu@<your-server-address>
```

**5. Встановлення Docker, якщо потрібен.** У терміналі сервера дотримуйся [інструкції Docker для Ubuntu](https://docs.docker.com/engine/install/ubuntu/) з репозиторієм apt, встанови також плагін Compose. Інструкція однакова для Arm та Intel/AMD. Перевір, що `sudo docker compose version` виводить версію.

**6. Запуск goodcryptoX.** Виконай на сервері:

```
curl -fsSLo compose.yaml https://github.com/GoodCryptoApp/gcx/releases/latest/download/compose.yaml && sudo docker compose up -d && sudo docker logs -f gcx
```

**7. Відкриття панелі.** Використовуй посилання з журналу, як у розділі [Вхід](#sign-in).

<details>

<summary>Натомість — SSH-тунель</summary>

Залиш це працювати в другому терміналі на комп'ютері:

```
ssh -i <your-private-key-file> -N -L 8128:127.0.0.1:8128 ubuntu@<your-server-address>
```

Потім виконай `sudo docker exec gcx gcx open --print` на сервері та протягом 60 секунд відкрий виведене посилання. Якщо журнал указує інший порт, підстав його в обидві частини тунелю. Нікому не передавай посилання для входу.

</details>

### Інші невеликі сервери <a href="#other-small-servers" id="other-small-servers"></a>

Опубліковані ціни перевірено 22 жовтня 2026 року; враховуй валюту, податок, регіон, строк оплати та поновлення. Перед оплатою читай підсумкову ціну. Для цих провайдерів поки немає такого розбору goodcryptoX за екранами, як вище.

|| Сервер | Опублікована ціна | Що врахувати || --- | --- | --- || [netcup VPS nano G11.5s](https://www.netcup.com/de/server/vps-lite) | €3,69/місяць із 19% ПДВ, строк шість місяців | 2 GB пам'яті, 60 GB диск; лише Нюрнберг. Податок залежить від країни; обери підключення IPv4 || [OVHcloud VPS-1](https://www.ovhcloud.com/en/vps/) | Від US$4,54/місяць | 4 GB пам'яті, 40 GB диск. Початкова ціна; перевір строк, податок, регіон і поновлення на сторінці замовлення || [IONOS VPS S+](https://www.ionos.com/servers/vps) | US$2/місяць перші три місяці, потім US$6/місяць, строк один рік | 2 GB пам'яті, 60 GB диск; низька стартова ціна не діє весь рік

## Проксі <a href="#proxy" id="proxy"></a>

Проксі спрямовує всі підключення до бірж через вибрану адресу — на комп'ютері, NAS чи сервері.

Відкрий **Налаштування › Загальні › Конфіденційність і безпека › Проксі**, обери **Проксі ввімкнено**, введи `socks5://host:port` або `http://host:port` і натисни **Зберегти**. Якщо адресу ще не збережено, збереження вмикає проксі. Якщо збережено, перемикач зберігає вибір одразу; вимкнення залишає адресу на майбутнє. У збереженій адресі пароль приховано; **Змінити** відкриває її з кнопками **Зберегти** та **Скасувати**, а **Видалити** очищає адресу й вимикає проксі. Порожнє поле не викликає попередження; якщо адреса не SOCKS5 і не HTTP, після збереження під полем з'явиться попередження, а адреса не збережеться. Якщо потрібна авторизація, використовуй `socks5://user:password@host:port` або `http://user:password@host:port`; закодуй спеціальні символи в логіні й паролі (наприклад, `@` як `%40`). Використовуй довірений проксі. Поточні потоки біржі перепідключаються через нього без перезапуску goodcryptoX. У разі збою проксі goodcryptoX попередить: перевір адресу й дані входу або вимкни проксі для прямого підключення.

Під час встановлення через термінал чи Docker задай `GCX_PROXY=socks5://host:port` (або HTTP-адресу) в оточенні до запуску goodcryptoX. Після збереження проксі в Налаштуваннях цей вибір має пріоритет над оточенням, зокрема вимкнення. Проксі використовується для бірж; ретранслятор goodcryptoX, звіти, оновлення та інші сервіси підключаються напряму.

На сервері чи NAS можна використовувати VPN через окремий контейнер Gluetun: додай сервіс нижче до поточного Compose-файлу, заповни дані VPN-провайдера й залиш `network_mode: host` у goodcryptoX. VPN використовує лише Gluetun; сервіси goodcryptoX підключаються напряму. Запусти оновлений проєкт і збережи `http://127.0.0.1:8888` у проксі (або задай `GCX_PROXY` для сервісу `gcx`). Порт проксі доступний лише на цьому пристрої. VPN-провайдер має підтримувати вказані облікові дані OpenVPN; на NAS потрібні `/dev/net/tun` та дозвіл `NET_ADMIN`.

```yaml
  gluetun:
    image: qmcgaw/gluetun:latest
    cap_add: [NET_ADMIN]
    devices: [/dev/net/tun:/dev/net/tun]
    environment:
      VPN_SERVICE_PROVIDER: <your-vpn-provider>
      VPN_TYPE: openvpn
      OPENVPN_USER: <your-vpn-user>
      OPENVPN_PASSWORD: <your-vpn-password>
      HTTPPROXY: "on"
    ports: ["127.0.0.1:8888:8888/tcp"]
    restart: unless-stopped
```

### Домашня мережа <a href="#your-home-network" id="your-home-network"></a>

goodcryptoX може відкриватися в домашній мережі напряму, без нашого сервера: увімкни один перемикач, і на сторінці з'явиться одне посилання. Відкрий його на будь-якому пристрої вдома — і goodcryptoX відкрито. Можливість вимкнена, доки ти її не ввімкнеш, на Mac, Windows, Linux, NAS чи сервері.

#### Як увімкнути <a href="#turn-it-on" id="turn-it-on"></a>

1. Відкрий goodcryptoX звичним способом: на самому пристрої, через my.goodcrypto.app або за посиланням, виведеним під час установлення. Це можна зробити звідки завгодно, навіть із телефона поза домом.
2. Відкрий **Налаштування › Пристрої** та ввімкни **Підключатися напряму вдома** у картці **Домашня мережа** внизу.
3. Картка покаже одне посилання та його QR-код: «Відкрий це посилання або відскануй QR-код на будь-якому пристрої у своїй домашній мережі».

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

Якщо брандмауер запитає, чи дозволити goodcryptoX приймати підключення, або заблокує їх, дозволь.

#### Підключити пристрій <a href="#connect-a-device" id="connect-a-device"></a>

Відкрий це посилання або відскануй QR-код на будь-якому пристрої у своїй домашній мережі. Натисни на текст посилання або **Копіювати**, щоб скопіювати його, а потім встав у браузер на цьому пристрої; на телефоні можна відсканувати QR-код камерою. goodcryptoX відкриється, і пристрій підключено. Повтори на кожному пристрої вдома.

Далі пристрій відкриває goodcryptoX за цією адресою з історії браузера або знову за тим самим посиланням: уже підключений пристрій відкриває його без другого кроку й без нового рядка у списку пристроїв.

На Mac або iPhone браузер може спочатку запитати, чи можна шукати пристрої у твоїй локальній мережі: дозволь. Якщо сторінка повідомляє, що адреса недоступна, увімкни браузер у Системні параметри › Приватність і безпека › Локальна мережа (на iPhone: Параметри › браузер › Локальна мережа) і перезавантаж сторінку.

#### На NAS чи сервері <a href="#on-a-nas-or-a-server" id="on-a-nas-or-a-server"></a>

Через my.goodcrypto.app увімкни можливість у Налаштування › Пристрої, як вище. Якщо звернення до нашого сервера немає або ще жоден пристрій не підключено, журнал під час кожного запуску підказує: «Підключатися напряму вдома: gcx network on у Terminal контейнера або docker exec gcx gcx network on».

1. Відкрий Terminal контейнера (на NAS — контейнер `gcx` у Container Manager; на сервері — консоль провайдера).
2. Виконай `gcx network on` (з оболонки пристрою: `sudo docker exec gcx gcx network on`). Команда виведе посилання та його QR-код.
3. Скопіюй посилання й відкрий його в браузері ноутбука.

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

Якщо ноутбук не може підключитися за запропонованою адресою, вкажи її самостійно: `gcx network on http://192.168.1.20:8128`, з адресою твого пристрою й портом, який показує goodcryptoX. Команда також виводить інші адреси пристрою для вибору.

Якщо goodcryptoX працює як сервіс на комп'ютері без екрана (не в Docker), такого рядка під час запуску немає: виконай `gcx network on` у його оболонці.

* `gcx network` показує, чи ввімкнено можливість, за якими адресами, і виводить посилання.
* `gcx network off` вимикає її.
* **Узагалі без звернення до нашого сервера:** задай `GCX_PHONE_RELAY: ""` для сервісу `gcx` у файлі compose до першого запуску. Якщо goodcryptoX уже запускався з нашим сервером, увімкнення перемикача не скасує перше звернення. Коли наш сервер вимкнено, **Додати пристрій** не показується: вхід — за домашнім посиланням.
* **Файл compose із комплекту** (мережа самого пристрою) не потребує змін для перемикача. Коли він вимкнений, goodcryptoX відповідає лише на самому пристрої, як раніше; коли ввімкнений — за адресами пристрою. Якщо перед NAS чи сервером є брандмауер, він має пропускати порт.

#### Хто може відкрити <a href="#who-can-open-it" id="who-can-open-it"></a>

Вмикай це вдома, у мережі, якій довіряєш. Не перенаправляй порт на роутері.

Будь-хто, хто має це посилання й перебуває у твоїй мережі, може додати пристрій, доки перемикач увімкнено. Посилання працює звідусіль, де його показали чи надіслали: зі знімка екрана, чату, журналу пристрою. Усі пристрої видно в **Налаштування › Пристрої**: видали ті, які додано не тобою. Щоб припинити дію самого посилання, вимкни й знову ввімкни перемикач: з'явиться нове посилання, а старе перестане працювати. Уже додані пристрої знову відкривають goodcryptoX після ввімкнення, доки ти їх не видалиш.

Усі інші, хто відкриє адресу, побачать лише логотип і «Щоб відкрити goodcryptoX у цьому браузері, скористайся домашнім посиланням із Налаштування › Пристрої на пристрої, де goodcryptoX уже відкрито».

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

Доданий тут пристрій може робити все, що й ти за комп'ютером, включно з торгівлею та зміною налаштувань, якщо не обрати **Лише читання**. Пристрій у режимі «Лише читання» бачить адресу, але ніколи не бачить посилання. HTTP передає сторінку, посилання й дані входу відкрито: той, хто може читати трафік твоєї мережі, може їх скопіювати; власна HTTPS-адреса захищає від цього.

#### На ноутбуці <a href="#on-a-laptop" id="on-a-laptop"></a>

На ноутбуці під час увімкнення **Підключатися напряму вдома** спочатку з'являється попередження: натисни **Увімкнути**, щоб продовжити, або **Скасувати**, щоб залишити доступ вимкненим. Це вікно з'являється лише на ноутбуці. Поки доступ увімкнено, картка показує той самий текст спокійним сірим кольором біля перемикача: «У будь-якій мережі Wi-Fi, до якої підключиться MacBook-Pro, будь-хто в ній може відкрити goodcryptoX за цим посиланням», з назвою твого пристрою. Домашня мережа — це будь-яка мережа Wi-Fi, до якої підключено ноутбук, зокрема в кафе чи готелі: будь-хто в цій мережі з посиланням може додати пристрій. Вимикай можливість перед виходом із дому або зберігай посилання лише в себе. goodcryptoX визначає ноутбук за батареєю чи корпусом; із Docker визначити це неможливо (Docker Desktop на ноутбуці не показує рядок), а за помилки читання рядок теж не показується.

#### Що означає «домашня мережа» <a href="#what-home-network-means" id="what-home-network-means"></a>

goodcryptoX відповідає пристроям у мережах, підключених до твого пристрою, і у твоєму власному VPN до дому; решту інтернету він відхиляє. Це перевірка за можливості, а не замок: проксі, VPN чи роутер із перенаправленням трафіку можуть її пройти, а з'єднання, через яке VPN надсилає трафік, — не твоя домашня мережа. Вона не визначає, до якого Wi-Fi підключено пристрій, і не відрізняє гостя від члена сім'ї. Від сторонніх захищають посилання й пристрої, які ти залишаєш.

#### Своя адреса <a href="#your-own-address" id="your-own-address"></a>

Якщо ти вже підключаєшся до пристрою за власним ім'ям через власний HTTPS-проксі (Caddy, nginx), укажи його на самому пристрої: `gcx network on https://gcx.example.com`. goodcryptoX збереже його, увімкне перемикач і покаже посилання за цією адресою. Ім'я також зберігає підключення пристроїв під час зміни адреси машини. HTTPS удома без власного проксі заплановано на майбутню версію.

<details>

<summary>Налаштування проксі</summary>

Стандартне налаштування Caddy підходить:

```caddyfile
gcx.example.com {
    reverse_proxy 127.0.0.1:8128
}
```

nginx має зберігати Host браузера й передавати WebSockets; звичайні рядки `X-Forwarded-*` можна залишити. Помісти map у блок `http` nginx, а location — у наявний HTTPS-сервер для цього імені:

```nginx
map $http_upgrade $gcx_connection {
    default upgrade;
    '' close;
}
location / {
    proxy_pass http://127.0.0.1:8128;
    proxy_http_version 1.1;
    proxy_set_header Host $http_host;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $gcx_connection;
}
```

Замість 8128 використовуй порт, який показує goodcryptoX. Якщо сторінка пише «Ця адреса недоступна», проксі змінив Host: збережи його таким, яким надіслав браузер.

Проксі на цьому пристрої, що передає goodcryptoX адресу `localhost`, отримує доступ як сам пристрій, і вимкнення перемикача його не закриває: обмеж або прибери такий проксі самостійно.

</details>

#### Твої пристрої <a href="#your-devices" id="your-devices"></a>

* Кожен пристрій, доданий так, має рядок у **Налаштування › Пристрої** із позначкою **Домашня мережа**, **Може торгувати** або **Лише читання** та **Видалити**. Видалення відразу припиняє доступ.
* Пристрій, яким не користувалися 90 днів, потрібно додати заново. Використовуваний пристрій залишається підключеним. Браузер зберігає вхід для адреси, за якою пристрій додано, тому той самий пристрій за іншою адресою (ім'я замість числа) додається знову; браузер також може забути вхід раніше, якщо очистити його дані.
* Телефон, який використовує і наш сервер (поза домом), і домашнє посилання (вдома), має два рядки: по одному на кожен спосіб входу. Видалення видаляє той рядок, у якому ти його натискаєш.
* Вимкнення перемикача закриває goodcryptoX для всіх пристроїв домашньої мережі; рядки залишаються, і повторне ввімкнення повертає доступ. Пристрої через наш сервер не зачіпаються (Доступ із телефона).
* Поза домом підключись до свого VPN у домашню мережу й відкрий ту саму адресу або використовуй наш сервер (Доступ із телефона).
* Увійти через Binance працює за адресою в домашній мережі, наприклад 192.168.1.20. За власною адресою (іменем) використовуй самостійно згенерований API-ключ.

#### Підключення гаманця за цією адресою <a href="#connect-a-wallet-at-this-address" id="connect-a-wallet-at-this-address"></a>

Гаманець підключається за домашньою адресою так само, як і будь-де: розширення гаманця в браузері (MetaMask, Rabby та інші) або гаманець на телефоні через сканування QR-коду. Коли відкривається вікно гаманця, адреса сторінки передається Reown / WalletConnect, зокрема адреса в домашній мережі (див. політику конфіденційності). Для QR-коду їхні сервери мають бути доступні.

Гаманець не шифрує твоє з'єднання з goodcryptoX: за домашньою адресою воно залишається звичайним HTTP. Якщо ти не довіряєш цій мережі, використовуй [свою адресу](#your-own-address) з HTTPS або відкрий goodcryptoX через наш сервер (Доступ із телефона).

Якщо сервіс гаманців колись відхилить цю адресу, вікно гаманця закриється, а рядок під **Підключити гаманець** підкаже, що робити: «Гаманці на телефоні не підключаються за цією адресою. Використай розширення гаманця в цьому браузері або відкрий цю сторінку в браузері застосунку гаманця». **Інші способи** додають goodcryptoX через наш сервер або SSH-тунель. Поки ти не перезавантажиш сторінку, вікно показує лише гаманці в браузері; якщо їх немає, Підключити гаманець пише «У цьому браузері немає розширення гаманця».

#### Якщо щось пішло не так <a href="#if-something-goes-wrong" id="if-something-goes-wrong"></a>

* **Посилання більше не працює:** перемикач вимкнули, а після ввімкнення з'явилося нове посилання. Відкрий нове в **Налаштування › Пристрої** на підключеному пристрої або виконай `gcx network` на самому пристрої.
* **Сторінка показує «Щоб відкрити goodcryptoX у цьому браузері, скористайся домашнім посиланням із Налаштування › Пристрої на пристрої, де goodcryptoX уже відкрито».** Пристрій не додано: його видалили, ним не користувалися 90 днів або браузер забув підключення. Відкрий посилання знову.
* **Усі пристрої втрачено:** у консолі пристрою виконай `gcx network` (`gcx network on`, якщо перемикач вимкнено) і відкрий виведене посилання. Скидання електронною поштою немає.
* **Адреса змінилася** (роутер може видати іншу) **або дані браузера очищено:** знову відкрий посилання з **Налаштування › Пристрої**: воно містить нову адресу. [Своя адреса](#your-own-address) дозволяє уникнути першого.
* **Картка повідомляє «goodcryptoX заблоковано»:** спочатку розблокуй goodcryptoX, і посилання знову з'явиться. Уже додані пристрої та саме посилання тим часом продовжують працювати.
* **Після перенесення goodcryptoX через імпорт** із пристрою, відкритого в домашній мережі: новий пристрій запускається з вимкненим перемикачем, без пристроїв домашньої мережі й без посилання, тому під час перезапуску той пристрій втрачає доступ до goodcryptoX. Увімкни там перемикач і відкрий нове посилання.

## Запитання <a href="#questions" id="questions"></a>

### Скільки це коштує? <a href="#what-does-it-cost" id="what-does-it-cost"></a>

Ти платиш за сервер: на 18 жовтня 2026 року KVM 1 у Hostinger коштував $6,49 на місяць за оплати на 24 місяці наперед, плюс податок. goodcryptoX працює і на недорогих, і навіть безкоштовних серверах. Сам goodcryptoX — без плати за запуск; єдина комісія — 0,03% за кожну виконану угоду (на споті — за кожен продаж).

### goodcryptoX на сервері торгує, коли комп'ютер вимкнений? <a href="#does-goodcryptox-on-a-server-trade-while-my-computer-is-off" id="does-goodcryptox-on-a-server-trade-while-my-computer-is-off"></a>

Так: сервер запускає goodcryptoX цілодобово. Після підключення телефона комп'ютер не потрібен: усім можна керувати з телефона.

### Якого провайдера сервера обрати? <a href="#which-server-provider-should-i-use" id="which-server-provider-should-i-use"></a>

Підійде будь-який: кроки показують Hostinger, найпростіший у налаштуванні зі знайдених нами; ті самі дії працюють в AWS, DigitalOcean, Google Cloud, Azure та в інших.

### Чи потрібен домен? <a href="#do-i-need-a-domain" id="do-i-need-a-domain"></a>

Ні: goodcryptoX вона не потрібна, застосунок відкривається на my.goodcrypto.app.

### Де мої дані? <a href="#where-is-my-data" id="where-is-my-data"></a>

У двох томах Docker на сервері: `gcx-data` та `gcx-secret`. Копіюй їх разом: сам `gcx-data` не зможе відкрити ключі.

### Чи можна пізніше перенести goodcryptoX на інший сервер? <a href="#can-i-move-goodcryptox-to-another-server-later" id="can-i-move-goodcryptox-to-another-server-later"></a>

Так: експортуй на старому сервері командою `sudo docker exec -it gcx gcx export` у його терміналі, скопіюй файл на комп'ютер і скористайся **Перенести** в панелі нового сервера, разом з акаунтами й ботами ([Перенесення goodcryptoX](https://docs.goodcrypto.app/goodcryptox-uk/goodcryptox-3.0/readme/moving-goodcryptox.md#from-one-server-to-another)).
