Chuyển đến nội dung

toeverything / AFFiNE

AFFiNE

Không gian làm việc gộp tài liệu, bảng trắng và bảng dữ liệu, ưu tiên lưu trên máy và có thể tự cài

AFFiNE là ứng dụng ghi chú và quản lý kiến thức mã nguồn mở, gộp soạn thảo tài liệu kiểu Notion với bảng trắng vô hạn kiểu Miro trên cùng một nền. Dự án theo hướng local-first (dữ liệu nằm trên máy bạn), có cộng tác thời gian thực, có AI hỗ trợ và có thể tự cài trên máy chủ riêng.

  • 74.574 sao
  • 5.528 fork
  • TypeScript
  • Cập nhật hôm nay
  • Giấy phép riêng, xem trên GitHub
Độ khó
Vừa Cần gõ vài lệnh hoặc dùng Docker
Dạng
Ứng dụng máy tính, Web tự cài (self-host)
Chạy trên
Windows, macOS, Linux, Web, Docker
Chi phí
Miễn phí, có bản trả phí

Trải nghiệm khi dùng AFFiNE

Bạn mở AFFiNE bằng bản web hoặc ứng dụng cài trên máy, tạo một trang và bắt đầu gõ như trong một trình soạn thảo tài liệu. Điểm đặc biệt là mỗi trang có thể chuyển giữa chế độ tài liệu và chế độ bảng trắng. Ở chế độ bảng trắng, bạn thả ghi chú dán, văn bản, hình, trang liên kết, bảng dữ liệu, thậm chí slide lên cùng một khung vô hạn.

Cách làm này hợp với những việc nửa viết nửa vẽ, như lên kế hoạch dự án, brainstorm hay chuẩn bị bài thuyết trình. README còn nói AFFiNE có trợ lý AI giúp viết báo cáo, biến dàn ý thành slide hoặc tóm tắt bài thành sơ đồ tư duy, nhưng chi tiết và điều kiện dùng nằm trên trang sản phẩm.

Vì ưu tiên local-first, dữ liệu luôn có bản trên máy bạn dù có đồng bộ hay không. Nếu muốn cả nhóm dùng chung, bạn có thể dùng dịch vụ của hãng hoặc tự cài bản self-host theo tài liệu chính thức.

Tính năng nổi bật

Tài liệu và bảng trắng hợp nhất

Đặt ghi chú, bảng dữ liệu, trang liên kết, hình dạng và slide lên cùng một khung vô hạn thay vì chuyển qua lại giữa nhiều công cụ.

Local-first

Dữ liệu luôn có bản trên máy của bạn, đồng bộ và cộng tác thời gian thực là lớp thêm vào.

Trợ lý AI đa phương thức

README mô tả AI giúp viết báo cáo, tạo slide từ dàn ý, tóm tắt thành sơ đồ tư duy hoặc sắp xếp công việc.

Cộng tác thời gian thực

Hỗ trợ đồng bộ và cùng làm việc trên bản web và các ứng dụng đa nền tảng.

Tự cài và tuỳ biến

Bạn có thể tự host, fork và build bản riêng. Tài liệu hướng dẫn tự cài ở docs.affine.pro.

Có mẫu dựng sẵn

Trang templates cung cấp mẫu như bảng tầm nhìn, giáo án hay one-pager để bắt đầu nhanh.

Tận dụng AFFiNE vào việc gì?

Dân văn phòng, quản lý

Lên kế hoạch dự án vừa viết vừa vẽ

Gom mục tiêu, sơ đồ quy trình và danh sách việc trên cùng một bảng trắng thay vì ba công cụ khác nhau.

Giáo viên, sinh viên

Soạn giáo án và học liệu

Dùng mẫu giáo án có sẵn hoặc tự dựng, ghi chú bài giảng và vẽ minh hoạ cạnh nhau.

Người làm marketing, nội dung

Brainstorm và sơ đồ tư duy

Thả ý tưởng lên bảng trắng, nhóm lại bằng hình dạng, rồi chuyển thành đề cương bài viết hoặc kịch bản video.

Doanh nghiệp nhỏ, đội kỹ thuật

Kho kiến thức riêng của nhóm

Tự cài AFFiNE để cả nhóm viết wiki nội bộ, giữ dữ liệu trong hạ tầng của mình.

