SSD Nodes Learn Hosting plans →
Hướng dẫn Matt ConnorBởi Matt Connor

BookStack, Wiki.js hay Outline: chọn wiki self-hosted

So sánh BookStack, Wiki.js và Outline về độ nặng khi cài, editor, đăng nhập và search. Chọn nhanh bản phù hợp cho admin solo hoặc team.

Bạn nên chạy wiki tự host nào

Một wiki tự host giúp tập hợp tài liệu của nhóm bạn vào một nơi có thể tìm kiếm được trên máy chủ do bạn kiểm soát. BookStack, Wiki.js và Outline đều thực hiện tốt công việc này. Sự khác biệt lớn nhất giữa chúng nằm ở khối lượng công việc bạn cần chuẩn bị trước khi trang đầu tiên được tải, và đối tượng nào được phép đăng nhập.

BookStack là phần mềm nhẹ nhất để triển khai và có quan điểm thiết kế rất rõ ràng về cấu trúc. Wiki.js cung cấp cho bạn nhiều lựa chọn trình soạn thảo nhất trên một cây thư mục trang. Outline mang lại trải nghiệm viết tốt nhất trong ba lựa chọn, và cấu hình production được tài liệu hóa của nó yêu cầu một nhà cung cấp danh tính (identity provider) bên ngoài để tạo không gian làm việc ban đầu.

Mọi thông tin dưới đây được trích xuất từ tài liệu chính thức của các dự án và các file cấu hình đã công bố. Đây là bảng so sánh khả năng, không phải là một bài benchmark. Các số phiên bản và yêu cầu hệ thống được đóng dấu thời gian vì cả ba dự án đều cập nhật liên tục.

Cấu trúc mới là lựa chọn thực sự

BookStack định hình sẵn nội dung của bạn. Một trang nằm trong một quyển sách, một quyển sách có thể chứa các chương, còn các kệ dùng để nhóm những quyển sách. Bạn không thể tự tạo cấp thứ năm. Giới hạn đó chính là đặc điểm của sản phẩm: người viết mới biết đặt trang ở đâu vì chỉ có một vị trí phù hợp. Đổi lại, nội dung không khớp với cấu trúc này sẽ bị ép vào đó.

Wiki.js sử dụng cây đường dẫn, tương tự các thư mục trên ổ đĩa. Một trang tại ops/backup/restic nằm ở bất kỳ vị trí nào bạn đặt, và bạn tự chọn độ sâu. Không có gì ngăn hai người lưu cùng một chủ đề dưới hai nhánh khác nhau, vì vậy một instance Wiki.js cần một người chịu trách nhiệm quản lý cây.

Outline sử dụng các collection, trong đó tài liệu có thể lồng bên trong tài liệu khác. Bạn di chuyển tài liệu bằng cách kéo thả chuột. Đây là hệ thống linh hoạt nhất trong ba hệ thống, nên cũng là hệ thống dễ bị mất cấu trúc nhất.

BookStack: cài đặt tối thiểu

BookStack là ứng dụng PHP sử dụng MySQL làm backend. Tính đến tháng 10 năm 2026, yêu cầu được ghi trong tài liệu là PHP 8.2 trở lên và MySQL 8.0 hoặc MariaDB 10.6 trở lên; nếu cài từ source thì cần thêm Composer 2.2 trở lên. Nhánh release hiện tại là 26.09, phát hành ngày 24 tháng 9 năm 2026, và release stable mới nhất là v26.09.3, một bản phát hành bảo mật từ ngày 11 tháng 11 năm 2026. Từ 26.09 trở đi, phải đặt giá trị APP_KEY; các bước dùng container bên dưới đã xử lý việc này. BookStack cũng công bố thông báo bảo mật PHP nghiêm trọng vào ngày 21 tháng 10 năm 2026: hãy cập nhật các package PHP bên dưới hoặc pull và tạo lại container bằng image đã vá, vì version BookStack tự nó không xác nhận rằng PHP đã được vá.

