Xuất bản Second Brain lên web có mật khẩu: Quartz, Cloudflare hoặc Obsidian Publish

Muốn xem kho trên điện thoại nhưng không muốn cả Internet thấy

Anh Tuấn có một kho Obsidian gồm quy trình, kịch bản tư vấn, ghi chú họp. Anh muốn mở kho trên điện thoại và cho hai trưởng nhóm đọc. Anh làm theo một hướng dẫn đưa kho lên web miễn phí, rồi mới phát hiện trang mở cho bất kỳ ai có đường dẫn, kèm cả ảnh chụp hợp đồng. (Tình huống minh hoạ.)

Đưa Second Brain lên web không khó. Khó là khoá đúng và không đưa nhầm. Bài này đi theo thứ tự đó: chọn phần được đưa lên, dựng trang, khoá trang, rồi kiểm tra từng địa chỉ trước khi gửi link. Chưa có kho, bắt đầu từ Cài Obsidian và tạo kho Second Brain đầu tiên.

Xuất bản Second Brain lên web có mật khẩu là gì?

Xuất bản Second Brain lên web có mật khẩu là biến một phần ghi chú đã chọn thành trang web để đọc trên mọi thiết bị, đặt sau một lớp đăng nhập để chỉ người được duyệt mới mở được.

Nguồn: Quartz GitHub · Cloudflare Access · Pages limits · Obsidian Publish · Publish – giới hạn

Bước 0: chọn phần được đưa lên trước khi dựng

Lớp mật khẩu có thể cấu hình sai; thứ không nằm trên web thì không thể lộ qua web.

• Tạo một thư mục riêng trong kho, ví dụ Web, chỉ chứa ghi chú bạn đồng ý cho người khác đọc. Không trỏ cả kho lên web.
• Để ngoài thư mục đó: dữ liệu khách hàng, lương, hợp đồng, số liệu tài chính, biên bản nhạy cảm.
• Rà ảnh, PDF đính kèm. Với Quartz, mọi tệp không phải Markdown trong thư mục nội dung đều được xuất ra công khai, kể cả khi ghi chú chứa nó đã bị lọc.
• Không có khoá API, mật khẩu, mã OTP nào trong ghi chú. Nếu có, chuyển sang trình quản lý mật khẩu và đổi khoá đó.
• Kho đã có lịch sử phiên bản hoặc bản sao lưu, xem Đồng bộ và sao lưu Second Brain.

Nguồn: Quartz – Private pages

Đường 1, bước 1–4: dựng trang bằng Quartz

Quartz là trình tạo web tĩnh, biến các tệp Markdown thành trang web có tìm kiếm, liên kết [[ ]], backlink và đồ thị ghi chú, tương thích Obsidian. Giấy phép MIT. Tài liệu hiện hành là Quartz 5 (bản 5.0.0, nhánh mặc định v5); yêu cầu Node.js từ v22 và npm từ 10.9.2.

Bước 1. Tạo kho GitHub riêng tư từ mẫu Quartz

Mở kho Quartz trên GitHub, bấm Use this template → Create a new repository, đặt tên và chọn Private. Tài liệu Quartz khuyên cách này vì không phải chỉnh lại địa chỉ kho về sau.

Bước 2. Tải về, cài, khởi tạo và xem thử trên máy

git clone https://github.com/<tài khoản GitHub>/<tên kho riêng tư>.git
cd <tên kho riêng tư>
node -v                                   # cần từ v22 trở lên
npm i
npx quartz create                         # chọn mẫu obsidian, cách nạp nội dung, base URL
npx quartz plugin install --from-config   # cài plugin mà mẫu đã chọn
npx quartz build --serve                  # xem thử tại http://localhost:8080

Khi npx quartz create hỏi: chọn mẫu obsidian; cách nạp nội dung chọn copy và trỏ tới thư mục Web ở bước 0, không trỏ cả kho; base URL không kèm https://.

