사용기 A-27

복사 버튼이 http 주소에서만 안 될 때, navigator.clipboard가 아예 없었어요

읽는 데 약 6분

아이티플레인

사용 기록

써 본 날2026-11-07

써 본 것클로드 코드로 만든 복사 페이지, 맥미니에서 띄우고 테일스케일 http 주소로 엶. 원인 시험은 맥의 크롬(Chromium)

비용없음

설치없음 (페이지 코드 몇 줄 수정)

회사 자료쓰지 않음

난이도코드 조금

결과테일스케일 http 주소에서는 isSecureContext false, navigator.clipboard undefined(TypeError). localhost에서는 기능은 생기고 권한에 따라 NotAllowedError. 옛 복사 명령(execCommand)으로 한 번 더 시도하게 고치니 글자 복사는 됐고, 그림 복사 버튼은 여전히 막힘

한 줄 결론테일스케일 http 주소에서는 클립보드 기능이 아예 없었어요. 글자는 옛 명령으로 우회됐고, 그림 복사는 그대로 막혔어요.

11월 7일, 맥미니에서 띄워 둔 복사 페이지를 테일스케일 주소로 열었어요. 글을 붙여 넣을 때 쓰는 페이지인데, 버튼을 누르면 제목이나 본문이 복사되게 클로드 코드로 만들어 둔 거예요.

‘제목 복사’를 누르고 붙여 넣었더니 엉뚱한 글이 들어갔어요. 그 전에 디스코드에서 복사해 둔 알림 머리글이었어요. 버튼이 아무것도 복사하지 않았던 거예요. 같은 페이지를 https 주소로 열었을 때는 잘 됐어요.

왜 http 주소에서만 안 됐나요?

버튼은 navigator.clipboard라는 브라우저 기능으로 글을 복사해요. MDN 문서는 이 기능을 보안 연결(secure context)에서만 쓸 수 있다고 적어 두었어요.

보안 연결로 치는 건 https 주소, 그리고 내 컴퓨터를 가리키는 localhost·127.0.0.1 같은 주소예요. 제가 쓴 테일스케일 주소는 100으로 시작하는 주소라 그 목록에 없어서, http로 열면 보안 연결로 인정되지 않았어요.

원인을 보려고 같은 코드로 작은 시험 페이지를 만들어 같은 주소로 열어 봤어요.

http 주소로 연 시험 페이지. 주소 http://100.x.x.x:8794/clip-demo/, 보안 연결(window.isSecureContext) false에 빨간 동그라미, 고치기 전 버튼을 누른 뒤 '막힘: TypeError → 선택만 해 둠' 문구에 빨간 동그라미
주소의 숫자는 가렸어요

window.isSecureContext가 false였고, navigator.clipboard는 아예 undefined였어요. 복사를 거절한 게 아니라 기능 자체가 없어서, 버튼 코드가 TypeError를 내고 실패 처리로 넘어갔어요.

제 페이지는 실패하면 글을 선택만 해 두고 “Ctrl+C로 복사하세요”라는 안내를 띄우게 돼 있었어요. 복사는 안 된 채였으니, 붙여 넣으면 예전 클립보드 내용이 들어갔던 거예요.

내 페이지도 같은 경우인지 어떻게 보나요?

복사 버튼이 안 되는 페이지를 연 채로 브라우저 개발자 도구(크롬은 F12, 맥은 Cmd+Option+I)의 콘솔에 두 줄을 넣어 보면 돼요.

브라우저 콘솔에 넣는 두 줄

isSecureContext
typeof navigator.clipboard

제 테일스케일 http 주소에서는 false와 'undefined'가 나왔어요. 이렇게 나오면 이 글과 같은 경우예요. 버튼 코드를 아무리 고쳐도 그 주소에서는 클립보드 기능이 생기지 않아요.

같은 시험 페이지를 맥 안에서 http://localhost로도 열어 봤어요. 이번에는 true와 'object'가 나왔어요. 주소가 http여도 localhost는 보안 연결로 쳐서 기능이 생긴 거예요.