Dự án chính thức hỗ trợ script cài đặt và hướng dẫn cho các bản Ubuntu LTS được liệt kê, hiện gồm 22.04, 24.04 và 26.04; đôi khi dự án cũng công bố các hướng dẫn và script không được hỗ trợ cho những môi trường khác. Script cho 24.04 tự cài Apache, MySQL 8.0 và PHP 8.3. Trên 26.04, hãy dùng installation-ubuntu-26.04.sh trong các lệnh bên dưới; script này cài MySQL 8.4 và PHP 8.5.

wget https://codeberg.org/bookstack/devops/raw/branch/main/scripts/installation-ubuntu-24.04.sh
chmod a+x installation-ubuntu-24.04.sh
sudo ./installation-ubuntu-24.04.sh

Đọc cảnh báo của script trước khi chạy. Tài liệu ghi rõ script này "CHỈ DÙNG CHO OS MỚI, nó sẽ cài Apache, MySQL 8.0 và PHP 8.3, đồng thời có thể GHI ĐÈ mọi cấu hình web hiện có trên máy". Script cho 24.04 kiểm tra cấu hình Apache và dữ liệu MySQL hiện có; nếu phát hiện một trong hai, script sẽ dừng trước khi cài đặt. Khi đó, hãy dùng container hoặc cài BookStack thủ công trên LAMP stack hiện có trên Ubuntu 24.04.

Cách dùng container sử dụng image LinuxServer.io, một trong hai thiết lập container cộng đồng được tài liệu BookStack liệt kê. BookStack cần session encryption key và sẽ không phục vụ trang nếu thiếu key này, vì vậy hãy tạo key trước.

docker run -it --rm --entrypoint /bin/bash lscr.io/linuxserver/bookstack:latest appkey

Chép giá trị được in ra vào APP_KEY, rồi ghi service. Service này cũng cần một database MySQL hoặc MariaDB có sẵn; đặt các giá trị DB_* cho phù hợp, vì snippet này không tạo database service.

services:
  bookstack:
    image: lscr.io/linuxserver/bookstack:latest
    container_name: bookstack
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - APP_URL=https://wiki.example.com
      - APP_KEY=paste_the_generated_key_here
      - DB_HOST=bookstack_db
      - DB_PORT=3306
      - DB_USERNAME=bookstack
      - DB_PASSWORD=change_me
      - DB_DATABASE=bookstackapp
    volumes:
      - ./config:/config
    ports:
      - 6875:80
    restart: unless-stopped

APP_URL phải khớp với địa chỉ mà người đọc thực sự nhập, bao gồm scheme và mọi port. Hãy đặt APP_URL thành http://localhost rồi phục vụ site qua HTTPS; khi đó các link và redirect được tạo sẽ trỏ đến sai host, khiến người đọc thấy một trang login tự quay lại chính nó. Nếu compose file còn mới với bạn, hãy bắt đầu bằng kiến thức cơ bản về Docker Compose trên VPS trước khi làm theo phần này.

Khởi động ứng dụng và kiểm tra rằng application trả lời request, không chỉ kiểm tra container đang chạy:

docker compose up -d
docker compose ps
curl -sI http://127.0.0.1:6875/login

200 OK có nghĩa là ứng dụng PHP đã khởi động và kết nối được đến database. 500 cần được chẩn đoán bằng application error log. Theo mặc định, BookStack ghi lỗi vào log file thay vì output của container, vì vậy hãy mở ./config/log/bookstack/laravel.log trên host để xem nguyên nhân. docker compose logs bookstack hiển thị các thông báo khởi động riêng của container, nhưng có thể không chứa application error.

Wiki.js: một cây, nhiều trình soạn thảo

Wiki.js là một ứng dụng Node.js. Thiết lập Docker được tài liệu hóa cho version 2 kết hợp Wiki.js với PostgreSQL, dù version 2 cũng hỗ trợ MySQL, MariaDB, MSSQL và SQLite. Version 3 yêu cầu PostgreSQL 17 hoặc 18. Đây là compose file trên trang Docker version 2 của dự án:

services:
  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: wiki
      POSTGRES_PASSWORD: wikijsrocks
      POSTGRES_USER: wikijs
    logging:
      driver: none
    restart: unless-stopped
    volumes:
      - db-data:/var/lib/postgresql/data
  wiki:
    image: ghcr.io/requarks/wiki:2
    depends_on:
      - db
    init: true
    environment:
      DB_TYPE: postgres
      DB_HOST: db
      DB_PORT: 5432
      DB_USER: wikijs
      DB_PASS: wikijsrocks
      DB_NAME: wiki
    restart: unless-stopped
    ports:
      - "80:3000"
