> 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-your-mac.md).

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

Один файл для Apple silicon та Intel, macOS 13.5 або новіша; автоматичні оновлення.

goodcryptoX для Mac — застосунок у рядку меню: завантаж один файл і користуйся в браузері. Він оновлюється сам, запускається під час входу в систему й торгує, поки Mac увімкнений та в мережі.

macOS 13.5 або новіша, Apple silicon чи Intel.

{% hint style="warning" %}
**goodcryptoX торгує, лише поки цей Mac увімкнений та в мережі.** Під час роботи він стежить за ордерами й ботами. Коротка перерва допустима: кілька хвилин без зв'язку, перезапуск застосунку чи Mac — після повернення goodcryptoX надолужить пропущене. Якщо Mac зазвичай не працює цілодобово, встанови goodcryptoX на [домашній NAS](https://docs.goodcrypto.app/goodcryptox-uk/goodcryptox-3.0/readme/set-up-on-a-nas.md) або [орендований сервер](https://docs.goodcrypto.app/goodcryptox-uk/goodcryptox-3.0/readme/set-up-on-a-server.md): один раз налаштуй за кроками, далі так само користуйся з браузера чи телефона, не хвилюючись про пропущений ордер. Можна почати тут і [перенести пізніше](https://docs.goodcrypto.app/goodcryptox-uk/goodcryptox-3.0/readme/moving-goodcryptox.md) одним файлом.
{% endhint %}

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

1. [Завантаж goodcryptoX](https://goodcrypto.app/download/mac?utm_source=docs\&utm_medium=page\&utm_campaign=setup-mac) і відкрий `.dmg`.
2. Перетягни **goodcryptoX** до **Програми**, потім двічі натисни **goodcryptoX** у тому самому вікні.
3. goodcryptoX з'явиться в рядку меню праворуч угорі й відкриється в браузері. Блок **Налаштуй goodcryptoX** на Дашборді проведе далі: акаунти біржі, потім Telegram-бот.

<details>

<summary>Якщо macOS запитує підтвердження відкриття</summary>

Під час першого запуску macOS повідомить, що goodcryptoX завантажено з інтернету й перевірено Apple: обери **Відкрити**. Це потрібно один раз. Якщо встановлено стару версію goodcryptoX, спочатку закрий її через меню **Завершити goodcryptoX** та обери **Замінити**. Якщо Mac вимагає пароль адміністратора для копіювання, використовуй папку «Програми» в домашній папці.

</details>

Крапка на значку goodcryptoX у рядку меню показує стан: зелена — усе добре, жовта — варто перевірити, червона — потрібна твоя увага зараз. goodcryptoX запускається під час входу в систему й працює із закритим браузером. Параметр **Не давати Mac засинати** (Налаштування › Загальні › Встановлення) не дає Mac із підключеним живленням засинати.

## Інший браузер <a href="#another-browser" id="another-browser"></a>

Щоб відкрити goodcryptoX в іншому браузері на цьому Mac, введи localhost:8118 в адресний рядок і натисни «Розблокувати». Якщо адреса не відкривається, обери «Копіювати посилання для входу» в меню goodcryptoX та встав його в браузер.

## Підключення телефона чи іншого комп'ютера <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)).

Удома ввімкни **Підключатися напряму вдома** у **Налаштування › Пристрої**, потім відкрий посилання на інших пристроях; спочатку перемикач у стані **Вимк.**. Якщо брандмауер Mac запитає, чи дозволити goodcryptoX приймати підключення, дозволь. Усі кроки — у розділі [Домашня мережа](#your-home-network).

## Проксі <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>

### goodcryptoX торгує, коли Mac спить? <a href="#does-goodcryptox-trade-while-my-mac-sleeps" id="does-goodcryptox-trade-while-my-mac-sleeps"></a>

Ні: лише поки Mac увімкнений та в мережі, хоча ордери на біржі й далі виконуються. Параметр **Не давати Mac засинати** не дає Mac із підключеним живленням засинати.

### На яких Mac працює goodcryptoX? <a href="#which-macs-does-goodcryptox-run-on" id="which-macs-does-goodcryptox-run-on"></a>

macOS 13.5 або новіша, на Apple silicon чи Intel.

### Чи можна пізніше перенести goodcryptoX з Mac? <a href="#can-i-move-goodcryptox-from-my-mac-later" id="can-i-move-goodcryptox-from-my-mac-later"></a>

Так: на [домашній NAS](https://docs.goodcrypto.app/goodcryptox-uk/goodcryptox-3.0/readme/set-up-on-a-nas.md) або [орендований сервер](https://docs.goodcrypto.app/goodcryptox-uk/goodcryptox-3.0/readme/set-up-on-a-server.md) одним файлом, з акаунтами та ботами ([Перенесення goodcryptoX](https://docs.goodcrypto.app/goodcryptox-uk/goodcryptox-3.0/readme/moving-goodcryptox.md)).

### Чи можна користуватися goodcryptoX з телефона? <a href="#can-i-use-goodcryptox-on-my-phone" id="can-i-use-goodcryptox-on-my-phone"></a>

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

### Чи потрібен іще ваш сервер? <a href="#do-i-still-need-your-server" id="do-i-still-need-your-server"></a>

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