- 공유 링크 만들기
- X
- 이메일
- 기타 앱
이 글의 목적은 Microsoft 365 및 Office 2021/2019/2016 설치 및 복구 과정에서 발생하는 오류 코드 30088-1015 문제를 재현 가능한 절차로 진단하고, 원인별로 즉시 적용 가능한 해결 단계를 제시하여 업무 다운타임을 최소화하는 것이다.
오류 30088-1015의 의미와 증상 정의
오류 30088-1015는 Office 클릭투런(Click-to-Run) 설치 엔진이 구성 요소 다운로드 또는 적용 단계에서 실패했을 때 발생하는 일반화된 실패 코드이다. 주로 네트워크 차단, 손상된 이전 설치 잔여물, Windows 구성 요소 문제, 디스크/권한 오류, 보안 솔루션의 간섭, 기업 환경의 프록시/패킷 검사로 인해 유발된다. 증상은 다음과 같다.
- Microsoft 365 앱 설치 진행률이 2~80% 구간에서 멈춘 뒤 30088-1015 코드가 표시되는 현상이다.
- 기존 Office 제거 후 재설치 시에도 동일 코드가 반복되는 현상이다.
- 오프라인 설치 파일 사용 시에는 설치가 시작되지 않거나 구성 마지막 단계에서 롤백되는 현상이다.
원인 분류 표
| 분류 | 구체 원인 | 영향 지점 |
|---|---|---|
| 네트워크 | 프록시 인증 실패, SSL 검사, 방화벽 포트 차단, DNS 오염 또는 느린 응답, 콘텐츠 필터링 정책이다. | 다운로드 단계, CDN 접속이다. |
| 잔여물 | 이전 MSI 설치와 CTR 공존, 레지스트리/서비스 잔존, AppV 캐시 손상이다. | 구성/적용 단계이다. |
| OS 구성 | 손상된 WinHTTP/윈속, 서비스 중지, Windows 업데이트 누락, 시스템 파일 손상이다. | 전 단계 광범위이다. |
| 디스크/권한 | 디스크 오류, 공간 부족, 프로필 권한 문제, ProgramData 접근 거부이다. | 추출 및 구성 단계이다. |
| 보안 솔루션 | EDR/안티바이러스 실시간 검사, 앱 제어, 스크립트 차단 정책이다. | 다운로드/적용 단계이다. |
| 배포 설정 | 설치 채널 혼합, 언어/에디션 충돌, 라이선스 플랜 불일치이다. | 적용 및 활성화 단계이다. |
사전 점검 체크리스트
| 항목 | 체크 방법 | 합격 기준 |
|---|---|---|
| 디스크 여유 공간 | C: 드라이브 속성 확인이다. | 최소 8GB 이상이다. |
| Windows 업데이트 | 설정 > Windows 업데이트에서 누적 업데이트 적용이다. | 재부팅 대기 없음이다. |
| 시간/날짜/타임존 | w32tm 동기화 또는 NTP 점검이다. | 시간 오차 ±2분 이내이다. |
| 네트워크 프록시 | 회사 프록시/SSL 검사 정책 확인이다. | Office CDN 예외 처리이다. |
| 기존 Office 잔여물 | 프로그램 목록, 서비스, 폴더 확인이다. | 잔여 없음 또는 완전 제거이다. |
빠른 해결: 10분 내 시도 순서
- 재부팅 후 관리자 권한 PowerShell 실행이다.
- 네트워크 초기화, WinHTTP 프록시 해제, DNS 캐시 플러시이다.
- Office 잔여물 제거 도구로 정리 후 오프라인 설치 파일로 재설치이다.
- 보안 솔루션 일시 예외 적용 후 재시도이다.
# 1) 관리자 PowerShell ipconfig /flushdns netsh winhttp reset proxy netsh winsock reset # 2) 재부팅 필수 shutdown /r /t 0 주의 : 원격근무·기업망에서 SSL 가시화(HTTPS Inspection)와 프록시 인증이 있으면 설치가 반복 실패할 수 있다. 보안팀과 협조하여 Office CDN 도메인을 SSL 검사 예외 처리하거나 임시로 오프라인 설치 매체를 사용해야 한다.
잔여물 완전 제거 절차
설치 실패 후 가장 흔한 재발 요인은 잔여 파일·서비스·레지스트리이다. 다음 순서로 정리한다.
- 앱 제거: 제어판 > 프로그램에서 Microsoft 365/Office 관련 항목을 제거한다.
- 서비스 종료: ClickToRunSvc, OfficeSvc 등 관련 서비스를 중지한다.
- 폴더 삭제: 아래 경로의 잔여 폴더를 삭제한다.
# 서비스 중지(관리자 PowerShell) sc stop ClickToRunSvc
잔여 폴더(존재 시 삭제)
C:\Program Files\Common Files\Microsoft Shared\ClickToRun
C:\Program Files\Microsoft Office
C:\Program Files (x86)\Microsoft Office
C:\ProgramData\Microsoft\ClickToRun
%LOCALAPPDATA%\Microsoft\Office
%ProgramData%\Package Cache
주의 : 회사에서 MSI 기반 Office가 남아 있는 PC에 CTR 기반 Microsoft 365를 함께 설치하면 충돌한다. MSI 흔적이 있으면 먼저 MSI 제품군을 완전 제거해야 한다.
네트워크 원인 해결
오류 30088-1015는 CDN 접속 실패가 빈번하다. 다음을 점검한다.
- 프록시 자동 스크립트(PAC) 비정상 캐시 제거이다.
- WinHTTP 프록시·사용자 브라우저 프록시 동기화 확인이다.
- SSL 가시화 예외에 Microsoft 다운로드/Office CDN 도메인 등록이다.
# WinHTTP 프록시 확인/초기화 netsh winhttp show proxy netsh winhttp reset proxy
DNS 교체 테스트(임시)
Set-DnsClientServerAddress -InterfaceAlias "Ethernet" -ServerAddresses 1.1.1.1,8.8.8.8
주의 : DNS를 영구 변경하면 조직 정책을 위반할 수 있다. 테스트 후 원복해야 한다.
Windows 구성 손상 복구
Winsock/WinHTTP, 시스템 파일 손상은 설치 엔진이 모듈을 적용할 때 실패를 유발한다. 표준 복구 명령을 실행한다.
# 관리자 PowerShell 또는 명령 프롬프트 sfc /scannow DISM /Online /Cleanup-Image /RestoreHealth # 재부팅 후 Windows 업데이트 강제 검색 usoclient StartScan 주의 : DISM 실행 중 네트워크가 불안정하면 복구 원본 다운로드에 실패한다. 기업 환경에서는 WSUS/캐시 서버 상태를 확인해야 한다.
오프라인 설치로 우회
네트워크 제약이 해결되기 어렵다면 오프라인 설치 매체를 사용한다. 설치 채널과 제품/언어를 Office 배포 도구(ODT) 구성 파일로 명시한다.
# 예시: configuration.xml 생성 <Configuration> <Add OfficeClientEdition="64" Channel="MonthlyEnterprise"> <Product ID="O365ProPlusRetail"> <Language ID="ko-kr"/> </Product> </Add> <RemoveMSI /> <AppSettings> <Setup Name="Company" Value="IT"/> </AppSettings> <Display Level="None" AcceptEULA="TRUE"/> <Property Name="FORCEAPPSHUTDOWN" Value="TRUE"/> </Configuration>
콘텐츠 다운로드(인터넷 가능 PC에서 1회)
setup.exe /download configuration.xml
대상 PC에서 오프라인 설치
setup.exe /configure configuration.xml
주의 : Channel/에디션이 조직 정책과 상충되면 라이선스 활성화가 거부될 수 있다. 테넌트 표준 채널을 확인해야 한다.
보안 솔루션 간섭 배제
EDR/안티바이러스 실시간 검사에서 설치 캐시나 ClickToRun 프로세스를 차단하면 30088-1015가 발생한다. 다음을 적용한다.
- 실시간 검사 예외: 설치 경로, 캐시 경로, setup.exe, OfficeC2RClient.exe를 예외 처리한다.
- 애플리케이션 제어 정책: 서명 기준 허용 목록에 Microsoft 설치 프로그램을 추가한다.
- 네트워크 필터: 패턴 검사에서 Office CDN을 우회한다.
# 대표 경로(예외 후보) C:\Program Files\Common Files\Microsoft Shared\ClickToRun\ C:\ProgramData\Microsoft\ClickToRun\ %ProgramData%\Package Cache\ 권한 및 디스크 문제 해결
프로필 권한 문제와 디스크 손상은 적용 단계에서 롤백을 유발한다.
- 프로필 새로 만들기 또는 다른 관리자 계정으로 설치를 시도한다.
- 디스크 체크를 수행한다.
# 디스크 점검 chkdsk C: /scan
임시 파일 정리
cleanmgr /sageset:1
cleanmgr /sagerun:1
주의 : 디스크 불량 섹터가 있을 경우 설치 중 대용량 파일 쓰기에서 오류가 집중된다. SMART 경고가 있으면 즉시 교체를 고려해야 한다.
로그로 원인 정확히 짚기
재현이 반복되면 로그 분석으로 병목 지점을 찾는다.
- 설치 로그:
%ProgramData%\Microsoft\ClickToRun\폴더 내 *.log 파일이다. - Windows 이벤트 뷰어: 응용 프로그램/설치 관련 오류 이벤트이다.
- 네트워크 추적: 기업망은 프록시/SSL 검사 로그를 확인한다.
# 최근 1시간 ClickToRun 로그 찾기(PowerShell) Get-ChildItem "C:\ProgramData\Microsoft\ClickToRun" -Filter *.log | Where-Object LastWriteTime -gt (Get-Date).AddHours(-1) | Sort-Object LastWriteTime -Descending 기업 환경 표준 운영 절차(SOP) 예시
- 장비 이미징 후 첫 부팅에서 Windows 누적 업데이트를 모두 적용한다.
- 보안 솔루션 배포 시 Office 설치 경로 예외를 템플릿에 포함한다.
- 프록시·SSL 검사 장비에 Office CDN 예외 규칙을 기본 정책으로 설정한다.
- ODT 기반 오프라인 패키지를 WSUS/사내 파일 서버에 주기적으로 갱신한다.
- 배포 실패 감지 시 스크립트가 잔여물 정리와 재시도를 자동 수행하도록 한다.
자동화 스크립트 템플릿
다음 스크립트는 네트워크 초기화, 잔여물 정리, ODT 설치까지 일괄 수행하는 예시이다. 조직 환경에 맞게 경로와 채널을 수정한다.
@echo off :: 관리자 권한 확인 생략
echo [1/5] 네트워크 초기화
ipconfig /flushdns
netsh winsock reset
netsh winhttp reset proxy
echo [2/5] Office 서비스 중지
sc stop ClickToRunSvc
echo [3/5] 잔여 폴더 제거
rmdir /s /q "C:\Program Files\Common Files\Microsoft Shared\ClickToRun"
rmdir /s /q "C:\ProgramData\Microsoft\ClickToRun"
rmdir /s /q "%LOCALAPPDATA%\Microsoft\Office"
echo [4/5] SFC/DISM 점검
sfc /scannow
DISM /Online /Cleanup-Image /RestoreHealth
echo [5/5] ODT 구성 파일로 설치
setup.exe /configure config.xml
exit /b
주의 : 일괄 스크립트는 조직 자산에 따라 위험할 수 있다. 대량 배포 전 파일 서버에서 디지털 서명을 적용하고, 테스트 그룹에서 검증한 뒤 운영 환경에 적용해야 한다.
채널·언어·제품 혼선 정리
설치 실패는 서로 다른 채널과 제품 ID 혼합으로도 발생한다. 다음 표를 참고하여 일관성을 유지한다.
| 항목 | 권장 설정 | 비고 |
|---|---|---|
| 채널(Channel) | MonthlyEnterprise 또는 Current 의 단일 채널이다. | 테넌트 표준과 일치해야 한다. |
| 에디션 | 64비트 단일화이다. | 32비트 플러그인 호환성 검토 필요하다. |
| 언어 | ko-kr + en-us 최소 두 개이다. | 사용자 전환 수요 대응이다. |
| 제품 ID | Microsoft 365 Apps for enterprise 계열이다. | Retail/Volume 혼합 지양이다. |
문제 재현 예와 대응
사례 1: VPN에서 설치 실패 후 사내망에서는 정상 설치되는 경우이다. 원인은 VPN의 SSL 가시화 정책이다. 해결은 오프라인 설치 또는 VPN 예외 정책 요청이다.
사례 2: 기존 Office 2016 MSI에서 365로 전환하며 발생한 경우이다. 해결은 <RemoveMSI />를 포함한 ODT 구성으로 완전 제거 후 설치이다.
사례 3: 디스크 공간 3GB 환경에서 반복 실패하는 경우이다. 임시 파일과 캐시를 정리하고 최소 8~10GB 확보 후 설치이다.
재발 방지 체크리스트
- 이미지 마스터에 최신 ODT 패키지 반영이다.
- EDR/AV 예외 정책을 표준화한다.
- 프록시/SSL 검사 예외를 네임·IP·카테고리 룰로 이중화한다.
- 배포 후 헬스체크 스크립트를 실행하여 설치 상태를 검증한다.
# 간단 헬스체크(설치 유무) Get-Item "C:\Program Files\Common Files\Microsoft Shared\ClickToRun\OfficeC2RClient.exe" # 버전 확인 Get-Item "C:\Program Files\Microsoft Office\root\Office16\WINWORD.EXE" | Select-Object VersionInfo 장애 조치 단계 요약
- 재부팅 및 네트워크 초기화이다.
- Windows 업데이트와 SFC/DISM으로 OS 상태 복구이다.
- Office 잔여물 완전 제거이다.
- 보안 솔루션 예외 적용이다.
- ODT 기반 오프라인 설치 또는 채널 통일 재설치이다.
- 여전히 실패 시 로그 분석과 네트워크 장비 정책 검토이다.
현장에서 바로 쓰는 명령어 모음
# 설치 엔진 강제 업데이트 시도 "C:\Program Files\Common Files\Microsoft Shared\ClickToRun\OfficeC2RClient.exe" /updatepromptuser
서비스 재등록(있을 때)
sc config ClickToRunSvc start= auto
sc start ClickToRunSvc
사용자 프로필 임시 경로 확인
echo %TEMP%
주의 : 로컬 관리자 권한이 없는 표준 사용자 계정에서는 설치가 제한된다. 배포 툴 사용 또는 임시로 관리자 권한 상승 절차가 필요하다.
FAQ
오류 30088-1015가 특정 사용자에서만 발생하는가?
가능하다. 사용자 프로필 손상과 권한 문제일 수 있다. 새 프로필 생성 후 설치를 시도하고, 문제가 해결되면 프로필 마이그레이션을 수행한다.
오프라인 설치 후에도 활성화가 실패하는가?
활성화는 클라우드 서비스와 통신해야 한다. 방화벽에서 테넌트 인증 엔드포인트를 허용하고, 시간 동기화를 확인한다.
MSI와 CTR을 동시에 유지할 수 있는가?
권장하지 않는다. 공존 시 충돌 가능성이 높아 오류 30088-1015를 포함한 설치 실패가 발생한다. 전환 시 MSI 완전 제거를 수행한다.
설치 채널을 바꾸면 문제가 해결되는가?
손상된 캐시나 정책 충돌이 원인인 경우 채널 전환만으로는 충분하지 않다. 잔여물 제거 후 일관된 채널로 재설치해야 한다.
보안 솔루션을 제거해야 하는가?
제거는 불필요하다. 설치 경로와 프로세스에 대한 예외를 적용하거나 일시 중지 후 설치하고 재활성화하면 충분하다.