dev chapter

content/dev/build/docker/_index.de.md

@@ -0,0 +1,35 @@
+---
+title: Docker 
+weight: 30
+---
+
+## Auf Docker Kompilieren
+
+Beginne damit das Repository zu klonen und den Docker Container zu bauen:
+
+```sh
+git clone https://github.com/rustdesk/rustdesk
+cd rustdesk
+docker build -t "rustdesk-builder" .
+```
+
+Jedes Mal, wenn du das Programm Kompilieren musst, nutze diesen Befehl:
+
+```sh
+docker run --rm -it -v $PWD:/home/user/rustdesk -v rustdesk-git-cache:/home/user/.cargo/git -v rustdesk-registry-cache:/home/user/.cargo/registry -e PUID="$(id -u)" -e PGID="$(id -g)" rustdesk-builder
+```
+
+Bedenke, dass das erste Mal Kompilieren länger dauern kann, da die Abhängigkeiten erst kompiliert werden müssen bevor sie zwischengespeichert werden können. Darauf folgende Kompiliervorgänge werden schneller sein. Falls du zusätzliche oder andere Argumente für den Kompilierbefehl angeben musst, kannst du diese am Ende des Befehls an der `<OPTIONAL-ARGS>` Position machen. Wenn du zum Beispiel eine optimierte Releaseversion kompilieren willst, kannst du das tun, indem du `--release` am Ende des Befehls anhängst. Das daraus entstehende Programm kannst du im “target” Ordner auf deinem System finden. Du kannst es mit folgenden Befehlen ausführen:
+
+```sh
+target/debug/rustdesk
+```
+
+Oder, wenn du eine Releaseversion benutzt:
+
+```sh
+target/release/rustdesk
+```
+
+Bitte gehe sicher, dass du diese Befehle vom Stammverzeichnis vom RustDesk Repository nutzt, sonst kann es passieren, dass das Programm die Ressourcen nicht finden kann. Bitte bedenke auch, dass Unterbefehle von Cargo, wie z. B. `install` oder `run` aktuell noch nicht unterstützt werden, da sie das Programm innerhalb des Containers starten oder installieren würden, anstatt auf deinem eigentlichen System.
+

content/dev/build/docker/_index.en.md

@@ -0,0 +1,35 @@
+---
+title: Docker 
+weight: 30
+---
+
+
+## How to build with Docker
+
+Begin by cloning the repository and building the docker container:
+
+```sh
+git clone https://github.com/rustdesk/rustdesk
+cd rustdesk
+docker build -t "rustdesk-builder" .
+```
+
+Then, each time you need to build the application, run the following command:
+
+```sh
+docker run --rm -it -v $PWD:/home/user/rustdesk -v rustdesk-git-cache:/home/user/.cargo/git -v rustdesk-registry-cache:/home/user/.cargo/registry -e PUID="$(id -u)" -e PGID="$(id -g)" rustdesk-builder
+```
+
+Note that the first build may take longer before dependencies are cached, subsequent builds will be faster. Additionally, if you need to specify different arguments to the build command, you may do so at the end of the command in the `<OPTIONAL-ARGS>` position. For instance, if you wanted to build an optimized release version, you would run the command above followed by `---release`. The resulting executable will be available in the target folder on your system, and can be run with:
+
+```sh
+target/debug/rustdesk
+```
+
+Or, if you're running a release executable:
+
+```sh
+target/release/rustdesk
+```
+
+Please ensure that you are running these commands from the root of the RustDesk repository, otherwise the application may be unable to find the required resources. Also note that other cargo subcommands such as `install` or `run` are not currently supported via this method as they would install or run the program inside the container instead of the host.

content/dev/build/docker/_index.fr.md

@@ -0,0 +1,34 @@
+---
+title: Docker 
+weight: 30
+---
+
+## Comment construire avec Docker
+
+Commencez par cloner le dépôt et construire le conteneur Docker :
+
+```sh
+git clone https://github.com/rustdesk/rustdesk
+cd rustdesk
+docker build -t "rustdesk-builder" .
+```
+
+Ensuite, chaque fois que vous devez compiler le logiciel, exécutez la commande suivante :
+
+```sh
+docker run --rm -it -v $PWD:/home/user/rustdesk -v rustdesk-git-cache:/home/user/.cargo/git -v rustdesk-registry-cache:/home/user/.cargo/registry -e PUID="$(id -u)" -e PGID="$(id -g)" rustdesk-builder
+```
+
+Notez que la première compilation peut prendre plus de temps avant que les dépendances ne soient mises en cache, les compilations suivantes seront plus rapides. De plus, si vous devez spécifier différents arguments à la commande de compilation, vous pouvez le faire à la fin de la commande à la position `<OPTIONAL-ARGS>`. Par exemple, si vous voulez compiler une version de release optimisée, vous devez exécuter la commande ci-dessus suivie de `---release`. L'exécutable résultant sera disponible dans le dossier cible sur votre système, et peut être lancé avec :
+
+```sh
+target/debug/rustdesk
+```
+
+Ou, si vous exécutez un exécutable provenant d'une release :
+
+```sh
+target/release/rustdesk
+```
+
+Veuillez vous assurer que vous exécutez ces commandes à partir de la racine du dépôt RustDesk, sinon l'application ne pourra pas trouver les ressources requises. Notez également que les autres sous-commandes de cargo telles que `install` ou `run` ne sont pas actuellement supportées par cette méthode car elles installeraient ou exécuteraient le programme à l'intérieur du conteneur au lieu de l'hôte.