volumes:
  db-data:

Hãy thay đổi POSTGRES_PASSWORD và DB_PASS cùng lúc trước khi chạy, vì chúng là một credential và giá trị mẫu đã được công khai. Tag được cố định ở ghcr.io/requarks/wiki:2 có chủ ý. Tài liệu khuyến nghị không dùng latest, vì một major version mới có thể gây breaking change; latest không còn được gán cho version 3 trở lên.

Version 3 trở thành stable vào ngày November 1, 2026. Tính đến ngày October 27, 2026, bản phát hành version 2 mới nhất là 2.5.317, một bản bug-fix từ ngày October 23, 2026, build lại image với các bản cập nhật bảo mật mới nhất của Node. Các bản phát hành version 2 hiện được publish từ một repository requarks/wiki-v2 riêng, và image tag :2 vẫn theo dõi các bản phát hành này. Theo kiểm tra ngày November 16, 2026, tài liệu cài đặt version 3 liệt kê các tag ghcr.io/requarks/wiki:3, ghcr.io/requarks/wiki:3.4.0 và ghcr.io/requarks/wiki:3.4, với image được tag theo version major, major.minor và major.minor.patch. Dùng version 3 cho cài đặt mới; compose example ở trên vẫn là thiết lập version 2. Bản phát hành trước đó, 2.5.316 từ ngày October 2, 2026, bổ sung utility export để chuyển content sang version 3 sau này. Một cài đặt version 2 hiện có cần export rồi import vào một instance version 3 riêng, không được chỉ đổi image tag tại chỗ; hãy xem lại permission và cấu hình lại authentication cùng storage sau khi migration.

Khi tải lần đầu, Wiki.js 2 hướng dẫn bạn qua quy trình setup trong trình duyệt để tạo account administrator. Trước khi hoàn tất, bất kỳ ai truy cập được port đều thấy wizard này, vì vậy hãy đặt service phía sau reverse proxy và TLS (transport layer security) trước khi mở firewall. Một wiki dùng hostname riêng sẽ phù hợp để chạy phía sau Traefik phía trước nhiều ứng dụng Docker khi server host nhiều service hơn chỉ service này.

Lựa chọn editor là lý do người dùng chọn Wiki.js. Một instance version 2 có thể chứa các trang Markdown, các trang dùng visual editor, các trang HTML thô và các trang AsciiDoc cạnh nhau. Điều này hữu ích khi bạn import content cũ ở format mà bạn không muốn convert. Tuy nhiên, nó cũng có thể khiến một wiki dùng bốn house style khác nhau, vì vậy hãy quyết định editor mặc định ngay từ ngày đầu và ghi lại quyết định đó.

Dàn ý: trình soạn thảo tốt nhất, yêu cầu nhiều nhất

Outline là lựa chọn mà mọi người thường nói đến khi muốn một công cụ ghi chú có cảm giác giống sản phẩm thương mại. Đây là một ứng dụng Node.js. Bản phát hành hiện tại tính đến ngày 16 tháng 11, 2026 là 1.13.0, được phát hành ngày 15 tháng 11, 2026. Bản phát hành này bỏ hỗ trợ Node 20 và cập nhật Docker image lên Node 26.13.1, vì vậy hãy cập nhật các bản cài đặt cũ. Bản cài đặt từ source hiện yêu cầu Node 22.23.5, 24.22.3 hoặc 26.13.1 trở lên. File môi trường mẫu liệt kê các thành phần cần thiết: PostgreSQL thông qua DATABASE_URL, Redis thông qua REDIS_URL, hai secret ngẫu nhiên và một URL có thể truy cập công khai.

openssl rand -hex 32
openssl rand -hex 32

Chạy lệnh đó 2 lần và giữ lại cả 2 giá trị. Giá trị đầu tiên trở thành SECRET_KEY, giá trị thứ hai trở thành UTILS_SECRET. Phần chính của file môi trường sẽ như sau:

