Monero 钱包恢复脚本的参数设置详解를 한국어로 완벽 정리합니다. Monero(XMR) 지갑을 복구할 때는 시드 구문만큼이나 monero-wallet-cli와 monero-wallet-rpc의 매개변수 설정이 중요합니다. 잘못된 restore-height, seed-offset, subaddress-lookahead 값은 잔액 0으로 보이게 만들 수 있습니다. 이 가이드는 코인 지갑 복구 전문 가이드의 오프라인 복구 원칙에 맞춰 안전한 스크립트 설정법을 설명합니다.
1. Monero 복구 스크립트의 기본 구조
Monero 지갑 복구는 보통 monero-wallet-cli로 시작합니다. 시드 구문은 보안상 명령줄 인자로 직접 전달하지 않고 대화형으로 입력하게 되어 있습니다. 따라서 스크립트 자동화를 할 때는 expect, pexpect 같은 도구로 시드 입력 프롬프트를 처리합니다. 기본 예시는 다음과 같습니다.
monero-wallet-cli --restore-deterministic-wallet --wallet-file=/path/recovered_wallet --password-file=/path/pw.txt --restore-height=3025000 --seed-offset= --mnemonic-language=English --subaddress-lookahead=50:200 --daemon-address=127.0.0.1 --daemon-port=18081 --trusted-daemon --log-file=/path/recovery.log
위 명령은 지갑 파일을 새로 만들고, 지정한 블록 높이부터 시드에 연결된 거래를 스캔합니다. --restore-deterministic-wallet은 시드 기반 복구를 활성화하는 핵심 플래그입니다.
2. 반드시 알아야 할 핵심 매개변수
2.1 --restore-height
--restore-height는 Monero 블록체인에서 몇 번째 블록부터 지갑을 스캔할지 지정합니다. 지갑을 처음 만든 날짜의 블록 높이를 알고 있다면 그 값을 넣는 것이 가장 빠릅니다. 모른다면 0으로 설정해 제네시스 블록부터 전체 스캔할 수 있지만, 동기화 시간이 매우 오래 걸립니다. 너무 높은 값을 넣으면 오래된 입금을 놓쳐 잔액이 0으로 보일 수 있습니다.
2.2 --seed-offset

--seed-offset은 시드 구문에 추가로 사용한 선택적 패스프레이즈입니다. 지갑 생성 시 seed offset을 설정하지 않았다면 빈 값으로 두어야 합니다. 만약 설정했다면 대소문자와 공백까지 정확히 일치해야 합니다. 이 값이 틀리면 완전히 다른 지갑이 복구됩니다.
2.3 --mnemonic-language
Monero 시드는 기본적으로 영어 니모닉을 사용합니다. --mnemonic-language에는 English, Spanish, German, French, Italian, Portuguese, Japanese, Russian, Chinese, Dutch, Esperanto, Lojban 등이 지원됩니다. 한국어 니모닉은 공식 지원되지 않으므로, 한국어로 백업한 경우에도 실제 시드 단어는 영어일 가능성이 높습니다. 언어를 잘못 지정하면 체크섬 오류가 발생합니다.
2.4 --password-file
--password-file은 지갑 파일 암호를 담은 파일 경로입니다. --password로 직접 암호를 넘기면 프로세스 목록에 노출될 수 있으므로 피해야 합니다. 암호 파일은 chmod 600으로 권한을 제한하고, 복구 후 즉시 삭제하는 것이 안전합니다.
2.5 --subaddress-lookahead
--subaddress-lookahead는 하위 주소를 얼마나 미리 스캔할지 결정합니다. 형식은 major:minor이며 기본값은 보통 50:200입니다. 많은 하위 주소를 사용했다면 50:500처럼 minor 값을 늘려야 잔액을 찾을 수 있습니다. 값을 너무 크게 하면 스캔 속도가 느려집니다.
2.6 데몬 연결 매개변수
--daemon-address와 --daemon-port는 동기화에 사용할 Monero 노드를 지정합니다. --trusted-daemon은 신뢰할 수 있는 자체 노드에만 사용하세요. 원격 노드에 이 옵션을 붙이면 프라이버시가 약해질 수 있습니다. 가능하면 로컬 풀 노드를 실행하고 방화벽으로 보호하는 것이 좋습니다.
2.7 네트워크 매개변수

--stagenet, --testnet은 각각 스테이지넷과 테스트넷용입니다. 메인넷 지갑을 복구할 때 실수로 이 옵션을 넣으면 잔액이 보이지 않습니다. 반드시 네트워크를 확인하세요.
2.8 로그와 성능 매개변수
--log-file과 --log-level은 복구 과정 디버깅에 유용합니다. 다만 로그에 지갑 주소나 메타데이터가 남을 수 있으므로 복구 후 안전하게 삭제해야 합니다. --max-concurrency는 스캔에 사용할 CPU 스레드 수를 조절합니다. 너무 높으면 시스템이 느려질 수 있습니다.
3. 스크립트 자동화 예시
시드 입력은 대화형이므로 expect를 사용합니다. 아래는 개념 예시이며 실제 시드는 절대 코드에 하드코딩하지 마세요.
#!/usr/bin/expect -f
set timeout -1
spawn monero-wallet-cli --restore-deterministic-wallet --wallet-file=recovered --restore-height=3025000 --password-file=pw.txt --mnemonic-language=English --subaddress-lookahead=50:200
expect {seed:}
send {word1 word2 word3 ... word25}
expect {offset}
send {}

interact
위 스크립트는 seed: 프롬프트를 기다렸다가 시드를 전달하고, seed offset이 없으면 빈 값을 보냅니다. 실제 환경에서는 프롬프트 문구가 버전에 따라 다를 수 있으므로 expect 패턴을 정확히 확인해야 합니다.
4. 자주 발생하는 오류와 해결법
- 잔액 0: restore-height가 너무 높거나, seed-offset 누락, 네트워크 불일치, subaddress-lookahead 부족이 원인일 수 있습니다.
- invalid mnemonic: 시드 단어 오타, 단어 순서 오류, 잘못된 언어 설정입니다.
- wallet file already exists: 복구 대상 경로를 바꾸거나 기존 파일을 백업하세요.
- daemon connection failed:
--daemon-address,--daemon-port를 확인하고 로컬 노드가 실행 중인지 점검하세요. - password incorrect:
--password-file내용과 줄바꿈 여부를 확인하세요.
5. 보안 체크리스트
Monero 복구 스크립트는 강력하지만, 잘못 사용하면 자산을 잃을 수 있습니다. 코인 지갑 복구 전문 가이드에서 강조하는 것처럼 모든 복구는 오프라인 또는 격리된 환경에서 수행하는 것이 원칙입니다. 시드를 클라우드에 저장하지 말고, 화면 캡처와 셸 히스토리를 피하며, 복구 후에는 반드시 새 지갑을 만들어 자금을 이동하세요. --password 대신 --password-file을 사용하고, 로그와 임시 파일은 안전하게 삭제해야 합니다.
6. 결론
Monero 지갑 복구 스크립트의 매개변수 설정은 단순한 명령어 암기보다 restore-height, seed-offset, subaddress-lookahead, password-file의 역할을 이해하는 것이 핵심입니다. 정확한 매개변수와 안전한 자동화 스크립트를 사용하면 잃어버린 Monero 지갑을 효율적으로 복구할 수 있습니다. 더 다양한 지갑 복구 사례와 BIP39/BIP32, btcrecover, HashCat, Pywallet 활용법은 코인 지갑 복구 전문 가이드에서 확인할 수 있습니다.