저도 처음에는 단순히 메일만 들어오면 된다고 생각했는데, 막상 설정해보니 MX 레코드, A 레코드, 시놀로지 MailPlus, 루트 도메인 접속 문제까지 함께 이해해야 제대로 동작했습니다. 특히 가비아 DNS에서 MX 값에 무엇을 넣어야 하는지, 그리고 why howinfo.kr 자체가 안 열리는지에서 가장 많이 헷갈렸습니다.

이번 글은 그런 시행착오를 줄이기 위해 정리한 실전 기록입니다.
설명에 사용하는 IP는 실제 값이 아니라 예시용 가상 IP입니다.

이 글에서 정리하는 내용

이 글에서는 아래 내용을 한 번에 정리합니다.

• admin@howinfo.kr 메일을 시놀로지에서 받는 전체 구조
• 가비아 DNS에서 A, MX 레코드를 어떻게 넣어야 하는지
• howinfo.kr 접속이 안 될 때 무엇을 먼저 봐야 하는지
• 시놀로지 MailPlus에서 어떤 방식으로 계정을 연결하면 편한지
• 설정 중 자주 만나는 오류와 해결 포인트

왜 도메인 메일이 필요한가

개인 메일 주소 대신 사이트 도메인 메일을 쓰면 운영 체계가 훨씬 정돈되어 보입니다. 예를 들어 admin@howinfo.kr 라는 주소는 사이트 관리자용 공식 창구처럼 보이기 때문에 방문자 입장에서도 신뢰도가 높습니다.

또한 도메인 메일은 문의 메일, 협업 요청, 운영 경고, 서비스 알림을 한곳으로 모으기 좋습니다. 이미 시놀로지 NAS를 사용하고 있다면 별도 외부 메일 서비스를 추가하지 않고도 직접 메일 수신 환경을 만들 수 있다는 점도 장점입니다.

먼저 이해해야 하는 전체 구조

도메인 메일은 아래 순서로 동작합니다.

1. 누군가 admin@howinfo.kr 로 메일을 보냅니다.
2. 발신 서버는 howinfo.kr 의 MX 레코드를 조회합니다.
3. MX 레코드는 메일을 받을 서버 이름을 알려줍니다.
4. 그 서버 이름은 다시 A 레코드를 통해 IP와 연결됩니다.
5. 최종적으로 시놀로지 MailPlus Server가 메일을 수신합니다.

여기서 핵심은 두 가지입니다.

첫째, MX는 메일 서버의 이름을 가리킵니다.
둘째, A 레코드는 그 이름을 실제 IP와 연결합니다.

즉 MX에는 IP를 넣는 것이 아니라 mail.howinfo.kr 같은 주소를 넣어야 합니다.

MX에 IP를 넣으면 안 되는 이유

처음 가장 많이 하는 실수가 바로 이 부분입니다.

아래처럼 설정하면 안 됩니다.

MX / @ / 203.0.113.25

이건 잘못된 방식입니다.
MX는 메일 서버 이름을 가리켜야 하기 때문입니다.

올바른 예시는 아래와 같습니다.

A  / mail / 203.0.113.25
MX / @    / mail.howinfo.kr

즉 먼저 mail.howinfo.kr 이라는 이름을 만들고, 그 이름을 A 레코드로 IP에 연결한 다음, MX는 그 이름을 바라보게 해야 합니다.

이 구조를 이해하면 메일 DNS 설정은 훨씬 쉬워집니다.

howinfo.kr 기준 DNS 예시

설명을 위한 가상 IP 203.0.113.25 를 기준으로 하면, 최소한 아래처럼 구성하면 됩니다.

웹 접속용

A / @   / 203.0.113.25
A / www / 203.0.113.25

메일 수신용

A  / mail / 203.0.113.25
MX / @    / mail.howinfo.kr

표로 정리하면 아래와 같습니다.

이 4줄이 가장 기본적인 핵심 설정입니다.

howinfo.kr 이 안 열릴 때 먼저 볼 것

실제로 설정 중 자주 겪는 문제가 있습니다.

• www.howinfo.kr 는 열리는데
• howinfo.kr 는 안 열리는 경우

이 경우는 대부분 아래 레코드가 빠져 있습니다.

A / @ / 203.0.113.25

많은 분들이 www 만 설정하고 루트 도메인 @ 를 빼먹습니다. 하지만 howinfo.kr 와 www.howinfo.kr 는 별도로 동작할 수 있기 때문에 둘 다 잡아줘야 합니다.

즉, howinfo.kr 자체 접속이 안 된다면 가장 먼저 A / @ 레코드를 확인하면 됩니다.

가비아 DNS에서 헷갈리는 부분

가비아 DNS 화면을 보면 호스트 와 값/위치 입력칸 때문에 처음에는 조금 헷갈릴 수 있습니다.

예를 들어 아래처럼 입력하면 됩니다.

A 레코드

• 타입: A
• 호스트: mail
• 값/위치: 203.0.113.25

이 뜻은 mail.howinfo.kr 이라는 주소를 해당 IP로 연결한다는 의미입니다.

MX 레코드

• 타입: MX
• 호스트: @
• 값/위치: mail.howinfo.kr
• 우선순위: 10

이 뜻은 howinfo.kr 로 들어오는 메일을 mail.howinfo.kr 가 받는다는 의미입니다.

여기서 가장 중요한 점은 MX 값에는 IP가 아니라 도메인 이름이 들어간다는 점입니다.

시놀로지 MailPlus에서는 어떻게 구성하면 좋은가

DNS가 끝나면 이제 시놀로지에서 메일을 받을 준비를 해야 합니다.

기본 순서는 아래와 같습니다.

1. DSM 패키지 센터에서 MailPlus Server 설치
2. 필요하면 MailPlus도 설치
3. 대표 메일 서버 이름 설정
4. SMTP, IMAP 활성화
5. 사용자 생성
6. admin@howinfo.kr 수신 연결

실무적으로는 내부 로그인용 계정과 외부 공개용 메일 주소를 분리하는 편이 편합니다.

예를 들어 아래처럼 운영할 수 있습니다.

• 내부 사용자: adminmail
• 외부 메일 주소: admin@howinfo.kr

이렇게 하면 외부에는 깔끔한 공식 메일 주소를 보여주면서도, 실제 시놀로지 내부에서는 관리하기 쉬운 사용자명으로 운영할 수 있습니다.

가장 단순한 추천 구성

howinfo.kr 하나만 기준으로 본다면 아래처럼 구성하면 충분합니다.

DNS

A  / @    / 203.0.113.25
A  / www  / 203.0.113.25
A  / mail / 203.0.113.25
MX / @    / mail.howinfo.kr

시놀로지

• MailPlus Server 설치
• 도메인 howinfo.kr 등록
• 사용자 adminmail 생성
• admin@howinfo.kr 수신 연결

운영 방식

• 외부에서는 admin@howinfo.kr 로 메일 발송
• 시놀로지 MailPlus 받은편지함에서 확인

이 구성이 가장 단순하면서도 관리하기 쉬운 형태입니다.

설정 중 자주 만나는 문제

MX를 넣었는데 메일이 안 들어오는 경우

이 경우는 보통 아래 둘 중 하나입니다.

• MX 값에 IP를 넣었음
• mail A 레코드가 없음

정상 예시는 아래입니다.

A  / mail / 203.0.113.25
MX / @    / mail.howinfo.kr

가비아에서 저장이 안 되는 경우

호스트를 입력해 주세요 같은 메시지가 뜬다면 새 레코드를 추가해놓고 빈 칸이 남아 있는 경우가 많습니다. 새 줄을 만들었으면 타입, 호스트, 값/위치를 모두 채운 뒤 저장해야 합니다.

howinfo.kr 자체가 접속되지 않는 경우

이 경우는 아래가 빠졌을 가능성이 큽니다.

A / @ / 203.0.113.25

DNS는 맞는데 메일이 안 들어오는 경우

이때는 DNS가 아니라 네트워크 문제일 수 있습니다. 아래를 같이 확인해야 합니다.

• 공유기 포트포워딩
• 외부 25번 포트 수신 가능 여부
• DSM 방화벽 허용 여부
• MailPlus Server 정상 실행 여부

실제 작업은 이 순서가 가장 편했습니다

제가 정리해보면 아래 순서가 가장 덜 헷갈립니다.

1단계. DNS 먼저 정리

A  / @    / 203.0.113.25
A  / www  / 203.0.113.25
A  / mail / 203.0.113.25
MX / @    / mail.howinfo.kr

2단계. 시놀로지 MailPlus 설치

• MailPlus Server
• MailPlus

3단계. 도메인 등록

• howinfo.kr

4단계. 사용자 생성

• adminmail

5단계. 수신 주소 연결

• admin@howinfo.kr

6단계. 외부 발송 테스트

• 다른 메일 계정에서 admin@howinfo.kr 로 발송
• 시놀로지 받은편지함에서 정상 수신 확인

이 순서대로 하면 중간에 꼬일 일이 많이 줄어듭니다.

운영 관점에서 느낀 점

howinfo.kr 같은 블로그나 정보 사이트를 운영할 때는 메일 시스템이 지나치게 복잡할 필요는 없습니다. 중요한 것은 문의를 놓치지 않고, 운영자가 쉽게 확인할 수 있으며, 외부에서 봤을 때 신뢰감을 주는 구조입니다.

admin@howinfo.kr 메일 주소는 그런 점에서 꽤 실용적입니다. 시놀로지 NAS를 이미 사용 중이라면 추가 비용 없이 직접 운영할 수 있다는 것도 장점입니다.

물론 발신까지 안정적으로 운영하려면 SPF, DKIM, DMARC, PTR 같은 설정도 추가로 고려해야 합니다. 하지만 첫 단계에서는 수신 구조부터 정확히 잡는 것이 우선입니다.

마무리 정리

이번 설정에서 가장 중요한 포인트는 두 가지였습니다.