NODE_ENV=production
URL=https://docs.example.com
PORT=3000
SECRET_KEY=<first openssl value>
UTILS_SECRET=<second openssl value>
DATABASE_URL=postgres://outline:change_me@postgres:5432/outline
PGSSLMODE=disable
REDIS_URL=redis://redis:6379
FILE_STORAGE=local
FILE_STORAGE_LOCAL_ROOT_DIR=/var/lib/outline/data

PGSSLMODE=disable chỉ đúng khi database nằm trên cùng máy hoặc cùng Docker network. Hãy bỏ biến này khi kết nối đến database qua network; nếu không, kết nối sẽ truyền dưới dạng plaintext. Attachment không còn bắt buộc bạn dùng object storage: FILE_STORAGE=local ghi file upload vào thư mục bên trên. Thư mục này phải là volume mà container có quyền ghi, đồng thời phải được đưa vào backup. Nếu muốn lưu các file đó trong S3 compatible bucket, hãy đặt FILE_STORAGE=s3 bằng các giá trị AWS_*.

Đây là phần thường khiến mọi người bất ngờ. Outline không có chức năng đăng nhập bằng username và password tích hợp sẵn. Cấu hình mẫu của chính Outline cho biết thông tin đăng nhập của bên thứ ba là bắt buộc: "at least ONE OF these is required for a working installation or you'll have no sign-in options". Các provider được tài liệu hóa gồm Google, Slack, Microsoft Entra, Discord và mọi server OpenID Connect (OIDC) thông qua OIDC_CLIENT_ID, OIDC_CLIENT_SECRET, OIDC_AUTH_URI, OIDC_TOKEN_URI và OIDC_USERINFO_URI. Workspace hiện có cũng có thể bật passkey và link hoặc code qua email. Đăng nhập qua email cần SMTP và không bypass SSO đối với các account đã liên kết với provider SSO.

Vì vậy, chi phí thực tế của cấu hình production được Outline tài liệu hóa là Outline cộng với PostgreSQL, Redis và một identity provider. Nếu team của bạn đã đăng nhập bằng Google Workspace hoặc Microsoft Entra, Outline trở nên rất hấp dẫn. Nếu chưa, bạn cũng phải self-host một hệ thống như Keycloak hoặc Authentik. Đây là service thứ hai cần patch và backup. Hãy phân bổ đủ memory: hướng dẫn của Outline ước tính khoảng 512 MB cho mỗi web process, được đặt bằng WEB_CONCURRENCY, chưa tính database và Redis.

Cách từng nền tảng xử lý quyền đọc nội dung

BookStack có sẵn tài khoản cục bộ dùng email và mật khẩu, đồng thời hỗ trợ LDAP, SAML2 và OIDC làm các phương án thay thế. Bạn thiết lập quyền theo từng role và có thể ghi đè trên từng shelf, book, chapter hoặc page. Quyền của book và chapter được kế thừa xuống nội dung con nếu không bị ghi đè; quyền của shelf phải được sao chép rõ ràng sang các book.

Wiki.js cũng có sẵn tài khoản cục bộ và bổ sung một danh sách dài các strategy mà bạn bật trong khu vực quản trị. Quy tắc page cho phép hoặc từ chối truy cập dựa trên pattern của path. Cách này mạnh nhưng dễ cấu hình sai, vì một rule cho phép các path bắt đầu bằng ops/ sẽ bao phủ mọi page mà sau này bạn đặt dưới path đó.

Outline dùng identity provider của bạn để quản lý thành viên SSO. Bên trong Outline, bạn kiểm soát quyền truy cập theo collection, document và group. Người dùng bị xóa khỏi identity provider sẽ bị đăng xuất khi lần tiếp theo tải Outline; hãy suspend họ trong Outline để kết thúc ngay các session hiện tại.

Cách tìm kiếm hoạt động trong từng nền tảng

Tìm kiếm quyết định một wiki có thực sự hữu ích hay chỉ trở thành một thư mục chứa những file bị bỏ quên.

