从零部署到高效协同：开源知识库mm-wiki的完整实践指南

1. 为什么选择mm-wiki作为团队知识库

第一次接触mm-wiki是在三年前的一个项目上，当时团队文档散落在各种云盘、聊天记录和本地文件中，找个技术方案像寻宝一样。试过几个知名文档系统后，发现要么太重，要么太贵，直到遇见这个轻量级的开源解决方案。

mm-wiki最打动我的地方在于它的极简设计和完整功能的完美平衡。作为一款专为企业知识管理设计的开源软件，它提供了文档编辑、版本控制、权限管理等核心功能，但安装包只有不到20MB。对比其他同类产品，它的资源占用率低得惊人——在1核2G的云服务器上就能流畅运行，这对中小团队特别友好。

实际使用中，我发现三个突出优势：

• Markdown原生支持：工程师们最爱的写作方式，代码块、表格等元素都能完美呈现
• 细粒度权限控制：可以精确到每个空间的读写权限，法务和财务部门特别喜欢这个功能
• 完整的版本历史：每次修改都有记录，误删文件也能一键恢复

有个真实的案例：去年帮一个50人团队迁移文档时，他们原本使用某商业产品，年费2万多。改用mm-wiki后，不仅省下这笔开支，搜索效率还提升了60%——因为所有文档终于集中在一个系统里了。

2. 从零开始部署mm-wiki

2.1 环境准备

建议选择Ubuntu 20.04 LTS或CentOS 7+作为操作系统，这是我测试最稳定的组合。硬件方面，1核CPU+2GB内存+50GB硬盘就能满足中小团队需求。以下是具体准备步骤：

bash复制# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装基础依赖
sudo apt install -y wget tar nginx mysql-server

数据库配置有个小技巧：提前创建专用账号比直接用root更安全。执行这些MySQL命令：

sql复制CREATE DATABASE mmwiki CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'mmwiki'@'localhost' IDENTIFIED BY '你的强密码';
GRANT ALL PRIVILEGES ON mmwiki.* TO 'mmwiki'@'localhost';
FLUSH PRIVILEGES;

2.2 安装过程详解

下载最新稳定版（目前是v0.2.1）时，国内用户建议用Gitee镜像：

bash复制wget https://gitee.com/phachon/mm-wiki/releases/download/v0.2.1/mm-wiki-v0.2.1-linux-amd64.tar.gz
tar -zxvf mm-wiki-v0.2.1-linux-amd64.tar.gz
cd mm-wiki/install

启动安装程序时有个隐藏技巧：通过--port参数可以避开常见的8090端口冲突：

bash复制./install --port=8087

浏览器访问http://服务器IP:8087后会看到安装向导。填数据库信息时注意：

• 主机地址保持127.0.0.1
• 数据库名填刚才创建的mmwiki
• 字符集一定要选utf8mb4

安装完成后，别急着关闭终端！先按Ctrl+C停止安装程序，然后返回上级目录启动服务：

bash复制cd ..
nohup ./mm-wiki --conf conf/mm-wiki.conf &

3. 生产环境优化配置

3.1 系统服务化

用systemd托管服务比nohup更可靠，创建/etc/systemd/system/mmwiki.service：

ini复制[Unit]
Description=mmwiki
After=network.target

[Service]
Type=simple
WorkingDirectory=/your/install/path
ExecStart=/your/install/path/mm-wiki --conf conf/mm-wiki.conf
Restart=always

[Install]
WantedBy=multi-user.target

启用服务的命令序列：

bash复制sudo systemctl daemon-reload
sudo systemctl start mmwiki
sudo systemctl enable mmwiki

3.2 Nginx反向代理

建议配置HTTPS提升安全性，先用Certbot获取免费证书：

bash复制sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d wiki.yourdomain.com

然后配置Nginx（/etc/nginx/sites-available/wiki）：

nginx复制server {
    listen 443 ssl;
    server_name wiki.yourdomain.com;

    ssl_certificate /etc/letsencrypt/live/wiki.yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/wiki.yourdomain.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

启用配置后记得测试：

bash复制sudo nginx -t
sudo systemctl restart nginx

4. 团队协作实战指南

4.1 权限体系设计

mm-wiki采用"空间-角色-用户"三级权限模型。建议按这个流程初始化：

1. 创建部门空间：如"技术部"、"产品部"
2. 定义角色：管理员、编辑、查看者
3. 分配权限：在空间设置中绑定角色权限

实际案例：我给研发团队这样配置：

• 公共空间：所有人可读，管理员可写
• 项目空间：项目成员可读写，其他人需申请
• 人事空间：仅HR部门有权限

4.2 文档规范制定

推行这些约定能让知识库更易用：

• 文件命名：[类型]-YYYYMMDD-描述，如会议记录-20230815-需求评审
• 目录结构：

  code复制技术部/
  ├── 开发规范
  ├── 项目文档
  │   ├── 需求文档
  │   └── API文档
  └── 运维手册
  

• 模板功能：常用文档类型保存为模板，新建时一键调用

4.3 日常维护技巧

三个实用小技巧：

1. 定期备份：设置cron任务自动备份数据库和附件

   bash复制# 每天2点备份
   0 2 * * * mysqldump -u mmwiki -p mmwiki > /backup/mmwiki_$(date +\%Y\%m\%d).sql
   

2. 空间归档：对过期项目空间设置只读权限
3. 搜索优化：在文档中合理使用标签（如#Linux、#MySQL）

遇到文档冲突时，系统会自动保留两个版本。作为管理员，可以在"系统日志"中查看所有修改记录，用"对比"功能快速定位差异。