content/dev/build/docker/_index.it.md

@@ -0,0 +1,34 @@
+---
+title: Docker 
+weight: 30
+---
+
+## Come compilare con Docker
+
+Cominciare clonando il repository e compilare i container docker:
+
+```sh
+git clone https://github.com/rustdesk/rustdesk
+cd rustdesk
+docker build -t "rustdesk-builder" .
+```
+
+Quindi, ogni volta che devi compilare l'applicazione, esegui il comando seguente:
+
+```sh
+docker run --rm -it -v $PWD:/home/user/rustdesk -v rustdesk-git-cache:/home/user/.cargo/git -v rustdesk-registry-cache:/home/user/.cargo/registry -e PUID="$(id -u)" -e PGID="$(id -g)" rustdesk-builder
+```
+
+Tieni presente che la prima build potrebbe richiedere più tempo prima che le dipendenze vengano memorizzate nella cache, le build successive saranno più veloci. Inoltre, se hai bisogno di specificare argomenti diversi per il comando build, puoi farlo alla fine del comando nella posizione `<OPTIONAL-ARGS>`. Ad esempio, se si desidera creare una versione di rilascio ottimizzata, eseguire il comando sopra seguito da `---release`. L'eseguibile generato sarà creato nella cartella di destinazione del proprio sistema e può essere eseguito con:
+
+```sh
+target/debug/rustdesk
+```
+
+Oppure, se si sta eseguendo un eseguibile di rilascio:
+
+```sh
+target/release/rustdesk
+```
+
+Assicurati di eseguire questi comandi dalla radice del repository RustDesk, altrimenti l'applicazione potrebbe non essere in grado di trovare le risorse richieste. Notare inoltre che altri sottocomandi cargo come `install` o `run` non sono attualmente supportati tramite questo metodo poiché installerebbero o eseguirebbero il programma all'interno del container anziché nell'host.

content/dev/build/docker/_index.ja.md

@@ -0,0 +1,35 @@
+---
+title: Docker 
+weight: 30
+---
+
+## Dockerでビルドする方法
+
+リポジトリのクローンを作成し、Dockerコンテナを構築することから始めます。
+
+```sh
+git clone https://github.com/rustdesk/rustdesk
+cd rustdesk
+docker build -t "rustdesk-builder" .
+```
+
+その後、アプリケーションをビルドする必要があるたびに、以下のコマンドを実行します。
+
+```sh
+docker run --rm -it -v $PWD:/home/user/rustdesk -v rustdesk-git-cache:/home/user/.cargo/git -v rustdesk-registry-cache:/home/user/.cargo/registry -e PUID="$(id -u)" -e PGID="$(id -g)" rustdesk-builder
+```
+
+なお、最初のビルドでは、依存関係がキャッシュされるまで時間がかかることがありますが、その後のビルドではより速くなります。さらに、ビルドコマンドに別の引数を指定する必要がある場合は、コマンドの最後にある `<OPTIONAL-ARGS>` の位置で指定することができます。例えば、最適化されたリリースバージョンをビルドしたい場合は、上記のコマンドの後に
+`---release` を実行します。できあがった実行ファイルは、システムのターゲット・フォルダに格納され、次のコマンドで実行できます。
+
+```sh
+target/debug/rustdesk
+```
+
+あるいは、リリース用の実行ファイルを実行している場合:
+
+```sh
+target/release/rustdesk
+```
+
+これらのコマンドをRustDeskリポジトリのルートから実行していることを確認してください。そうしないと、アプリケーションが必要なリソースを見つけられない可能性があります。また、 `install` や `run` などの他の cargo サブコマンドは、ホストではなくコンテナ内にプログラムをインストールまたは実行するため、現在この方法ではサポートされていないことに注意してください。

content/dev/build/docker/_index.pt.md

