홍드로이드의 야매코딩

Claude 자체 호스팅 게이트웨이 — 공개 주소로는 로그인이 안 됩니다 본문

AI & Vibe Coding

Claude 자체 호스팅 게이트웨이 — 공개 주소로는 로그인이 안 됩니다

홍드로이드 2026. 8. 31. 01:41
반응형

회사에서 AI 도구를 쓰려는데 데이터를 우리 클라우드 밖으로 못 보내는 사정이 있다면, 직접 세우는 관문이라는 선택지가 있습니다. 놀랍게도 노트북에서 쓰던 그 실행 파일 하나가 그대로 서버가 돼요. 그런데 공식 문서를 읽다 보니 함정이 하나 있습니다 — 인터넷에 올려두면 로그인 단계에서 거부당합니다. 주소가 공개 대역으로 풀리면 안 되거든요. 붙이고 나서 조용히 꺼지는 기능들도 있고요. 정리했습니다.

📌 30초 요약

  • ★같은 실행 파일이 서버가 됩니다 — 따로 설치할 게 없습니다.
  • ★★공개 주소로는 로그인이 거부됩니다.
  • 회사 계정으로 로그인하니 개발자가 키를 안 들고 다닙니다.
  • ⚠️ 잘 떴다고 되는 게 아닙니다 — 첫 요청에서야 드러납니다.
  • ★원격 제어·웹 검색이 꺼지고 캐시 수명도 짧아집니다.
  • ⚠️ 데스크톱 앱은 경고 없이 제한에서 빠집니다.

쓰던 실행 파일이 그대로 서버가 됩니다

가장 먼저 놀란 점입니다. 별도 서버 프로그램을 받는 게 아니라, 노트북에서 쓰던 그 실행 파일에 설정 파일을 물려 실행하면 관문이 됩니다. 개발자 기계와 서버가 같은 것을 쓰는 셈이에요. 대신 양쪽 다 일정 판올림 이상이어야 하고, 그보다 낮으면 그 기능 자체가 없습니다.

개발자는 회사 계정으로 로그인합니다. 키나 클라우드 자격증명을 들고 다니지 않아요. 관문이 상류 자격증명을 쥐고, 계정이 속한 그룹에 따라 쓸 수 있는 모델과 정책을 강제합니다. 사용량 기록은 우리 회사 관측 도구로 흘려보낼 수 있고요.

👀 회사가 볼 수 있는 것

걱정되는 부분이니 짚어둡니다. 기본으로 넘어가는 건 누가 썼는지, 토큰을 얼마나 썼는지, 어떤 모델이었는지, 얼마나 걸렸는지입니다. 주고받은 대화 내용은 기록하거나 저장하지 않는다고 명시돼 있어요. 다만 더 자세한 기록을 켤지는 조직이 정하는 몫이고, 그렇게 되면 실행한 명령이나 파일 경로가 들어갈 수 있습니다. 도입할 때 이 선택지를 어디까지 켰는지 물어보세요.

공개 주소로는 로그인이 안 됩니다

여기가 이 글의 핵심입니다. 관문을 세워두고 편하게 인터넷에서 접근하게 하자 싶겠지만 안 됩니다. 로그인 단계에서 관문 주소가 사설 대역으로만 풀리는지 확인하고, 공개 주소면 거부합니다.

더 깐깐한 건 이름이 여러 주소로 풀릴 때 그중 하나라도 공개 대역이면 걸린다는 점이에요. 안팎 양쪽에서 쓰라고 이름 하나에 주소를 여럿 물려두면 사내에서도 로그인이 안 됩니다. 그리고 한 겹 더 — 회사 프록시를 거쳐 나가는 환경이라면 그 프록시 주소까지 사설이어야 하고, 아니면 관문만 프록시를 안 타도록 예외로 빼줘야 합니다.

⚠️ 잘 떴다고 되는 게 아닙니다

서버가 문제없이 부팅됐다고 실제로 답을 받아올 수 있다는 뜻이 아닙니다. 클라우드 쪽 자격증명은 첫 요청이 들어올 때 비로소 풀리기 때문에, 그전까지는 맞는지 틀린지 알 수 없어요. "띄웠으니 됐다"고 넘어가면 개발자들이 붙는 순간 한꺼번에 실패합니다. 세우고 나서 직접 한 번 물어보는 것까지가 설치입니다. 암호화 통신도 필수라, 인증서를 붙이거나 앞단에서 처리해줘야 합니다.

붙이면 몇 가지가 꺼집니다

이게 도입 전에 꼭 알아야 할 대목입니다. 관문을 통해 쓰면 평소 쓰던 기능 몇 가지가 아예 안 됩니다. 고장이 아니라 구조상 그래요.

기능 관문 뒤에서
모델에 딸린 웹 검색 꺼짐 — 어느 제공자로 가는지 몰라 지원 확인 불가
폰에서 원격으로 지휘 안 됨 — 관문을 지목하는 오류가 뜸
긴 수명 캐시 짧은 쪽으로 고정 — 모든 상류가 지원하진 않아서
기본 캐시 그대로 동작 — 재사용 표시를 다 넘김
1차 전용 최적화 안 걸림
회사 계정 로그인 방식 표준 방식만 — 다른 방식은 앞단에서 변환 필요

