> 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-fr/goodcryptox-3.0/readme/set-up-on-a-nas.md).

# Installer sur un NAS

Un NAS chez toi fait tourner goodcryptoX jour et nuit, sans location. Les étapes utilisent Synology ; les autres apps de conteneurs prennent le même fichier.

Un NAS chez toi fait tourner goodcryptoX jour et nuit, sans location. Commence ici ou sur Mac, puis déplace-le ici en un fichier. Les étapes ci-dessous utilisent un Synology ; les apps de conteneurs des autres fabricants prennent le même fichier.

## Vérifier ton NAS <a href="#check-your-nas" id="check-your-nas"></a>

goodcryptoX a besoin de trois choses :

1. **L'app de conteneurs du fabricant  :** Synology Container Manager, QNAP Container Station, Asustor Docker Engine, UGREEN Docker, TerraMaster Docker Manager.
2. **Au moins 2 Go de mémoire installée**, dont environ 1 Go libre.
3. **Un processeur 64 bits** (x86-64 ou ARM64).

Chez Synology, les modèles Plus depuis 2018 (DS218+, DS220+, DS224+, DS920+, DS923+ et autres) ainsi que DS223 et DS423 conviennent. Les j et play, DS124, DS118, DS218 et DS418 ne conviennent pas. Un doute ? Demande dans le groupe Telegram goodcryptoX, [t.me/goodcrypto](https://t.me/goodcrypto), avec ton modèle exact.

## Démarrer goodcryptoX <a href="#start-goodcryptox" id="start-goodcryptox"></a>

1. Dans **Centre de paquets**, installe **Container Manager**.
2. Télécharge le fichier Compose de goodcryptoX : [compose.yaml](https://github.com/GoodCryptoApp/gcx/releases/latest/download/compose.yaml).
3. Dans Container Manager, **Projet › Créer** : nomme-le `gcx`, choisis un nouveau dossier sur le disque du NAS (comme `docker/gcx`), puis **Charger docker-compose.yml** et le fichier. Appuie sur **Suivant** jusqu'à **Terminé**. goodcryptoX démarre.

Le fichier utilise la dernière version de goodcryptoX sur GitHub.

<details>

<summary>Si cela ne fonctionne pas</summary>

Choisis **Créer docker-compose.yml** au lieu du chargement et colle le contenu du fichier :

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

## Se connecter <a href="#sign-in" id="sign-in"></a>

Dans Container Manager, ouvre le conteneur `gcx` et son journal. Au premier démarrage, les premières lignes affichent un lien : copie-le dans le navigateur de ton ordinateur et crée une passkey avec Touch ID ou le déverrouillage de ton ordinateur. goodcryptoX s'ouvre sur my.goodcrypto.app. Ajoute ensuite ton téléphone depuis le panneau : Paramètres › Appareils › **Ajouter un appareil** affiche un QR code à scanner.

Le premier lien est à usage unique : il expire dès qu'un appareil l'utilise. Il expire aussi après 10 minutes. Pour en obtenir un nouveau, redémarre le conteneur ou lance `gcx pair` dans son terminal. Ce lien est une clé : ne le partage jamais et ne le colle nulle part ailleurs.

Le lien passe par le relais de goodcryptoX.

<details>

<summary>Si cela ne fonctionne pas</summary>

Passe plutôt par un tunnel. Active SSH sur le NAS (**Panneau de configuration › Terminal & SNMP › Terminal › Activer le service SSH** ; seul un compte administrateur peut se connecter). Sur ton ordinateur, ouvre Terminal (PowerShell sous Windows), exécute cette ligne avec ton utilisateur et l'adresse du NAS, saisis ton mot de passe et garde la fenêtre ouverte :

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

Dans une seconde fenêtre, connecte-toi au NAS avec `ssh <user>@<your NAS's address>`, lance `sudo docker exec gcx gcx open --print` et ouvre le lien affiché dans ton navigateur sous 60 secondes. goodcryptoX s'ouvre à `http://localhost:8128/gcx`. Une adresse réseau comme `http://192.168.1.20:8128` ne l'ouvre qu'après activation de **Se connecter directement à la maison**, ci-dessous.

</details>

Ensuite, tout est comme sur serveur : [ajouter un téléphone ou un autre ordinateur](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/readme/set-up-on-a-server.md#add-a-phone-or-another-computer), [mises à jour et sauvegardes](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/readme/set-up-on-a-server.md#updates-and-backups).

### Ton réseau domestique <a href="#your-home-network" id="your-home-network"></a>

goodcryptoX peut s'ouvrir directement sur ton réseau domestique, sans notre serveur : active un interrupteur et la page affiche un lien. Ouvre ce lien sur n'importe quel appareil à la maison et goodcryptoX est là. L'option reste désactivée jusqu'à ce que tu l'actives, sur Mac, Windows, Linux, NAS ou serveur.

#### L'activer <a href="#turn-it-on" id="turn-it-on"></a>

1. Ouvre goodcryptoX comme d'habitude : sur la machine, via my.goodcrypto.app ou avec le lien affiché par l'installation. Tu peux le faire de n'importe où, même depuis un téléphone hors de chez toi.
2. Ouvre **Paramètres › Appareils** et active **Se connecter directement à la maison**, dans la carte **Réseau domestique** en bas.
3. La carte affiche un lien et son code QR : « Ouvre ce lien ou scanne le code QR sur n'importe quel appareil de ton réseau domestique ».

Le lien reste le même jusqu'à ce que tu désactives l'interrupteur. Garde-le là où tu gardes tes affaires : dans ton navigateur, dans une note ou dans un message à toi-même.

Si le pare-feu demande si goodcryptoX peut accepter des connexions, ou le bloque, autorise-le.

#### Connecter un appareil <a href="#connect-a-device" id="connect-a-device"></a>

Ouvre ce lien ou scanne le code QR sur n'importe quel appareil de ton réseau domestique. Clique sur le texte du lien ou sur **Copier** pour le copier, puis colle-le dans le navigateur de cet appareil ; sur un téléphone, tu peux scanner le code QR avec l'appareil photo. goodcryptoX s'ouvre et l'appareil est connecté. Fais de même sur chaque appareil à la maison.

L'appareil ouvre ensuite goodcryptoX à cette adresse depuis l'historique du navigateur ou depuis le même lien : un appareil déjà connecté l'ouvre sans autre étape ni nouvelle ligne dans Appareils.

Sur un Mac ou un iPhone, le navigateur peut d'abord demander s'il peut rechercher des appareils sur ton réseau local : autorise-le. Si la page indique que l'adresse est inaccessible, active le navigateur dans Réglages Système › Confidentialité et sécurité › Réseau local (sur un iPhone : Réglages › le navigateur › Réseau local) et recharge la page.

#### Sur un NAS ou un serveur <a href="#on-a-nas-or-a-server" id="on-a-nas-or-a-server"></a>

Via my.goodcrypto.app, tu l'actives dans Paramètres › Appareils, comme ci-dessus. Sans contact avec notre serveur, ou tant qu'aucun appareil n'est connecté, le journal de la machine indique comment faire à chaque démarrage : « Se connecter directement à la maison : gcx network on dans le Terminal du conteneur, ou docker exec gcx gcx network on ».

1. Ouvre le Terminal du conteneur (sur NAS, le conteneur `gcx` dans Container Manager ; sur serveur, la console de ton fournisseur).
2. Lance `gcx network on` (depuis le shell de la machine : `sudo docker exec gcx gcx network on`). La commande affiche un lien et son QR code.
3. Copie le lien et ouvre-le dans le navigateur de ton portable.

Tant qu'aucun appareil n'est connecté, le journal affiche le même lien à chaque démarrage. Le lien est une clé : toute personne qui lit le journal du conteneur peut le voir, alors garde le journal pour toi.

Si l'adresse proposée n'est pas celle que ton portable atteint, donne-la toi-même : `gcx network on http://192.168.1.20:8128`, avec l'adresse de ta machine et le port affiché par goodcryptoX. La commande liste aussi les autres adresses de la machine pour choisir.

Un goodcryptoX qui tourne comme service sur un ordinateur sans écran (hors Docker) n'affiche pas cette ligne au démarrage : lance `gcx network on` dans son shell.

* `gcx network` indique si l'option est activée, à quelles adresses, et affiche le lien.
* `gcx network off` la désactive.
* **Aucun contact avec notre serveur :** définis `GCX_PHONE_RELAY: ""` sur le service `gcx` du fichier compose avant son premier démarrage. Une fois goodcryptoX démarré avec notre serveur, activer l'interrupteur n'annule pas ce premier contact. Avec notre serveur désactivé, **Ajouter un appareil** ne s'affiche pas : le lien domestique permet d'entrer.
* **Le fichier compose fourni** (réseau de la machine) n'a pas besoin d'être modifié pour l'interrupteur. Désactivé, goodcryptoX répond seulement sur la machine elle-même, comme avant ; activé, à ses adresses. Un pare-feu devant le NAS ou serveur doit laisser passer le port.

#### Qui peut l'ouvrir <a href="#who-can-open-it" id="who-can-open-it"></a>

Active cette option chez toi, sur un réseau de confiance. Ne redirige pas le port sur ton routeur.

Toute personne qui a ce lien et se trouve sur ton réseau peut ajouter un appareil tant que l'option est activée. Le lien fonctionne partout où il a été affiché ou envoyé : capture d'écran, discussion, journal de la machine. Tu vois chaque appareil dans **Paramètres › Appareils** : retire ceux que tu n'as pas ajoutés. Pour invalider le lien lui-même, désactive puis réactive l'interrupteur : cela crée un nouveau lien et l'ancien cesse de fonctionner. Les appareils déjà ajoutés ouvrent à nouveau goodcryptoX à la réactivation, jusqu'à ce que tu les retires.

Toute autre personne qui ouvre l'adresse ne voit que le logo et « Pour ouvrir goodcryptoX dans ce navigateur, utilise le lien de la maison disponible dans Paramètres › Appareils sur un appareil où goodcryptoX est ouvert. »

Si tu perds un appareil ou soupçonnes un autre accès : retire l'appareil, désactive puis réactive l'interrupteur pour un nouveau lien, puis vérifie Appareils et retire ceux que tu n'as pas ajoutés ; révoque les clés créées entre-temps et toute clé qui a pu être copiée.

Un appareil ajouté ici peut faire tout ce que tu fais sur ton ordinateur, trading et modification des paramètres compris, sauf si tu le règles sur **Lecture seule**. Un appareil en Lecture seule voit l'adresse, jamais le lien. HTTP transporte la page, le lien et la connexion en clair : quelqu'un qui peut lire le trafic de ton réseau peut les copier ; ta propre adresse HTTPS protège contre cela.

#### Sur un portable <a href="#on-a-laptop" id="on-a-laptop"></a>

Sur un portable, l'activation de **Se connecter directement à la maison** affiche d'abord un avertissement : choisis **Activer** pour continuer ou **Annuler** pour laisser l'option désactivée. Cette fenêtre apparaît uniquement sur un portable. Tant que l'option est activée, la carte garde le même texte en gris discret près de l'interrupteur : « Sur chaque réseau Wi-Fi auquel MacBook-Pro se connecte, toute personne connectée à ce réseau peut ouvrir goodcryptoX avec ce lien », avec le nom de ta machine. Le réseau domestique est le Wi-Fi auquel le portable est connecté, même celui d'un café ou d'un hôtel : toute personne sur ce réseau qui a le lien peut ajouter un appareil. Désactive l'option avant de quitter la maison, ou garde le lien pour toi. goodcryptoX reconnaît un portable par sa batterie ou son boîtier ; il ne peut pas le savoir depuis Docker (Docker Desktop sur un portable n'affiche aucune ligne), et n'en affiche pas non plus si la lecture échoue.

#### Ce que signifie « réseau domestique » <a href="#what-home-network-means" id="what-home-network-means"></a>

goodcryptoX répond aux appareils des réseaux auxquels ta machine est connectée et de ton propre VPN vers chez toi ; il refuse le reste d'internet. Cette vérification fait au mieux, ce n'est pas un verrou : un proxy, un VPN ou un routeur qui transfère le trafic peut la passer, et la connexion par laquelle un VPN envoie ton trafic n'est pas ton réseau domestique. goodcryptoX ne sait pas sur quel Wi-Fi un appareil se trouve et ne distingue pas un invité d'un membre de la famille. Ce sont le lien et les appareils que tu gardes qui tiennent les autres à l'écart.

#### Ta propre adresse <a href="#your-own-address" id="your-own-address"></a>

Si tu atteins déjà ta machine par un nom à toi, via ton propre proxy HTTPS (Caddy, nginx), indique-le sur la machine : `gcx network on https://gcx.example.com`. goodcryptoX l'enregistre, active l'interrupteur et affiche le lien à cette adresse. Un nom garde aussi tes appareils connectés quand l'adresse de la machine change. HTTPS à la maison sans ton propre proxy est prévu pour une version ultérieure.

<details>

<summary>Paramètres du proxy</summary>

La configuration par défaut de Caddy fonctionne :

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

nginx doit conserver le Host du navigateur et transmettre les WebSockets ; les lignes habituelles `X-Forwarded-*` peuvent rester. Mets la map dans le bloc `http` de nginx et la location dans ton serveur HTTPS existant pour ce nom :

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

Utilise le port affiché par goodcryptoX à la place de 8128. Si une page indique « Cette adresse n'est pas disponible », le proxy a modifié le Host : garde-le tel que le navigateur l'a envoyé.

Un proxy sur cette machine qui transmet à goodcryptoX une adresse `localhost` y accède comme la machine elle-même, et désactiver l'interrupteur ne le bloque pas : restreins ou supprime ce proxy toi-même.

</details>

#### Tes appareils <a href="#your-devices" id="your-devices"></a>

* Chaque appareil ajouté ainsi a sa ligne dans **Paramètres › Appareils**, marquée **Réseau domestique**, avec **Peut trader** ou **Lecture seule** et **Retirer**. Supprimer coupe l'accès immédiatement.
* Un appareil inutilisé pendant 90 jours doit être ajouté à nouveau. Un appareil utilisé reste connecté. Ton navigateur garde sa connexion pour l'adresse où il a été ajouté : la même machine à une autre adresse (un nom au lieu d'un nombre) doit donc être ajoutée à nouveau ; le navigateur peut aussi l'oublier plus tôt si tu effaces ses données.
* Un téléphone qui utilise notre serveur (ailleurs) et le lien domestique (chez toi) a deux lignes : une par accès. Retirer supprime la ligne sur laquelle tu appuies.
* Désactiver l'interrupteur ferme goodcryptoX à tous les appareils du réseau domestique ; leurs lignes restent et le réactiver les laisse entrer. Les appareils qui utilisent notre serveur ne sont pas affectés (Accès depuis un téléphone).
* Hors de chez toi, connecte-toi à ton propre VPN vers ton réseau domestique et ouvre la même adresse, ou utilise notre serveur (Accès depuis un téléphone).
* Se connecter avec Binance fonctionne à ton adresse sur le réseau domestique, comme 192.168.1.20. À ta propre adresse (un nom), utilise une clé API autogénérée.

#### Connecter un wallet à cette adresse <a href="#connect-a-wallet-at-this-address" id="connect-a-wallet-at-this-address"></a>

Un wallet se connecte à l'adresse domestique comme ailleurs : une extension de wallet dans ton navigateur (MetaMask, Rabby et autres), ou un wallet mobile en scannant le code QR. Ouvrir la fenêtre du wallet envoie à Reown / WalletConnect l'adresse de la page, y compris celle de ton réseau domestique (voir la politique de confidentialité). Le code QR nécessite que leurs serveurs soient joignables.

Un wallet ne chiffre pas ta connexion à goodcryptoX : à l'adresse domestique, elle reste en HTTP non chiffré. Si tu ne fais pas confiance à ce réseau, utilise [ta propre adresse](#your-own-address) en HTTPS, ou ouvre goodcryptoX via notre serveur (Accès depuis le téléphone).

Si le service de wallets refuse un jour cette adresse, la fenêtre se ferme et une ligne sous **Connecter le wallet** indique quoi faire : « Les portefeuilles mobiles ne peuvent pas se connecter à cette adresse. Utilise une extension de portefeuille dans ce navigateur, ou ouvre cette page dans le navigateur de l'app de ton portefeuille ». **Autres moyens** ajoute goodcryptoX via notre serveur ou un tunnel SSH. Jusqu'au rechargement de la page, la fenêtre liste uniquement les wallets de ton navigateur ; sans extension, Connecter le wallet indique « Aucune extension de wallet dans ce navigateur ».

#### En cas de problème <a href="#if-something-goes-wrong" id="if-something-goes-wrong"></a>

* **Le lien ne fonctionne plus :** l'interrupteur a été désactivé et sa réactivation a créé un nouveau lien. Ouvre le nouveau depuis **Paramètres › Appareils** sur un appareil connecté, ou lance `gcx network` sur la machine.
* **La page affiche « Pour ouvrir goodcryptoX dans ce navigateur, utilise le lien de la maison disponible dans Paramètres › Appareils sur un appareil où goodcryptoX est ouvert. »** L'appareil n'est pas ajouté : il a été retiré, inutilisé pendant 90 jours ou oublié par son navigateur. Ouvre à nouveau le lien.
* **Tous les appareils sont perdus :** dans la console de la machine, lance `gcx network` (`gcx network on` si l'interrupteur est désactivé) et ouvre le lien affiché. Il n'y a pas de réinitialisation par e-mail.
* **L'adresse a changé** (un routeur peut en attribuer une autre) **ou les données du navigateur ont été effacées :** ouvre à nouveau le lien depuis **Paramètres › Appareils** : il contient la nouvelle adresse. [Ta propre adresse](#your-own-address) évite le premier cas.
* **La carte indique « goodcryptoX est verrouillé » :** déverrouille d'abord goodcryptoX ; le lien réapparaît. Les appareils déjà ajoutés et le lien lui-même continuent de fonctionner entre-temps.
* **Après avoir déplacé goodcryptoX avec Importer** depuis un appareil ouvert sur le réseau domestique : la nouvelle machine démarre avec l'interrupteur désactivé, sans appareils du réseau domestique ni lien, donc cet appareil perd l'accès à goodcryptoX au redémarrage. Active l'interrupteur sur la nouvelle machine et ouvre son nouveau lien.

## Utiliser un proxy <a href="#proxy" id="proxy"></a>

Un proxy fait passer chaque connexion d'exchange par l'adresse de ton choix, sur ordinateur, NAS ou serveur.

Ouvre **Paramètres › Général › Confidentialité et sécurité › Serveur proxy**, active **Proxy activé**, saisis `socks5://host:port` ou `http://host:port` et appuie sur **Enregistrer**. Sans adresse enregistrée, Enregistrer l'active. Avec une adresse, l'interrupteur enregistre immédiatement ; désactiver garde l'adresse pour plus tard. Le mot de passe est masqué dans l'adresse enregistrée. **Modifier** l'ouvre avec **Enregistrer** et **Annuler** ; **Retirer** l'efface et désactive le proxy. Un champ vide ne montre aucun avertissement ; une adresse autre que SOCKS5 ou HTTP affiche un avertissement après Enregistrer et n'est pas sauvegardée. Si le proxy exige un identifiant, utilise `socks5://user:password@host:port` ou `http://user:password@host:port` ; encode les caractères spéciaux (par exemple `@` en `%40`). Utilise un proxy de confiance. Les flux d'exchange existants se reconnectent par lui sans redémarrer goodcryptoX. En cas de panne du proxy, goodcryptoX t'alerte : vérifie adresse et identifiants ou désactive le proxy pour une connexion directe.

Pour une installation en terminal ou Docker, définis `GCX_PROXY=socks5://host:port` (ou l'adresse HTTP) dans son environnement avant de démarrer goodcryptoX. Dès que tu enregistres le proxy dans les paramètres, ce choix prime sur l'environnement, même désactivé. Le proxy couvre les exchanges ; relais, rapports, mises à jour et autres services de goodcryptoX se connectent directement.

Sur serveur ou NAS, tu peux utiliser un VPN via un conteneur Gluetun auxiliaire : ajoute le service ci-dessous au fichier Compose existant, renseigne ton fournisseur VPN et garde `network_mode: host` pour goodcryptoX. Seul Gluetun utilise le VPN ; les services de goodcryptoX restent directs. Démarre le projet modifié, puis enregistre `http://127.0.0.1:8888` dans Proxy (ou définis `GCX_PROXY` sur le service `gcx`). Le port du proxy n'est accessible que sur cette machine. Le fournisseur VPN doit accepter tes identifiants OpenVPN ; un NAS doit disposer de `/dev/net/tun` et autoriser la capacité `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
```

## Questions fréquentes <a href="#questions" id="questions"></a>

### Quels NAS peuvent faire tourner goodcryptoX ? <a href="#which-nas-can-run-goodcryptox" id="which-nas-can-run-goodcryptox"></a>

Un NAS avec l'app de conteneurs du fabricant, au moins 2 Go de mémoire et un processeur 64 bits. Chez Synology, les Plus depuis 2018 ainsi que DS223 et DS423 conviennent.

### goodcryptoX sur NAS trade-t-il quand mon ordinateur est éteint ? <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>

Oui : le NAS fait tourner goodcryptoX jour et nuit et tu l'ouvres depuis ordinateur ou téléphone.

### Où sont mes données ? <a href="#where-is-my-data" id="where-is-my-data"></a>

Dans deux volumes Docker, `gcx-data` et `gcx-secret` : sauvegarde-les ensemble, car `gcx-data` seul ne peut pas ouvrir tes clés.

### Puis-je commencer sur Mac et passer sur NAS plus tard ? <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>

Oui : **Exporter** sur ton Mac et **Importer** dans le panneau du NAS. Ton navigateur envoie le fichier, comptes et bots compris ([Déplacer goodcryptoX](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/readme/moving-goodcryptox.md)).

### Ai-je encore besoin de votre serveur ? <a href="#do-i-still-need-your-server" id="do-i-still-need-your-server"></a>

Non : chez toi, tes appareils ouvrent goodcryptoX directement. Ailleurs, utilise ton propre VPN vers chez toi ou notre serveur ([Accès depuis un téléphone](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/readme/phone-access.md)).