하나는 MX에는 IP가 아니라 mail.howinfo.kr 같은 메일 서버 이름을 넣어야 한다는 점입니다.
다른 하나는 howinfo.kr 자체 접속을 위해 A / @ 레코드가 꼭 필요하다는 점입니다.

결국 핵심은 아래 4줄입니다.

A  / @    / 203.0.113.25
A  / www  / 203.0.113.25
A  / mail / 203.0.113.25
MX / @    / mail.howinfo.kr

이후 시놀로지 MailPlus에서 admin@howinfo.kr 수신 구조만 연결하면 기본적인 도메인 메일 환경은 완성됩니다.

처음에는 조금 복잡해 보여도 MX와 A 레코드의 역할만 제대로 구분하면 생각보다 어렵지 않게 정리할 수 있습니다.

체크리스트

아래 항목만 확인해도 대부분의 기본 오류는 줄일 수 있습니다.

• A / @ 레코드가 있는지
• A / mail 레코드가 있는지
• MX / @ / mail.howinfo.kr 로 설정했는지
• MailPlus Server가 실행 중인지
• 공유기 포트포워딩이 되어 있는지
• 외부에서 테스트 메일을 보내봤는지

FAQ

Q1. MX에는 왜 IP를 넣으면 안 되나요?

MX는 메일 서버의 이름을 지정하는 레코드이기 때문입니다. IP는 A 레코드가 담당합니다.

Q2. mail.howinfo.kr 는 꼭 필요한가요?

반드시 mail 이어야 하는 것은 아니지만, 메일 서버용 서브도메인을 따로 두는 방식이 일반적이고 관리하기도 쉽습니다.

Q3. howinfo.kr 는 안 열리고 www만 열리면 왜 그런가요?

대부분 A / @ 레코드가 빠져 있기 때문입니다.

Q4. admin@howinfo.kr 를 실제 로그인 계정으로 꼭 만들어야 하나요?

꼭 그렇지는 않습니다. 내부에서는 adminmail 같은 사용자로 운영하고, 외부 수신 주소만 admin@howinfo.kr 로 연결해도 됩니다.

Q5. 이 글의 IP를 그대로 써도 되나요?

아니요. 이 글의 IP는 예시용 가상 IP입니다. 실제 운영 시에는 본인의 공인 IP로 바꿔야 합니다.

게시물 시놀로지에서 admin@howinfo.kr 메일 받는 방법, 가비아 DNS와 MailPlus 설정 정리이 하우인포-IT·테크에 처음 등장했습니다.

저도 처음에는 이 부분이 제일 헷갈렸습니다. PC에서는 Docker 명령어가 보이고, 시놀로지 NAS에서는 Container Manager라는 이름으로 보이니 완전히 다른 제품처럼 느껴졌거든요. 그런데 실제로 써보면 구조는 생각보다 단순합니다. Docker는 컨테이너를 실행하는 기반 기술이고, DSM 7.3의 Container Manager는 NAS에서 그걸 좀 더 쉽게 다루게 해주는 관리 도구에 가깝습니다. Docker 컨테이너는 호스트의 커널을 공유하는 가벼운 격리 프로세스라 VM보다 부담이 적고, Docker Compose는 여러 서비스를 한 번에 정의하고 띄울 수 있게 해줍니다.

이번 글에서는

• Docker가 왜 필요한지
• 시놀로지 NAS에서 Container Manager로 무엇을 할 수 있는지
• 둘의 차이를 어떻게 이해하면 쉬운지
• 실제 예시는 어떤 식으로 시작하면 좋은지

이 순서로 정리해보겠습니다.

Docker를 한 문장으로 설명하면

Docker는 애플리케이션을 필요한 실행 환경과 함께 묶어서, 어느 서버에서든 비슷하게 실행할 수 있게 해주는 컨테이너 플랫폼입니다. Docker 공식 문서도 Docker를 “애플리케이션을 개발·배포·실행하기 위한 오픈 플랫폼”으로 설명하고 있고, 컨테이너는 필요한 파일을 포함한 격리된 프로세스로 설명합니다.

쉽게 말하면 이런 느낌입니다.

예전 방식은
“서버마다 설치 환경이 달라서 여기서는 되는데 저기서는 안 된다”는 문제가 자주 생겼습니다.

Docker 방식은
“앱 + 라이브러리 + 실행 환경”을 이미지로 묶어두고, 그 이미지를 어디서든 같은 방식으로 실행하는 구조입니다.

그래서 개발 PC에서 잘 돌던 앱을 NAS나 리눅스 서버로 옮길 때도 훨씬 예측 가능해집니다.

컨테이너와 가상머신은 무엇이 다를까

처음 입문할 때 가장 많이 비교하는 대상이 VM입니다.

가상머신은 운영체제 자체를 통째로 하나 더 올리는 느낌입니다.
반면 컨테이너는 호스트 OS의 커널을 공유하면서 필요한 프로세스만 격리해서 실행합니다. Docker 문서에서도 여러 컨테이너가 같은 커널을 공유한다고 설명합니다. 그래서 보통 컨테이너가 더 가볍고, 시작도 빠르고, 작은 단위의 서비스 배포에 잘 맞습니다.

제가 실무나 홈서버 관점에서 느낀 차이는 이렇습니다.

• 가상머신: 운영체제까지 따로 필요, 무겁지만 독립성이 큼
• 컨테이너: 앱 단위 배포에 유리, 가볍고 빠름
• 홈서버/NAS: 제한된 자원에서 여러 서비스를 띄우려면 컨테이너가 훨씬 효율적

즉, NAS처럼 CPU·메모리가 아주 넉넉하지 않은 환경에서는 Docker가 특히 잘 맞습니다.

Docker에서 자주 보는 핵심 용어 5가지

1) 이미지(Image)

컨테이너를 만들기 위한 템플릿입니다.
예를 들어 nginx, postgres, wordpress 같은 것들이 이미지입니다.

2) 컨테이너(Container)

이미지를 실제로 실행한 상태입니다.
이미지는 설계도, 컨테이너는 실행 중인 인스턴스라고 생각하면 이해가 쉽습니다.

3) 볼륨(Volume)

컨테이너를 지워도 데이터를 남기기 위한 저장소입니다.
DB 데이터, 업로드 파일, 설정 파일은 보통 볼륨에 분리합니다. Docker Engine 문서는 이미지·컨테이너 외에도 볼륨과 네트워크 같은 객체를 daemon이 관리한다고 설명합니다.

4) 네트워크(Network)

컨테이너끼리 통신하거나 외부와 연결될 때 쓰는 가상 네트워크입니다.

5) Compose

여러 컨테이너를 한 번에 정의하는 방식입니다. Docker는 Compose를 단일 YAML 파일로 서비스·네트워크·볼륨을 관리하는 도구로 설명합니다.

Docker Engine과 Synology Container Manager의 관계

이 부분이 가장 중요합니다.

Docker Engine은 실제로 컨테이너를 실행하는 핵심 엔진입니다. Docker 공식 문서에 따르면 Docker Engine은 dockerd 데몬, API, CLI로 구성되고 이미지·컨테이너·네트워크·볼륨 등을 관리합니다.

반면 시놀로지 DSM 7.3의 Container Manager는
NAS 환경에서 컨테이너를 GUI로 다루기 쉽게 만든 관리 레이어라고 보면 됩니다. Synology 공식 문서에서는 Project 메뉴에서 하나 또는 여러 컨테이너로 구성된 프로젝트를 생성·운영·관리할 수 있다고 안내합니다.

즉,

• Docker Engine = 실제 실행 엔진
• Container Manager = NAS에서 쉽게 다루는 관리 화면
• Compose / Project = 여러 컨테이너를 한 세트로 관리하는 방식

이라고 이해하면 거의 맞습니다.

DSM 7.3 Container Manager가 편한 이유

시놀로지 NAS를 쓰는 분이라면 명령어보다 GUI가 편한 순간이 많습니다.

Container Manager의 장점은 이런 쪽에서 크게 느껴집니다.

1) GUI로 이미지 검색과 다운로드가 쉬움

Docker Hub에서 이미지를 찾고 내려받는 과정을 NAS 화면에서 처리할 수 있습니다.

2) 컨테이너 생성이 쉬움

포트, 환경변수, 볼륨 마운트, 재시작 정책 등을 화면에서 입력할 수 있어 초보자 진입장벽이 낮습니다.

3) 로그와 상태 확인이 쉬움

실행 여부, 에러 로그, 리소스 사용 현황을 빠르게 확인할 수 있습니다.

4) Project 방식으로 Compose 운영이 가능함

여러 컨테이너를 하나의 프로젝트처럼 묶어 관리할 수 있어서, 웹앱 + DB 같이 함께 움직여야 하는 구성을 다루기 편합니다. Synology 공식 Project 문서도 이 개념을 지원한다고 설명합니다.

반대로 CLI Docker가 더 좋은 경우

Container Manager가 편하긴 하지만, 모든 상황에서 최고는 아닙니다.

직접 docker 나 docker compose 명령어를 쓰면 좋은 경우도 분명합니다.

1) 재현성이 좋음

Compose 파일 하나만 있으면 다른 서버에서도 거의 같은 구조로 올리기 쉽습니다. Docker Compose는 다중 컨테이너 앱을 YAML로 정의하고 전체 라이프사이클을 관리할 수 있다고 공식 문서가 설명합니다.

2) 백업과 버전관리가 쉬움

설정이 파일로 남기 때문에 Git으로 관리하기 좋습니다.

3) 자동화에 강함

스크립트, CI/CD, 배포 자동화와 연결하기 좋습니다.

4) 옵션을 세밀하게 다루기 좋음

GUI에서 안 보이는 옵션도 CLI로는 직접 제어하기 쉽습니다.

한눈에 비교: Docker CLI vs DSM 7.3 Container Manager

제 경험상

• 처음 시작은 Container Manager
• 구성이 커지면 Compose 파일 관리
  이 흐름이 가장 안정적이었습니다.

