도입부

Local을 이용해서 WordPress를 로컬 환경에서 개발하다가 갑자기 “Uh-oh! Could not update hosts file” 또는 “Missing hosts entry. This site may be inaccessible”이라는 오류 메시지가 나타났다면, 당신만의 문제가 아닙니다. 이것은 Local 사용자들 사이에서 가장 흔한 문제 중 하나입니다.

이 오류가 발생하는 원인은 다양합니다. Windows의 hosts 파일이 읽기 전용으로 설정되어 있거나, 보안 프로그램이 접근을 차단하거나, Local 애플리케이션에 관리자 권한이 없을 수 있습니다. 다행히 대부분의 경우는 몇 가지 간단한 해결 방법으로 빠르게 해결할 수 있습니다. 이 글에서는 이 오류를 야기하는 모든 원인과 각각에 대한 구체적인 해결 방법을 단계별로 설명하겠습니다.

hosts 파일 오류란?

먼저 hosts 파일이 무엇인지 이해해야 문제를 해결할 수 있습니다. hosts 파일은 Windows 운영 체제에서 도메인 이름을 IP 주소로 변환하는 역할을 하는 시스템 파일입니다. 일반적으로 DNS 서버가 이 작업을 수행하지만, hosts 파일은 로컬 컴퓨터에서 이를 먼저 확인합니다.

Local 애플리케이션은 WordPress 개발 환경을 만들 때 testsite.local 같은 로컬 도메인을 사용합니다. 이 도메인이 localhost(127.0.0.1)를 가리키도록 하기 위해 Local은 자동으로 hosts 파일을 수정합니다. 그런데 어떤 이유로 Local이 hosts 파일에 접근하지 못하면 바로 이 오류가 발생하는 것입니다.

문제의 원인 파악

hosts 파일 업데이트 오류는 여러 가지 원인에서 비롯됩니다:

• Hosts 파일이 읽기 전용으로 설정됨: Windows의 파일 속성에서 “읽기 전용” 체크박스가 활성화되어 있음
• 보안 프로그램의 차단: Windows Defender, Norton, McAfee, Bitdefender 등의 보안 프로그램이 파일 접근을 차단
• Local이 관리자 권한으로 실행되지 않음: Windows에서 hosts 파일 수정은 관리자 권한이 필요함
• Hosts 파일 권한 제한: 파일의 권한(NTFS 권한)이 제한되어 있음
• 사용자 계정 제어(UAC) 문제: UAC가 너무 높게 설정되어 있음

[이미지 삽입 포인트 1: 오류 메시지 스크린샷 및 hosts 파일 위치 다이어그램]

해결 방법 1: Local을 관리자로 실행하기

가장 간단하고 효과적인 해결 방법은 Local 애플리케이션을 관리자 권한으로 실행하는 것입니다. Windows에서 hosts 파일 수정은 관리자 권한이 필수이기 때문입니다.

Windows에서 Local을 관리자로 실행하는 방법:

1. 바탕화면이나 시작 메뉴에서 Local 애플리케이션 아이콘을 찾습니다.
2. Local 아이콘 위에 마우스 우클릭합니다.
3. 나타나는 메뉴에서 “관리자 권한으로 실행(Run as administrator)”을 클릭합니다.
4. 사용자 계정 제어 대화상자가 나타나면 “예(Yes)”를 클릭하여 권한을 승인합니다.
5. Local이 관리자 권한으로 열리고, 이전에 실패한 사이트를 다시 시작하면 hosts 파일이 정상적으로 업데이트됩니다.

💡 팁: 매번 관리자 권한으로 실행하는 것이 번거롭다면, Local의 바로가기를 만들 때 “항상 관리자 권한으로 실행” 옵션을 체크할 수 있습니다. Local 아이콘 → 우클릭 → 속성 → 고급(Advanced) → “관리자 권한으로 실행” 체크박스 활성화.

[이미지 삽입 포인트 2: 관리자 권한으로 실행하는 절차 스크린샷]

해결 방법 2: Hosts 파일의 읽기 전용 속성 제거

두 번째 해결 방법은 hosts 파일의 읽기 전용(Read-only) 속성을 제거하는 것입니다. 많은 경우 이것이 오류의 주요 원인입니다.

Windows에서 Hosts 파일의 읽기 전용 속성 제거하기:

1. Windows 키 + E를 눌러 파일 탐색기를 엽니다.
2. 주소창에 다음을 입력합니다: C:\Windows\System32\drivers\etc
3. Enter를 누르면 해당 폴더로 이동합니다.
4. hosts 파일을 찾아서 우클릭합니다. (확장자 없음)
5. “속성(Properties)”을 클릭합니다.
6. “일반(General)” 탭에서 아래쪽의 “읽기 전용(Read-only)” 체크박스를 찾습니다.
7. 체크박스가 활성화되어 있다면 클릭하여 비활성화합니다.
8. “적용(Apply)” 버튼을 클릭한 후 “확인(OK)”을 클릭합니다.

