> 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-a-nas.md).

# Установка goodcryptoX на NAS

Домашний NAS запускает goodcryptoX круглосуточно без аренды. Инструкция для Synology; контейнерные приложения других производителей используют тот же файл.

Домашний NAS запускает goodcryptoX круглосуточно, без аренды. Начни здесь или на Mac и перенеси сюда позже одним файлом. Ниже — шаги для Synology; контейнерные приложения других производителей используют тот же файл.

## Проверь свой NAS <a href="#check-your-nas" id="check-your-nas"></a>

goodcryptoX нужны три вещи:

1. **Контейнерное приложение производителя:** Synology Container Manager, QNAP Container Station, Asustor Docker Engine, UGREEN Docker, TerraMaster Docker Manager.
2. **Не менее 2 GB установленной памяти,** из них около 1 GB свободно.
3. **64-битный процессор** (x86-64 или ARM64).

У Synology подходят модели Plus с 2018 года (DS218+, DS220+, DS224+, DS920+, DS923+ и другие), DS223 и DS423. Модели j и play, DS124, а также DS118, DS218 и DS418 не подходят. Не уверен? Напиши точную модель в Telegram-группе goodcryptoX: [t.me/goodcrypto](https://t.me/goodcrypto).

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

1. В **Центре пакетов** установи **Container Manager**.
2. Скачай Compose-файл goodcryptoX: [compose.yaml](https://github.com/GoodCryptoApp/gcx/releases/latest/download/compose.yaml).
3. В Container Manager выбери **Проект › Создать**: имя `gcx`, путь — новая папка на собственном диске NAS (например, `docker/gcx`). Выбери **Загрузить docker-compose.yml** и укажи файл. Нажимай **Далее** до **Готово**. goodcryptoX запустится.

Файл использует последний релиз goodcryptoX на GitHub.

<details>

<summary>Если не получается</summary>

Вместо загрузки выбери **Создать docker-compose.yml** и вставь текст файла:

```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}
```

</details>

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

В Container Manager открой контейнер `gcx` и его журнал. При первом запуске в первых строках появится ссылка: скопируй, вставь в браузер на компьютере и создай ключ доступа через Touch ID или способ разблокировки компьютера. goodcryptoX откроется на my.goodcrypto.app. Затем добавь телефон из панели: Настройки › Устройства › **Добавить устройство** покажет QR-код для сканирования.

Первая ссылка одноразовая: перестает работать, как только устройство ее использует. Она также истекает через 10 минут: для новой перезапусти контейнер или выполни `gcx pair` в его терминале. Ссылка — это ключ: никому не передавай и никуда не вставляй.

Ссылка проходит через ретранслятор goodcryptoX.

<details>

<summary>Если не получается</summary>

Вместо этого подключись к goodcryptoX через туннель. Включи SSH на NAS (**Панель управления › Терминал и SNMP › Терминал › Включить службу SSH**; войти может только администратор). На компьютере открой Терминал (PowerShell в Windows), выполни строку со своим пользователем и адресом NAS, введи пароль и оставь окно открытым:

```
ssh -N -L 8128:127.0.0.1:8128 <user>@<your NAS's address>
```

Во втором окне подключись к NAS командой `ssh <user>@<your NAS's address>`, выполни `sudo docker exec gcx gcx open --print` и открой выведенную ссылку в браузере в течение 60 секунд. goodcryptoX откроется по адресу `http://localhost:8128/gcx`. Сетевой адрес вроде `http://192.168.1.20:8128` откроет его только после включения **Подключаться напрямую дома**, как описано ниже.

</details>

Дальше всё как на сервере: [подключение телефона или другого компьютера](https://docs.goodcrypto.app/goodcryptox-ru/goodcryptox-3.0/readme/set-up-on-a-server.md#add-a-phone-or-another-computer), [обновления и резервные копии](https://docs.goodcrypto.app/goodcryptox-ru/goodcryptox-3.0/readme/set-up-on-a-server.md#updates-and-backups).

### Домашняя сеть <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="#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="#questions" id="questions"></a>

### На каких NAS работает goodcryptoX? <a href="#which-nas-can-run-goodcryptox" id="which-nas-can-run-goodcryptox"></a>

Нужны контейнерное приложение производителя, минимум 2 GB памяти и 64-битный процессор. У Synology подходят модели Plus с 2018 года, DS223 и DS423.

### goodcryptoX на NAS торгует, когда компьютер выключен? <a href="#does-goodcryptox-on-a-nas-trade-while-my-computer-is-off" id="does-goodcryptox-on-a-nas-trade-while-my-computer-is-off"></a>

Да: NAS запускает goodcryptoX круглосуточно, а ты открываешь его с компьютера или телефона.

### Где мои данные? <a href="#where-is-my-data" id="where-is-my-data"></a>

В двух томах Docker: `gcx-data` и `gcx-secret`. Копируй их вместе: один `gcx-data` не сможет открыть ключи.

### Можно начать на Mac и позже перейти на NAS? <a href="#can-i-start-on-my-mac-and-move-to-a-nas-later" id="can-i-start-on-my-mac-and-move-to-a-nas-later"></a>

Да: **Экспортировать** на Mac и **Перенести** в панели NAS; браузер отправит файл с аккаунтами и ботами ([Перенос goodcryptoX](https://docs.goodcrypto.app/goodcryptox-ru/goodcryptox-3.0/readme/moving-goodcryptox.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)).