실제 예시 1: 가장 쉬운 시작, Nginx 하나 띄워보기

Docker 입문에서 제일 쉬운 예시는 정적 웹서버입니다.

예를 들어 Nginx 컨테이너 하나를 띄우면
“이미지 다운로드 → 컨테이너 실행 → 포트 연결”
이라는 Docker의 핵심 흐름을 빠르게 익힐 수 있습니다.

Docker 공식 문서에서 docker run은 이미지로부터 컨테이너를 실행하는 기본 명령이고, 이미지 참조에는 태그를 붙여 특정 버전을 지정할 수 있다고 설명합니다.

예시 명령은 이런 형태입니다.

docker run -d --name my-nginx -p 8080:80 nginx:latest

이 의미는 다음과 같습니다.

• -d : 백그라운드 실행
• --name my-nginx : 컨테이너 이름 지정
• -p 8080:80 : NAS나 서버의 8080 포트를 컨테이너 80 포트와 연결
• nginx:latest : 실행할 이미지

DSM 7.3 Container Manager에서는?

같은 작업을 GUI로 할 수 있습니다.

1. 이미지 검색에서 nginx 다운로드
2. 새 컨테이너 생성
3. 로컬 포트 8080 → 컨테이너 포트 80 연결
4. 실행
5. 브라우저에서 NAS주소:8080 접속

처음 Docker를 이해할 때는 이 예시 하나만 성공해도 감이 많이 잡힙니다.

실제 예시 2: 웹서비스답게, WordPress + MariaDB 같이 올리기

여기부터는 Compose 개념이 정말 편해집니다.

워드프레스는 단독으로 끝나지 않고 보통

• WordPress 컨테이너
• MariaDB 또는 MySQL 컨테이너
  두 개 이상이 함께 필요합니다.

이런 구조를 각각 따로 만들 수도 있지만, Compose로 관리하면 훨씬 정리됩니다. Compose는 여러 서비스를 한 YAML로 정의하는 방식이고, Docker 공식 빠른 시작도 Python 앱 + Redis 예시로 이런 멀티 컨테이너 구조를 보여줍니다.

아래는 입문용 예시입니다.

services:
  db:
    image: mariadb:11
    container_name: wp-db
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: strong_root_password
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wpuser
      MYSQL_PASSWORD: strong_wp_password
    volumes:
      - ./db_data:/var/lib/mysql  wordpress:
    image: wordpress:php8.2-apache
    container_name: wp-app
    restart: unless-stopped
    depends_on:
      - db
    ports:
      - "8081:80"
    environment:
      WORDPRESS_DB_HOST: db:3306
      WORDPRESS_DB_USER: wpuser
      WORDPRESS_DB_PASSWORD: strong_wp_password
      WORDPRESS_DB_NAME: wordpress
    volumes:
      - ./wp_data:/var/www/html

이 예시에서 중요한 포인트

• services 아래에 앱과 DB를 같이 정의
• depends_on으로 실행 순서를 어느 정도 정리
• volumes로 데이터를 컨테이너 밖에 보관
• 포트 8081:80으로 워드프레스 접속 가능

DSM 7.3 Container Manager에서는?

Project 기능에서 이런 YAML 기반 구성을 가져와 관리할 수 있습니다. Synology 공식 문서도 Project가 하나 또는 여러 컨테이너로 구성된 프로젝트를 생성·관리하는 메뉴라고 설명합니다.

즉, NAS에서도
“단순 GUI 클릭”만이 아니라
“Compose 스타일의 프로젝트 운영”이 가능하다는 점이 꽤 큰 장점입니다.

시놀로지 NAS에서 Docker를 쓸 때 특히 좋은 사례

제가 보기엔 DSM 7.3 Container Manager는 아래 같은 용도에서 특히 강합니다.

1) 홈서버 서비스 운영

• 워드프레스
• n8n
• Jellyfin
• Joplin Server
• Grafana
• Portainer

2) 작은 사내 서비스 테스트

• 내부용 웹앱
• API 서버
• 대시보드
• DB 실험 환경

3) 개발·검증용 분리 환경

같은 NAS 안에서도 프로젝트별로 분리해서 돌리기 좋습니다.

특히 시놀로지는 파일 접근, 폴더 권한, 백업 구조를 NAS 친화적으로 관리할 수 있어서 “홈랩 + 운영 연습” 용도로 꽤 괜찮습니다.

Docker를 처음 쓸 때 가장 많이 하는 실수

실제로 처음 할 때는 기술 자체보다 운영 습관에서 문제가 많이 납니다.

1) 데이터를 컨테이너 안에만 저장함

컨테이너 삭제 시 데이터가 같이 날아갈 수 있습니다.
DB, 업로드 파일, 설정 파일은 볼륨 또는 바인드 마운트로 분리하는 습관이 중요합니다. Docker Engine 문서도 persistent data에 volume 사용을 안내합니다.

2) 포트 충돌을 확인하지 않음

NAS에서 80, 443, 8080, 5000 계열 포트는 이미 다른 서비스가 쓰고 있을 수 있습니다.

3) latest 태그만 무조건 사용함

처음에는 편하지만, 나중에 버전이 달라져 예기치 않은 변경이 생길 수 있습니다. Docker 문서도 이미지 참조에 태그를 써서 특정 버전을 지정할 수 있다고 설명합니다.

4) 환경변수를 정리하지 않음

비밀번호나 설정값을 하드코딩하면 나중에 관리가 어렵습니다.

5) 백업을 안 함

Compose 파일, 데이터 폴더, DB 덤프는 반드시 따로 백업하는 습관이 필요합니다.

입문자에게 추천하는 시작 순서

처음이면 너무 어렵게 가지 않는 게 좋습니다.

1단계

Container Manager에서 Nginx 하나 띄워보기

2단계

볼륨 마운트와 포트 매핑 이해하기

3단계

환경변수 넣는 컨테이너 실행해보기
예: DB, 워드프레스

4단계

Project 기능으로 Compose 스타일 구성 써보기

5단계

나중에는 YAML 파일을 따로 관리하면서 버전관리까지 연결하기

이렇게 가면 GUI의 편의성과 Docker 본질 둘 다 잡을 수 있습니다.

결국 무엇이 더 좋을까

정리하면 이렇습니다.

Docker는 컨테이너를 실행하는 기술 자체이고,
DSM 7.3 Container Manager는 그 기술을 시놀로지 NAS에서 쉽게 다루는 도구입니다. Docker는 애플리케이션을 컨테이너로 패키징해 실행하게 해주고, Docker Compose는 여러 서비스를 하나의 YAML로 정의·운영하게 해주며, Synology의 Project 기능은 이런 멀티 컨테이너 구성을 NAS GUI에서 관리하는 데 초점을 둡니다.

그래서 제 추천은 단순합니다.

• 처음 배우는 단계라면 → DSM 7.3 Container Manager부터
• 반복 배포와 구조화가 필요해지면 → Compose 파일 관리까지
• 실무형으로 확장하고 싶다면 → CLI와 YAML 중심으로 이동

처음부터 명령어만 붙잡고 씨름할 필요는 없습니다.
반대로 GUI만 쓰다 보면 구조를 놓칠 수도 있습니다.
가장 좋은 방법은 시놀로지 GUI로 감을 잡고, 나중에 Compose로 정리하는 흐름입니다.

이 방식이 홈서버 운영에도 좋고, 나중에 리눅스 서버나 클라우드로 넘어갈 때도 가장 자연스럽습니다.

마무리

Docker를 배우면 단순히 “앱 하나 실행하는 법”만 익히는 게 아닙니다.
서비스를 더 깔끔하게 배포하고, 더 쉽게 옮기고, 더 안정적으로 관리하는 방식을 배우게 됩니다.

시놀로지 NAS의 DSM 7.3 Container Manager는 그 첫걸음을 꽤 쉽게 만들어줍니다.
특히 홈서버, 개인 블로그, 자동화 도구, DB 실험 환경, 내부 웹서비스를 운영하려는 분들에게는 정말 좋은 입문 도구입니다.

저도 처음에는 NAS에서 GUI로 시작했지만, 나중에는 Compose 파일을 직접 관리하는 쪽이 훨씬 편해졌습니다.
그래서 처음 시작하시는 분이라면 이렇게 말씀드리고 싶습니다.

“Container Manager로 시작하고, Docker Compose로 정리해가면 됩니다.”

그 흐름만 잡혀도 Docker가 훨씬 덜 어렵게 느껴질 겁니다.

게시물 Docker란 무엇인가? 시놀로지 NAS DSM 7.3 Container Manager와 함께 이해하는 실전 입문 가이드이 하우인포-IT·테크에 처음 등장했습니다.

1) 준비물 체크

• Windows 11 (Pro/Home 무관)
• Docker Desktop 설치 완료 (docker ps가 에러 없이 동작해야 함)
• 공유기: ipTIME (KT 회선 환경 가정)
• 접속 클라이언트: 안드로이드 Minecraft(베드락)

2) BDS 기본 포트(중요)

베드락 서버 기본 포트는 다음과 같습니다.

• UDP 19132 (게임 접속 포트)

즉, 내부/외부 모두 UDP 19132만 제대로 열리면 접속이 됩니다.

3) Docker로 BDS 설치(Compose 방식)

3-1. 서버 폴더 만들기 (월드/설정 영구 저장)

예시: D:\minecraft\bedrock

PowerShell:

mkdir D:\minecraft\bedrock
cd D:\minecraft\bedrock

3-2. docker-compose.yml 만들기

D:\minecraft\bedrock\docker-compose.yml 파일을 만들고 아래 내용을 그대로 붙여넣습니다.

