Chuyển đến nội dung

outline / outline

Outline

Wiki nội bộ cho nhóm, soạn cùng lúc, tương thích Markdown, có thể tự cài

Outline là kho tri thức dạng wiki cho nhóm làm việc: bạn viết tài liệu, quy trình, ghi chú họp, cả nhóm cùng sửa theo thời gian thực. Có thể dùng bản hosted của hãng hoặc tự cài trên máy chủ. Giấy phép là BSL 1.1 chứ không phải giấy phép mã nguồn mở kiểu MIT, nên cần đọc kỹ nếu định dùng thương mại.

  • 41.274 sao
  • 3.659 fork
  • TypeScript
  • Cập nhật hôm nay
  • Giấy phép riêng, xem trên GitHub
Độ khó
Khó Dành cho người biết lập trình
Dạng
Web tự cài (self-host)
Chạy trên
Web, Docker, Node.js
Chi phí
Miễn phí, có bản trả phí

Trải nghiệm khi dùng Outline

Với người dùng cuối, Outline là một trang web: cây tài liệu bên trái, trang soạn thảo sạch sẽ ở giữa. Bạn gõ tài liệu, thêm ảnh, bảng, nhúng nội dung và gõ Markdown quen thuộc; người khác trong nhóm mở cùng trang thì thấy chỉnh sửa của nhau ngay. Rất hợp để viết quy trình làm việc hay hướng dẫn nhân viên mới.

Người cài đặt có cảm giác khác hẳn. README của repo không đưa lệnh cài từng bước mà chỉ gửi bạn sang tài liệu hosting chính thức để chạy bản production, và cho biết có ảnh container trên Docker Hub. Nghĩa là bạn cần quen với Docker, cơ sở dữ liệu và cấu hình đăng nhập cho nhóm.

Vì thế với nhóm nhỏ không có người quản trị máy chủ, README còn nhắc thẳng rằng nếu chỉ muốn dùng Outline thì không cần chạy mã này, hãy dùng bản hosted tại getoutline.com.

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

Soạn thảo cộng tác thời gian thực

Nhiều người cùng sửa một tài liệu mà không ghi đè lên nhau.

Tương thích Markdown

Gõ Markdown quen thuộc hoặc dùng giao diện soạn thảo, tuỳ bạn.

Tổ chức theo bộ sưu tập

Sắp xếp tài liệu theo bộ sưu tập và cây trang để cả nhóm tìm nhanh.

Tìm kiếm nhanh

Mô tả của dự án nhấn mạnh tốc độ: tìm tài liệu trong kho kiến thức rất nhanh.

Tích hợp với công cụ nhóm

Theo chủ đề của repo, có tích hợp Slack để nối wiki vào luồng làm việc.

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

Chủ doanh nghiệp nhỏ, bộ phận nhân sự

Cẩm nang nhân viên mới

Gom nội quy, quy trình bán hàng, cách xử lý đơn hoàn vào một nơi để nhân viên mới tự tra.

Lập trình viên, IT nội bộ

Wiki cho đội kỹ thuật

Ghi tài liệu hệ thống, hướng dẫn triển khai, ghi chú xử lý sự cố.

Quản lý dự án

Ghi chú họp có thể tìm lại

Cả nhóm cùng cập nhật biên bản, việc cần làm, rồi tìm lại sau vài tháng.

Đội làm marketing, thiết kế

Trung tâm tài liệu cho agency

Lưu brief khách hàng, hướng dẫn thương hiệu, mẫu báo cáo ở một nơi chung.