BookStack tìm kiếm trong database và cung cấp cho người đọc một query language có thể học trong một phút. Đặt một cụm từ trong dấu ngoặc kép, như trong "london meeting", yêu cầu chuỗi đó phải khớp chính xác. Dùng dấu ngoặc vuông để tìm tag: [location=london] khớp theo tên tag, value hoặc cả hai, với các phép so sánh gồm !=, >= và like. Dùng dấu ngoặc nhọn để lọc theo metadata, như trong {created_after:2016-12-30}. Có thể loại trừ bất kỳ term exact, tag hoặc filter nào bằng cách thêm - ở đầu. BookStack giới hạn số term của từng loại trong một query, vì vậy query quá dài sẽ bị cắt bớt thay vì được thực thi.

Wiki.js 2 xem search là một module có thể thay thế. Các engine được tài liệu hóa gồm basic database engine, PostgreSQL engine, Elasticsearch, Algolia, AWS CloudSearch và Azure Search. Basic engine khớp title, description và path thay vì nội dung page. Nếu bạn chạy PostgreSQL, hãy chuyển sang PostgreSQL engine trong khu vực admin, vì engine này dùng full text index của database thay vì kiểu khớp đơn giản. Hãy dùng Elasticsearch cho một wiki đủ lớn để bạn chấp nhận vận hành và cập nhật bản vá cho thêm một search service.

Outline tìm kiếm trên full text index của PostgreSQL. Keyword search tích hợp sẵn không cần search service riêng. Với wiki của một team có vài nghìn document, đây là lựa chọn ít công sức nhất trong ba nền tảng.

Lựa chọn nào phù hợp với bạn

Hãy chọn BookStack nếu bạn muốn wiki chạy ngay trong chiều nay và ưu tiên tranh luận về nội dung hơn là cấu trúc. Nó có ít thành phần chuyển động nhất: một ứng dụng PHP và một cơ sở dữ liệu MySQL. Nó phù hợp cho các runbook nội bộ và tài liệu khách hàng, cũng như các nhóm mà đa số người viết không phải là kỹ sư. Đây cũng là lựa chọn dễ sao lưu nhất trong ba loại, vì trạng thái của nó chỉ bao gồm một bản dump cơ sở dữ liệu cộng với các tệp đã tải lên và cấu hình .env, bao gồm cả APP_KEY.

Hãy chọn Wiki.js nếu bạn cần một trình soạn thảo cụ thể hoặc một chiến lược xác thực đặc thù mà các lựa chọn khác không cung cấp, hoặc nếu bạn đang nhập một lượng lớn Markdown hoặc AsciiDoc hiện có và muốn giữ nguyên cấu trúc đường dẫn. Hãy chấp nhận rằng bạn đang chạy một stack nặng hơn và hãy ghim tag phiên bản chính (major version).

Hãy chọn Outline nếu chất lượng viết là quan trọng nhất, wiki dành cho một nhóm thay vì công chúng và bạn đã có sẵn một nhà cung cấp danh tính (identity provider). Nó đền đáp thiết lập đó bằng một trình soạn thảo mà mọi người thực sự thích sử dụng. Đừng chọn nó làm ứng dụng tự host đầu tiên của bạn.

Nếu không có lựa chọn nào trong ba loại trên phù hợp, sự không tương thích thường nằm ở loại nội dung. Các hóa đơn và hợp đồng đã quét thuộc về một hệ thống quản lý tài liệu như Paperless-ngx thay vì wiki, và việc ép buộc chúng vào wiki là lý do khiến nhiều wiki bị bỏ hoang. Một sự không tương thích phổ biến khác là khi bạn muốn một không gian làm việc thay vì một wiki, với tài liệu, bảng biểu và bảng trắng trên cùng một khung vẽ; đây là nơi một không gian làm việc AFFiNE tự host phù hợp hơn bất kỳ lựa chọn nào ở trên. Để có cái nhìn rộng hơn về những gì xứng đáng có mặt trên máy chủ của bạn, hãy xem danh sách rút gọn các ứng dụng tự host cho năm 2026.

Định cỡ và backup

Cả ba đều chạy được trên một VPS nhỏ. Mức tài nguyên tối thiểu thực tế khác nhau vì mỗi ứng dụng có các thành phần phía sau khác nhau. BookStack gồm một tiến trình ứng dụng và MySQL. Wiki.js gồm một tiến trình Node và PostgreSQL. Outline gồm một tiến trình Node, PostgreSQL và Redis, thường chạy cùng một identity provider. Vì vậy, Outline cần được cấp thêm memory.

