mm-wiki 搭建教程

最近搭了一个团队wiki程序 MM-Wiki，感觉还不错，一个轻量级的企业知识分享与团队协同软件，可用于快速构建企业Wiki和团队知识分享平台。部署方便，使用简单，帮助团队构建一个信息共享、文档管理的协作环境，安装也是很简单的，毕竟是基于Golang，这里介绍下。
一、成品预览

首页展示图↑

空间分享图↑
二、特点
1 部署方便，基于golang编写，只需要下载对于平台下二进制文件执行即可。

2 快速安装程序, 提供方便的安装界面程序，无需任何手动操作。

3 独立的空间，空间是一组文档的集合，一般为公司部门或者团队，空间下的文档相互独立。空间可根据需求设置空间访问级别。

4 完善的系统权限管理，系统可以自定义角色，并为不同角色授予不同的权限。

5 集成统一登录，本系统支持通过外部系统认证用户, 比如与公司的LDAP登录融合。具体请看登录认证功能。

6 邮件通知功能，当开启邮件通知，文档更改会通知所有关注该文档的用户。

7 文档具有分享和下载功能，目前只支持下载MarkDown源文件。
三、安装
1. 安装mysql
按照自己的linux 版本进行选择，若已有mysql请跳过。 若查看更详细的mysql链接，点击此处跳转。

#CentOS 6系统

rpm -ivh http://repo.mysql.com/mysql57-community-release-el6.rpm

yum install mysql-community-server -y

service mysqld start

chkconfig mysqld on

#CentOS 7系统

rpm -ivh http://repo.mysql.com/mysql57-community-release-el7.rpm

yum install mysql-community-server -y

systemctl start mysqld

systemctl enable mysqld

#Debian/Ubuntu系统

apt update

apt install mysql-server -y

2.安装mm-wiki
Github地址：https://github.com/phachon/mm-wiki

先找到最新版本的二进制，地址→传送门，这里使用Linux VPS搭建，所以找到Linux版本即可，32位的为386，64位的为amd64。
下载安装：

#创建并进入wiki目录

mkdir /root/mmwiki

cd $_

#下载最新版二进制，这里为64位系统，32位自行替换二进制链接

wget https://github.com/phachon/mm-wiki/releases/download/v0.1.8/mm-wiki-linux-amd64.tar.gz

#解压并删除压缩包

tar -zxvf mm-wiki-linux-amd64.tar.gz && rm -rf mm-wiki-linux-amd64.tar.gz

#安装程序，这里运行端口为9999，自行修改
install/install --port=9999

接下来访问ip:9999进入安装配置，如果你使用ip访问，监听地址填0.0.0.0，用域名的话，填127.0.0.1即可，监听端口可以继续填9999。

配置好了后，再使用Ctrl+C断开运行。

对于CentOS系统，访问不了安装界面的话，还需要开启9999端口，开启如下：

#CentOS 6

iptables -I INPUT -p tcp --dport 9999 -j ACCEPT

service iptables save

service iptables restart

#CentOS 7

firewall-cmd --zone=public --add-port=9999/tcp --permanent

firewall-cmd --reload

像阿里云等，还需要额外在安全组开放端口。

然后新建Systemd配置文件(只适用于CentOS 7、Debian 8+、Ubuntu 16+等)

#修改下mmwiki源码路径即可，然后一起复制到SSH运行

cat > /etc/systemd/system/mmwiki.service <<EOF

[Unit]

Description=mmwiki

After=network.target

Wants=network.target

[Service]

Type=simple

PIDFile=/var/run/mmwiki.pid

WorkingDirectory=/root/mmwiki

ExecStart=/root/mmwiki/mm-wiki --conf conf/mm-wiki.conf

RestartPreventExitStatus=23

Restart=always

[Install]

WantedBy=multi-user.target

EOF

启动并开机自启：

systemctl start mmwiki

systemctl enable mmwiki

其它系统直接使用命令启动并守护进程：

nohup /root/mmwiki/mm-wiki --conf conf/mm-wiki.conf &

此时访问地址就是ip:9999，即你安装的时候，填的监听端口9999或其它。如果你想设置域名，继续往下面看。

四、mm-wiki 升级（可选）
访问该mm-wiki 的git ，在release note 中能查看到升级方法。这里给大家截下图，并link过去 https://github.com/phachon/mm-wiki/releases

五、域名访问（可选）
反代可以用Nginx、Apache、Caddy，这里只说宝塔和Caddy。如果你网站有宝塔，就可以使用宝塔进行反代，如果没有，建议使用第2种的Caddy反代，配置很快。

1、宝塔面板

点击左侧网站，添加站点，然后再点击添加好了的域名名称，这时候就进入了站点配置，点击反向代理，目标URL填入http://127.0.0.1:9999，再启用反向代理，然后点击SSL，申请免费的Let’s Encrypt证书，并强制HTTPS。

2、使用Caddy

安装Caddy：

wget -N --no-check-certificate https://raw.githubusercontent.com/ToyoDAdoubiBackup/doubi/master/caddy_install.sh && chmod +x caddy_install.sh && bash caddy_install.sh

#备用地址

wget -N --no-check-certificate https://www.moerats.com/usr/shell/Caddy/caddy_install.sh && chmod +x caddy_install.sh && bash caddy_install.sh

配置Caddy：

#以下全部内容是一个整体，请修改域名和反代端口后一起复制到SSH运行！

echo "www.moerats.com {

gzip

tls admin@moerats.com

proxy / 127.0.0.1:9999 {

    header_upstream Host {host}

    header_upstream X-Real-IP {remote}

    header_upstream X-Forwarded-For {remote}

    header_upstream X-Forwarded-Proto {scheme}

  }

}" > /usr/local/caddy/Caddyfile

tls参数会自动帮你签发ssl证书，如果你要使用自己的ssl，改为tls /root/xx.crt /root/xx.key即可。后面为ssl证书路径。

启动Caddy：

/etc/init.d/caddy start

就可以打开域名进行访问了。

感谢 https://jszbug.com/15307
作者：程序媛鑫鑫
链接：https://www.jianshu.com/p/5cd837acd26e
来源：简书
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。