Cần chuẩn bị gì?

  • Dùng bản web chỉ cần trình duyệt hiện đại; có ứng dụng cài trên máy tính, xem trang tải chính thức của AFFiNE.
  • Tự cài (self-host): máy chủ có Docker và Docker Compose; docs khuyên tối thiểu 4 nhân CPU, 2 GB RAM cho nhu cầu cơ bản, thêm ổ cứng cho Postgres và file tải lên.
  • Chạy công khai nên có tên miền và HTTPS (đặt sau reverse proxy).
  • Kết nối Internet để dùng đồng bộ, cộng tác và AI.

Hướng dẫn cài đặt chi tiết

Cài trên Bản web và ứng dụng

  1. Mở trang chính thức của AFFiNE để dùng bản web ngay, hoặc tải ứng dụng cho máy tính từ trang tải. README còn có bản demo trực tuyến để xem thử trước khi quyết định.

    Văn bản
    https://affine.pro
  2. Cách nhanh trên Windows: mở PowerShell và cài bằng winget (trình quản lý ứng dụng có sẵn trên Windows 10/11).

    PowerShell
    winget install --id "ToEverything.AFFiNE" -e
  3. Trên macOS đã cài Homebrew: cài bằng một lệnh trong Terminal.

    Terminal
    brew install --cask affine
  4. Tạo tài khoản hoặc dùng chế độ chạy cục bộ nếu muốn dữ liệu chỉ nằm trên máy. Tuỳ phiên bản, giao diện có thể thay đổi nên hãy làm theo màn hình chào.

  5. Tạo không gian làm việc đầu tiên và bắt đầu với một trang trống hoặc một mẫu có sẵn.

Cài trên Tự cài (Docker Compose)

  1. Docs chính thức khuyên dùng Docker Compose. Kiểm tra Docker Compose đã có, rồi tạo thư mục triển khai (nơi sẽ chứa dữ liệu, nên để ở chỗ cố định).

    Terminal
    docker compose version
    mkdir affine
    cd affine
    mkdir -p config
  2. Tải file docker-compose.yml bản mới nhất. Theo docs, dữ liệu Postgres nằm ở ./data/postgres, file tải lên ở ./data/storage và cấu hình ở ./config.

    Terminal
    curl -L -o docker-compose.yml \
      https://github.com/toeverything/AFFiNE/releases/latest/download/docker-compose.yml
  3. Tải file cấu hình mẫu. Mở config/config.json và đặt server.externalUrl là địa chỉ mà người dùng sẽ mở; chạy trên máy cá nhân thì để mặc định http://localhost:3010, còn công khai thì dùng URL HTTPS cuối cùng, ví dụ https://affine.example.com. Bản cài mới không cần file .env.

    Terminal
    curl -L -o config/config.json \
      https://github.com/toeverything/AFFiNE/releases/latest/download/config.json.example
  4. Khởi động rồi kiểm tra trạng thái: container migration chạy một lần rồi thoát thành công, còn AFFiNE, PostgreSQL và Redis phải đang chạy. Nếu lỗi, xem log.

    Terminal
    docker compose up -d
    docker compose ps
    docker compose logs --tail=200 affine affine_migration
  5. Mở trình duyệt vào địa chỉ dưới (hoặc URL bạn đặt ở externalUrl) và tạo tài khoản quản trị viên đầu tiên.

    Văn bản
    http://localhost:3010
  6. Sao lưu cả thư mục ./data và ./config. Trước khi nâng cấp hãy đọc ghi chú phát hành, sao lưu Postgres và đừng dùng tag latest một cách tuỳ tiện cho môi trường thật; chi tiết xem trang Upgrade của docs.

    Văn bản
    https://docs.affine.pro/self-host-affine
  7. Kiểm tra phần giấy phép: README repo ghi giấy phép riêng cho thư mục backend, nên nếu bạn là doanh nghiệp hãy đọc file LICENSE trong repo trước khi triển khai.

Dùng thử lần đầu

  1. Tạo một trang mới và gõ vài dòng ghi chú để làm quen trình soạn thảo.

  2. Chuyển trang đó sang chế độ bảng trắng và thả thêm vài ghi chú dán, hình dạng hoặc hình ảnh lên khung.

  3. Thử chèn một bảng dữ liệu và một trang liên kết để thấy cách các khối kết nối với nhau trên cùng một khung.

  4. Mở trang templates của AFFiNE, chọn một mẫu như one-pager và dùng thử để thấy cách nhóm nội dung.

  5. Nếu dùng tính năng AI, thử nhờ nó tóm tắt một đoạn văn thành sơ đồ tư duy, và nhớ kiểm tra kết quả.

