## 为什么需要知识库
程序员的知识体系是碎片化的：今天学了个 Nginx 配置技巧，明天发现了一个 Docker 最佳实践，后天同事分享了一个 Shell 脚本。如果不系统化管理，一个月后多半忘了。
Wiki.js 是目前最漂亮的开源 Wiki 系统，基于 Node.js，支持 Markdown 编辑，界面现代。
## Docker Compose 部署
```yaml
version: '3'
services:
wiki:
image: requarks/wiki:2
container_name: wikijs
restart: unless-stopped
ports:
- "8080:3000"
environment:
DB_TYPE: sqlite
DB_FILEPATH: /data/db.sqlite
volumes:
- ./data:/data
```
这是最简单的部署方式，使用 SQLite 无需额外数据库。如果文章量大，建议换 PostgreSQL。
## PostgreSQL 版部署
```yaml
version: '3'
services:
db:
image: postgres:15-alpine
restart: unless-stopped
environment:
POSTGRES_DB: wiki
POSTGRES_PASSWORD: your_password
POSTGRES_USER: wikijs
volumes:
- ./db:/var/lib/postgresql/data
wiki:
image: requarks/wiki:2
restart: unless-stopped
ports:
- "8080:3000"
depends_on:
- db
environment:
DB_TYPE: postgres
DB_HOST: db
DB_PORT: 5432
DB_USER: wikijs
DB_PASS: your_password
DB_NAME: wiki
```
## 核心功能
- **Markdown 编辑器**：所见即所得，支持代码高亮、数学公式、流程图
- **权限管理**：可以设置公开页和私有页
- **全文搜索**：内置搜索引擎，找文档很快
- **多语言**：支持中文界面
- **备份恢复**：支持 Git 同步和手动导出
- **OAuth 登录**：支持 GitHub/Google/微软等 SSO
## 我的使用方式
1. **运维文档**：每台服务器的配置、IP、安装的服务都记录在案
2. **踩坑记录**：每次遇到奇怪的 bug 和解决方案，写一篇文章
3. **代码片段**：常用脚本和配置模板，复制即用
4. **学习笔记**：新技术的学习路径和关键知识点
## 最佳实践
- 每篇文章加标签，方便分类检索
- 坚持"遇到问题→解决→记录"的习惯
- 每周花 10 分钟整理零散笔记
- 把 Wiki.js 设为浏览器首页，督促自己记录
搭建起来只需要 5 分钟，但坚持下去，一年后你会感谢自己。