[운영] 화이트리스트로 원하는 사람만 접속하게 하기 + OP 설정 | 마크빌드업 EP.09

 

이런 분들께 추천합니다

• 서버 IP가 어떻게 알려졌는지 모르는 사람이 들어와서 당황하셨던 분
• 친구들끼리만 안전하게 즐기는 비공개 서버를 만들고 싶으신 분
• 화이트리스트 켰는데 친구가 못 들어온다는 연락을 받아본 적이 있으신 분

---

요약

문제	모르는 사람이 서버에 들어와서 건축물을 부수고 가는 경우가 있다
시도	마크 기본 화이트리스트 기능으로 등록된 사람만 접속 가능하게 하자
해결	white-list=true + /whitelist add <닉네임> 명령어로 친구만 받기

 

이 글을 따라하면 서버 IP가 노출돼도 등록된 사람만 접속할 수 있게 막을 수 있고, OP 권한까지 같이 설정해서 친구한테 관리 권한을 줄 수 있습니다.

---

사전 준비

• 등록할 친구들의 마인크래프트 닉네임 미리 받아두기
• (선택) server.properties 편집 방법

---

1. 화이트리스트란?

화이트리스트는 "이 명단에 등록된 사람만 서버에 접속 가능" 하게 만드는 마크 기본 기능입니다. 등록 안 된 사람이 접속을 시도하면 다음 메시지가 뜨면서 강퇴됩니다.

You are not white-listed on this server!

 

그리고 화이트리스트를 설정하면, 등록된 닉네임 목록이 서버 폴더의 whitelist.json 파일에 저장됩니다.

# 예시
[
  {
    "uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5",
    "name": "Notch"
  }
]

 

💡 참고: OP / 화이트리스트 차이

• 화이트리스트 (white-list=true): 명단에 등록된 사람만 접속 허용 — "누구는 들어올 수 있는지 통제"
• OP (/op <닉네임>): 서버 관리자 권한 부여 — "들어온 사람한테 권한 주기"

독립적으로 작동합니다. 화이트리스트에 추가됐다고 OP가 되는 게 아닙니다.

---

2. 화이트리스트 활성화

화이트리스트는 기본적으로 꺼져 있습니다. 켜는 방법은 두 가지인데, 둘 다 결과는 같습니다.

2-1. 방법 1: server.properties 수정

외전 EP.02에서 다룬 방식대로 server.properties 파일을 열어서 다음 값을 변경합니다.

white-list=true

저장 후 서버를 재시작하면 적용됩니다.

2-2. 방법 2: 콘솔 명령어 (재시작 불필요)

서버가 이미 실행 중이라면, 서버 콘솔에 다음 명령어를 입력하는 게 더 빠릅니다.

/whitelist on

 

Whitelist is now turned on

이 메시지가 뜨면 활성화 완료. 서버 재시작 없이 바로 적용됩니다.

⚠️ 주의: 화이트리스트만 켜고 끝내면 본인조차도 접속 못 합니다. 다음 단계를 계속 진행해 주세요.

---

3. 화이트리스트에 사람 추가하기

3-1. 친구 닉네임 추가

서버 콘솔에서 다음 명령어를 입력합니다.

/whitelist add <친구_닉네임>

예를 들어 친구 닉네임이 Buildify365이면:

/whitelist add Buildify365

 

Added Buildify365 to the whitelist

이 메시지가 뜨면 추가 완료.

💡 닉네임은 정확하게 입력해야 합니다 마크 정품 닉네임은 대소문자를 구분하지 않지만, 공백이나 오타가 있으면 안 됩니다.
친구한테 정확한 닉네임을 받아서 그대로 입력하세요!

3-2. 본인 닉네임도 추가

본인 계정도 화이트리스트에 추가해야 접속할 수 있습니다. (OP라도 화이트리스트 명단에는 따로 추가해야 합니다)

/whitelist add <본인_닉네임>

3-3. 등록된 명단 확인

지금까지 누가 등록되어 있는지 확인하려면:

/whitelist list

 

There are 1 whitelisted players: Buildify365

이렇게 등록된 사람 수와 닉네임 목록이 표시됩니다.

---

4. 친구한테 관리 권한 주기 (OP 설정)

화이트리스트만 추가하면 친구는 일반 플레이어로 들어옵니다. 친구가 서버 운영을 도와주거나, 본인이 자리를 비웠을 때도 명령어를 쓸 수 있게 하려면 OP 권한을 줘야 해요.

4-1. OP 권한 부여

/op <닉네임>

 

Made Buildify365 a server operator

