docs(ko): translate rustdesk-server-pro

2026-07-20 13:49:18 +00:00 · 2026-07-06 17:51:07 +09:00
parent e268815f19
commit 591a0cdbdf
19 changed files with 2778 additions and 0 deletions
@@ -0,0 +1,96 @@
+---
+title: Docker
+weight: 3
+description: "호스트 네트워킹을 사용하여 Docker Compose를 통해 RustDesk 서버 프로를 설치하기. 이 안내서를 사용해 제공된 compose 파일로 hbbs, hbbr 및 Pro 웹 콘솔을 배포하세요."
+keywords: ["rustdesk server pro docker", "rustdesk pro docker compose", "rustdesk pro host network", "rustdesk hbbs hbbr docker", "rustdesk self-host pro docker"]
+---
+
+이 안내서를 사용하여 Docker Compose와 필요한 호스트 네트워킹 구성으로 RustDesk Server Pro를 설치하기 바랍니다.
+
+## RustDesk Server Pro의 권장 Docker 설정은 무엇인가요?
+
+`network_mode: "host"`를 사용한 Docker Compose는 대부분의 Linux 기반 RustDesk Server Pro 배포에 권장되는 설정입니다. 이 방법은 `hbbs`와 `hbbr`를 하나의 재현 가능한 구성으로 함께 유지하며, 호스트 네트워킹을 사용하지 않을 경우 발생할 수 있는 라이선스 문제를 피할 수 있습니다.
+
+## RustDesk Server Pro Docker 체크리스트
+
+1. Docker를 설치하기.
+2. 키 및 데이터베이스와 같은 RustDesk 파일을 위한 영구 `data` 디렉터리를 생성하세요.
+3. Docker Compose로 `hbbs`와 `hbbr`를 시작하세요.
+4. 필요한 RustDesk 포트를 열어주세요. 특히 웹 콘솔을 직접 사용하는 경우 `21114` 포트를 열어야 합니다.
+5. 도메인 뒤에 웹 콘솔을 원한다면 HTTPS를 별도로 추가하세요.
+
+## 언제 원시 `docker run` 대신 Compose를 사용해야 하나요?
+
+장기적인 프로덕션 배포 및 업그레이드에는 Docker Compose를 사용하세요. 원시 `docker run` 명령어는 주로 테스트, 디버깅 또는 각 컨테이너에 대한 완전한 수동 제어가 필요한 환경에서 사용하세요.
+
+## Docker Compose(권장)
+
+Docker Compose를 사용하려면 라이선스가 작동하도록 `network_mode: "host"`를 반드시 사용해야 합니다. 이 [guide](https://docs.docker.com/engine/install)를 사용해 Docker를 설치하여 최신 버전을 보장하세요!
+
+아래 내용을 `compose.yml`에 복사하세요.
+
+```yaml
+services:
+  hbbs:
+    container_name: hbbs
+    image: docker.io/rustdesk/rustdesk-server-pro:latest
+    command: hbbs
+    volumes:
+      - ./data:/root
+    network_mode: "host"
+
+    depends_on:
+      - hbbr
+    restart: unless-stopped
+
+  hbbr:
+    container_name: hbbr
+    image: docker.io/rustdesk/rustdesk-server-pro:latest
+    command: hbbr
+    volumes:
+      - ./data:/root
+    network_mode: "host"
+    restart: unless-stopped
+```
+
+그런 다음 `sudo docker compose up -d` 또는 `podman-compose up -d`를 실행하십시오.
+
+> `podman-compose` 설치용 `sudo apt install podman-compose`
+
+{{% notice note %}}
+[Set up HTTPS for web console manually](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/faq/#set-up-https-for-web-console-manually)를 사용하는 방법.
+{{% /notice %}}
+
+## Docker 명령어
+
+이 [guide](https://docs.docker.com/engine/install)를 사용해 Docker를 설치하면 가장 최신 버전을 보장할 수 있습니다!
+
+또는 이 단일 명령어로 Docker를 설치할 수도 있습니다.
+
+```
+bash <(wget -qO- https://get.docker.com)
+```
+
+다음 명령어를 실행하십시오(s6 이미지에는 `./data:/root` 대신 `./data:/data`가 필요할 수 있음):
+
+```sh
+sudo docker image pull rustdesk/rustdesk-server-pro
+sudo docker run --name hbbs -v ./data:/root -td --net=host --restart unless-stopped docker.io/rustdesk/rustdesk-server-pro hbbs
+sudo docker run --name hbbr -v ./data:/root -td --net=host --restart unless-stopped docker.io/rustdesk/rustdesk-server-pro hbbr
+```
+
+{{% notice note %}}
+위의 예제에서는 `sudo`와 `--net=host`를 사용합니다. 이는 Windows에서 작동하지 않으니 해당 명령어를 제거해 주세요. 만약 `--net=host`를 제거하신다면 아래를 확인해 주세요.
+{{% /notice %}}
+
+```sh
+macaddrhbbs=$(echo -n A0-62-2F; dd bs=1 count=3 if=/dev/random 2>/dev/null |hexdump -v -e '/1 "-%02X"')
+sudo docker run --name hbbs -p 21114:21114 -p 21115:21115 -p 21116:21116 -p 21116:21116/udp -p 21118:21118 -v ./data:/root -td --mac-address="$macaddrhbbs" --restart unless-stopped docker.io/rustdesk/rustdesk-server-pro hbbs
+sudo docker run --name hbbr -p 21117:21117 -p 21119:21119 -v ./data:/root -td --restart unless-stopped docker.io/rustdesk/rustdesk-server-pro hbbr
+```
+
+{{% notice note %}}
+[Set up HTTPS for web console manually](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/faq/#set-up-https-for-web-console-manually) 사용 방법.
+{{% /notice %}}
+
+> Fedora에서 SELinux로 문제가 발생하면 이 [issue](https://github.com/rustdesk/rustdesk-server/issues/230)를 확인해 보세요.
@@ -0,0 +1,102 @@
+---
+title: install.sh
+weight: 4
+description: "라이선스를 받은 후 install.sh 스크립트를 사용하여 Linux에 RustDesk 서버 Pro를 설치하기 바랍니다. 이 방법은 Pro 서버 구성 요소의 간단한 스크립트 설정에 사용됩니다."
+keywords: ["rustdesk server pro install.sh", "rustdesk pro linux install", "rustdesk pro script install", "rustdesk self-host pro linux", "rustdesk server pro setup"]
+---
+
+자신만의 서비스 설정을 처음부터 작성하지 않고 간단한 Linux 기반 RustDesk Server Pro 설치를 원할 때는 `install.sh` 방법을 사용하세요.
+
+{{% notice note %}}
+[https://rustdesk.com/pricing/](https://rustdesk.com/pricing/)에서 라이선스를 받는 것을 잊지 마세요. 더 자세한 내용은 [license](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/license/) 페이지를 확인해 주세요.
+
+이 간단한 설치를 하기 전에 먼저 [OSS installation](https://rustdesk.com/docs/en/self-host/rustdesk-server-oss/install/)를 읽어보시기 바랍니다. 여기서 더 깊이 있는 세부 정보를 알 수 있습니다.
+{{% /notice %}}
+
+## install.sh는 언제 사용해야 하나요?
+
+`systemd`가 있는 Linux 호스트에 RustDesk Server Pro를 가장 빠르게 배포하려면 `install.sh`를 사용하세요. 스크립트가 종속성 설치, 바이너리 배치, 서비스 생성을 수행하고, 선택적으로 웹 콘솔용 HTTPS를 준비하기를 원하는 간단한 단일 서버 설정에 가장 적합합니다.
+
+## install.sh 빠른 답변
+
+- `systemd`를 사용한 간단한 Linux 배포에는 이 방법을 사용하십시오.
+- 더 쉬운 업그레이드, 롤백 및 컨테이너 기반 운영을 원하시면 대신 [Docker](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/installscript/docker/#docker-compose)를 사용하십시오.
+- 시작하기 전에 Pro 라이선스를 준비해 두십시오.
+- 도메인을 사용하는 경우 스크립트가 HTTPS를 위해 `nginx`와 `certbot`도 설정할 수 있습니다.
+- 첫 번째 설치 후 업그레이드에는 `update.sh`를 사용하십시오.
+
+## 설치하기
+
+위의 명령어를 복사하여 Linux 터미널에 붙여넣어 RustDesk 서버 프로를 설치하세요.
+
+`wget -qO- https://raw.githubusercontent.com/rustdesk/rustdesk-server-pro/main/install.sh | bash`
+
+{{% notice note %}}
+[the Docker image](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/installscript/docker/#docker-compose) 사용을 권장합니다. 솔루션 배포와 업데이트 과정이 크게 간소화됩니다. 리소스 소비량도 매우 낮습니다.
+
+또한, 위의 명령어는 쓰기 권한이 없는 디렉터리가 아닌 홈 디렉터리에서 실행해 주세요.
+{{% /notice %}}
+
+이것이 하는 일:
+
+- 일부 종속성 설치하기
+- 사용 가능한 경우 UFW 방화벽 설정하기
+- 작업 디렉터리 `/var/lib/rustdesk-server`와 로그 디렉터리 `/var/log/rustdesk-server` 생성하기
+- 실행 파일을 `/usr/bin`에 설치하기
+- RustDesk Pro 서비스를 다운로드하고 위 폴더에 압축 해제하기
+- hbbs 및 hbbr용 systemd 서비스 생성하기(서비스 이름은 `rustdesk-hbbs.service` 및 `rustdesk-hbbr.service`)
+- 도메인을 선택하면 Nginx와 Certbot이 설치되어 API가 포트 `443`(HTTP)에서 이용 가능하며, 포트 `80`를 통해 SSL 인증서를 받게 됩니다. 이 인증서는 자동으로 갱신됩니다. HTTPS가 준비되면, `https://yourdomain.com:21114` 대신 `https://yourdomain.com`로 접속해 주세요.
+
+{{% notice note %}}
+[Set up HTTPS for web console manually](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/faq/#set-up-https-for-web-console-manually)를 사용하는 방법.
+{{% /notice %}}
+
+{{% notice note %}}
+systemd 서비스가 시작되지 않으면, 아마도 SELinux와 관련이 있을 수 있으니 [this](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/faq/#selinux)를 확인해 보세요.
+{{% /notice %}}
+
+{{% notice note %}}
+클라이언트가 서버에 연결되지 않거나 웹 콘솔에 접근할 수 없는 경우, [this](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/faq/#firewall)를 확인해 보세요.
+{{% /notice %}}
+
+## 업그레이드
+
+위의 명령어를 복사하여 Linux 터미널에 붙여넣어 기존 RustDesk Server Pro 설치를 업그레이드하세요. 이 명령어는 로컬에 저장하여 cron으로 예약할 수도 있습니다.
+
+`wget -qO- https://raw.githubusercontent.com/rustdesk/rustdesk-server-pro/main/update.sh | bash`
+
+{{% notice note %}}
+이 스크립트에서 문제가 발생하면, 스크립트를 하나씩 직접 실행해 보시기를 권장합니다.
+
+또한 홈 디렉터리에서 위 명령어를 실행해 주세요. 쓰기 권한이 없는 디렉터리에서는 실행하지 마세요.
+{{% /notice %}}
+
+이것이 하는 일:
+
+- RustDesk Server Pro의 새로운 버전을 확인합니다.
+- 새로운 버전이 발견되면 API 파일을 제거하고 새 실행파일과 API 파일을 다운로드합니다.
+
+## 오픈소스에서 변환하기
+
+위의 명령어를 복사하여 Linux 터미널에 붙여넣어 RustDesk Server를 RustDesk Server Pro로 변환하세요.
+
+`wget -qO- https://raw.githubusercontent.com/rustdesk/rustdesk-server-pro/main/convertfromos.sh | bash`
+
+{{% notice note %}}
+방화벽에 `21114` TCP 포트를 추가해 주세요. 이는 RustDesk 클라이언트의 웹 콘솔 및 사용자 로그인을 위한 추가 포트입니다.
+{{% /notice %}}
+
+{{% notice note %}}
+이 스크립트와 관련된 문제가 발생하면 Docker 설치로 전환하는 것을 권장합니다. 또는 스크립트를 직접 살펴보고 단계별로 수동으로 실행할 수도 있습니다.
+{{% /notice %}}
+
+기능:
+
+- 이전 서비스를 비활성화하고 제거합니다.
+- 일부 종속성을 설치합니다.
+- 사용 가능한 경우 UFW 방화벽을 설정합니다.
+- `/var/lib/rustdesk-server` 폴더를 생성하고 여기에 인증서를 복사합니다.
+- `/var/log/rustdesk`를 삭제하고 `/var/log/rustdesk-server`를 생성합니다.
+- RustDesk Pro 서비스를 다운로드하여 위 폴더에 압축 해제합니다.
+- hbbs 및 hbbr용 systemd 서비스를 생성합니다(서비스 이름은 rustdesk-hbbs.service 및 rustdesk-hbbr.service입니다).
+- 도메인을 선택하면 Nginx와 Certbot이 설치되어 API가 포트 443(HTTP)에서 이용 가능하며, 포트 80을 통해 SSL 인증서를 받고 자동으로 갱신됩니다.
@@ -0,0 +1,53 @@
+---
+title: 설치
+weight: 2
+description: "Docker, Linux 설치 스크립트 또는 이전 Windows 방법을 사용해 RustDesk 서버 Pro를 설치하기. 여기에서 시작하여 환경에 맞는 올바른 배포 경로를 선택하세요."
+keywords: ["rustdesk server pro install", "rustdesk self-host pro", "rustdesk pro docker", "rustdesk pro linux install", "rustdesk pro windows install"]
+---
+
+환경에 가장 적합한 RustDesk Server Pro 설치 방법을 선택하려면 여기에서 시작하세요. 권장 옵션은 Docker입니다.
+
+## RustDesk Server Pro를 설치하는 가장 좋은 방법은 무엇인가요?
+
+대부분의 팀에서는 Docker가 RustDesk Server Pro를 설치하는 가장 좋은 방법입니다. 업데이트가 간편하고 배포 과정이 재현하기 쉽기 때문입니다. `install.sh` 경로는 Linux에서 네이티브 systemd 서비스를 원할 때 유용합니다. 이미 RustDesk 서버를 운영 중이고 Pro로 계속 이동하고자 한다면 OSS에서 변환하는 것이 적합한 경로입니다.
+
+## 시작하기 전에 무엇이 필요하나요?
+
+- RustDesk Server Pro 라이선스
+- Linux 서버 또는 VM, 또는 이미 Docker가 설치된 호스트
+- 방화벽에서 필요한 RustDesk 포트가 열려 있어야 하며, 웹 콘솔과 API가 필요하다면 `21114` 또는 `443`도 열려 있어야 합니다.
+- 도메인에 HTTPS를 적용하려면 선택적 DNS 이름이 필요합니다.
+
+## 어떤 설치 방법을 선택해야 하나요?
+
+| 방법 | 최적의 사용처 | 사용하는 이유 |
+| --- | --- | --- |
+| Docker | 대부분의 새로운 Pro 배포 | 가장 쉬운 업그레이드, 간편한 롤백 및 일관된 설정 |
+| `install.sh` | 기본 서비스를 원하는 Linux 관리자 | systemd 서비스를 생성하고 선택적으로 Nginx와 Certbot을 설정할 수 있음 |
+| 오픈소스에서 변환 | 기존 OSS 배포 | 기존 RustDesk 서버 설치를 제로부터 시작하지 않고 Pro로 이동함 |
+
+## 방법 1: Docker (권장)
+
+```
+bash <(wget -qO- https://get.docker.com)
+wget rustdesk.com/pro.yml -O compose.yml
+sudo docker compose up -d
+```
+
+자세한 내용은 [Docker](/docs/ko/self-host/rustdesk-server-pro/installscript/docker/)를 확인하십시오.
+
+## 방법 2: install.sh
+
+Linux에 능숙하다면 아래 스크립트를 사용하십시오. 그렇지 않으면 실패할 경우 심각한 문제가 발생할 수 있으며, 왜 작동하지 않는지 파악하기 어려울 수 있습니다.
+
+`bash <(wget -qO- https://raw.githubusercontent.com/rustdesk/rustdesk-server-pro/main/install.sh)`
+
+자세한 내용은 [install.sh](/docs/ko/self-host/rustdesk-server-pro/installscript/script/)를 확인하십시오.
+
+## 오픈소스에서 변환하기
+
+### Docker
+Docker를 사용해 오픈소스 버전을 설치한 경우, 이를 직접 변환할 수 있는 방법은 없습니다. 대신 Pro 이미지로 새 컨테이너를 실행해야 합니다. 이를 수행하기 전에 개인 키(파일명 `id_ed25519`, `id_ed25519.pub`가 아님)를 백업해 두십시오. 새 컨테이너가 설정되면 기존의 `id_ed25519` 개인 키 파일을 새 컨테이너의 작업 디렉터리로 복사한 다음, 컨테이너를 다시 시작하십시오.
+
+### install.sh
+install.sh를 사용해 오픈소스 버전을 설치한 경우, [this](/docs/ko/self-host/rustdesk-server-pro/installscript/script/#convert-from-open-source)를 따르십시오.
@@ -0,0 +1,77 @@
+---
+title: Windows 설치(사용 중단됨)
+weight: 5
+description: "Windows에서 RustDesk Server Pro를 설치하는 레거시 가이드입니다. 사전 요구사항, 라이선스 설정 및 다운로드 단계가 포함되어 있지만, 대신 Linux 또는 Docker를 사용하는 것이 좋습니다."
+keywords: ["rustdesk server pro windows", "rustdesk pro windows install", "rustdesk self-host pro windows", "rustdesk windows install deprecated", "rustdesk pro license windows"]
+---
+
+이것은 RustDesk Server Pro의 레거시 Windows 설치 경로입니다. 가능하면 대신 Linux 또는 Docker를 사용하십시오.
+
+{{% notice note %}}
+Windows 보안 정책은 까다롭습니다. 이 튜토리얼이 작동하지 않거나 불안정한 연결을 경험한다면, Linux 서버로 마이그레이션해 주세요.
+{{% /notice %}}
+
+{{% notice note %}}
+GUI 버전인 `RustDeskServer.setup.exe`는 더 이상 유지보수가 되지 않으므로 권장하지 않습니다.
+{{% /notice %}}
+
+## Windows 설치 경로를 사용해야 하나요?
+
+이 가이드는 RustDesk Server Pro 호스트가 반드시 Windows에 있어야 할 때만 사용하십시오. 새로운 자체 호스팅 배포의 경우, Linux나 Docker가 더 나은 기본 옵션입니다. 자동화, 업데이트 및 안정적인 운영이 더 쉽기 때문입니다.
+
+## Windows 설치 빠른 답변
+
+- 이 경로는 레거시 경로로 간주하며, 선호하는 배포 방식은 아닙니다.
+- 시작하기 전에 Microsoft Visual C++ 재배포 가능 패키지를 설치하세요.
+- 오래된 GUI 설치 프로그램은 더 이상 유지보수가 되지 않습니다.
+- 장기적으로 안정적인 배포가 필요하다면, Linux나 Docker로 이동하세요.
+- Windows에 계속 머무를 경우, 서비스를 어떻게 실행하고 웹 콘솔을 어떻게 프록시할지 계획하세요.
+
+## 설치
+
+Windows에서 rustdesk를 실행하려면 Microsoft Visual C++ 재배포 가능 패키지가 필요합니다. 이를 [here](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist)에서 다운로드할 수 있습니다.
+
+1. [https://rustdesk.com/pricing.html](https://rustdesk.com/pricing.html)에서 라이선스를 받고, 자세한 내용은 [license](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/license/) 페이지를 확인하세요.
+2. [GitHub](https://github.com/rustdesk/rustdesk-server-pro/releases/latest)에서 Windows 설치 프로그램을 다운로드하세요.
+3. Windows 설치 프로그램을 압축 해제하세요.
+4. 설치 프로그램을 실행하고 화면에 표시된 단계를 따르세요. 또는 [PM2 or NSSM](https://rustdesk.com/docs/en/self-host/rustdesk-server-oss/windows/)를 사용해 수동으로 설치하세요.
+5. 설치가 완료되면 RustDesk 서버를 엽니다.
+6. 안내에 따라 설치를 진행하세요.
+7. `Services`를 클릭한 다음 `Start`를 클릭하세요.
+8. 설치가 완료되면 `http://youripaddress:21114`로 이동하세요.
+9. 사용자 이름 `admin`와 비밀번호 `test1234`로 로그인하세요.
+10. 1단계에서 구매한 라이선스 코드를 입력하세요.
+
+## IIS를 프록시로 사용하기
+
+`Dynamic Content Compression`가 설치되어 있는지 확인하세요(이는 서버 역할과 함께 설치할 수 있는 IIS 기능입니다).
+1. IIS를 열거나 설치하세요.
+2. RustDesk용 새 웹사이트를 생성하고 바인딩(이상적으로 443)과 관련 인증서를 설정하세요. 기본 설정은 이 웹사이트를 빈 폴더로 지정해야 합니다. (기본 사이트를 사용하는 경우, 해당 폴더에 다른 파일이 없도록 하세요).
+3. IIS에서 [Application Request Routing](https://www.iis.net/downloads/microsoft/application-request-routing)와 [URL Rewrite](https://learn.microsoft.com/en-us/iis/extensions/url-rewrite-module/using-the-url-rewrite-module)를 설치하세요.
+
+## 애플리케이션 요청 라우팅
+
+1. IIS 서버 호스트 아래에서 애플리케이션 요청 라우팅을 엽니다.
+2. 서버 프록시 설정으로 이동하세요.
+3. 프록시를 활성화하면 모든 설정이 표시되며, 기본값으로 두어도 됩니다.
+4. 설정을 저장한 후 다음 단계인 URL 다시쓰기로 넘어갈 수 있습니다.
+
+## URL 다시쓰기
+
+1. 왼쪽 창에서 IIS의 사이트를 열고 URL 다시 쓰기를 두 번 클릭하세요.
+2. `Add rules`를 클릭하세요.
+3. 새 리버스 프록시 규칙을 설정하세요.
+4. 로컬 주소(21114 주소)를 설정하세요.  
+인바운드 규칙 – RustDesk 내부 21114 주소  
+아웃바운드 규칙 – `From`는 RustDesk 내부 21114 주소이고, `To`는 외부 주소입니다.  
+노트: 주소 앞에 http/https를 붙이지 마세요 – 자동으로 처리됩니다. 또한 모든 주소가 내부와 외부에서 모두 접근 가능하도록 확인하세요.
+
+## 압축
+
+1. `Dynamic Content Compression`를 비활성화하세요.
+
+## 문제 해결
+
+오류 500.52가 발생한 경우, 언급된 변수를 추가하세요: [IIS acting as reverse proxy: Where the problems start](https://techcommunity.microsoft.com/t5/iis-support-blog/iis-acting-as-reverse-proxy-where-the-problems-start/ba-p/846259).
+
+SSL 설정을 'SSL 필요 → 무시'로 변경해야 할 수 있습니다.