버전 업데이트

새 버전으로 업데이트

업데이트는 프로그램만 교체합니다. 설정, 크레딧, 공유 파일 기록, 미완료 다운로드, 완료된 파일은 새 버전이 덮어쓰지 않는 위치에 보관되므로, 대부분의 시스템에서는 기존 버전 위에 새 버전을 설치하면 업데이트가 끝납니다. 유일한 예외는 Windows ZIP입니다. 이 경우 데이터가 프로그램 폴더 안에 있으므로, 압축을 풀기 전에 해당 항목을 먼저 읽어 보세요.

데이터 위치

사용 환경	프로그램	내 데이터
Windows 설치 프로그램	`C:\Program Files\eMule Qt`	`%LOCALAPPDATA%\eMuleQt`, 내부에 `Incoming`과 `Temp` 포함
Windows ZIP (포터블)	압축을 푼 `eMule` 폴더	같은 폴더: `emuleqt.exe` 옆의 `config`, `Incoming`, `Temp`
macOS	응용 프로그램 폴더의 `emuleqt.app`	`~/eMuleQt/Config`, `~/eMuleQt/Incoming`, `~/eMuleQt/Temp`
Linux	tarball의 `eMuleQt` 폴더	`~/eMuleQt/Config`, `~/eMuleQt/Incoming`, `~/eMuleQt/Temp`
Docker	이미지	`/config` 및 `/data` 볼륨

옵션에서 Incoming, Temp 또는 공유 폴더를 다른 곳으로 옮겼다면 지정한 위치에 그대로 남아 있습니다. 어떤 업데이트도 이 폴더들을 건드리지 않습니다.

업데이트 전 준비

eMule Qt와 코어를 종료하세요. 창과 코어(emulecored)는 서로 다른 두 프로그램입니다. 상태 표시줄의 체인 아이콘이 끊어져 있으면 코어가 분리된 상태이며, 창을 닫아도 계속 실행됩니다. 작업 관리자, 활동 상태 보기 또는 pgrep emulecored로 emulecored가 남아 있지 않은지 확인하세요.
config 폴더를 백업하세요. 용량이 작으니 복사해 두어도 손해가 없습니다. 일반적인 업데이트에서는 Temp의 미완료 다운로드는 백업하지 않아도 됩니다.

Windows 설치 프로그램

다운로드 페이지에서 새 설치 파일(eMuleQt-vX.Y.Z-win64-setup.exe)을 내려받으세요.
실행하세요. 기존 설치를 찾아 같은 폴더에 새 버전을 설치합니다. 실행 중인 eMule Qt와 코어는 자동으로 종료됩니다.
“eMule에서 설정 가져오기”는 체크하지 마세요. 업데이트 시에는 eMule Qt 프로필이 이미 사용 중이므로 기본적으로 체크가 해제되어 있습니다.
eMule Qt를 시작하세요.

먼저 제거할 필요는 없습니다. 제거하더라도 제거 프로그램은 %LOCALAPPDATA%\eMuleQt를 건드리지 않습니다.

Windows ZIP (포터블)

포터블 버전에서는 config 폴더가 프로그램 폴더 안에 있고, ZIP에도 자체 config 폴더가 들어 있습니다. ZIP의 config 폴더에 들어 있는 파일은 다음과 같습니다.

교체해야 하는 프로그램 파일: eMule.tmpl, webserver 폴더, nodes.ed3knod, GeoLite2-Country.mmdb.
자신의 사본을 유지해야 하는 초기 파일: server.met, nodes.dat, webservices.dat, FakeFileFilter.dat. ZIP이 이 파일들을 덮어쓰면 서버 목록과 Kad 연락처가 배포 당시의 상태로 돌아갑니다. 문제가 생기지는 않지만 그동안 쌓은 목록은 사라집니다.

개인 파일은 ZIP에 전혀 들어 있지 않습니다: preferences.yml, preferences.dat, cryptkey.dat, clients.met, known.met, Temp의 .part 파일, 완료된 다운로드. 압축을 풀어도 이 파일들은 영향을 받지 않습니다.

업데이트 방법