@@ -0,0 +1,34 @@
+---
+title: Docker 
+weight: 30
+---
+
+## Como compilar com Docker
+
+Comece clonando o repositório e montando o container docker:
+
+```sh
+git clone https://github.com/rustdesk/rustdesk
+cd rustdesk
+docker build -t "rustdesk-builder" .
+```
+
+Então, sempre que precisar compilar a aplicação, execute este comando:
+
+```sh
+docker run --rm -it -v $PWD:/home/user/rustdesk -v rustdesk-git-cache:/home/user/.cargo/git -v rustdesk-registry-cache:/home/user/.cargo/registry -e PUID="$(id -u)" -e PGID="$(id -g)" rustdesk-builder
+```
+
+Note que a primeira compilação pode demorar mais antes que as dependências sejam armazenadas em cache, as compilações subsequentes serão mais rápidas. Adicionalmente, se você precisar especificar argumentos diferentes para o comando de compilação, você pode fazê-lo ao final do comando na posição do `<OPTIONAL-ARGS>`. Por exemplo, se você gostaria de compilar uma versão de release otimizada, você executaria o comando acima seguido de `--release`. O executável gerado estará disponível no diretório alvo no seu sistema, e pode ser executado com:
+
+```sh
+target/debug/rustdesk
+```
+
+Ou, se estiver rodando um executável de release:
+
+```sh
+target/release/rustdesk
+```
+
+Por favor verifique que está executando estes comandos da raiz do repositório do RustDesk, senão a aplicação pode não encontrar os recursos necessários. Note também que outros subcomandos do cargo como `install` ou `run` não são suportados atualmente via este método, já que eles iriam instalar ou rodar o programa dentro do container ao invés do host.

content/dev/build/docker/_index.ru.md

@@ -0,0 +1,34 @@
+---
+title: Docker 
+weight: 30
+---
+
+## Как собрать с помощью Docker
+
+Начните с клонирования репозитория и создания docker контейнера:
+
+```sh
+git clone https://github.com/rustdesk/rustdesk
+cd rustdesk
+docker build -t "rustdesk-builder" .
+```
+
+Затем каждый раз, когда вам нужно собрать приложение, запускайте следующую команду:
+
+```sh
+docker run --rm -it -v $PWD:/home/user/rustdesk -v rustdesk-git-cache:/home/user/.cargo/git -v rustdesk-registry-cache:/home/user/.cargo/registry -e PUID="$(id -u)" -e PGID="$(id -g)" rustdesk-builder
+```
+
+Обратите внимание, что первая сборка может занять больше времени, прежде чем зависимости будут кэшированы, последующие сборки будут выполняться быстрее. Кроме того, если вам нужно указать другие аргументы для команды сборки, вы можете сделать это в конце команды в позиции `<OPTIONAL-ARGS>`. Например, если вы хотите создать оптимизированную версию, вы должны запустить приведенную выше команду, а затем `---release`. Полученный исполняемый файл будет доступен в целевой папке вашей системы и может быть запущен с помощью:
+
+```sh
+target/debug/rustdesk
+```
+
+Или, если вы используете исполняемый файл релиза:
+
+```sh
+target/release/rustdesk
+```
+
+Пожалуйста, убедитесь, что вы запускаете эти команды из корня репозитория RustDesk, иначе приложение не сможет найти необходимые ресурсы. Также обратите внимание, что другие cargo подкоманды, такие как `install` или `run`, в настоящее время не поддерживаются этим методом, поскольку они будут устанавливать или запускать программу внутри контейнера, а не на хосте.

content/dev/build/docker/_index.zh-cn.md