다만 기능이 있다고 바로 복사되지는 않았어요. 자동으로 띄운 시험용 크롬에서 클립보드 권한을 주지 않고 누르면 NotAllowedError가 났고, 권한을 준 뒤 누르니 “복사됨”이 떴어요. 같은 “복사가 안 돼요”라도 오류 이름이 달라요. TypeError면 기능 자체가 없는 거고, NotAllowedError면 기능은 있는데 브라우저가 허락하지 않은 거예요.

어떻게 고쳤나요?

안내만 띄우던 자리에서, 선택해 둔 글을 옛 복사 명령 document.execCommand('copy')로 한 번 더 복사하게 했어요. 이번 크롬 시험에서는 보안 연결이 아니어도 이 명령으로 글자가 복사됐어요. 이 명령은 실패해도 오류를 내지 않고 false를 돌려줘서, 그 값까지 보고 성공을 띄우게 했어요.

고친 버튼을 누른 뒤 '복사됨 (execCommand 대체)' 문구에 빨간 동그라미

고친 버튼을 누른 뒤 빈 입력칸에 붙여 넣어 보니 “테일스케일 주소에서 복사 버튼 시험”이 그대로 들어갔어요. 실제 복사 페이지에서도 ‘제목 복사’와 ‘본문 전체 복사’가 “복사됨”으로 바뀌었어요.

그대로 붙여 넣는 프롬프트

이 페이지의 복사 버튼이 http 주소에서는 안 돼.
navigator.clipboard 가 실패하면, 복사할 칸을 선택한 뒤 document.execCommand('copy') 로 한 번 더 시도하게 고쳐 줘.
execCommand 가 false 를 돌려주면 실패로 보고, 그때만 "선택해 뒀어요. Ctrl+C(맥은 Cmd+C)로 복사하세요" 안내를 띄워 줘.

11월 7일 맥미니에서 고친 내용을 프롬프트로 옮긴 거예요. 이 문장 그대로 클로드에게 시키지는 않았어요.

그래도 안 되는 것

그림 복사 버튼은 그대로 막혀요. 제 페이지의 그림 버튼은 navigator.clipboard.write를 쓰는데, http에서는 그 기능이 없어요. 글자처럼 옛 명령으로 우회하는 코드는 만들지 않았고, 그림 자리에는 ‘오른쪽 클릭 → 이미지 복사’ 안내를 넣었어요.

옛 복사 명령은 MDN에 ‘더 이상 권장하지 않음’으로 적혀 있어요. 지금 크롬에서 되는 걸 확인했을 뿐, 언제까지 될지는 몰라요. 사파리·파이어폭스·폰 브라우저는 시험하지 않았어요.

같은 페이지를 https 주소로 열었을 때는 그림 버튼까지 동작했어요. 테일스케일에는 내 기기 사이에서 https 주소를 만들어 주는 기능(serve)이 있어서 맥에서 켜 보려 했더니 “Serve is not enabled on your tailnet”이 떴어요. 관리 화면에서 켜라는 안내였고, 이번에는 켜 보지 않았어요.

그래서 저는 이렇게 정했어요

결론은 주소에 따라 나뉘어요. 제 기기에서만 여는 페이지를 테일스케일 http 주소로 쓸 거면, 글자 복사는 옛 명령으로 한 번 더 시도하는 것으로 충분했어요. 제목·본문 복사는 이걸로 다시 버튼 한 번에 됐어요.

그림까지 버튼 하나로 복사하려면 https 주소가 필요해요. 테일스케일 serve를 켜면 테일스케일 주소로도 https를 쓸 수 있지만, 관리 화면 설정이 먼저라 아직은 https로 열리는 주소를 따로 써야 해요. 앞으로 클로드 코드에 이런 작은 페이지를 시킬 때는 처음부터 “http 주소에서도 복사되게”를 같이 적기로 했어요.

함께 읽을 글


2026년 11월 11일 기준.

참고한 자료

아이티플레인 · 만들면서 AI 도구를 매일 쓰는 개발자가 적습니다 · 소개 보기