🌐 공개 접속: 나만의 도메인 + Cloudflare

집에 있는 NAS에서 OKNote를 돌리면 기본적으로 로컬 네트워크 안에서만 접속할 수 있습니다. 회사에서든, 이동 중이든, 어디서든 OKNote를 열려면 "공개 매핑"이 필요합니다. OKNote에는 Cloudflare Tunnel 옵션이 내장되어 있습니다.

• 공인 IP도, 공유기의 포트 포워딩 설정도 필요 없습니다. 통신사가 제공하는 사설 IP(CGNAT)여도 문제없습니다.
• 나만의 도메인으로 주소를 만들고(예: https://notes.example.com) Cloudflare의 암호화된 터널을 통해 접속하므로 안전하고 안정적입니다.

사전 조건: 공개 매핑은 패밀리 플랜 이상에서 제공되는 기능이며, 무료 플랜에는 포함되지 않습니다. 또한 터널의 호스트 역할은 서버 빌드(NAS / 데스크톱 서버)여야 합니다. Mac App Store 인앱 결제 버전은 샌드박스에서 실행되므로 터널 호스트로 사용할 수 없습니다.

모든 과정은 설정 → 공개 매핑 → "공개 접속 설정하기 · 나만의 도메인 연결"의 4단계 마법사 안에서 이루어집니다. 아래에서 단계별로 안내합니다. 핵심은 3단계에서 토큰을 발급받는 부분이니 꼼꼼히 읽으면 막히는 일이 없을 겁니다.

1단계: 도메인 준비하기

주소를 만들려면 나만의 도메인이 필요합니다.

• 이미 도메인이 있다면(GoDaddy, Namecheap, Aliyun 등에서 구매한 것) → 그대로 사용하고 2단계로 넘어가세요.
• 아직 도메인이 없다면 → Cloudflare Registrar, GoDaddy, 또는 다른 곳에서 하나 구매하세요. 보통 연간 몇 달러 수준입니다. .com / .top / .xyz 모두 사용 가능합니다.

2단계: 도메인을 Cloudflare에 연결하기

이 단계는 도메인의 DNS 관리를 Cloudflare에 넘기는 과정입니다.

1. Cloudflare 대시보드에 가입하고 로그인하세요(무료).
2. Add a site를 클릭하고 도메인을 입력하세요.
3. Free 플랜을 선택하세요. Cloudflare가 두 개의 nameserver(DNS 서버) 주소를 알려줍니다.
4. 도메인을 구매한 곳으로 돌아가 nameserver를 Cloudflare가 알려준 두 개로 변경하세요.
   • GoDaddy: My Domains → 해당 도메인의 Domain Settings 열기 → Nameservers → Change → Custom 선택 → 두 주소 입력 후 저장.
   • Namecheap 등: "Nameservers" 설정을 찾아 Custom DNS로 전환하고 두 주소를 입력한 뒤 저장하세요.
5. Cloudflare에서 도메인 상태가 Active로 바뀔 때까지 기다리세요. 보통 몇 분에서 몇 시간 정도 걸립니다.

만약 도메인을 애초에 Cloudflare Registrar에서 구매했다면 이미 연결되어 있으니 이 단계는 건너뛰어도 됩니다.

3단계: API 토큰 만들기(🔑 가장 중요한 단계)

이 단계는 OKNote에게 "열쇠"를 쥐여줘서 여러분의 도메인 아래에 터널을 자동으로 만들고 DNS를 설정하게 하는 과정입니다. 어려운 부분은 전부 여기에 있으며, 핵심은 올바른 권한을 부여하는 것입니다.

1. Cloudflare API Tokens 페이지를 여세요.

2. Create Token을 클릭 → 맨 아래로 스크롤해 Create Custom Token의 Get started를 클릭하세요.

3. Permissions에서 아래 세 행을 정확히 추가하세요("+ Add more"를 눌러 행을 늘릴 수 있습니다).

   첫 번째 칸(그룹)	두 번째 칸(항목)	세 번째 칸(수준)
   Account	Cloudflare Tunnel	Edit
   Zone	DNS	Edit
   Zone	Zone	Read

   세 행 모두 필요합니다. 첫 번째 행은 OKNote가 터널을 만들 수 있게 하고, 두 번째 행은 접속 도메인의 DNS를 설정할 수 있게 하며, 세 번째 행은 여러분의 도메인 목록을 읽을 수 있게 합니다.

4. 그 아래에서:

   • Account Resources: 여러분의 계정을 선택하세요.
   • Zone Resources: 사용할 도메인을 선택하세요(또는 All zones를 선택해도 됩니다).

5. Continue to summary → Create Token을 클릭한 뒤 생성된 토큰을 복사하세요.

   ⚠️ 이 토큰은 이번 한 번만 표시됩니다. 페이지를 떠나기 전에 반드시 복사해 두세요. 잃어버리면 새로 만들어야 합니다.

6. 복사한 토큰을 마법사 4단계로 가져가세요.

4단계: 입력하고 활성화하기

OKNote 마법사의 4단계로 돌아옵니다.

1. 도메인: 루트 도메인을 입력하세요. 예: example.com(https:// 없이, 서브도메인 없이).
2. 서브도메인: 접속 프리픽스입니다. 기본값은 notes입니다. 입력하는 동안 마법사가 실시간으로 주소를 보여줍니다. 예: https://notes.example.com.
3. Cloudflare API Token: 3단계에서 복사한 토큰을 붙여넣으세요.
4. "도메인과 토큰 확인"을 클릭하세요. 성공하면 초록색으로 "확인 완료, 활성화 가능"이 표시됩니다.

   확인에 실패하나요? 대부분 3단계에서 권한 행이 하나 빠졌거나, 도메인 입력이 틀렸거나 아직 Active 상태가 아닌 경우입니다. 돌아가서 세 행의 권한을 다시 확인하세요.

5. "활성화"를 클릭하세요. 잠시 후 공개 주소가 적용됩니다.

이후로는 어떤 네트워크에서든 https://notes.여러분의도메인을 열면 이 OKNote에 접속할 수 있습니다.

자주 묻는 질문

• 도메인을 꼭 사야 하나요? 네, 나만의 도메인 연결에는 여러분 소유의 도메인이 필요합니다(연간 몇 달러 수준). 이렇게 하면 주소가 온전히 여러분 것이 되어 깔끔하고 안정적입니다.
• 확인이 계속 실패하나요? 다음 순서로 확인하세요. ① 3단계의 권한 세 행이 모두 있고 그룹/항목/수준이 정확히 일치하는지, ② Cloudflare에서 도메인이 Active 상태인지, ③ 도메인 오타나 토큰을 전체 복사하지 못한 부분이 없는지.
• 활성화했는데 열리지 않나요? 도메인을 막 연결한 직후에는 DNS가 전파되는 데 시간이 조금 걸립니다. 서버 자체가 온라인 상태이고 인터넷에 연결되어 있는지 확인하세요(터널은 서버가 Cloudflare로 아웃바운드 연결을 맺는 방식입니다).
• 도메인을 바꾸거나 끄고 싶다면? 설정 → 공개 매핑으로 돌아가 다시 설정하거나 공개 접속을 끌 수 있습니다.

📸 Cloudflare는 이따금 버튼 위치를 바꾸지만, "Create Custom Token과 위의 세 가지 권한 행"이라는 핵심은 변하지 않습니다. 권한 표만 믿고 따라가면 문제없습니다.

---

가이드는 여기까지입니다 🎉 이 노트들은 자유롭게 수정하거나 삭제해도 좋습니다. 어떤 기능도 망가지지 않습니다. OKNote와 즐거운 시간 보내세요!