> 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-ru/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-ru/goodcryptox-3.0/readme/set-up-on-a-nas.md) или [арендованный сервер](https://docs.goodcrypto.app/goodcryptox-ru/goodcryptox-3.0/readme/set-up-on-a-server.md): один раз настрой по шагам, затем так же пользуйся из браузера или с телефона, не переживая о пропущенном ордере. Можно начать здесь и [перенести позже](https://docs.goodcrypto.app/goodcryptox-ru/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-ru/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-ru/goodcryptox-3.0/readme/set-up-on-a-nas.md) или [арендованный сервер](https://docs.goodcrypto.app/goodcryptox-ru/goodcryptox-3.0/readme/set-up-on-a-server.md) одним файлом, с аккаунтами и ботами ([Перенос goodcryptoX](https://docs.goodcrypto.app/goodcryptox-ru/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-ru/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-ru/goodcryptox-3.0/readme/phone-access.md)).
