설치 안내를 그대로 따라갑니다. 마지막에 컨테이너를 띄우는 명령 한 줄에서 에러가 납니다. 명령을 다시 확인합니다. 맞습니다. 지우고 다시 깝니다. 또 에러입니다. 검색해서 나온 방법을 전부 해봅니다. 재부팅합니다. 그대로입니다.

제 경우엔 그렇게 4일이 갔습니다. 그 4일 동안 손댄 곳은 전부 같은 자리 — 컨테이너를 띄우는 그 명령어 한 줄이었습니다. 그런데 원인은 그 줄에 없었습니다.

실력이 부족해서 생기는 일이 아닙니다. 원인은 대개 한 곳입니다 — 증상이 보이는 자리와 고쳐야 하는 자리가 다르다는 것. 그리고 인터넷의 설치 글 대부분은 그 사슬의 앞쪽을 아예 언급하지 않습니다. 글쓴이의 기계에서는 그 단계가 애초에 문제가 아니었기 때문입니다.

"글 대로 했는데 나만 안 되는" 상황의 정체가 이겁니다. 글이 틀린 게 아니라, 글을 쓴 사람의 기계와 내 기계의 출고 기본값이 달랐던 것입니다.

이 사슬 하나가 이 책 전체의 방식입니다. 증상은 마지막 칸에서만 보이니, 진단은 반대 방향으로 첫 칸부터 합니다. 각 칸마다 "무엇이 참이어야 이 칸을 통과한 것인지"를 정해 두고, 그게 참이 된 뒤에만 다음으로 넘어갑니다.

같은 방식이 나머지 장에도 그대로 적용됩니다. 밖에서 접속이 안 될 때도 원인 후보가 아홉 개인데 증상은 전부 "안 됨" 하나로 보입니다. 백업도 마찬가지입니다 — "파일이 생겼다"와 "그 파일로 되돌릴 수 있다"는 서로 다른 사실입니다.

각 장은 같은 순서로 씌어 있습니다 — 증상 → 왜 그런가 → 에이전트에게 줄 브리프 → 완료조건 → 직접 확인 → 에이전트가 자주 틀리는 지점.

마지막 두 절이 이 책의 핵심입니다. 에이전트는 "완료했습니다"라고 말하는데, 그 말이 맞는지는 사람이 확인해야 합니다. 그래서 항목마다 사람이 눈으로 볼 것을 따로 적어 두었습니다. 예를 들어 BIOS 설정은 에이전트가 구조적으로 볼 수 없는 화면이라, 거기서는 "켰습니다"라는 보고 자체가 성립하지 않습니다.

이렇게 보시면 됩니다

• 0장을 건너뛰지 마세요. 기기끼리 파일만 동기화하려는 거라면 도메인도 포트포워딩도 필요 없습니다. 이걸 모르고 도메인 구입부터 시작해 며칠 쓰는 경우가 흔합니다.

• 목차에서 지금 막힌 증상을 찾습니다. 1장부터 읽지 않아도 됩니다.

• 그 장의 브리프를 그대로 복사해 에이전트에게 줍니다.

• 완료조건이 참이 됐는지 직접 확인합니다. 안전장치를 다루는 장에서는 일부러 깨뜨려서 정말 막히는지 보게 합니다.

6장에는 아무것도 고치지 않는 진단기가 들어 있습니다. 무엇이 막혔는지만 확정하고, 대응은 부록의 대응표에서 증상 코드로 찾습니다. 진단과 처방을 나눈 이유는 하나입니다 — 원인 후보가 여럿인데 증상이 똑같아 보이면, 손이 먼저 나가는 순간 반드시 엉뚱한 곳을 고치게 되기 때문입니다.

진단기와 대응표는 한 원본에서 나오고, 어긋나면 빌드가 멈춥니다. 진단기가 뱉은 코드를 부록에서 찾았는데 없는 상황이 신뢰를 가장 빨리 깎기 때문입니다.

세 번째 건은 조금 더 적어 두겠습니다. 이 책의 홍보를 겸해 무료 글을 올렸더니, 기술 설명 하나가 틀렸다는 지적이 세 분에게서 각각 왔습니다. 컨테이너를 "경량 가상머신 위에서 돈다"고 쓴 대목이었습니다. 결론(BIOS를 켜라)은 맞았지만 이유가 틀렸고, 틀린 이유는 잘못된 개념을 퍼뜨립니다.