이제 Local을 관리자로 실행한 후 다시 시도하면 hosts 파일이 성공적으로 업데이트됩니다.

[이미지 삽입 포인트 3: Hosts 파일 위치 및 읽기 전용 체크박스 제거 절차]

해결 방법 3: 보안 프로그램 확인 및 제외 설정

Windows Defender, 안티바이러스 소프트웨어, 또는 기타 보안 도구가 Local의 hosts 파일 접근을 차단하고 있을 수 있습니다.

Windows Defender 예외 추가:

1. Windows 설정을 엽니다. (Windows 키 + I)
2. 왼쪽 사이드바에서 “개인정보 및 보안(Privacy & Security)”을 클릭합니다.
3. “바이러스 및 위협 방지(Virus & threat protection)”를 클릭합니다.
4. “바이러스 및 위협 방지 설정(Virus & threat protection settings)”를 클릭합니다.
5. “제외 항목 관리(Manage settings)” 섹션에서 “제외 항목 추가(Add exclusions)”를 클릭합니다.
6. “폴더(Folder)”를 선택하고 Local 설치 폴더(보통 C:\Users\[사용자명]\AppData\Local\Local)를 선택합니다.
7. hosts 파일도 직접 제외하려면 “파일(File)”을 선택하고 C:\Windows\System32\drivers\etc\hosts를 추가합니다.

타사 보안 프로그램의 경우:

Norton, McAfee, Bitdefender 같은 타사 안티바이러스를 사용한다면, 해당 프로그램의 설정에서 Local 또는 hosts 파일을 파일/폴더 제외 목록에 추가해야 합니다. 정확한 절차는 각 프로그램마다 다르므로 해당 프로그램의 지원 문서를 참고하세요.

⚠️ 주의: 보안 프로그램을 완전히 비활성화하는 것은 권장하지 않습니다. 항상 특정 항목만 제외하도록 설정하세요.

[이미지 삽입 포인트 4: Windows Defender 제외 항목 설정 화면]

해결 방법 4: Hosts 파일 권한 수정

위의 방법들이 작동하지 않으면, hosts 파일의 NTFS 권한 설정을 직접 수정해야 할 수 있습니다.

Hosts 파일의 권한 설정 변경:

1. 파일 탐색기를 열고 C:\Windows\System32\drivers\etc로 이동합니다.
2. hosts 파일을 우클릭하고 “속성(Properties)”을 선택합니다.
3. “보안(Security)” 탭을 클릭합니다.
4. “편집(Edit)” 버튼을 클릭합니다. (관리자 권한 필요)
5. 사용자 또는 그룹 목록에서 현재 사용자를 선택합니다.
6. 아래의 “권한(Permissions)” 섹션에서 “모든 권한(Full Control)”에 체크박스를 활성화합니다.
7. “적용(Apply)” 및 “확인(OK)”을 클릭합니다.

만약 현재 사용자가 목록에 없다면, “편집” 창에서 “추가(Add)” 버튼을 클릭하고 현재 사용자명을 입력한 후 “이름 확인(Check Names)”을 클릭합니다.

[이미지 삽입 포인트 5: Hosts 파일 보안 권한 설정 절차]

해결 방법 5: Hosts 파일 수동으로 편집

Local이 hosts 파일을 자동으로 업데이트하지 못하면, 수동으로 편집할 수도 있습니다. 이 방법은 기술적으로 조금 더 복잡하지만 매우 효과적입니다.

Hosts 파일을 수동으로 편집하는 방법:

1. 먼저 관리자 권한으로 메모장을 엽니다. (Windows 키 → “메모장” 검색 → 우클릭 → “관리자 권한으로 실행”)
2. 메모장에서 “파일(File)” → “열기(Open)” 또는 Ctrl + O를 누릅니다.
3. 주소창에 C:\Windows\System32\drivers\etc를 입력합니다.
4. 파일 형식을 “텍스트 문서(*.txt)”에서 “모든 파일(*.*)”로 변경합니다.
5. hosts 파일을 선택하고 “열기(Open)”를 클릭합니다.
6. 파일의 맨 끝에 새 줄을 추가하고 다음과 같은 형식으로 입력합니다:

127.0.0.1       testsite.local

여기서 “127.0.0.1”은 localhost를 의미하고, “testsite.local”은 Local에서 생성한 사이트의 도메인입니다. 여러 개의 로컬 사이트가 있다면 각각을 새 줄에 추가합니다:

127.0.0.1       myproject1.local
127.0.0.1       myproject2.local
127.0.0.1       myproject3.local

수정을 완료한 후 “파일(File)” → “저장(Save)” 또는 Ctrl + S를 눌러 저장합니다.

💡 팁: Local 애플리케이션에서 사이트 정보를 확인하면 정확한 도메인 이름을 알 수 있습니다. Local 창에서 사이트를 선택하면 “Domains” 또는 “Site Domain” 섹션에 표시됩니다.

[이미지 삽입 포인트 6: 메모장에서 Hosts 파일 수동 편집 화면]

추가 해결 방법: DNS 캐시 지우기