eMule Qt와 코어를 종료하세요 (위 내용 참조).
새 버전을 임시 폴더에 압축 해제하세요. 기존 설치 폴더 위에 풀면 안 됩니다.
임시 eMule\config 폴더에서 server.met, nodes.dat, webservices.dat, FakeFileFilter.dat를 삭제하세요.
임시 eMule 폴더의 모든 내용을 기존 eMule 폴더 위에 복사하고 파일 교체를 확인하세요.
eMule Qt를 시작한 뒤 임시 폴더를 삭제하세요.

.:제자리에서 업데이트하고, 이동하지 마세요

새 폴더에 압축을 풀고 config만 복사하고 싶은 유혹이 들 수 있습니다. 그렇게 하지 마세요. 미완료 다운로드는 Temp에, 완료된 파일은 Incoming에 있으며 둘 다 기존 폴더에 있고, preferences.yml에는 이들의 전체 경로가 저장되어 있습니다. 새 폴더에서는 다운로드 목록이 비어 시작하거나, 모르는 사이에 기존 폴더를 계속 사용하게 됩니다. 정말로 설치 위치를 옮기려면 폴더 전체를 옮기고, 이후 옵션에서 디렉터리를 확인하세요.

config\webserver의 웹 인터페이스 파일을 수정했다면 먼저 백업하세요. 업데이트하면 해당 파일이 교체됩니다.

macOS

eMule Qt와 코어를 종료하세요 (위 내용 참조).
새 디스크 이미지를 여세요: Apple 실리콘은 eMuleQt-vX.Y.Z-macOS-arm64.dmg, Intel은 eMuleQt-vX.Y.Z-macOS-x86_64.dmg입니다.
eMule Qt를 응용 프로그램 폴더로 드래그하고 교체를 선택하세요.
eMule Qt를 시작하세요.

~/eMuleQt에 있는 데이터는 앱 바깥에 있으므로 그대로 유지됩니다.

Linux

eMule Qt와 코어를 종료하세요 (위 내용 참조).
새 tarball을 기존 tarball과 같은 위치에 풀어 기존 eMuleQt 폴더를 덮어쓰세요: tar xzf eMuleQt-vX.Y.Z-linux-x86_64.tar.gz
eMule Qt를 시작하세요. 경로가 바뀌지 않았으므로 메뉴 항목과 파일 형식 연결은 계속 작동합니다.

.:기존 폴더를 먼저 삭제하지 마세요

tarball을 홈 폴더에 풀었다면 프로그램과 데이터가 한 폴더를 공유합니다. 프로그램은 ~/eMuleQt이고 데이터는 ~/eMuleQt/Config, Incoming, Temp입니다. 업데이트 전에 기존 프로그램 폴더를 삭제하면 이 데이터도 모두 삭제됩니다. tarball에는 Config, Incoming, Temp 폴더가 없으므로 위에 덮어 풀면 언제나 안전합니다. 소문자 config 폴더에는 배포 기본값이 들어 있으며, eMule Qt는 이를 사용자가 수정한 파일 위에 복사하지 않습니다.

새 버전을 다른 위치에 풀었다면 그곳에서 한 번 실행하세요. eMule Qt가 메뉴 항목을 새 경로로 갱신합니다.

Docker

새 이미지를 받아 컨테이너를 다시 만드세요. 데이터는 볼륨에 있습니다.

Docker Compose: docker compose pull && docker compose up -d
일반 Docker: docker pull ghcr.io/moddermule/emuleqt:latest 후 기존 컨테이너를 제거하고 동일한 -v 옵션으로 새 컨테이너를 시작하세요.

새 버전 알림 방식

eMule Qt는 스스로 새 버전을 확인하고, 변경 사항과 다운로드 페이지 링크가 담긴 창을 표시합니다. 바로 확인하려면 도구 → 링크 → 버전 확인을 사용하세요. 창에 업데이트가 필수라고 표시되면 현재 버전에 알려진 심각한 버그가 있다는 뜻이며, 업데이트할 때까지 eMule Qt가 종료됩니다.

서버나 NAS에서 창 없이 실행되는 코어는 스스로 업데이트를 설치할 수 있습니다. emulecored --autoupdate로 시작하세요. 새 릴리스를 다운로드하여 검증하고, 이 페이지에서 설명한 방식대로 설치하며(포터블 설치에서도 사용자의 config 파일은 유지), 같은 옵션으로 다시 시작합니다. Docker 컨테이너는 스스로 업데이트되지 않으므로 새 이미지를 받아 사용하세요.

도움말로 돌아가기