확인해 보니 같은 문장이 원고 일곱 곳에 있었습니다. 전부 고쳤고, 지적해 주신 분들께 답글로 밝혔습니다. 아직 팔지 않은 책이라 개정판을 돌릴 필요가 없었습니다.

이 책이 계속 말하는 것이 정확히 이겁니다 — 확인하지 않은 채로 내보낸 문장은 언젠가 밖에서 잡힙니다. 그래서 저는 이 사고를 감추는 대신 판매 페이지에 적어 둡니다.

이런 분께 권합니다

• 미니PC나 안 쓰는 노트북으로 홈서버를 시작하려는 분

• 안내 글을 따라 했는데 마지막 명령에서 막혀 있는 분

• AI 에이전트에게 시켜서 짓고 싶은데, 어디까지 맡겨도 되는지 모르겠는 분

• 동기화해 둔 것을 백업이라고 믿고 계신 분

• 백업 파일은 있는데 복원해 본 적은 없는 분

이런 분께는 권하지 않습니다

• 이미 홈서버를 몇 년 운영 중이고 복구 훈련도 정기적으로 하시는 분

• AI 에이전트를 쓸 생각이 없는 분 — 이 책의 절반이 무의미해집니다.

• "이대로만 하면 무조건 됩니다"라는 목록을 찾는 분 — 환경이 다르면 다르게 막힙니다.

자주 묻는 질문

Q. 리눅스로 서버를 꾸릴 건데도 쓸모가 있나요?
A. 2장의 앞 세 항목(BIOS·하위 시스템·설치와 실행의 구분)은 윈도우 얘기라 해당이 없습니다. 나머지 일곱 장은 운영체제와 무관합니다 — 무엇을 대체할지 정하기, 시켜도 되는 일의 경계, 동기화와 백업의 차이, 복구 훈련, 외부 접속 진단, 6개월 뒤 유지. 리눅스라면 2장을 건너뛰고 3장부터 보시면 됩니다.

Q. 어떤 기기가 필요한가요?
A. 컴퓨터 한 대(미니PC, 안 쓰는 노트북, 초소형 보드 컴퓨터 무엇이든)와 AI 코딩 에이전트를 쓸 수 있는 환경이면 됩니다. 특정 제품을 추천하지는 않습니다 — 인쇄되는 순간부터 낡기 때문에, 대신 무엇을 기준으로 고를지를 씁니다.

Q. 명령어를 몰라도 되나요?
A. 외울 필요는 없습니다. 그건 에이전트가 합니다. 다만 그것이 맞는지 확인하는 법은 이 책이 가르칩니다. 그게 이 책의 전부라고 해도 됩니다.

Q. 환불이 되나요?
A. 다운로드형 디지털 콘텐츠라 결제 후 취소가 되지 않습니다. 위 목차와 예시를 충분히 보시고 결정해 주세요. 파일이 열리지 않는 등 전달 자체에 문제가 있으면 아래 메일로 연락 주시면 바로 처리해 드립니다.

Q. 코드는 그대로 돌아가나요?
A. 본문에 실린 스크립트는 전문을 그대로 실었고, 실제로 스택을 띄워 복구 훈련까지 통과시킨 뒤 넣었습니다. 책에 실린 코드가 제가 실제로 돌린 스크립트와 한 글자라도 다르지 않은지, 빌드할 때마다 기계가 대조합니다. 다만 각자의 환경은 다르므로, 5장의 훈련을 본인 환경에서 한 번 돌려 보시길 권합니다.

Q. 업데이트는요?
A. 무료입니다. 구매하신 메일로 보내 드립니다.

Q. 파일은 어떻게 받나요?
A. 결제 후 바로 PDF 한 개가 다운로드됩니다. 회원가입은 필요하지 않습니다. 스크립트는 별도 파일이 아니라 본문에 전문이 실려 있어 그대로 복사해 쓰시면 됩니다 — 지면 폭에 맞춰 잘리는 줄이 없도록 짰습니다.

Q. 앞 책과 어떤 관계인가요?
A. 이 책은 『"다 됐습니다"를 믿지 마세요 — AI가 일했다는 증거』의 후속입니다. 앞 책이 "에이전트가 일했다는 것을 어떻게 증명하는가"를 다루고, 이 책이 그 방법을 홈서버라는 구체적인 일에 적용합니다. 순서는 상관없습니다 — 이 책만 읽어도 됩니다.

문의: alphamates.sy@gmail.com