@@ -0,0 +1,86 @@
+---
+title: Docker 
+weight: 30
+---
+
+## 使用 Docker 编译
+
+首先克隆存储库并构建 docker 容器：
+
+```sh
+git clone https://github.com/rustdesk/rustdesk
+cd rustdesk
+docker build -t "rustdesk-builder" .
+```
+
+针对国内网络访问问题，可以做以下几点优化：
+
+1. Dockerfile 中修改系统的源到国内镜像
+
+   ```
+   在Dockerfile的RUN apt update之前插入两行：
+
+   RUN sed -i "s/deb.debian.org/mirrors.163.com/g" /etc/apt/sources.list
+   RUN sed -i "s/security.debian.org/mirrors.163.com/g" /etc/apt/sources.list
+   ```
+
+2. 修改容器系统中的 cargo 源，在`RUN ./rustup.sh -y`后插入下面代码：
+
+   ```
+   RUN echo '[source.crates-io]' > ~/.cargo/config \
+    && echo 'registry = "https://github.com/rust-lang/crates.io-index"'  >> ~/.cargo/config \
+    && echo '# 替换成你偏好的镜像源'  >> ~/.cargo/config \
+    && echo "replace-with = 'sjtu'"  >> ~/.cargo/config \
+    && echo '# 上海交通大学'   >> ~/.cargo/config \
+    && echo '[source.sjtu]'   >> ~/.cargo/config \
+    && echo 'registry = "https://mirrors.sjtug.sjtu.edu.cn/git/crates.io-index"'  >> ~/.cargo/config \
+    && echo '' >> ~/.cargo/config
+   ```
+
+3. Dockerfile 中加入代理的 env
+
+   ```
+   在User root后插入两行
+
+   ENV http_proxy=http://host:port
+   ENV https_proxy=http://host:port
+   ```
+
+4. docker build 命令后面加上 proxy 参数
+
+   ```
+   docker build -t "rustdesk-builder" . --build-arg http_proxy=http://host:port --build-arg https_proxy=http://host:port
+   ```
+
+然后，每次需要构建应用程序时，运行以下命令：
+
+```sh
+docker run --rm -it -v $PWD:/home/user/rustdesk -v rustdesk-git-cache:/home/user/.cargo/git -v rustdesk-registry-cache:/home/user/.cargo/registry -e PUID="$(id -u)" -e PGID="$(id -g)" rustdesk-builder
+```
+
+运行若遇到无权限问题，出现以下提示：
+
+```
+usermod: user user is currently used by process 1
+groupmod: Permission denied.
+groupmod: cannot lock /etc/group; try again later.
+```
+
+可以尝试把`-e PUID="$(id -u)" -e PGID="$(id -g)"`参数去掉。（出现这一问题的原因是容器中的 entrypoint 脚本中判定 uid 和 gid 与给定的环境变量不一致时会修改 user 的 uid 和 gid 重新运行，但是重新运行时取不到环境变量中的 uid 和 gid 了，会再次进入 uid 与 gid 与给定值不一致的逻辑分支）
+
+请注意，第一次构建可能需要比较长的时间，因为需要缓存依赖项（国内网络经常出现拉取失败，可多尝试几次），后续构建会更快。此外，如果您需要为构建命令指定不同的参数，
+您可以在命令末尾的 `<OPTIONAL-ARGS>` 位置执行此操作。例如，如果你想构建一个优化的发布版本，你可以在命令后跟 `---release`。
+将在 target 下产生可执行程序，请通过以下方式运行调试版本：
+
+```sh
+target/debug/rustdesk
+```
+
+或者运行发布版本:
+
+```sh
+target/release/rustdesk
+```
+
+请确保您从 RustDesk 存储库的根目录运行这些命令，否则应用程序可能无法找到所需的资源。另请注意，此方法当前不支持其他`Cargo`子命令，
+例如 `install` 或 `run`，因为运行在容器里，而不是宿主机上。

content/dev/build/docker/_index.zh-tw.md

@@ -0,0 +1,47 @@
+---
+title: Docker 
+weight: 30
+---
+
+## 使用 Docker 編譯
+
+首先克隆存儲庫並構建 docker 容器：
+
+```sh
+git clone https://github.com/rustdesk/rustdesk
+cd rustdesk
+docker build -t "rustdesk-builder" .
+```
+
+然後，每次需要構建應用程序時，運行以下命令：
+
+```sh
+docker run --rm -it -v $PWD:/home/user/rustdesk -v rustdesk-git-cache:/home/user/.cargo/git -v rustdesk-registry-cache:/home/user/.cargo/registry -e PUID="$(id -u)" -e PGID="$(id -g)" rustdesk-builder
+```
+
+運行若遇到無權限問題，出現以下提示：
+
+```
+usermod: user user is currently used by process 1
+groupmod: Permission denied.
+groupmod: cannot lock /etc/group; try again later.
+```
+
+可以嘗試把`-e PUID="$(id -u)" -e PGID="$(id -g)"`參數去掉。 （出現這一問題的原因是容器中的 entrypoint 腳本中判定 uid 和 gid 與給定的環境變量不一致時會修改 user 的 uid 和 gid 重新運行，但是重新運行時取不到環境變量中的 uid 和 gid 了，會再次進入 uid 與 gid 與給定值不一致的邏輯分支）
+
+請注意，第一次構建可能需要比較長的時間，因為需要緩存依賴項（國內網絡經常出現拉取失敗，可多嘗試幾次），後續構建會更快。此外，如果您需要為構建命令指定不同的參數，
+您可以在命令末尾的 `<OPTIONAL-ARGS>` 位置執行此操作。例如，如果你想構建一個優化的發布版本，你可以在命令後跟 `---release`。
+將在 target 下產生可執行程序，請通過以下方式運行調試版本：
+
+```sh
+target/debug/rustdesk
+```
+
+或者運行發布版本:
+
+```sh
+target/release/rustdesk
+```
+
+請確保您從 RustDesk 存儲庫的根目錄運行這些命令，否則應用程序可能無法找到所需的資源。另請注意，此方法當前不支持其他`Cargo`子命令，
+例如 `install` 或 `run`，因為運行在容器裡，而不是宿主機上。