Mẹo dùng hay

  • Dùng chế độ tài liệu cho nội dung dài, bảng trắng cho bước phác ý tưởng, rồi liên kết giữa hai bên.
  • Thử vài mẫu có sẵn trước khi tự dựng cấu trúc, vì nó giúp bạn thấy AFFiNE được thiết kế để dùng thế nào.
  • Nếu làm việc quan trọng, nên xuất hoặc sao lưu định kỳ trước khi nâng cấp phiên bản lớn.
  • Tham gia Discord hoặc GitHub Discussions của dự án để hỏi khi gặp lỗi hoặc cần tính năng mới.

Lưu ý và hạn chế

  • Giấy phép của repo không đơn giản: phần lớn mã dưới MIT nhưng thư mục backend và một số phần có giấy phép riêng. Doanh nghiệp tự host nên đọc kỹ file LICENSE.
  • Một số tính năng như AI và đồng bộ đám mây phụ thuộc dịch vụ của hãng và có thể có gói trả phí. Kiểm tra điều kiện trên trang sản phẩm.
  • README nhắc plugin và block của bên thứ ba vẫn là kế hoạch tương lai, nên hệ sinh thái mở rộng còn hạn chế.

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

AFFiNE có miễn phí không?

Có thể dùng miễn phí và tự cài, nhưng một số dịch vụ như đồng bộ nâng cao hoặc AI có thể thuộc gói trả phí. Hãy xem trang giá chính thức vì điều kiện có thể thay đổi.

Dữ liệu của tôi lưu ở đâu?

AFFiNE theo hướng local-first nên dữ liệu có bản trên máy bạn. Nếu bật đồng bộ hoặc tự host, dữ liệu còn nằm trên máy chủ tương ứng.

Khác gì Notion hay Miro?

README tự giới thiệu là lựa chọn thay thế cho cả hai, gộp tài liệu và bảng trắng vào một nền. Notion và Miro có hệ sinh thái lớn hơn, còn AFFiNE là mã nguồn mở và tự cài được.

Tải mã nguồn về máy

Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.

Terminal
git clone https://github.com/toeverything/AFFiNE.git

Repo tương tự nên xem

Năng suất & ghi chú79K

AppFlowy

AppFlowy-IO / AppFlowy

Không gian làm việc kiểu Notion mã nguồn mở: ghi chú, tài liệu, bảng dữ liệu, bạn giữ quyền với dữ liệu

DễWindowsmacOSLinuxAndroid+1
Năng suất & ghi chú51,4K

tldraw

tldraw / tldraw

Bộ công cụ để lập trình viên nhúng bảng trắng vô hạn kiểu Miro vào ứng dụng React

KhóWebNode.js
Năng suất & ghi chú47,2K

SiYuan (Tư Nguyên)

siyuan-note / siyuan

Ứng dụng ghi chú theo khối, dữ liệu nằm trên máy bạn, có bản Windows, macOS, điện thoại và Docker

DễWindowsmacOSLinuxAndroid+2

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: Năng suất & ghi chú

Năng suất & ghi chú136K

Excalidraw

excalidraw / excalidraw

Bảng trắng vẽ sơ đồ phong cách nét vẽ tay, dùng ngay trên trình duyệt, miễn phí và có thể cộng tác trực tiếp

DễWebNode.js
Năng suất & ghi chú80,8K

Hoppscotch

hoppscotch / hoppscotch

Công cụ gửi và kiểm thử API ngay trên trình duyệt, nhẹ hơn Postman và có thể tự cài trên máy chủ riêng

VừaWebWindowsmacOSLinux+1
Năng suất & ghi chú65,5K

NocoDB

nocodb / nocodb

Biến cơ sở dữ liệu thành bảng tính kiểu Airtable: xem, lọc, nhập liệu và chia sẻ mà không cần viết code

VừaDockerWeb
Năng suất & ghi chú64,5K

Memos

usememos / memos

Sổ ghi chú nhanh tự cài trên máy chủ của bạn, ghi chú theo dòng thời gian, hỗ trợ Markdown và thẻ

VừaDockerWebLinuxmacOS+1
Năng suất & ghi chú64,1K

MarkText

marktext / marktext

Trình soạn thảo Markdown đơn giản, xem trước ngay khi gõ, miễn phí cho Windows, macOS và Linux

DễWindowsmacOSLinux
Năng suất & ghi chú64K

draw.io Desktop

jgraph / drawio-desktop

Bản ứng dụng máy tính của draw.io (diagrams.net) để vẽ sơ đồ, lưu file ngay trên máy và dùng không cần mạng

DễWindowsmacOSLinux

Xem cả 18 repo Năng suất & ghi chú Về Kho Repo