services:
  bds:
    image: itzg/minecraft-bedrock-server:latest
    container_name: mc-bedrock
    ports:
      - "19132:19132/udp"
    environment:
      EULA: "TRUE"
      SERVER_NAME: "Howinfo Bedrock Server"
      GAMEMODE: "survival"
      DIFFICULTY: "normal"
      LEVEL_NAME: "HowinfoWorld"
      MAX_PLAYERS: "10"
      ONLINE_MODE: "true"
      TZ: "Asia/Seoul"
    volumes:
      - ./data:/data
    restart: unless-stopped

3-3. 서버 실행

docker compose up -d

정상 동작 확인:

docker ps
docker logs -f mc-bedrock

• docker ps에서 mc-bedrock이 Running이면 1차 성공
• docker logs -f에서 심각한 에러 없이 대기 상태로 들어가면 OK

4) Windows 방화벽 열기 (UDP 19132)

서버 PC(Windows 11)에서 방화벽이 막고 있으면, 같은 집에서도 접속이 안 될 수 있습니다.

Windows 보안 → 방화벽 및 네트워크 보호 → 고급 설정 → 인바운드 규칙 → 새 규칙

• 규칙 유형: 포트
• 프로토콜: UDP
• 포트: 19132
• 허용
• 프로필: 보통 개인(Private) 포함(필요 시 도메인도)
• 이름 예: Minecraft Bedrock UDP 19132

5) 안드로이드에서 “같은 와이파이”로 접속 확인 (내부 접속)

외부 설정 전에 먼저 내부에서 정상 접속되는지 확인하는 게 가장 빠릅니다.

5-1. 서버 PC 내부 IP 확인

PowerShell:

ipconfig

예: 192.168.0.15

5-2. 안드로이드 Minecraft에서 서버 추가

Minecraft(베드락) → 플레이 → 서버 → 서버 추가 (핸드폰에서 연결할 서버주소 또는 도메인 직접 입력)

• 서버 이름: 아무거나
• 서버 주소: 192.168.0.15 (서버 PC 내부 IP)
• 포트: 19132

✅ 같은 와이파이에서 접속이 되면, BDS 설치/컨테이너/방화벽은 거의 끝난 것입니다.

6) ipTIME 공유기 포트포워딩(외부 접속) 설정

이제 집 밖(모바일 데이터, 회사, 외부 PC)에서도 접속되게 하려면 공유기에서 포트를 열어야 합니다.

6-1. 서버 PC 내부 IP 고정(권장)

서버 PC의 내부 IP가 바뀌면 포트포워딩이 무용지물이 됩니다.

• ipTIME 관리자 페이지 접속(보통 192.168.0.1)
• DHCP 서버 설정 / 주소 예약 메뉴에서
  서버 PC의 MAC 주소에 192.168.0.15처럼 고정 예약 권장

6-2. 포트포워딩 추가

ipTIME 관리자 페이지 → NAT/라우터관리 → 포트포워드

• 프로토콜: UDP
• 외부 포트: 19132
• 내부 IP: 서버 PC 내부 IP (예: 192.168.0.15)
• 내부 포트: 19132

저장 후 적용

7) 집 밖(외부)에서 접속 확인

7-1. 공인 IP 확인

서버 PC 또는 휴대폰에서 “내 IP” 검색(공인 IP 확인)
외부 접속 테스트 시 주소로 사용합니다.

7-2. 안드로이드에서 모바일 데이터로 접속 테스트

안드로이드에서 와이파이를 끄고(모바일 데이터로 전환) Minecraft → 서버 추가:

• 서버 주소: 공인 IP
• 포트: 19132

✅ 모바일 데이터에서 접속되면 외부 접속까지 성공입니다.

8) 외부 접속이 안 될 때(가장 흔한 원인 3가지)

1. UDP 포트포워딩을 TCP로 걸어둔 경우
   • 베드락은 기본이 UDP입니다. 포워딩 프로토콜이 UDP인지 다시 확인하세요.
2. Windows 방화벽 규칙 누락
   • UDP 19132 인바운드가 실제로 허용됐는지 재확인
3. 이중 NAT (KT 장비 + ipTIME)
   • KT 모뎀/공유기가 라우팅을 하고, ipTIME도 라우팅을 하면 “겹 NAT”가 생겨 외부 접속이 막히는 경우가 있습니다.
   • 이때 해결 방법은 보통:
     • KT 장비를 브릿지 모드로 전환하거나
     • KT 장비에서 ipTIME을 DMZ로 지정하거나
     • ipTIME을 AP 모드로 전환(권장 시나리오에 따라 다름)

외부 접속이 막히면, 집 네트워크 구조(“KT 장비가 따로 있는지”)부터 확인하는 게 제일 빠릅니다.

9) 운영 팁(최소한만)

• 서버 재시작:

docker restart mc-bedrock

• 서버 종료/시작:

docker stop mc-bedrock
docker start mc-bedrock

• 데이터(월드/설정) 저장 위치:
  • D:\minecraft\bedrock\data\
    이 폴더만 백업하면 됩니다(서버 중지 후 압축 권장).

마무리

정리하면, Windows 11에서 Docker로 BDS 운영은 아래 순서로 끝납니다.

1. Docker Compose로 BDS 실행
2. Windows 방화벽 UDP 19132 허용
3. 안드로이드(같은 와이파이) 접속 확인
4. ipTIME UDP 19132 포트포워딩
5. 안드로이드(모바일 데이터)로 외부 접속 확인

여기까지 되면 “서버가 실제로 운영 가능한 상태”입니다.

게시물 너무나 쉬운 윈도우즈11+docker 이용 베드락 마인크래프트 설치하고 외부에서 접근하여 게임즐기기이 하우인포-IT·테크에 처음 등장했습니다.

저는 미니스포럼 N5 Pro 같은 저전력·고효율 미니PC를 홈서버/NAS 보조 서버로 쓰는 경우가 많은데, 이때 Windows 11 Pro에서 Docker를 가장 쾌적하게 돌리는 방식은 Docker Desktop + WSL 2 백엔드 조합이었습니다.

이 글은 초보자도 그대로 따라 하면 설치가 끝나는 흐름으로 정리했고, 실제로 많이 막히는 오류 해결까지 함께 넣었습니다. (붙여넣기용 완성본)

1) 오늘 설치할 구성 (핵심 요약)

• Windows 11 Pro
• WSL 2 활성화
• Docker Desktop 설치 (WSL 2 백엔드 사용)
• docker run hello-world로 최종 검증
• 오류 발생 시 체크 순서 제공

2) 사전 준비 체크 (여기서 80%가 결정됩니다)

(1) BIOS 가상화(VT-x/AMD-V) 활성화 확인

WSL 2와 Docker는 가상화 기능에 의존합니다.

• BIOS 메뉴에서 아래 항목이 Enabled인지 확인
  • Intel Virtualization Technology (VT-x)
  • 또는 SVM / AMD-V

✅ 증상 힌트

• 가상화가 꺼져 있으면 WSL 설치가 되더라도 Docker가 정상 실행되지 않거나, WSL이 1로 떨어지는 경우가 있습니다.

(2) Windows 기능 켜기 (필수)

시작 메뉴 → “Windows 기능 켜기/끄기” 검색 후 실행, 아래 항목을 체크합니다.

• Linux용 Windows 하위 시스템
• 가상 머신 플랫폼
• (Pro라면 켜두면 좋은 편) Hyper-V

체크 후 [확인] → 재부팅

✅ 포인트

• WSL 2는 “가상 머신 플랫폼”이 꺼져 있으면 정상 동작이 어렵습니다.
• Hyper-V는 WSL 2 백엔드에서도 환경에 따라 도움이 됩니다(특히 회사 PC/보안정책 환경).

3) WSL 2 설치 및 업데이트 (PowerShell 관리자)

PowerShell을 관리자 권한으로 실행합니다.

(1) WSL 설치/업데이트

wsl --install
wsl --update

(2) WSL 기본 버전 2 고정

wsl --set-default-version 2

(3) WSL 상태 확인(선택)

wsl --status
wsl -l -v

✅ 여기서 확인할 것

• wsl -l -v 출력에서 배포판이 보이고, VERSION이 2인지 확인

4) 리눅스 배포판(Ubuntu) 설치 (없으면 반드시)

wsl -l -v에서 배포판이 하나도 없다면 Ubuntu를 설치합니다.

wsl --install -d Ubuntu

설치 후 Ubuntu를 한 번 실행하면 Linux 사용자 이름/비밀번호를 설정하는 단계가 나옵니다.
(비밀번호는 입력해도 화면에 안 보이는 게 정상입니다)

5) Docker Desktop 설치 (WSL 2 백엔드로)

(1) 설치 파일 실행

Docker Desktop Installer.exe 실행

(2) 설치 중 가장 중요한 옵션

설치 과정에서 아래 옵션이 나오면 반드시 체크된 상태로 진행합니다.

• ✅ Use WSL 2 instead of Hyper-V (recommended)

(3) 설치 완료 후 재부팅

설치가 끝나면 Close and restart로 재부팅합니다.

6) Docker Desktop 설정 확인 (WSL 통합)

재부팅 후 Docker Desktop 실행 → Settings에서 확인합니다.

• Settings → Resources → WSL Integration
  • Ubuntu(또는 설치한 배포판)에 대해
  • ✅ Enable integration 켬

✅ 추천

• 배포판이 여러 개라면, 실제 사용할 배포판 하나만 통합 켜두는 게 관리가 편합니다.

7) 설치 확인 테스트 (여기까지 오면 끝)

PowerShell 또는 Windows Terminal에서 실행합니다.

(1) 버전 확인

docker --version

(2) hello-world 테스트

docker run hello-world

아래 문구가 나오면 성공입니다.

• Hello from Docker!

8) 오류 해결 모음 (실제로 제일 많이 막히는 구간)

아래는 “증상 → 원인 → 해결” 순서로 정리했습니다.

오류 1) docker 명령어가 인식되지 않음

증상

• docker : The term 'docker' is not recognized...

원인

• Docker Desktop 설치가 안 되었거나, 재부팅 전 상태이거나, PATH 적용이 안 된 케이스

해결