Cần chuẩn bị gì?

  • Máy chủ chạy được Docker hoặc môi trường Node.js, cùng cơ sở dữ liệu theo tài liệu hosting chính thức.
  • Cấu hình đăng nhập cho nhóm; chi tiết nằm trong tài liệu hosting của Outline.
  • Kỹ năng quản trị máy chủ để cài, cập nhật và sao lưu.
  • Nếu không muốn tự vận hành: dùng bản hosted tại getoutline.com.

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

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

  1. Docs chính thức khuyên dùng Docker. Cần Docker và Docker Compose trên máy chủ, cùng PostgreSQL và Redis (có thể chạy chung trong compose như bên dưới). Tạo thư mục riêng cho Outline và file docker.env chứa biến môi trường. Tối thiểu cần URL (địa chỉ truy cập), DATABASE_URL, REDIS_URL và SECRET_KEY; thiếu biến nào Outline sẽ báo khi khởi động. Giá trị dưới đây khớp với compose mẫu; SECRET_KEY là chuỗi bí mật ngẫu nhiên bạn tự tạo.

    Văn bản
    URL=http://localhost:3000
    DATABASE_URL=postgres://user:pass@postgres:5432/outline
    REDIS_URL=redis://redis:6379
    SECRET_KEY=CHUOI_BI_MAT_NGAU_NHIEN
  2. Tạo file docker-compose.yml dựa trên mẫu của docs (rút gọn: bỏ dịch vụ https-portal là proxy SSL tuỳ chọn; thêm dòng ports để mở thử trên máy). Docs khuyên ghim phiên bản image (ví dụ outlinewiki/outline:1.2.0, postgres:18) thay vì latest để tự chủ việc nâng cấp. Đổi user, pass của Postgres cho khớp DATABASE_URL.

    YAML
    services:
      outline:
        image: docker.getoutline.com/outlinewiki/outline:latest
        env_file: ./docker.env
        ports:
          - "3000:3000"
        volumes:
          - storage-data:/var/lib/outline/data
        depends_on:
          - postgres
          - redis
      redis:
        image: redis
        env_file: ./docker.env
      postgres:
        image: postgres:18
        env_file: ./docker.env
        volumes:
          - database-data:/var/lib/postgresql
        healthcheck:
          test: ["CMD", "pg_isready", "-d", "outline", "-U", "user"]
          interval: 30s
          timeout: 20s
          retries: 3
        environment:
          POSTGRES_USER: 'user'
          POSTGRES_PASSWORD: 'pass'
          POSTGRES_DB: 'outline'
    volumes:
      storage-data:
      database-data:
  3. Khởi động và đọc kỹ log xem có lỗi kết nối cơ sở dữ liệu hoặc Redis không. Migration (tạo bảng) chạy tự động khi container khởi động.

    Terminal
    docker compose up -d
    docker compose logs -f outline
  4. Muốn truy cập từ internet với HTTPS thì làm theo tài liệu cấu hình SSL (có thể dùng dịch vụ https-portal trong compose mẫu của docs). Dữ liệu nằm trong các volume storage-data và database-data nên nhớ sao lưu.

    Văn bản
    https://docs.getoutline.com/s/hosting/doc/docker-7pfeLP5a8t
  5. Cập nhật: sao lưu cơ sở dữ liệu, kéo image mới (hoặc sửa số phiên bản trong compose nếu đã ghim), rồi khởi động lại container; migration sẽ tự chạy.

    Terminal
    docker pull docker.getoutline.com/outlinewiki/outline:latest
    docker compose up -d

Cài trên Dùng bản hosted

  1. Nếu chỉ muốn dùng chứ không cần tự cài, README đề xuất bản hosted của hãng. Truy cập địa chỉ dưới, đăng ký và mời nhóm của bạn.

    Văn bản
    https://www.getoutline.com
  2. Bản hosted là dịch vụ của hãng, có thể có phí; xem trang giá chính thức vì README không nêu giá.

Dùng thử lần đầu

  1. Cấu hình ít nhất một phương thức đăng nhập cho nhóm theo tài liệu Authentication của Outline, rồi mở http://localhost:3000 (hoặc URL bạn đặt) và đăng nhập.

  2. Tạo một bộ sưu tập (collection) đầu tiên, ví dụ Quy trình bán hàng, rồi tạo một tài liệu trong đó.

  3. Mời một đồng nghiệp mở cùng tài liệu và thử sửa đồng thời để thấy chỉnh sửa hiện ngay.

  4. Đọc hướng dẫn người dùng của Outline để biết cách phân quyền và chia sẻ tài liệu ra ngoài.

Mẹo dùng hay

  • Quyết định cấu trúc bộ sưu tập từ sớm (theo phòng ban hoặc theo dự án) để wiki không thành đống rối.
  • Nếu không có người lo máy chủ, hãy cân nhắc bản hosted ngay từ đầu vì tiết kiệm công vận hành.
  • Đưa vào wiki dần dần: mỗi lần giải thích điều gì cho đồng nghiệp hơn hai lần thì viết thành tài liệu.

Lưu ý và hạn chế

  • Giấy phép là BSL 1.1 (Business Source License), không phải giấy phép mã nguồn mở tự do kiểu MIT hay Apache; hãy đọc tệp LICENSE trước khi dùng thương mại hoặc cung cấp thành dịch vụ.
  • README không nêu lệnh cài đặt cụ thể; bạn phải theo tài liệu hosting bên ngoài repo.
  • Dự án yêu cầu không gửi pull request do AI sinh ra hàng loạt và phải thảo luận với nhóm lõi trước khi gửi mã.

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

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

Bạn có thể tự cài từ mã nguồn, nhưng bản hosted của hãng là dịch vụ riêng và README không nêu giá. Hãy xem trang giá chính thức.

Có tiếng Việt không?

README có nhắc đến việc dịch giao diện sang ngôn ngữ khác nhưng không liệt kê tiếng Việt. Bạn gõ nội dung tiếng Việt thì bình thường; muốn biết giao diện đã dịch chưa, hãy kiểm tra trong ứng dụng.

Máy yếu có chạy được không?

README không nêu yêu cầu phần cứng; hãy theo tài liệu hosting. Vì cần cả ứng dụng và cơ sở dữ liệu, bạn nên chuẩn bị một máy chủ chuyên dụng cho nhóm.

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/outline/outline.git

Repo tương tự nên xem

Năng suất & ghi chú74,6K

AFFiNE

toeverything / 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

VừaWindowsmacOSLinuxWeb+1
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ú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ộ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,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
Năng suất & ghi chú62,5K

Plane

makeplane / plane

Công cụ quản lý dự án mã nguồn mở theo kiểu Jira, Linear: theo dõi công việc, chu kỳ làm việc và lộ trình

KhóWebDocker

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