브라우저에서 한 번 설치
Cloudflare 화면에서
설치하고 운영하기
우분투에서 브라우저를 열고 Cloudflare에 로그인하면 됩니다. 파일은 이미 빌드해 두었습니다. 서버를 켜 두거나 터미널 명령을 실행할 필요가 없습니다.
화면과 기능은 Worker, 원고 저장은 D1이 맡습니다. 휴대폰과 PC에서 같은 주소로 접속합니다. Cloudflare Tunnel은 필요 없습니다.
직접 설치한 이 기록장은 개인 비밀번호로 로그인합니다. 원고는 연결된 D1에 저장됩니다.
설치 파일 내려받기
설치 파일 ZIP을 내려받아 우분투 파일 관리자에서 압축을 풉니다.
간편설치/worker.js가 실제 배포 파일입니다. 화면·기능·939개 질문이 이 한 파일에 들어 있습니다.기존 명령줄 설치용 v1.0 대신 이 v1.1 파일을 사용합니다. 앱 소스도 함께 들어 있습니다.
Worker 만들고 코드 등록하기
Cloudflare 대시보드에서 Workers & Pages → Create application → Start with Hello World! → Deploy 순서로 진행합니다. 이름은
coupang-writing으로 정합니다.생성한 Worker의 Edit code를 엽니다. 기본
worker.js내용을 모두 지우고, 아래 버튼으로 복사한 코드를 붙여넣어 Deploy를 누릅니다.코드 복사가 안 되면
압축 파일 안의
간편설치/worker.js를 아래에서 선택한 다음 ‘Worker 코드 복사’를 다시 누릅니다. 또는 우분투 텍스트 편집기로 파일을 열고 전체 선택 후 복사합니다.정적 파일 드래그앤드롭 화면과 Worker 코드 편집기는 서로 다른 화면입니다. 이번 설치에서는 서버 기능이 포함된 Worker 코드 편집기를 사용합니다. 처음에는 저장소 설정 안내가 나와도 정상입니다.
D1 만들고 원고 보관함 준비하기
Storage & databases → D1 SQL database → Create database에서
coupang-writing-db를 만듭니다. 만든 데이터베이스를 열고 Console에 아래 SQL 전체를 붙여넣어 Execute를 누릅니다.-- Cloudflare > Storage & databases > D1 > coupang-writing-db > Console -- 전체를 붙여넣고 Execute. 기존 답변은 삭제하지 않습니다. CREATE TABLE IF NOT EXISTS answers ( question_id TEXT PRIMARY KEY, answer TEXT NOT NULL DEFAULT '', notes TEXT NOT NULL DEFAULT '', scene_id TEXT NOT NULL DEFAULT '', status TEXT NOT NULL DEFAULT 'not_started' CHECK (status IN ('not_started','in_progress','completed')), version INTEGER NOT NULL DEFAULT 0, updated_at TEXT ); CREATE TABLE IF NOT EXISTS answer_revisions ( id INTEGER PRIMARY KEY AUTOINCREMENT, question_id TEXT NOT NULL REFERENCES answers(question_id), answer TEXT NOT NULL, notes TEXT NOT NULL, scene_id TEXT NOT NULL, status TEXT NOT NULL, version INTEGER NOT NULL, updated_at TEXT NOT NULL, UNIQUE (question_id,version) ); CREATE INDEX IF NOT EXISTS revisions_question ON answer_revisions(question_id,version DESC); CREATE TABLE IF NOT EXISTS sessions (token_hash TEXT PRIMARY KEY,credential_tag TEXT NOT NULL,expires_at INTEGER NOT NULL); CREATE INDEX IF NOT EXISTS sessions_expiry ON sessions(expires_at); CREATE TABLE IF NOT EXISTS login_attempts (key TEXT PRIMARY KEY,attempts INTEGER NOT NULL,expires_at INTEGER NOT NULL);다시 실행해도 기존 답변을 삭제하지 않습니다. 질문은 Worker에 들어 있어 939개를 따로 업로드할 필요가 없습니다.
Worker에 D1 연결하기
Workers & Pages → coupang-writing → Bindings → Add binding → D1 database로 이동합니다.
항목 입력값 Variable name DB· 대문자D1 database coupang-writing-dbAdd binding으로 저장하고, 배포 적용 안내가 나오면 적용합니다.
비밀번호와 비밀키 설정하기
Worker의 Settings → Variables and Secrets → Add에서 아래 두 값을 각각 Secret 유형으로 추가합니다. 저장 후 Deploy 안내가 나오면 적용합니다.
이름 넣을 값 APP_PASSWORD직접 정한 12자 이상 로그인 비밀번호 SESSION_SECRET아래에서 생성한 64자 무작위 문자열 키는 현재 브라우저 안에서 생성됩니다. 설치 단계 확인 기록에는 저장하지 않습니다. 두 비밀값을 Worker 코드에 적지 마세요.
Worker 첫 화면의
workers.dev주소에서 직접 정한 비밀번호로 로그인해 봅니다. 이 주소에서 저장까지 되면 다음 단계로 갑니다.write.brainnode.cloud 연결하기
brainnode.cloud가 같은 Cloudflare 계정의 도메인 목록에서 Active 상태인지 확인합니다. 다른 곳에서 DNS를 관리 중이면 먼저 도메인을 Cloudflare에 연결해야 합니다.Worker의 Settings → Domains & Routes → Add → Custom Domain에 다음 주소를 넣고 Add Custom Domain을 누릅니다.
write.brainnode.cloud
Cloudflare가 이 서브도메인의 DNS와 HTTPS 인증서를 준비합니다. 활성화되면 https://write.brainnode.cloud로 접속합니다.
이번 설치용으로 준비한 주소이며 아직 본인 계정에 연결한 것은 아닙니다. ‘write’라는 기존 CNAME이 있으면 충돌할 수 있습니다. 쓰임을 확인한 뒤 이 집필 앱으로 전환할 때만 해당 레코드를 정리합니다. 루트 도메인과 다른 서브도메인의 레코드는 수정하지 않습니다.
휴대폰에서 이어 쓰기
휴대폰 Safari나 Chrome에서
https://write.brainnode.cloud를 열고 같은 비밀번호로 로그인합니다. 질문과 답변 → 질문 선택 → 답변 작성으로 들어갑니다. 모바일에서는 목록과 작성 화면이 한 화면씩 표시됩니다.- PC에서 짧은 답변을 쓰고 저장됨을 확인합니다.
- 휴대폰에서 새로고침해 그 답변을 열고 수정합니다.
- 다시 PC에서 새로고침해 수정 내용이 보이는지 확인합니다.
휴대폰 공유 메뉴나 브라우저 메뉴의 홈 화면에 추가로 아이콘을 만들 수 있습니다. 답변 글자는 16px, 줄간격은 1.5배입니다.
다른 기기에서 바꾼 내용은 새로고침 후 보입니다. 인터넷이 끊기면 해당 브라우저에 임시 보관하며, 다시 연결되고 저장됨이 표시되어야 D1에 반영됩니다. 같은 문항을 동시에 수정하면 비교 화면으로 덮어쓰기를 방지합니다.
운영 · 백업 · 업데이트
앞으로는 휴대폰이나 PC에서 주소를 열어 글만 쓰면 됩니다. Ubuntu를 켜 두거나 설치 명령을 다시 실행할 필요가 없습니다.
- 백업: ‘전체 내보내기’에서 엑셀·CSV·마크다운을 내려받습니다.
- 업데이트: 같은 Worker의 Edit code에서 새 worker.js로 교체하고 Deploy합니다. 기존 D1 연결과 두 Secret은 유지합니다.
- 비밀번호 변경: APP_PASSWORD를 바꾸고 배포하면 기존 로그인은 해제됩니다.
원고 텍스트 자체는 작습니다. 예를 들어 939문항에 각 2,000자의 한글을 적으면 본문 약 5.6MB이며, 수정 이력과 DB 부가 용량은 별도입니다. D1은 기기 간 공유 저장소로 사용합니다.
막혔을 때
- 로그인 대신 설치 안내가 나와요
- DB 바인딩 이름이 대문자 DB인지, APP_PASSWORD가 12자 이상인지, SESSION_SECRET이 32자 이상인지 확인하고 배포를 적용합니다.
- 저장소 연결 오류가 나요
- 연결한 D1 Console에서 3단계 SQL을 실행했는지 확인합니다.
- 도메인을 연결할 수 없어요
- 같은 계정의 brainnode.cloud가 Active인지, write라는 CNAME이 이미 있는지 확인합니다.
- 휴대폰에서 답변이 달라요
- 두 기기가 같은 주소의 기록장을 열었는지 확인하고, 저장됨을 확인한 다음 다른 기기에서 새로고침합니다.
선택: 나중에 Ubuntu 터미널로 업데이트하고 싶을 때
기본 설치에는 필요 없습니다. Node.js 22 이상이 있는 Ubuntu에서 소스 폴더를 열고 wrangler.worker.jsonc의 D1 ID를 실제 값으로 바꾸면 다음 명령으로 같은 Worker를 업데이트할 수 있습니다. Worker 이름과 D1은 유지합니다.
npm ci npm run build:worker npx wrangler login npx wrangler deploy --config wrangler.worker.jsonc
설정 파일에 write.brainnode.cloud의 custom_domain 경로를 넣어 두었습니다. 비밀값은 대시보드에 둡니다.