1. Docker Desktop이 설치되어 있는지 확인
2. 재부팅 1회
3. 그래도 안 되면 Docker Desktop 재설치

오류 2) WSL 2 installation is incomplete

증상

• Docker Desktop 실행 시 WSL 2 커널 관련 경고

원인

• WSL 업데이트/Windows 업데이트 미반영 또는 재부팅 누락

해결

1. PowerShell(관리자) 실행

wsl --update

2. 재부팅
3. Windows Update 최신 상태 확인(선택)

오류 3) wsl -l -v에서 VERSION이 1로 뜸

원인

• 기본 버전이 2로 고정되지 않았거나, 배포판이 1로 생성된 상태

해결

wsl --set-default-version 2
wsl --set-version Ubuntu 2

오류 4) 0x80370102 / “가상 머신 플랫폼” 관련 오류

증상

• WSL 실행/설치 중 가상화 관련 오류 코드 발생

원인

• BIOS 가상화 꺼짐, Windows 기능 미활성화, 보안 기능 충돌

해결 체크 순서

1. BIOS VT-x/AMD-V Enabled
2. Windows 기능: Linux용 Windows 하위 시스템 / 가상 머신 플랫폼 체크
3. 재부팅
4. PowerShell 관리자에서 wsl --update

오류 5) docker run hello-world가 다운로드에서 멈춤

원인

• 회사망/프록시/방화벽/DNS 이슈가 흔함

해결

• 집 인터넷/모바일 핫스팟에서 한 번 테스트
• Docker Desktop의 네트워크/프록시 설정 확인
• 회사 PC라면 보안 정책상 Docker 허용 여부 확인 필요

오류 6) Docker Desktop이 “Starting…”에서 멈춤

원인

• WSL 통합 문제, 배포판 손상, 업데이트 충돌

해결(가벼운 순서)

1. Docker Desktop 종료 후 재실행
2. 재부팅
3. PowerShell 관리자:

wsl --shutdown

4. Docker Desktop 다시 실행
5. 그래도 안 되면 WSL 배포판 재설치 고려(마지막 수단)

9) 설치 후 추천: 홈서버/NAS 운영에 바로 쓰는 기본 명령어

컨테이너 목록 보기

docker ps
docker ps -a

이미지 목록 보기

docker images

컨테이너 중지/삭제

docker stop <컨테이너ID>
docker rm <컨테이너ID>

이미지 삭제

docker rmi <이미지ID>

10) 마무리 (제가 이 구성을 추천하는 이유)

Windows 11 Pro에서 Docker를 운영할 때, Hyper-V 기반으로도 가능하지만
실사용(특히 미니PC/홈서버)에서는 WSL 2 백엔드가 설치·유지보수 난이도가 낮고 안정적인 편이었습니다.

• 개발 환경(리눅스 도구)도 WSL에서 자연스럽게 이어지고
• 컨테이너 운영도 Docker Desktop에서 시각적으로 관리 가능해서
• “홈서버 운영 + 개발” 둘 다 잡기 좋았습니다.

게시물 Windows 11 Pro Docker 설치 가이드 (WSL 2 백엔드) + 오류 해결이 하우인포-IT·테크에 처음 등장했습니다.

NAS는 결국 “필요할 때만 켜서 쓰고, 평소엔 꺼두는” 운영이 핵심이죠.
그런데 윈도우 11 Pro 설치 후 기본 설정만으로는 WOL이 안 되는 경우가 정말 많습니다.
저도 “다 설정했는데 왜 안 켜지지?”를 반복하다가, 결론적으로 아래 2개가 핵심 원인이었습니다.

• BIOS의 ErP Ready
• 윈도우의 빠른 시작(Fast Startup)

게다가 외부에서 깨우려면 ipTIME 공유기 설정까지 연결되어야 완성됩니다.
이 글 하나로 **BIOS → Windows → ipTIME(외부 WOL)**까지 끝낼 수 있게 구성해볼게요.

요약

1. BIOS에서 ErP Ready = Disabled, Wake on PCI-E = Enabled
2. Windows에서 랜카드 Wake on Magic Packet = Enabled, 전원관리에서 매직 패킷만 허용
3. Windows 전원 옵션에서 ‘빠른 시작 켜기’ 해제
4. ipTIME은 **WOL 기능 + DDNS(원격 접속)**로 외부에서도 깨우기

1. WOL이 안 되는 대표 증상 (제가 겪었던 것들)

아래 중 하나라도 해당되면, 거의 확실히 이 글의 설정이 필요합니다.

• 절전(Sleep)에서는 깨우는데 종료(Shut down) 후에는 WOL이 안 됨
• 종료 후 랜포트 LED가 꺼지거나 링크가 사라짐
• 같은 집(내부망)에서는 되는데 외부(LTE/회사)에서는 안 됨
• 어떤 날은 되고 어떤 날은 안 됨 (대개 빠른 시작/드라이버 전원정책 영향)

2. BIOS 설정 (전원 꺼져도 랜카드가 살아있게 만들기)

목표는 딱 하나입니다.
PC가 꺼져 있어도(Soft Off) 랜카드가 전원을 유지하고 매직패킷을 받을 수 있게 하는 것.

2-1) BIOS 진입

• 부팅 시 Del 키 연타

2-2) ErP Ready 비활성화 (가장 중요)

• Advanced → ACPI Settings
• ErP Ready = Disabled

ErP가 켜져 있으면 대기전력을 줄이려고 랜카드 전원까지 차단하는 경우가 많습니다.
이 상태에서는 WOL 신호가 와도 받을 수가 없습니다.

2-3) WOL 활성화 (PCI-E Wake)

아래 중 하나로 보이는 항목을 찾아 켭니다(보드/BIOS마다 명칭이 조금 다름).

• Wake configuration
• Resume By PCI-E Device
• Wake on PCI-E
• Wake on LAN

→ 해당 항목을 Enabled

2-4) 저장 후 재부팅

• F10 → Save & Exit

✅ BIOS 체크포인트(매우 유용)
PC를 “종료”한 뒤, 랜포트 LED가 살아있는지 보세요.
LED가 완전히 꺼진다면 ErP나 전원 항목이 아직 막고 있을 가능성이 큽니다.

3. Windows 11에서 네트워크 어댑터 WOL 설정

BIOS가 준비되었으면, 이제 Windows가 랜카드를 “깨울 수 있는 장치”로 허용해야 합니다.

3-1) 장치 관리자 열기

• 시작 버튼 우클릭 → 장치 관리자
• 네트워크 어댑터 펼치기
• 사용 중인 유선 어댑터(예: Realtek PCIe 2.5GbE) 우클릭 → 속성

3-2) [고급] 탭 설정

• Wake on Magic Packet = Enabled
• (있다면) Shutdown Wake-On-LAN = Enabled
• (있다면) Wake on pattern match = Disabled 권장
  → 원치 않는 트래픽에 혼자 켜지는 현상을 줄여줍니다.

3-3) [전원 관리] 탭 설정

아래 두 개는 거의 필수입니다.

• ✅ “이 장치를 사용하여 컴퓨터의 대기 모드를 종료할 수 있음” 체크
• ✅ “매직 패킷에서만 컴퓨터의 대기 모드를 종료할 수 있음” 체크

두 번째 체크가 없으면, 네트워크 브로드캐스트/스캔 패킷에 의해 의도치 않게 켜질 수 있습니다.

4. 결정타: ‘빠른 시작(Fast Startup)’ 끄기

윈도우 10/11의 빠른 시작은 종료를 완전 종료가 아니라 “하이브리드 종료”처럼 만들어서,
환경에 따라 종료 후 WOL이 무시되는 경우가 꽤 많습니다.

4-1) 빠른 시작 해제 경로

• 제어판 → 하드웨어 및 소리 → 전원 옵션
• 좌측 전원 단추 작동 설정
• 상단 ‘현재 사용할 수 없는 설정 변경’ 클릭
• 하단 [빠른 시작 켜기(권장)] 체크 해제
• 저장

✅ 실전 팁
“절전은 되는데 종료는 안 됨”이면, 이 단계가 진짜 마지막 퍼즐일 가능성이 큽니다.

5. 내부망(집 안)에서 먼저 WOL 테스트하기

외부 WOL로 바로 가지 말고, 먼저 집 안에서 성공시키는 게 순서입니다.

• 스마트폰 WOL 앱 또는 PC 도구로 같은 와이파이/내부망에서 매직패킷 전송
• N5 Pro가 켜지면 → Windows/BIOS는 성공
• 안 켜지면 → 2~4단계를 다시 점검

6. ipTIME 공유기에서 외부 WOL 완성하기 (진짜 NAS 운영의 핵심)

이제 핵심입니다.
집 안에서는 되었는데 외부에서 안 된다면, 대부분 ipTIME에서 아래 이슈 때문입니다.

• PC가 꺼지면 공유기 ARP 테이블에서 MAC↔IP 정보가 사라짐
• 외부에서 들어온 매직패킷이 내부 브로드캐스트로 전달되지 않음

그래서 ipTIME 환경에서는 가장 안정적으로 “공유기의 WOL 기능”을 쓰는 방식을 추천합니다.

6-1) 사전 준비: 고정 IP + MAC 주소 확보

외부 WOL은 “고정 IP”가 거의 필수입니다.

① MAC 주소 확인

• cmd 실행 → ipconfig /all
• “물리적 주소(Physical Address)” 확인
  예: AA-BB-CC-DD-EE-FF

② ipTIME에서 DHCP 고정할당(권장)

• 관리자 페이지 접속: 192.168.0.1
• 메뉴 예시: 고급 설정 → 네트워크 관리 → 내부 네트워크 설정(DHCP 서버)
• DHCP 고정할당 / IP-MAC 바인딩 메뉴에서
  N5 Pro MAC 주소 등록 + 고정 IP(예: 192.168.0.15) 지정

✅ 이걸 해두면 WOL 목록 등록/ARP 유지가 훨씬 안정적입니다.