표에서 눈여겨볼 건 폰에서 원격으로 지휘하는 기능이 막힌다는 점입니다. 밖에서 폰으로 작업을 이어가던 방식에 익숙해졌다면 도입 후 그게 사라진다는 뜻이에요. 다행히 기본 캐시는 그대로 도니, 다른 제품을 쓸 때 캐시가 조용히 꺼지는 문제는 여기서 걱정하지 않아도 됩니다.

데스크톱 앱은 경고 없이 빠집니다

보안 담당자라면 이 대목을 꼭 봐야 합니다. 데스크톱 앱에도 정책이 내려가긴 하는데 일부만 갑니다. 쓸 수 있는 모델 목록과 막아둔 도구 목록은 적용되지만, 바깥으로 나가는 통신을 제한하는 규칙은 별도 설정을 켜야만 닿아요.

무서운 건 안 켜두면 그 세션은 나가는 제한 없이 도는데, 아무 경고도 안 뜬다는 겁니다. 모델은 막히니 "정책이 잘 걸렸구나" 하고 넘어가기 딱 좋아요. 데스크톱만 쓰는 기계가 있다면 그 설정이 켜져 있는지 따로 확인하세요.

🛠️ 세우고 나면 운영이 남습니다

조건을 다 맞춰 세웠다면 다음은 굴리는 일입니다. 운영에서 부딪히는 함정이 따로 있는데, 가장 아까운 건 저장소가 잠깐 멈췄을 때 멀쩡히 답할 수 있는 서버까지 앞단에서 통째로 빠지는 경우예요. 점검 통로를 어디로 향하게 하느냐로 갈립니다. 한 사람만 로그아웃시키는 방법이 없다는 점도 미리 알아두세요.

자주 묻는 질문 (FAQ)

Q. 우리 회사에 이게 맞을까요?

문서가 선을 명확히 긋습니다. "우리 클라우드로 돌려야 한다"는 요구가 있을 때를 위한 물건이에요. 데이터를 어느 지역에 둬야 한다는 규정 같은 것들요. 그런 요구가 없다면 오히려 다른 선택지가 낫다고 문서가 직접 권합니다 — 계정 자동 관리나 웹·모바일 이용 같은 기능이 필요하면 특히요. 인프라 하나를 떠안는 대가가 있으니 요구사항부터 확인하세요.

Q. 설정은 화면에서 바꾸나요?

관리 화면이 없습니다. 설정 파일을 고치고 다시 배포하는 것이 유일한 방법이에요. 서버는 상태를 안 들고 도는 구조라 배포 자체는 간단하지만, "관리자가 클릭으로 바꾼다"는 그림은 없습니다. 운영 환경도 제한이 있는데 윈도우 서버는 지원하지 않고 리눅스로 올려야 합니다. 맥은 개발용으로만이고요. 로그인 발급처는 관문 하나당 하나라, 여러 곳을 쓰려면 인스턴스를 나눠야 합니다.

Q. 정책 잠금을 하나 걸면 나머지도 걸리나요?

아니요, 각각 따로 걸어야 합니다. 그리고 함정이 있는데 — 목록을 비운 채로 잠그면 정반대 결과가 나올 수 있어요. 나가는 주소를 빈 목록으로 잠그면 바깥 통신이 전부 막히고, 반대로 외부 서버를 빈 목록으로 잠그면 따로 막아둔 것 말고는 전부 열립니다. 잠금 옆에는 반드시 우리 조직의 허용 목록을 함께 적어두세요.

🧾 정직하게 밝혀둘 것

  • 제가 직접 세워본 실측이 아닙니다. 공식 문서의 요구 조건·제한 표·주의 사항을 우리말로 정리했습니다.
  • ★설정 항목 이름·명령어·판올림 번호·대역 표기는 옮기지 않았습니다. 실제로 구축할 때는 원문을 보세요.
  • ★"띄운 뒤 직접 한 번 물어보는 것까지가 설치"는 제 정리이고, 문서는 부팅이 추론 경로를 검증하지 않는다는 사실만 밝힙니다.
  • 지원 범위와 제한은 판올림마다 바뀝니다. 2026년 8월 기준입니다.

✨ 정리하면

노트북에서 쓰던 실행 파일이 그대로 서버가 되고, 개발자는 회사 계정으로 로그인합니다. 가장 큰 함정은 공개 주소로 올려두면 로그인이 거부된다는 것 — 이름이 풀리는 주소 중 하나라도 공개 대역이면 걸립니다. 부팅 성공이 동작 확인은 아니고, 원격 지휘와 웹 검색은 꺼지며, 데스크톱 앱은 경고 없이 나가는 제한에서 빠집니다. 개발자 쪽에서 보이는 증상은 게이트웨이 연결 문제 정리, 관문이 무엇을 넘겨야 하는지는 사내 게이트웨이 도입 정리, 폰에서 지휘하는 이야기는 Cursor 아이폰 앱, 전체 비용 흐름은 AI 지출 관리 허브에 모아뒀습니다.

※ 출처: Claude apps gateway 공식 문서(2026년 8월 31일 열람). 지원 범위와 제한은 판올림마다 달라집니다.

반응형
Comments