⚠️ OP 권한은 신중하게 부여하세요 기본 OP 권한 레벨은 4(최고 권한)입니다. /stop, /ban, /op 등 모든 명령어를 쓸 수 있습니다.
정말 신뢰할 수 있는 친구한테만 주는 걸 권장합니다.

4-2. OP 권한 제거

권한을 회수하려면:

/deop <닉네임>

4-3. 본인은 어떻게 OP가 되나요?

본인 서버라도 처음에는 OP가 아닙니다. 두 가지 방법이 있어요.

방법 1: 서버 콘솔에서 부여

서버 콘솔(start.bat 또는 tmux 세션)에서 직접 입력합니다. 콘솔에는 모든 권한이 있어요.

op <본인_닉네임>

💡 콘솔에서는 명령어 앞에 /를 안 붙여도 됩니다.

 

방법 2: ops.txt 파일 직접 편집 (서버 종료 후)

서버 폴더의 ops.json 파일을 직접 수정할 수도 있지만, 콘솔 사용이 훨씬 간단합니다.

ops.json

 

기본적으로 닉네임과 uuid라는 고유한 문자열이 필요합니다. 이를 위해서 다음과 같은 본인의 uuid를 알 수 있는 API를 사용하여 정보를 추출하고 위 양식에 따라 복사 붙여넣기 하면 됩니다.

아래 방법 말고도 다른 방법도 있지만 방법 1이 자동으로 이 작업을 해줘서 방법 1을 강력 추천합니다.

• NameMC — 닉네임 검색하면 UUID + 스킨까지 보여줌
• MCUUID — 깔끔하게 하이픈 있는/없는 둘 다 표시

 

https://api.mojang.com/users/profiles/minecraft/<닉네임>

---

5. 화이트리스트에서 빼기

5-1. 명단에서 제거

/whitelist remove <닉네임>

5-2. 즉시 강퇴까지 하려면

server.properties에서 enforce-whitelist=true로 설정해두면, 화이트리스트에서 빠지는 즉시 접속 중인 사람도 강퇴됩니다.

enforce-whitelist=true

기본값은 false라서, 끄지 않으면 접속 중인 사람은 그대로 남고 다음 접속 시에만 차단됩니다.

💡 분쟁 시 빠른 대응: 친구 사이에 트러블이 생겨서 즉시 내보내고 싶을 때, enforce-whitelist=true가 켜져 있으면 /whitelist remove <닉네임> 만으로 즉시 강퇴 가능합니다.

---

6. 화이트리스트 명령어 전체 정리

자주 쓰는 명령어를 한 번에 정리하면:

/whitelist on              # 화이트리스트 활성화
/whitelist off             # 화이트리스트 비활성화
/whitelist add <닉네임>    # 명단에 추가
/whitelist remove <닉네임> # 명단에서 제거
/whitelist list            # 현재 명단 확인
/whitelist reload          # whitelist.json 직접 수정 후 다시 불러오기

 

OP 관련 명령어:

/op <닉네임>     # OP 권한 부여
/deop <닉네임>   # OP 권한 제거

---

마무리

전체 흐름을 정리하면 다음과 같습니다.

1. /whitelist on으로 화이트리스트 활성화
2. /whitelist add <본인_닉네임> (필수! 안 그러면 본인도 못 들어감)
3. 친구 닉네임도 /whitelist add로 추가
4. (선택) 친구한테 OP 권한 주려면 /op <닉네임>
5. (선택) 즉시 강퇴 기능 원하면 enforce-whitelist=true

이제 IP가 노출되더라도 등록된 사람만 접속할 수 있게 되었습니다! 친구들끼리 안전하게 마크를 즐길 수 있는 환경 완성입니다.

---

다음 글에서는...

큰 틀에서의 서버 운영 환경은 이제 거의 다 갖춰졌습니다.

그런데 마지막으로 한 가지 남은 게 있습니다.

며칠 동안 짓던 건축물이 갑자기 사라지면 어떻게 될까요?

다음 글에서는 마인크래프트 월드 백업하기를 다뤄보겠습니다.

Windows / Ubuntu(GCP 등 클라우드의 OS) 환경에서 안전하게 월드를 백업하는 방법을 정리할 예정입니다.

아래 내용은 댓글 요청이 있으면 별도로 다룰 예정입니다.

• 권한 세분화: OP 레벨 1~3으로 친구별 다른 권한 주기
• 게임 외부에서 화이트리스트 관리: 디스코드, 웹 등에서 화이트리스트 관리
• 밴 시스템: /ban, /ban-ip 명령어로 차단

---

References

• Minecraft Wiki - Commands/whitelist (공식 위키)
• Minecraft Wiki - Whitelist.json
• 마크빌드업 외전 EP.01 — 서버 실행 스크립트
• 마크빌드업 외전 EP.02 — server.properties 설정