6-2) ipTIME WOL 기능으로 내부 WOL 등록

• 192.168.0.1 접속 후 로그인
• WOL 메뉴(펌웨어/모델에 따라 다름)
  • 고급 설정 → 특수 기능 → WOL
  • 또는 시스템 관리 → 기타 설정 → WOL

WOL 목록에 N5 Pro 등록

• 장치 이름: N5Pro-NAS
• MAC 주소: 위에서 확인한 값 입력
• (필요 시) IP 주소도 함께 입력
• 저장

6-3) 외부에서 깨우는 방법 1 (가장 단순): ipTIME DDNS + 원격 접속 후 WOL 버튼

ipTIME 공유기 관리페이지에 외부에서 들어가서 “WOL 버튼”을 누르는 방식입니다.
구성이 단순하고 성공률도 높습니다.

① ipTIME DDNS 설정

• 고급 설정 → 특수 기능 → DDNS 설정
• ipTIME 계정으로 DDNS 도메인 생성
  예: myhome.iptime.org

② 원격관리(외부 접속) 설정

• 고급 설정 → 시스템 관리 → 원격 관리(또는 웹 관리)
• 원격 관리 활성화
• 관리 포트는 꼭 변경(보안상 매우 중요)
  예: 8443 같은 값으로 변경

③ 외부에서 접속해서 WOL 실행

• 외부(모바일 LTE)에서 브라우저로 접속
  myhome.iptime.org:8443
• 로그인 → WOL 메뉴 → N5Pro-NAS 깨우기 실행

✅ 장점

• 복잡한 브로드캐스트/포트포워딩보다 성공률 높음
• 공유기가 내부로 매직패킷을 뿌려주므로 안정적

⚠️ 보안 팁(꼭!)

• 관리자 비번 강하게
• 원격관리 포트 변경 필수
• 가능하면 원격관리 허용 IP 제한(기능이 있다면) 사용 권장

6-4) 외부에서 깨우는 방법 2 (실전 최강 안정성): 내부 “대리 송신기” 구성

저는 개인적으로 이 방식이 가장 마음 편했습니다.

• 집에 항상 켜져 있는 장치(시놀로지/오렌지파이/라즈베리파이)가 있다면
• 외부에서 그 장치로 접속(SSH/VPN) → 내부에서 WOL 송신

✅ 장점

• 공유기 브로드캐스트/ARP 문제를 대부분 회피
• 공유기 원격관리 포트를 외부에 열지 않아도 되는 경우가 많아 보안도 좋음

7. 최종 점검 체크리스트 (이대로만 하면 됩니다)

BIOS

• ErP Ready = Disabled
• Wake on LAN / Resume by PCI-E = Enabled
• 종료 후 랜포트 LED가 살아있음

Windows (장치 관리자)

• Wake on Magic Packet = Enabled
• (있으면) Shutdown WOL = Enabled
• 전원 관리: “장치로 깨우기” 체크
• 전원 관리: “매직 패킷만” 체크

Windows (전원 옵션)

• 빠른 시작 끔

ipTIME(외부 WOL)

• DHCP 고정할당으로 내부 IP 고정
• ipTIME WOL 목록에 MAC 등록
• (선택) DDNS + 원격관리 포트 변경 후 외부에서 WOL 실행
  또는
• (강추) 내부 대리 송신기(홈서버/나스/라즈베리파이) 구성

8. 자주 묻는 질문(FAQ)

Q1. 절전에서는 되는데 종료에서는 안 돼요.

• 빠른 시작이 켜져 있거나
• 드라이버에서 Shutdown WOL이 꺼져 있거나
• BIOS ErP가 켜져 있을 가능성이 큽니다.
  → 이 글의 2~4장 순서대로 다시 체크하세요.

Q2. 집에서는 되는데 밖에서는 안 돼요.

• 공유기의 ARP/브로드캐스트 이슈일 가능성이 큽니다.
  → ipTIME WOL 기능 + DDNS 원격 접속 방식을 쓰면 성공률이 올라갑니다.
  → 가장 안정적인 건 “내부 대리 송신기” 방식입니다.

마무리

미니스포럼 N5 Pro를 NAS로 운영할 때, WOL이 잡히면 운영 난이도가 확 내려갑니다.
필요할 때만 깨워서 쓰고 다시 끄는 패턴이 가능해지니까요.

핵심은 한 줄입니다.

ErP 끄고, 빠른 시작 끄고, ipTIME WOL로 외부에서도 깨우기.

게시물 [리뷰/팁] 미니스포럼 N5 Pro NAS 구축기: 윈도우 11에서 WOL 완벽 설정하기 (BIOS + Windows + ipTIME 외부 WOL까지)이 하우인포-IT·테크에 처음 등장했습니다.

오늘 미니스포럼 N5 Pro가 드디어 도착했습니다. ^^
그런데… 저는 첫날부터 한 번 크게 삽질을 시작합니다.
**SSD 128GB / 메모리 16GB가 ‘같이 왔는데 어디를 봐도 없더라구요 그런데 본체에 탑재 되어 있음 , OS가 설치되어 있을 줄 알고 전원을 넣었다가 부팅이 안 되는 상황을 겪었습니다. 이게 뭘까나 .
결국 제조사 안내와 MinisCloud OS Installation step(PDF) 문서를 참고해 OS를 새로 설치하고 나서야 정상 부팅에 성공했어요.

이 글은 저처럼 “처음 받자마자 바로 쓰려다 막히는” 분들을 위해, 언박싱 → SSD/메모리 장착 → OS 설치(재설치) → 첫 세팅까지 한 번에 정리한 실전 기록입니다.

1) 언박싱: 사진 몇장 올립니다.

2) 첫날 멘붕 포인트: “동봉 = 탑재 = OS 설치”가 아니었다

제가 실수한 흐름은 이랬습니다.

• SSD 128GB / RAM 16GB가 같이 왔음
• 당연히 본체에 장착돼 있고, OS도 설치돼 있을 줄 알고 전원 ON
• 결과: 부팅 불가(또는 OS 진입 불가)
• 해결: SSD/메모리 장착 후 MinisCloud OS를 새로 받아 설치

혹시 저처럼 “받자마자 부팅이 안 된다”면, 무조건 아래부터 확인하는 게 빠릅니다.

• SSD가 실제로 장착돼 있는지
• 메모리가 장착돼 있는지
• OS가 비어있거나 손상된 상태는 아닌지(재설치 필요)

3) SSD / 메모리 장착: OS 설치 전에 먼저 끝내야 할 작업

3-1. 작업 전 필수

• 전원 케이블 완전 분리
• 정전기 방지(금속 프레임 잠깐 만지기)
• 나사/부품 분실 주의

3-2. SSD 장착 체크(가장 흔한 실수)

• M.2 SSD는 규격이 여러 종류라, NVMe인지부터 확인하고 장착합니다.
• “예전에 쓰던 M.2”를 재활용하려다가 SATA 방식이라 인식이 안 되는 경우도 많아요.

3-3. 메모리 장착 체크

• 메모리 슬롯에 끝까지 밀어 넣고 “딱” 고정되는 느낌이 나야 합니다.
• 헐겁게 끼워지면 부팅 자체가 안 되거나, 전원만 들어오고 화면이 안 뜨는 경우가 생깁니다.

저는 첫날 “어? 왜 안 켜지지?”에서 시간을 많이 썼는데, 지금 생각하면 SSD/메모리 장착 여부를 먼저 확인했으면 30분 컷이었어요.

4) OS 설치(재설치) 준비물: 이거 없으면 시작이 안 됨

제가 실제로 사용한 “정석 루틴”은 이 준비물부터입니다.

• 다른 PC 1대(Windows면 가장 편함)
• USB 메모리(8GB 이상 권장)
• 모니터(HDMI), 키보드/마우스
• 유선 LAN(가능하면 권장)
• MinisCloud OS 설치 파일 + 설치 안내 PDF(Installation step)

5) MinisCloud OS 설치(재설치) 실전 루틴

아래 흐름은 **PDF 설치 가이드(Installation step)**를 참고해서, 제가 실제로 해결한 방식대로 “실수 안 나게” 정리한 절차입니다.

5-1. 설치 USB 만들기

1. MinisCloud OS 설치 파일을 내려받습니다.
2. 안내 문서에서 지정한 방식대로 부팅 USB를 생성합니다.
   • 여기서 실패가 많습니다. “파일을 USB에 복사”가 아니라 **부팅 가능한 형태로 ‘굽기/쓰기’**가 되어야 합니다.

자주 터지는 문제

• USB가 부팅으로 안 잡힘 → “USB 생성이 제대로 안 됨” 가능성이 큼
• USB 포트 변경/다른 USB로 재시도하면 해결되는 경우도 많습니다.

5-2. N5 Pro에 연결(설치 모드)

• USB(설치용) 연결
• HDMI로 모니터 연결
• 키보드/마우스 연결
• 유선 LAN 연결
• 전원 ON

5-3. 부팅 메뉴(또는 BIOS)에서 USB 부팅

• 전원을 켠 직후, 부트 메뉴 키를 눌러 USB를 선택합니다.
• 메뉴 진입이 안 되면 재부팅하면서 타이밍을 조금씩 조정합니다.

5-4. 설치 대상 디스크 선택(중요)

• 설치 화면에서 “대상 디스크”를 고르게 됩니다.
• 보통 OS는 **내장 SSD(128GB)**에 설치하는 흐름이 가장 단순합니다.

⚠️ 주의
이 단계에서 디스크 선택을 잘못하면, 데이터가 있는 드라이브를 포맷할 수 있습니다.
첫 설치는 ‘새 디스크만’ 꽂고 시작하는 게 마음 편합니다.

5-5. 설치 완료 → 재부팅 → USB 제거

• 설치가 끝나면 재부팅 후 USB를 뽑고 내장 SSD로 부팅되게 합니다.
• 여기서 USB를 꽂아둔 채로 두면 다시 설치 화면으로 들어가 “왜 또 설치 화면이지?”가 발생합니다.

