- Wiki-Go là wiki flat-file viết bằng Go, chạy bằng 1 binary ~44 MB, không cần database hay bất kỳ runtime nào.
- Miễn phí hoàn toàn theo GPL-3.0, phiên bản v1.8.8 với 55 releases và 557 stars trên GitHub.
- Hỗ trợ Kanban boards, Mermaid diagrams, LaTeX, full-text search và role-based access control.
- Cài đặt mất vài giây: tải binary, chạy, xong.
TL;DR
Wiki-Go là nền tảng wiki flat-file không cần database, viết bằng Go và phân phối dưới dạng file nhị phân đơn lẻ ~44 MB. Không cần cài Node.js, không cần PHP, không cần PostgreSQL - tải về và chạy là có ngay một wiki đầy đủ tính năng. Phiên bản mới nhất v1.8.8 (phát hành cuối tháng 4/2026), miễn phí hoàn toàn theo giấy phép GPL-3.0, đang có 557 stars trên GitHub với 55 releases trong vòng chưa đầy 2 năm.
Vấn đề cần giải quyết
Khi một team muốn triển khai wiki nội bộ, con đường thường gặp là: chọn Wiki.js (cần Node.js + PostgreSQL), BookStack (cần PHP + MySQL), hoặc Confluence (tốn tiền bản quyền). Quy trình cài đặt kéo theo đó là xin phê duyệt nội bộ, phối hợp với IT, đôi khi mất vài tháng chỉ để chạy được một PoC nhỏ.
DokuWiki là lựa chọn flat-file gần nhất - không cần database - nhưng vẫn đòi hỏi PHP runtime và web server (Apache hoặc Nginx). Vẫn còn phụ thuộc môi trường bên ngoài.
Wiki-Go giải quyết tận gốc vấn đề này: một file nhị phân duy nhất, tự chứa web server của riêng mình, không phụ thuộc runtime hay dịch vụ bên ngoài nào. Tại các tổ chức phi kỹ thuật, điều này có nghĩa là nhóm ở hiện trường có thể "chạy thử ngay" mà không cần chờ phê duyệt IT - trải nghiệm thực tế trước, thủ tục sau.
Kiến trúc bên dưới
Wiki-Go được xây dựng với Go (33.7% codebase) làm backend, JavaScript/CSS (59.6%) và HTML (5.3%) cho frontend. Editor dùng CodeMirror5, syntax highlighting bằng Prism.js, diagrams qua Mermaid.js và math rendering qua MathJax.
Toàn bộ nội dung lưu dưới dạng file document.md trong cấu trúc thư mục phân cấp trên filesystem. Không có database, không có bảng quan hệ. Version history theo convention đặt tên file theo timestamp. Attachments lưu cùng thư mục với document.
Cấu hình qua file data/config.yaml - được tạo tự động khi khởi chạy lần đầu. Vì là flat-file, toàn bộ wiki có thể backup bằng rsync, đặt vào Git repo ngoài ứng dụng, hoặc chỉnh sửa trực tiếp bằng bất kỳ text editor nào.
Cài đặt siêu nhanh
Có 3 cách triển khai chính:
- Binary trực tiếp: Tải file ~44 MB từ GitHub Releases (Linux AMD64/ARM64, macOS Intel/Apple Silicon, Windows AMD64), chạy trực tiếp. Port mặc định: 8080.
- Docker (test nhanh):
docker run -p 8080:8080 ghcr.io/leomoon-studios/wiki-go- có ngay wiki chạy trên localhost:8080. - Docker Compose (production): Template sẵn cho plain HTTP (port 8080) và native HTTPS (port 443). Hỗ trợ TLS trong
config.yaml.
Demo live tại wikigo.leomoon.com - login admin / demo123 (reset tự động mỗi giờ). Build từ source cần Go 1.21+.
Tính năng nổi bật
- Markdown đầy đủ: Emoji shortcodes (
:smile:), Mermaid diagrams (flowchart, sequence diagram...), LaTeX math qua MathJax, code syntax highlighting Prism.js - Kanban boards: Biến bất kỳ document nào thành Kanban board trực quan - drag-and-drop tasks, nested sub-tasks, nhiều board trong 1 document, real-time updates
- Full-text search: Exact phrase matching (dùng dấu nháy kép), bộ lọc include/exclude từ khóa, highlight kết quả tìm kiếm
- Role-based access: 3 mức (admin, editor, viewer), gán user vào groups, path-based access rules, private wiki mode, brute-force protection qua login rate limiting
- Version history: Lưu toàn bộ lịch sử chỉnh sửa theo timestamp, khôi phục bất kỳ phiên bản nào
- Attachments: Upload file trực tiếp vào document - hỗ trợ jpg, png, gif, svg, pdf, docx, xlsx, pptx, mp4, zip...
- Link management: Tạo collection links với auto-fetch metadata và phân loại theo category
- Custom shortcodes: Mở rộng Markdown với shortcodes như
:::stats recent=5:::; REST API cho truy cập nội dung theo chương trình - Open Graph: Meta tags đầy đủ cho social sharing, custom.js, custom logo/favicon/banner
So sánh với các lựa chọn khác
| Platform | Database | Runtime cần thiết | Triển khai | License |
|---|---|---|---|---|
| Wiki-Go | Không | Không (self-contained) | 1 binary / Docker | GPL-3.0 |
| DokuWiki | Không | PHP + web server | Cần cấu hình | GPL-2.0 |
| Wiki.js | PostgreSQL/MySQL | Node.js | Phức tạp | AGPL-3.0 |
| BookStack | MySQL | PHP + web server | Phức tạp | MIT |
Điểm khác biệt quan trọng với DokuWiki - đối thủ gần nhất về concept: Wiki-Go là web server luôn, không cần Apache hay Nginx bọc ngoài. DokuWiki vẫn cần PHP runtime. Kanban, Mermaid, MathJax là built-in trong Wiki-Go, không cần plugin.
Ai nên dùng ngay
Wiki-Go phù hợp nhất với:
- Team trong tổ chức phi kỹ thuật: Muốn wiki nội bộ nhưng không muốn trải qua quy trình phê duyệt IT cho database server - 1 binary chạy được ngay với quyền ở mức hiện trường
- Developer self-host: Cần wiki cá nhân hoặc team nhỏ, không muốn quản lý hạ tầng database, không muốn trả tiền SaaS
- Dự án cần backup đơn giản: Toàn bộ dữ liệu là Markdown files - backup bằng
rsynchoặc đặt vào Git - Homelab / self-hosted enthusiast: Footprint nhỏ (~44 MB binary), low maintenance, chạy tốt trên Raspberry Pi hay VPS nhỏ
Không phù hợp nếu bạn cần tính năng enterprise phức tạp như LDAP/SSO tích hợp sâu, complex relational content structure, hoặc analytics dashboard tổng hợp nhiều nguồn.
Tài liệu tham khảo
Nguồn: GitHub - leomoon-studios/wiki-go, LeoMoon Studios, Zenn.dev - Introducing Wiki-Go.