← 집필 기록장설치 파일 다운로드 ↓

브라우저에서 한 번 설치

Cloudflare 화면에서
설치하고 운영하기

우분투에서 브라우저를 열고 Cloudflare에 로그인하면 됩니다. 파일은 이미 빌드해 두었습니다. 서버를 켜 두거나 터미널 명령을 실행할 필요가 없습니다.

예정 주소: https://write.brainnode.cloud

화면과 기능은 Worker, 원고 저장은 D1이 맡습니다. 휴대폰과 PC에서 같은 주소로 접속합니다. Cloudflare Tunnel은 필요 없습니다.

직접 설치한 이 기록장은 개인 비밀번호로 로그인합니다. 원고는 연결된 D1에 저장됩니다.

기본 방법 · Cloudflare 대시보드0 / 8단계 확인
  1. 설치 파일 내려받기

    설치 파일 ZIP을 내려받아 우분투 파일 관리자에서 압축을 풉니다. 간편설치/worker.js가 실제 배포 파일입니다. 화면·기능·939개 질문이 이 한 파일에 들어 있습니다.

    기존 명령줄 설치용 v1.0 대신 이 v1.1 파일을 사용합니다. 앱 소스도 함께 들어 있습니다.

  2. Worker 만들고 코드 등록하기

    Cloudflare 대시보드에서 Workers & Pages → Create application → Start with Hello World! → Deploy 순서로 진행합니다. 이름은 coupang-writing으로 정합니다.

    생성한 Worker의 Edit code를 엽니다. 기본 worker.js 내용을 모두 지우고, 아래 버튼으로 복사한 코드를 붙여넣어 Deploy를 누릅니다.

    Worker 파일만 받기 ↓
    코드 복사가 안 되면

    압축 파일 안의 간편설치/worker.js를 아래에서 선택한 다음 ‘Worker 코드 복사’를 다시 누릅니다. 또는 우분투 텍스트 편집기로 파일을 열고 전체 선택 후 복사합니다.

    정적 파일 드래그앤드롭 화면과 Worker 코드 편집기는 서로 다른 화면입니다. 이번 설치에서는 서버 기능이 포함된 Worker 코드 편집기를 사용합니다. 처음에는 저장소 설정 안내가 나와도 정상입니다.

  3. 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개를 따로 업로드할 필요가 없습니다.

  4. Worker에 D1 연결하기

    Workers & Pages → coupang-writing → Bindings → Add binding → D1 database로 이동합니다.

    항목입력값
    Variable nameDB · 대문자
    D1 databasecoupang-writing-db

    Add binding으로 저장하고, 배포 적용 안내가 나오면 적용합니다.

  5. 비밀번호와 비밀키 설정하기

    Worker의 Settings → Variables and Secrets → Add에서 아래 두 값을 각각 Secret 유형으로 추가합니다. 저장 후 Deploy 안내가 나오면 적용합니다.

    이름넣을 값
    APP_PASSWORD직접 정한 12자 이상 로그인 비밀번호
    SESSION_SECRET아래에서 생성한 64자 무작위 문자열

    키는 현재 브라우저 안에서 생성됩니다. 설치 단계 확인 기록에는 저장하지 않습니다. 두 비밀값을 Worker 코드에 적지 마세요.

    Worker 첫 화면의 workers.dev 주소에서 직접 정한 비밀번호로 로그인해 봅니다. 이 주소에서 저장까지 되면 다음 단계로 갑니다.

  6. 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이 있으면 충돌할 수 있습니다. 쓰임을 확인한 뒤 이 집필 앱으로 전환할 때만 해당 레코드를 정리합니다. 루트 도메인과 다른 서브도메인의 레코드는 수정하지 않습니다.

  7. 휴대폰에서 이어 쓰기

    휴대폰 Safari나 Chrome에서 https://write.brainnode.cloud를 열고 같은 비밀번호로 로그인합니다. 질문과 답변 → 질문 선택 → 답변 작성으로 들어갑니다. 모바일에서는 목록과 작성 화면이 한 화면씩 표시됩니다.

    • PC에서 짧은 답변을 쓰고 저장됨을 확인합니다.
    • 휴대폰에서 새로고침해 그 답변을 열고 수정합니다.
    • 다시 PC에서 새로고침해 수정 내용이 보이는지 확인합니다.

    휴대폰 공유 메뉴나 브라우저 메뉴의 홈 화면에 추가로 아이콘을 만들 수 있습니다. 답변 글자는 16px, 줄간격은 1.5배입니다.

    다른 기기에서 바꾼 내용은 새로고침 후 보입니다. 인터넷이 끊기면 해당 브라우저에 임시 보관하며, 다시 연결되고 저장됨이 표시되어야 D1에 반영됩니다. 같은 문항을 동시에 수정하면 비교 화면으로 덮어쓰기를 방지합니다.

  8. 운영 · 백업 · 업데이트

    앞으로는 휴대폰이나 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 경로를 넣어 두었습니다. 비밀값은 대시보드에 둡니다.