Bước 3. Đặt hai lớp lọc trong quartz.config.yaml

configuration:
  baseUrl: <tên miền, không có https://>
  ignorePatterns:
    - private
    - templates
    - .obsidian
    - "<thư mục nhạy cảm, ví dụ Khach-hang>"

plugins:
  - source: "@quartz-community/remove-draft"
    enabled: true      # bỏ ghi chú có draft: true
  - source: "@quartz-community/explicit-publish"
    enabled: true      # chỉ xuất bản ghi chú có publish: true

Lớp 1 là plugin lọc: bật explicit-publish thì chỉ ghi chú có publish: true mới lên web. Lớp 2 là ignorePatterns: thư mục bị bỏ qua hoàn toàn. Tài liệu Quartz nhắc hai lớp này chỉ giữ trang khỏi bản web; kho GitHub công khai thì phải thêm cả vào .gitignore, nên để kho riêng tư như bước 1.

Bước 4. Đẩy lên GitHub

npx quartz sync --no-pull   # lần đầu
npx quartz sync             # những lần sau

Nguồn: Quartz 5 · Quartz – Installation · Quartz – Configuration · Quartz – Private pages

Đường 1, bước 5: đưa lên Cloudflare Pages

1. Đăng nhập bảng điều khiển Cloudflare, vào Compute (Workers) → Workers & Pages → Create application → Pages → Connect to Git, chọn kho GitHub vừa tạo.
2. Ở mục Set up builds and deployments, điền theo bảng dưới rồi bấm Save and deploy.
3. Từ đây, mỗi lần npx quartz sync, Cloudflare tự build lại trang.

Trang lấy ngày cập nhật từ git thì thêm git fetch --unshallow && vào đầu lệnh build, vì Pages chỉ tải lịch sử git rút gọn.

Gói Free của Pages: 500 lần build mỗi tháng, mỗi build tối đa 20 phút, 20.000 tệp mỗi site, mỗi tệp tối đa 25 MiB.

Nguồn: Quartz – Hosting · Pages limits · Cloudflare Pages

Đường 1, bước 6: khoá trang bằng Cloudflare Access

Cloudflare Access đặt một cổng đăng nhập trước trang web. Gói Free giá 0 USD, dành cho nhóm dưới 50 người dùng; trên mức đó là gói trả theo người, 7 USD/người/tháng nếu trả năm. Người xem không cần tài khoản riêng: Access có thể gửi mã PIN một lần qua email tới địa chỉ được duyệt.

1. Trong dự án Pages, vào Settings → General, bấm Enable access policy. Bước này khoá các bản xem trước (preview), vốn mặc định công khai.
2. Bấm Manage ở policy vừa tạo, mở ứng dụng của dự án, chọn Configure, ở mục Public hostname bỏ dấu * ở ô Subdomain rồi lưu (nếu báo lỗi, đổi tên ứng dụng), để khoá luôn địa chỉ chính tên-dự-án.pages.dev.
3. Quay lại dự án, bật lại access policy cho preview. Kiểm tra phải có hai policy: một cho *.pages.dev, một cho preview.
4. Trong quy tắc của ứng dụng, chỉ cho phép đúng danh sách email bạn duyệt.
5. Thêm cách đăng nhập bằng mã PIN: Zero Trust → Integrations → Identity providers, thêm One-time PIN. Tổ chức Zero Trust mới mặc định dùng nhà cung cấp danh tính của Cloudflare, nên bước này phải tự làm.
6. Có tên miền riêng: vào Zero Trust → Access controls → Applications → Create new application, chọn loại Self-hosted and private, thêm public hostname là đúng tên miền đó. Thiếu bước này, trang đăng nhập vẫn hiện ra nhưng không hoạt động. Lưu ý thứ tự: hiện không thêm được tên miền tuỳ chỉnh khi tên miền đó đã có Access policy, nên gắn tên miền vào dự án trước.