6) 설치 후 첫 세팅: “당일에 끝내는 기본 안정화”

OS 설치가 끝났으면, 그 다음은 운영 안정화입니다. 저는 첫날에 아래만은 꼭 해둡니다.

6-1. 계정/보안

• 관리자 계정 비밀번호는 강하게 설정
• 가능하면 2단계 인증/접근제한 옵션도 함께 확인

6-2. 네트워크

• 유선 LAN으로 먼저 안정화
• 이후에 필요하면 고속 포트(5G/10G) 환경을 단계적으로 업그레이드

6-3. 스토리지 구성

• 단일 디스크로 시작할지, 미러/RAID로 갈지 결정
• “백업이 필요한 데이터”라면, 초기부터 이중화/백업 루틴을 설계하는 게 마음 편합니다.

6-4. 설치 위치/발열

• NAS는 24시간 도는 장비라, 통풍 확보가 중요합니다.
• 벽에 너무 붙이지 말고, 상단/후면 공기 흐름을 막지 않게 설치합니다.

7) 제가 느낀 N5 Pro 첫인상(짧은 후기)

• “NAS + 미니PC” 성격이 강해서, 단순 파일서버를 넘어서 도커/자동화/개발 쪽으로 확장하기 좋아 보였습니다.
• 다만 첫날은 “기대(탑재/설치 완료)” 때문에 삽질을 했고,
  이 경험 덕분에 오히려 설치 과정 전체를 내 손으로 정리해두게 되어 장기적으로는 더 든든해졌습니다.

8) 당일 체크리스트(복붙용)

• SSD 128GB가 본체에 실제 장착됐는지 확인
• 메모리 16GB가 정상 장착됐는지 확인
• 설치 USB 생성(부팅 가능 형태로 쓰기 완료)
• HDMI/키보드/마우스 연결 후 부팅
• 부트 메뉴/BIOS에서 USB 부팅 선택
• 설치 대상 디스크 선택 실수 방지(데이터 디스크 포맷 주의)
• 설치 완료 후 재부팅 + USB 제거
• 관리자 계정/보안 설정
• 스토리지 구성(단일/미러/RAID) 결정
• 통풍 확보/설치 위치 정리

9) FAQ

Q1. “받자마자 부팅이 안 돼요.” 제일 먼저 뭘 봐야 하나요?

A. SSD/메모리가 동봉만 되고 미장착인 경우가 있어요. 내부를 열어 실제로 장착되어 있는지가 1순위입니다.

Q2. OS가 설치된 줄 알았는데 비어있을 수도 있나요?

A. 네. 케이스에 따라 OS가 준비되어 있어도 손상/미탑재 상태일 수 있어, MinisCloud OS 재설치 루틴을 알아두면 가장 빨리 복구됩니다.

Q3. 설치 USB 만들었는데 USB로 부팅이 안 돼요.

A. 파일 복사가 아니라 **부팅 가능한 형태로 “쓰기/굽기”**가 되어야 합니다. USB를 바꾸거나 다른 포트로 재시도하면 해결되는 경우가 많습니다.

Q4. 디스크 여러 개 꽂아도 되나요?

A. 가능하지만 첫 설치는 새 디스크만으로 시작하는 편이 안전합니다. 설치 과정에서 디스크 선택을 잘못하면 포맷 사고가 날 수 있어요.

저처럼 삽질 하지 마시고 . 일단 중요한것은

os가 설치가 안되어 있고 미니스포럼 사이트에서 os를 받아서 싱글보드 이미지 굽듯이 구워서 다시 설치하고 부팅 그리고 같은 네트워크에서 동일 대역에서 접근해야 함 할때 . 인증등 있음 아래 참고

게시물 미니스포럼 N5 Pro 언박싱부터 OS 설치까지: 집 NAS 세팅 실전기이 하우인포-IT·테크에 처음 등장했습니다.

NAS나 서버 IP가 바뀌면 포워딩이 무용지물 됩니다.

설정 위치

고급 설정 → 네트워크 관리 → 내부 네트워크 설정
→ DHCP 서버 설정 → 주소 예약

예시:

✔ 반드시 고정 IP 설정 먼저

2️⃣ 포트포워딩 설정 메뉴 이동

고급 설정 → NAT/라우터 관리 → 포트포워드 설정

3️⃣ 새 규칙 추가

예시 ① NAS DSM 접속

예시 ② WordPress (Docker)

외부 접속:

http://공인IP:8080

또는 DDNS 사용 시:

http://myhome.iptime.org:8080

🔍 정상 작동 확인 방법

외부 LTE/5G 환경에서 테스트하세요.

✔ 스마트폰 데이터로 접속
✔ 포트 오픈 확인 사이트 이용
✔ telnet 테스트

🚨 자주 발생하는 문제 5가지

❗ 1. 내부 IP 변경됨

→ DHCP 예약 안했을 경우 발생

❗ 2. 이중 NAT 문제

공유기 WAN IP 확인:

고급 설정 → 시스템 정보

WAN IP가

192.168.x.x
10.x.x.x

라면 → 통신사 모뎀 브릿지 필요

❗ 3. 80/443 직접 개방 위험

보안 위험 매우 높음

✔ 관리자 페이지 직접 노출 금지
✔ 가능하면 Reverse Proxy 사용
✔ SSL 적용 필수

❗ 4. Docker 포트 매핑 불일치

예:

docker run -p 8080:80

공유기 외부포트 8080
내부포트 8080이 아닌 80으로 헷갈리는 경우 많음

❗ 5. NAS 방화벽 차단

시놀로지 사용 시:

제어판 → 보안 → 방화벽

포트 허용 필요

🧱 실전 운영 예시 (홍경민님 구조 기준)

[인터넷]
    ↓
[ipTIME 공유기]
    ↓
 ├─ NAS (WordPress, MariaDB)
 ├─ n8n
 ├─ Orange Pi 5

✔ 공유기에서 포트 전달
✔ NAS 내부 방화벽 허용
✔ 가능하면 80/443 대신 Reverse Proxy 사용

🔐 보안 권장 설정

✔ 관리자 포트 변경
✔ 원격 관리 비활성화
✔ 포트 범위 제한
✔ 접근 IP 제한
✔ Fail2ban 또는 WAF 사용

📊 포트포워딩 vs VPN 비교

💡 결론

✔ 테스트용 서버 → 포트포워딩 충분
✔ 상시 운영 서버 → VPN 또는 Reverse Proxy 권장
✔ 수익형 블로그 운영 → 80/443 직접 개방 비추천

게시물 ipTIME 포트포워딩 설정 방법 (실전 기준)이 하우인포-IT·테크에 처음 등장했습니다.

📌 왜 DDNS가 필요할까?

집에서 NAS, 웹서버, n8n, WordPress, CCTV 등을 운영하다 보면
외부에서 접속하려고 할 때 이런 문제를 겪습니다.

❗ “우리 집 공인 IP가 계속 바뀐다”

통신사에서 제공하는 공인 IP는 대부분 유동 IP입니다.
IP가 바뀌면 기존 접속 주소는 무용지물이 됩니다.

👉 이걸 해결하는 방법이 DDNS (Dynamic DNS) 입니다.

🧠 DDNS란 무엇인가?

DDNS는

바뀌는 IP 주소를
항상 같은 도메인 주소로 연결해주는 서비스

예:

123.45.67.89  →  myhome.iptime.org
IP 변경됨 →  59.22.11.88 → 자동 반영

ipTIME 공유기는 자체 DDNS 서비스를 무료로 제공합니다.

🛠 ipTIME 공유기 DDNS 설정 방법 (실전)

1️⃣ 공유기 관리자 접속

브라우저 주소창에 입력:

http://192.168.0.1

관리자 로그인

2️⃣ 고급 설정 이동

고급 설정 → 특수기능 → DDNS 설정

3️⃣ ipTIME DDNS 사용 선택

• DDNS 사용: ✔ 체크
• 호스트 이름 입력
  • 예: howinfohome
  • 최종 주소: howinfohome.iptime.org

저장 클릭

4️⃣ 정상 등록 확인

등록이 정상이라면 상태가 이렇게 표시됩니다.

등록 성공
현재 공인 IP: xxx.xxx.xxx.xxx

이제 외부에서 아래 주소로 접근 가능:

자기도메인명.iptime.org

🌐 외부 접속하려면 추가 설정 필요

DDNS는 “주소”만 만들어주는 기능입니다.

실제 접속을 하려면:

✅ 포트포워딩 설정

고급 설정 → NAT/라우터 관리 → 포트포워드 설정

예시:

🔐 보안 설정 꼭 하세요

외부 공개는 위험합니다.

반드시 설정할 것

• 관리자 비밀번호 변경
• 원격 관리 포트 변경
• 80/443 직접 개방 최소화
• 가능하면 Reverse Proxy 사용
• NAS 방화벽 활성화

홍경민님처럼 NAS + Docker + WordPress 운영 중이라면
Reverse Proxy + SSL 인증서 조합이 가장 안전합니다.

🚨 자주 발생하는 문제

❗ DDNS 등록 실패

원인:

• 공유기가 공인 IP를 직접 받지 못한 경우
• 모뎀 + 공유기 이중 NAT 구조

확인 방법:

공유기 상태정보에서

WAN IP가 192.168.x.x / 10.x.x.x 인 경우

→ 통신사 모뎀에 브릿지 모드 요청 필요

❗ 접속은 되는데 내부 접속 안됨

• 포트포워딩 오류
• 내부IP 변경됨 (고정IP 설정 필요)

🧱 실전 구성 예시 (홈서버 운영 기준)

홍경민님처럼 NAS + SBC 운영 구조라면:

[인터넷]
    ↓
[ipTIME 공유기]
    ↓
    ├── NAS (Docker / WordPress)
    ├── Orange Pi 5
    └── 기타 서버

