wiki.js搭建

官網[wiki.js：](https://docs.requarks.io/wiki/)
目前這個wiki.js還存在一些bug,期待2.x版本正式釋出！

軟體依賴

wiki.js需要以下軟體包：
- git 2.7.4 or later is required
- nodejs 6.11.1 or later is required.
- mongodb 3.2 or later is required.
下面說以下這三個的安裝方式

git安裝

檢視git版本

git --version

weget https://mirrors.edge.kernel.org/pub/software/scm/git/git-2.9.5.tar.gz
tar -xzvf git-2.9.5.tar.gz 
cd git-2.9.5
make prefix=/usr/local/git all
make prefix=/usr/local/git install
#修改git路徑
whereis git
#將檢視到的都mv掉，建立新的路徑
mv /usr/bin/git /usr/bin/git-2.15.git
mv /usr/local/bin/git /usr/local/bin/git-2.15.git
ln -s /usr/bin/git /usr/local/git/bin/git
ln -s /usr/local/git/bin/git /usr/bin/git
git --version
 

mongodb

到mongodb的官網上下載最新的版本

wget https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-rhel62-4.0.0.tgz
tar -xzvf mongodb-linux-x86_64-rhel62-4.0.0.tgz
mv mongodb-linux-x86_64-rhel62-4.0.0 /usr/local/mongodb
#將路徑加入系統Path
export PATH=/usr/local/mongodb/bin:$PATH
#mongodb配置
mkdir /data/mongodb
mkdir /var/log/mongodb/
vim /etc/mongodb.conf
 

將以下配置寫到mongodb.conf中

# Where to store the data.
dbpath=/data/mongodb
#where to log
logpath=/var/log/mongodb/mongodb.log
logappend=true
bind_ip = 127.0.0.1
port = 27017
#sslDisabledProtocols = none
# Enable journaling, http://www.mongodb.org/display/DOCS/Journaling
journal=true
fork=true
maxConns=50000
auth = false
 

暫時不開啟認證，等後面配置密碼再開啟
啟動mongodb:

mongod --config /etc/mongodb.conf

預設是27017埠，可通過netstat -nlpt來檢視

nodejs

curl --silent --location https://rpm.nodesource.com/setup_8.x | sudo bash -
yum install gcc-c++ make
#最好將yarn也安裝
yum install -y nodejs yarn

下載wiki.js

mkdir /data/wiki
cd /data/wiki
wget https://github.com/Requarks/wiki/releases/download/v1.0.78/wiki-js.tar.gz
wget https://github.com/Requarks/wiki/releases/download/v1.0.78/node_modules.tar.gz
tar -xzvf wiki-js.tar.gz
tar -xzvf node_modules.tar.gz
cp -n config.sample.yml config.yml

原版的wiki程式碼在ip:埠的方式訪問用起來會有問題，所以需要在wiki的程式碼上做如下修改：
在server檔案下，查詢src=appconfig.host + 替換成 src= ,查詢href=appconfig.host + 替換成href=，以上是為了將相關連結都改為相對路徑

配置wiki

在/data/wiki下，執行：

node wiki configure

瀏覽器開啟 localhost:3000,根據步驟配置。其中mongodb的配置為上面配置的資料庫；wiki的git repo配置為我們的gitlab上的wiki庫：http://gitlab.example.com/dev/wiki.git，使用wiki使用者進行同步。
以上配置後就可以通過： node wiki start啟動wiki了

配置mongodb許可權

#進入mongo shell
mongo
>use wiki
>db.createUser({user:'wiki',pwd:"123456",roles:[{role:"readWrite",db:"wiki"}]})
>exit

注意，mongodb連線語句中對 @ 和 ： 這兩個符號敏感，所以不要密碼中不要用這兩個字元。
賦予wiki使用者許可權後，修改/etc/mongodb.conf,修改auth = false 為 auth = true
重啟mongo：

ps -ef | grep mongo | grep -v grep | awk '{print $2}' | xargs kill
mongod --config /etc/mongodb.conf

再修改/data/wiki/config.yml檔案，修改db屬性為：

db: 'mongodb://wiki:[email protected]:27017/wiki'

重啟wiki

cd /data/wiki
node wiki restart

nginx代理

我們啟用nginx對wiki進行代理，wiki的域名暫為： wiki.example.com
在/usr/local/nginx/conf/vhost/下，建立檔案wiki.conf,新增配置：

server {
    listen 80;
    server_name  wiki.example.com;
    location / {
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_pass http://192.168.59.128:8556;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_next_upstream error timeout http_502 http_503 http_504;
    }
  access_log /usr/local/nginx/logs/wiki.log;
  error_log  /usr/local/nginx/logs/wiki.log;
}

重啟nginx:

/usr/local/nginx/sbin/nginx -s reload

因wiki原始碼在頁面訪問時對域名不友好，需修改wiki原始碼：

• 修改config.yml檔案，在port屬性後新增屬性：

  domain : 'http://wiki.example.com'
  其中wiki.example.com為我們自己wiki的域名，與nginx配置中的域名一致。

•  修改server/views/layout.pug檔案，在23行，將23行改為var siteRoot = '!{appconfig.domain}' ，啟用域名的方式跳轉

重啟wiki,在瀏覽器輸入wiki.example.com進行訪問
以上，介紹！

config.yml配置

config.yml在node wiki configure進行配置後生成，可以通過修改這個檔案並重啟wiki來更改配置。當前配置模板：

title: wiki
host: 'http://192.168.59.128
port: 8556
domain : 'http://wiki.example.com'
paths:
  repo: ./repo
  data: ./data
uploads:
  maxImageFileSize: 3
  maxOtherFileSize: 100
lang: zh
langRtl: false
public: false
auth:
  defaultReadAccess: false
  local:
    enabled: true
  google:
    enabled: true
    clientId: GOOGLE_CLIENT_ID
    clientSecret: GOOGLE_CLIENT_SECRET
  microsoft:
    enabled: true
    clientId: MS_APP_ID
    clientSecret: MS_APP_SECRET
  facebook:
    enabled: false
    clientId: FACEBOOK_APP_ID
    clientSecret: FACEBOOK_APP_SECRET
  github:
    enabled: false
    clientId: GITHUB_CLIENT_ID
    clientSecret: GITHUB_CLIENT_SECRET
  slack:
    enabled: false
    clientId: SLACK_CLIENT_ID
    clientSecret: SLACK_CLIENT_SECRET
  ldap:
    enabled: false
    url: 'ldap://serverhost:389'
    bindDn: cn='root'
    bindCredentials: BIND_PASSWORD
    searchBase: 'o=users,o=example.com'
    searchFilter: '(uid={{username}})'
    tlsEnabled: false
    tlsCertPath: 'C:\example\root_ca_cert.crt'
  azure:
    enabled: false
    clientId: APP_ID
    clientSecret: APP_SECRET_KEY
    resource: 00000002-0000-0000-c000-000000000000
    tenant: YOUR_TENANT.onmicrosoft.com
  oauth2:
    enabled: false
    clientId: OAUTH2_CLIENT_ID
    clientSecret: OAUTH2_CLIENT_SECRET
    authorizationURL: OAUTH2_AUTH_URL
    tokenURL: OAUTH2_TOKEN_URL
sessionSecret: 89a845b448c498e23c4f46698255717bff6f718fd3e62c4f149494ee05da19cb
db: 'mongodb://wiki:[email protected]:27017/wiki'
git:
  url: 'http://gitlab.example.com/dev/wiki.git'
  branch: master
  auth:
    type: basic
    username: wiki
    password: [email protected]
    privateKey: /etc/wiki/keys/git.pem
    sslVerify: true
  showUserEmail: true
  serverEmail: [email protected]
features:
  linebreaks: true
  mathjax: true
externalLogging:
  bugsnag: false
  loggly: false
  papertrail: false
  rollbar: false
  sentry: false
theme:
  primary: indigo
  alt: blue-grey
  viewSource: all
  footer: blue-grey
  code:
    dark: true
    colorize: true

mongodb init.d 啟停

#!/bin/sh
 
### BEGIN INIT INFO
# Provides:     mongodb
# Required-Start:
# Required-Stop:
# Default-Start:        2 3 4 5
# Default-Stop:         0 1 6
# Short-Description: mongodb
# Description: mongo db server
### END INIT INFO
 
EXE_FILE=/usr/local/mongodb/bin/mongod
CONFIG_FILE=/etc/mongodb.conf
 
MONGOPID=`ps -ef| grep mongodb.conf| grep -v grep| awk '{print $2}'`
test -x $EXE_FILE || exit 0
 
case "$1" in
  start)
    echo "Starting MongoDB server"
    $EXE_FILE --config $CONFIG_FILE
    echo "mongoDB started"
    ;;
  stop)
    echo "Stopping MongoDB server"
    if [ ! -z "$MONGOPID" ]; then
        kill -15 $MONGOPID
    fi
    echo "MongoDB stopped"
    ;;
  status)
    ps -ef| grep mongodb.conf | grep -v grep
    ;;
  restart)
    echo "Stopping MongoDB server"
    if [ ! -z "$MONGOPID" ]; then
        kill -15 $MONGOPID
    fi
    echo "Starting MongoDB server"
    $EXE_FILE --config $CONFIG_FILE
    echo "MongoDB restarted"
    ;;
  *)
    echo "Usage: /etc/init.d/mongodb {start|stop|status}"
    exit 1
esac
 
exit 0