Nguồn: Cloudflare Access – gói · Pages – Access · Preview deployments · One-time PIN · Basic Auth

Đường 2: Obsidian Publish có mật khẩu

Obsidian Publish là dịch vụ trả phí của chính Obsidian: chọn ghi chú, bấm Publish, trang nằm ở publish.obsidian.md/tên-site hoặc tên miền riêng. Giá 8 USD/site/tháng trả năm, 10 USD trả tháng, gồm 4 GB lưu trữ. Chỉ ghi chú bạn chọn mới được gửi lên máy chủ (hạ tầng Cloudflare, đặt ở San Francisco).

Chọn ghi chú

1. Bật core plugin Publish, tạo site trong tài khoản Obsidian có gói Publish.
2. Ở thanh bên trái, bấm Publish changes, chọn ghi chú ở mục NEW rồi bấm Publish.
3. Thuộc tính publish: true tự đưa ghi chú vào danh sách, publish: false loại ra.
4. Nút Add linked thêm các ghi chú được liên kết. Xem lại danh sách trước khi bấm, vì liên kết có thể kéo theo ghi chú bạn chưa định chia sẻ.
5. Ghi chú đổi tên hoặc đã xoá trên máy không tự gỡ khỏi web: phải tự tích ô xoá khi Publish.

Đặt mật khẩu cho cả site

1. Publish changes → Change site options.
2. Ở Other site settings, cạnh Passwords, bấm Manage → New password.
3. Nhập mật khẩu, đặt Nickname theo người được cấp (để sau này thu hồi đúng người), bấm Add this password.

Nguồn: Obsidian Publish · Publish your content · Publish – Security and privacy · Obsidian pricing

Aduca làm bản web riêng tư thế nào?

Aduca tự dựng theo hướng gần đường 1: kho Obsidian được xuất thành trang web bằng Quartz trên Cloudflare Pages; lớp đăng nhập dùng mật khẩu kèm mã Authenticator (TOTP). Trên đó có giao diện "chòm sao tri thức" để xem liên kết giữa các ghi chú. Bản web đồng bộ với máy Mac khoảng 2 phút một lần; khi hai bên cùng sửa, bản xung đột được lưu riêng chứ không ghi đè.

Phần sửa trên web và đồng bộ hai chiều là phần làm thêm, ngoài phạm vi bài này; người mới nên bắt đầu với bản chỉ đọc. Thứ tự vẫn là: chia vùng, khoá, kiểm tra, rồi mới chia sẻ. Chi tiết: Nhật ký Aduca xây Second Brain.

Kiểm tra đã làm đúng

npx quartz build                                   # build lại, kết quả nằm trong thư mục public
find public -type f \( -iname "*.pdf" -o -iname "*.png" -o -iname "*.jpg" \)   # liệt kê tệp ảnh, PDF sẽ lên web
grep -ril "<từ khoá nhạy cảm>" public            # thấy kết quả là phải gỡ trước khi đẩy lên

• Mở cửa sổ ẩn danh, vào tên miền riêng: phải hiện trang đăng nhập.
• Vào địa chỉ tên-dự-án.pages.dev: phải hiện trang đăng nhập.
• Vào một bản preview (dạng <mã>.tên-dự-án.pages.dev, tạo khi đẩy lên nhánh phụ): phải hiện trang đăng nhập.
• Dán thẳng đường dẫn một ảnh hoặc PDF trên trang: phải hiện trang đăng nhập.
• Thử đăng nhập bằng một email không nằm trong danh sách: không nhận được quyền vào.
• Kho GitHub ở chế độ Private; danh sách người có quyền vào kho đúng như dự định.
• Với Obsidian Publish: mở site bằng cửa sổ ẩn danh, phải bị hỏi mật khẩu; mục Passwords có đúng số mật khẩu, đúng biệt danh.

Lỗi thường gặp và cách xử lý