DDNS는 공유기에서 1번만 설정하면 됩니다.

📊 DDNS vs 유료 도메인 비교

💡 결론

✔ 간단한 홈서버 운영 → ipTIME DDNS 충분
✔ 블로그 / 수익형 사이트 운영 → 개인 도메인 추천

게시물 ipTIME 공유기 DDNS 설정 방법(쉬움)이 하우인포-IT·테크에 처음 등장했습니다.

홈 인프라의 시작

제 홈랩은 이렇게 시작했습니다.

• 라즈베리파이4 → 가벼운 서버 실험
• 오렌지파이5 → 연산 성능 향상 + AI 테스트
• 시놀로지 DS720+ → 안정적인 데이터 보관

여기까지도 충분해 보였습니다.

하지만 시간이 지나면서 한 가지가 분명해졌습니다.

저장은 안정적이지만,
연산과 작업 환경이 분리되어 있다.

AI 시대, 성능이 필요해졌다

요즘 작업 환경은 과거와 다릅니다.

• 이미지 생성
• 로컬 AI 테스트
• Docker 다중 컨테이너
• 영상 편집
• 대용량 데이터 처리

특히 발빠른 AI와 자동화 프로젝트를 진행하면서 느낀 점은:

이제는 “가벼운 서버”로는 부족하다. 좀더 강한 그리고 안정적인게 필요 하다 .

AI 시대에는
연산 성능이 곧 생산성이 됩니다.

단순 저장용 NAS가 아니라
고성능 PC급 성능을 가진 통합 서버가 필요했습니다. (n5 pro는 저에게 적당한 타협선 이었습니다. ㅜㅜ)

그리고 AI 370 칩에 980에 음.. 아무튼 저한테는 이정도 ..

왜 추가로 N5 Pro를 구매했는가

그래서 선택한 장비가
MINISFORUM N5 Pro 입니다.

이건 단순 NAS 추가가 아닙니다.

✔ 1. Windows 기본 탑재 → 통합 작업 환경

기존에는:

• PC에서 작업
• SBC에서 테스트
• NAS에 저장

이렇게 흐름이 나뉘어 있었습니다.

하지만 N5 Pro는:

• Windows 기본 환경
• 원격 데스크톱 가능
• 어디서든 동일한 작업 환경 유지

즉,

집이든 외부든
하나의 Windows 서버에서 통일된 작업 가능

AI 툴, Docker, 개발 환경을
한곳에서 운영할 수 있게 되었습니다.

✔ 2. 성능 부문 — AI 시대에 맞는 하드웨어

이 장비를 선택한 가장 큰 이유는 성능입니다.

구매를 하려는데 메모리값이 . ㅜㅜ 너무 비싸졌어요.. 여러번 구매를 했는데 계속 메모리 값등이 올라서 취소가 계속 ㅜㅜ // 저는 참고로 쿠팡에서 사는데 . 쿠팡 가격이 널뛰기라서 . ㅜㅜ 현재 최종 주문은 했는데. 언제 올지 ㅜㅜ

• 데스크탑급 CPU
• 다중 베이 확장
• 10GbE 네트워크
• Docker 동시 운영

AI 모델 테스트나 대용량 연산은
CPU/메모리/스토리지 속도가 모두 중요합니다.

이제는 단순 저장이 아니라:

• 연산
• 개발
• 실험
• 자동화

를 동시에 처리할 수 있는 구조가 필요했습니다.

✔ 3. 작업 + 보관 분리 전략

기존에 사용 중인
Synology DiskStation DS720+
는 여전히 안정적인 저장소 역할을 합니다.

그래서 구조를 이렇게 재정의했습니다.

이제 작업은 N5 Pro에서 수행하고,
완성된 데이터는 NAS에 안정적으로 보관합니다.

작업과 저장을 분리하되,
작업 환경은 통합한다.

이게 이번 구매의 핵심입니다.

이번 구매의 본질

이건 단순 업그레이드가 아닙니다.

✔ AI 시대 대응
✔ 고성능 통합 작업 서버 확보
✔ 원격 Windows 작업 환경 통일
✔ 데이터 이중 백업 구조 완성

라즈베리파이로 시작한 홈랩이
이제는 작은 데이터센터 구조로 확장되었습니다.

어디서든 접근해서 추가적으로 작업을 할 수 있고 데이터도 안정적으로 보관이 되고 집에서 돌리는거라 . 내 맘대로 할 수 있고 .. 나스 장비가 오면 언박싱도 추가적으로 하면서 현실 중심으로 적어 볼께요.

그리고 WOL 기능이 있는지도 .. 공유기나 옆에 장비에서 호출해서 전원 부팅이 된다면 .. 필요할 때만 전원을 켜서 할수 있을것 같아 이것도 가능한지도 글을 남기도록 하겠습니다.

언능 와라 ..

앞으로 다룰 내용

이 시리즈에서는:

• 언박싱 & 하드웨어 구조 분석
• Windows 기반 서버 세팅
• Docker 통합 운영
• 10GbE 네트워크 구성
• NAS 간 백업 전략
• AI 실험 환경 구축
• 실제 장애 사례 공유

까지 실제 운영 중심으로 다룰 예정입니다.

마치며

AI 시대에는
저장이 아니라 연산 능력이 핵심이 됩니다.

그리고 그 연산 결과는
안정적으로 보관되어야 합니다.

이번 N5 Pro 도입은
성능과 안정성을 동시에 확보하기 위한
구조 재설계의 시작입니다.

다음 편에서는
실제 언박싱과 내부 구조를 분석해보겠습니다.

언능 와라 … 널 기다리마..

사이트는 아래 링크 입니다.

Minisforum N5 Pro AI NAS – Minisforum KR

게시물 MINISFORUM N5 Pro 도입기 (배송중…)이 하우인포-IT·테크에 처음 등장했습니다.

Git을 설치하고 로컬에서 git init까지는 했는데…

• ❓ GitHub는 왜 또 필요하지?
• ❓ 로그인은 어떻게 하지?
• ❓ 비밀번호가 안 되는데?
• ❓ 토큰은 뭐야?

👉 이 구간에서 70%가 멈춥니다.
👉 오늘 여기서 끝냅니다.

1️⃣ GitHub는 뭐고 왜 연결하나요?

정리하면 이렇습니다.

즉,

👉 Git만 쓰면 “내 컴퓨터 안에서만” 관리
👉 GitHub까지 연결하면 “클라우드 백업 + 협업 가능”

2️⃣ GitHub 가입 (처음이면)

1. https://github.com 접속
2. Sign up 클릭
3. 이메일 인증
4. 사용자명 생성

✔ 무료로 충분합니다.

3️⃣ GitHub에서 저장소(Repository) 만들기

로그인 후

1. 오른쪽 위 ➕ 버튼 클릭
2. New repository
3. Repository name: 예) my-project
4. Public / Private 선택
5. Create repository

⚠️ 여기서 README 생성 체크하지 마세요 (초보는 비워두는 게 안전)

4️⃣ 이제 로컬 Git과 연결합니다

이미 PC에서 이런 상태라고 가정합니다:

mkdir my-project
cd my-project
git init

GitHub에서 repo 생성 후 보이는 주소를 복사합니다.

예:

https://github.com/yourname/my-project.git

4-1) 원격 저장소 연결

git remote add origin https://github.com/yourname/my-project.git

확인:

git remote -v

5️⃣ 이제 push 해봅니다 (여기서 막힘 발생)

git branch -M main
git push -u origin main

👉 여기서 로그인 창이 뜨거나
👉 비밀번호를 요구합니다.

❗ 여기서 비밀번호 입력하면 실패합니다

GitHub는 더 이상 비밀번호 로그인 안 됩니다.
👉 Personal Access Token(토큰) 사용해야 합니다.

6️⃣ 토큰 생성 (초보용 단계별)

1. GitHub 오른쪽 위 프로필 클릭
2. Settings
3. 왼쪽 아래 → Developer settings
4. Personal access tokens
5. Tokens (classic) 클릭
6. Generate new token (classic)

설정 방법

• Note: git-login
• Expiration: 90 days (초보는 이렇게)
• Scopes:
  • ✅ repo (체크)

Generate token 클릭

⚠️ 생성되면 토큰 문자열이 보입니다.
👉 복사해서 안전한 곳에 저장
👉 다시는 안 보여줍니다

7️⃣ 토큰으로 로그인

다시 push 실행:

git push -u origin main

아이디 입력 → GitHub 아이디
비밀번호 입력 → 토큰 붙여넣기

👉 성공하면 업로드 완료 🎉

8️⃣ 이제부터는 이렇게 사용합니다

작업하고 커밋

git add .
git commit -m "feat: update feature"

GitHub에 업로드

git push

다른 PC에서 가져오기

git pull

9️⃣ 자주 발생하는 초보 오류 해결

❌ authentication failed

→ 토큰 잘못 입력
→ 토큰 만료
→ repo 권한 없음

❌ failed to push some refs

→ 먼저 pull 해야 하는 경우

git pull origin main --rebase
git push

🔟 브랜치까지 맛보기 (안전 작업)

기능 추가할 때는 이렇게:

git checkout -b feature/login

작업 후

git add .
git commit -m "feat: login"
git push -u origin feature/login

GitHub에서 PR 생성 → 병합

💡 제가 초보 때 깨달은 핵심

GitHub 연결은
👉 명령어보다 “토큰 이해”가 핵심

• Git = 로컬 기록
• GitHub = 원격 저장
• 토큰 = 로그인 비밀번호 대신

이 세 가지만 이해하면 더 이상 두렵지 않습니다.

📌 블로그용 정리 문장

Git 초보가 제일 막히는 구간은 “로그인”입니다.
비밀번호가 아니라 토큰으로 인증한다는 개념만 이해하면
GitHub 연결은 5분이면 끝납니다.

게시물 GitHub 연결까지 완전 정복 (토큰 로그인 포함)이 하우인포-IT·테크에 처음 등장했습니다.