hosts 파일을 수정한 후에도 여전히 사이트에 접근할 수 없다면, 컴퓨터의 DNS 캐시를 지워야 할 수 있습니다. 이전의 DNS 정보가 캐시되어 있을 수 있기 때문입니다.

Windows에서 DNS 캐시 지우기:

1. 명령 프롬프트를 관리자로 엽니다. (Windows 키 → “cmd” 검색 → 우클릭 → “관리자 권한으로 실행”)
2. 다음 명령을 입력하고 Enter를 누릅니다:

ipconfig /flushdns

명령 실행 후 “DNS Resolver Cache was successfully flushed”라는 메시지가 나타나면 성공입니다.

웹 브라우저 캐시도 지우기:

DNS 캐시를 지운 후, 사용 중인 웹 브라우저의 캐시도 지워야 합니다. 또는 새로운 탭이나 시크릿 모드에서 사이트에 접속해보세요.

문제 해결 체크리스트

hosts 파일 오류를 해결하기 위한 단계별 체크리스트입니다:

• ☑ Local을 관리자 권한으로 실행했는가?
• ☑ Hosts 파일의 읽기 전용 속성을 제거했는가?
• ☑ Windows Defender 또는 안티바이러스에서 Local과 hosts 파일을 예외 목록에 추가했는가?
• ☑ Hosts 파일의 권한을 확인하고 필요하면 수정했는가?
• ☑ 필요하면 hosts 파일을 수동으로 편집했는가?
• ☑ DNS 캐시를 지웠는가?
• ☑ 웹 브라우저 캐시를 지웠는가?
• ☑ 웹 브라우저를 완전히 재시작했는가?

자주하는 질문 (FAQ)

Q1. Local을 매번 관리자로 실행해야 하나요?

A: 그럴 필요는 없습니다. Local의 바로가기 속성에서 “항상 관리자 권한으로 실행” 옵션을 체크하면, 이후 Local을 실행할 때마다 자동으로 관리자 권한이 적용됩니다.

Q2. Hosts 파일을 실수로 삭제했어요. 복구할 수 있나요?

A: 걱정하지 마세요. Windows는 기본 hosts 파일 템플릿을 가지고 있습니다. 새 hosts 파일을 만들거나 시스템 복원을 사용할 수 있습니다. 또는 Microsoft 공식 문서에서 기본 hosts 파일 내용을 찾아서 복구할 수 있습니다.

Q3. Mac이나 Linux에서도 같은 문제가 발생하나요?

A: Mac과 Linux에서는 hosts 파일 위치와 권한 설정이 다릅니다. Mac에서는 /etc/hosts (터미널에서 sudo로 편집), Linux에서도 /etc/hosts (sudo 권한 필요)입니다. 웹에서 각 OS별 해결 방법을 검색하면 도움을 받을 수 있습니다.

Q4. 여러 보안 프로그램을 사용하고 있는데 Local을 모두에 추가해야 하나요?

A: 네, 보안 프로그램이 여러 개 설치되어 있다면 모두에서 Local과 hosts 파일을 예외 항목으로 추가하는 것이 좋습니다. 각 프로그램의 설정 메뉴에서 파일 제외 또는 방화벽 예외를 설정할 수 있습니다.

Q5. Hosts 파일을 수동으로 편집한 후 Local은 자동으로 업데이트하나요?

A: Local은 사이트를 시작하거나 멈출 때 hosts 파일을 업데이트하려고 시도합니다. 수동으로 편집한 후 Local이 자동으로 추가 항목을 넣으려고 하면 이전 수정 사항을 덮어쓸 수 있습니다. 이 경우 Local의 자동 업데이트 기능을 비활성화하거나 수동 편집 방식을 계속 사용하는 것이 좋습니다.

추가 팁: 이후에 같은 문제를 피하기 위해

이 오류를 경험한 후에는 다음과 같이 설정하여 이후에 같은 문제를 피할 수 있습니다:

• Local을 항상 관리자 권한으로 실행하도록 설정
• 보안 프로그램에서 Local 폴더와 hosts 파일을 영구적으로 예외 항목으로 등록
• hosts 파일의 읽기 전용 속성이 다시 활성화되지 않도록 주기적으로 확인
• Windows 업데이트 후에는 permissions를 다시 확인

결론

Local WordPress 개발 환경에서 “Could not update hosts file” 오류는 매우 흔한 문제이지만, 이 글에서 소개한 5가지 해결 방법 중 하나로 대부분 해결할 수 있습니다. 먼저 Local을 관리자로 실행해보고, hosts 파일의 읽기 전용 속성을 확인한 후, 필요하면 보안 프로그램 설정을 조정하세요.

가장 일반적인 원인은 관리자 권한 부족과 읽기 전용 속성이므로, 이 두 가지를 먼저 확인하면 대부분의 경우 문제가 해결됩니다. 여전히 문제가 지속된다면 hosts 파일을 수동으로 편집하는 방법이 효과적입니다.

이제 Local에서 WordPress 개발을 방해받지 않고 자유롭게 진행할 수 있을 것입니다!