Nguồn: Quartz – Hosting · Pages – known issues · Publish – limitations

Bắt đầu từ đâu?

1. Hôm nay: tạo thư mục Web, chuyển vào 10–20 ghi chú bạn sẵn sàng cho người khác đọc, rà ảnh và PDF đi kèm.
2. Tuần này: chọn đường. Có người kỹ thuật thì dựng Quartz, đưa lên Pages, khoá bằng Access; muốn nhanh thì dùng Obsidian Publish với mật khẩu theo từng người.
3. Trước khi gửi link: chạy hết mục "Kiểm tra đã làm đúng", ghi lại ai được cấp quyền và lịch rà soát danh sách mỗi tháng.

Muốn AI cùng đọc kho theo cách có kiểm soát, xem Kết nối Second Brain với AI qua MCP và Nối Second Brain với Claude qua MCP. Muốn được tư vấn hoặc cùng dựng Second Brain cho doanh nghiệp, bạn có thể đăng ký Tư vấn 1-1 hoặc Coaching 1-1; chi phí báo sau buổi tư vấn.

Đọc tiếp: Cho nghiên cứu thị trường →

Câu hỏi thường gặp

Tài liệu liên quan

• Second Brain · AI AgentSecond Brain là gì? Bộ não thứ 2 cho chủ doanh nghiệp thời AISecond Brain (bộ não thứ 2) là gì: kho tri thức số bên ngoài đầu bạn, phương pháp CODE và PARA, vì sao quan trọng khi dùng AI Agent, kèm ví dụ của Aduca.
• Second Brain · AI AgentCài Obsidian và tạo kho Second Brain đầu tiênCài Obsidian từ trang chính thức trên Windows, macOS, Linux, điện thoại; tạo vault, dựng cây thư mục PARA, bật plugin lõi, đặt thư mục mẫu và chọn cách đồng bộ.
• Second Brain · AI AgentPhương pháp CODE và PARA: thu, sắp, chắt, dùng tri thứcPhương pháp CODE và PARA cho Second Brain: 4 bước thu, sắp, chắt, dùng; 4 nhóm PARA; tóm tắt lũy tiến; Zettelkasten, MOC và cách áp dụng cho doanh nghiệp nhỏ.
• Second Brain · AI Agent30 mẫu ghi chú Second Brain dùng ngay cho doanh nghiệp30 mẫu ghi chú Second Brain kèm properties: nguồn, bảng giá, kịch bản tư vấn, SOP, biên bản họp, prompt, luật cho AI; cách dùng plugin Templates của Obsidian.

Xem tất cả tài liệu hướng dẫn →

Bước tiếp theo

Đăng ký Tư vấn 1-1 xây Second Brain

Chuyên gia Aduca cùng bạn xem tri thức đang nằm rải rác ở đâu, chọn công cụ và cấu trúc phù hợp, rồi lên lộ trình nối Second Brain với AI Agent một cách an toàn. Dịch vụ dựng Second Brain nằm trong gói Tư vấn 1-1 hoặc Coaching 1-1; chi phí báo sau buổi tư vấn.

Đăng ký Tư vấn 1-1 xây Second BrainXem thư viện tài liệu

Nguồn tham khảo

• Quartz – trang chủ tài liệu (Quartz 5)
• Quartz – triển khai lên Cloudflare Pages
• Quartz – ẩn ghi chú riêng tư
• Cloudflare Pages – giới hạn
• Cloudflare Pages – bật Access cho dự án
• Cloudflare Zero Trust – đăng nhập bằng mã PIN qua email
• Cloudflare Access – gói và giá
• Obsidian Help – mật khẩu cho Obsidian Publish
• Obsidian Publish – tính năng và giá
• Cloudflare Workers – mẫu Basic Auth

Lịch sử cập nhật

• 21/10/2026 — Bản đầu.

Miễn trừ trách nhiệm