Hãy backup database cùng với dữ liệu upload, rồi restore cả hai vào một instance tạm thời một lần trước khi phụ thuộc vào bản backup đó. Một bản backup wiki chưa từng được restore chỉ là phỏng đoán. Với BookStack, việc này có nghĩa là mysqldump cùng với volume /config. Với Wiki.js và Outline, việc này có nghĩa là pg_dump cùng với data volume; riêng Outline còn cần backup cả những gì nằm trong FILE_STORAGE_LOCAL_ROOT_DIR.

FAQ

Wiki tự host nào dễ cài đặt nhất?

BookStack. Đây là một ứng dụng PHP đơn lẻ dùng cơ sở dữ liệu MySQL. Dự án cung cấp installation script cho Ubuntu 24.04, script này cài Apache, MySQL 8.0 và PHP 8.3 trong một lần chạy. Container image cần có APP_KEY, APP_URL và thông tin xác thực cho một cơ sở dữ liệu hiện có. Wiki.js cần thêm Node runtime và PostgreSQL server. Outline cần Redis và một identity provider bên ngoài trong setup ban đầu theo tài liệu.

Tôi có thể dùng Outline mà không cần Google hoặc SSO provider khác không?

Setup production theo tài liệu của Outline yêu cầu một provider để tạo workspace ban đầu. Outline không có hình thức đăng nhập cục bộ bằng username và password. Sample configuration của dự án nêu rõ phải có ít nhất một third-party sign-in provider. Nếu không, bạn sẽ không có bất kỳ tùy chọn đăng nhập nào. Bạn có thể dùng Google, Slack, Microsoft Entra, Discord hoặc bất kỳ OpenID Connect server nào, chẳng hạn Keycloak hoặc Authentik tự host. Workspace hiện có có thể bật passkey hoặc email link và code. Đăng nhập bằng email cần SMTP. Các account đã liên kết với SSO vẫn dùng provider đó.

Tôi nên cài Wiki.js 3 hay Wiki.js 2?

Dùng version 3 cho installation mới. Version này trở nên stable vào November 1, 2026. Tài liệu cài đặt hiện liệt kê các tag ghcr.io/requarks/wiki:3, ghcr.io/requarks/wiki:3.4.0 và ghcr.io/requarks/wiki:3.4. Hãy pin tag của major version thay vì latest. Tag này không còn được gán cho version 3 trở lên. Compose example ở trên vẫn được pin vào version 2. Installation hiện có của version 2 phải export migration package rồi import package đó vào một instance version 3 riêng. Chỉ thay image tag không phải là cách upgrade được hỗ trợ.

Bản nào có search tốt nhất?

Mỗi bản mạnh theo một cách khác nhau. BookStack cung cấp cho người đọc query language với exact phrase, bộ lọc tag như [location=london] và bộ lọc metadata như {created_after:2016-12-30}. Bạn có thể phủ định bất kỳ thuật ngữ nào bằng cách thêm - ở đầu. Keyword search tích hợp của Outline không cần search service riêng. Wiki.js 2 có khả năng tùy chỉnh cao nhất vì bạn được chọn engine. PostgreSQL engine có thể search nội dung page mà basic engine không search được.

Sau này tôi có thể chuyển nội dung từ bản này sang bản khác không?

Có, nhưng chỉ một phần và bạn nên dự kiến sẽ phải thao tác thủ công. Cả ba đều export Markdown. Tuy nhiên, import tích hợp của BookStack nhận Portable ZIP format, nên chỉ có Markdown thì không thể import trực tiếp vào BookStack. Cấu trúc cũng không được giữ nguyên hoàn toàn. BookStack book và chapter không có thành phần tương đương trong nested document của Outline. Path của Wiki.js cũng không ánh xạ được sang hierarchy cố định của BookStack. Attachment, permission và page history là những phần dễ bị mất nhất. Vì vậy, hãy export thử một sample và kiểm tra các phần này trước khi quyết định migration.

Bài viết này có hữu ích không?