不管是在企業中還是在自己的個人知識整理上，我們都需要通過某種方式來有條理的組織相應的知識架構，那麼一個好的知識整理工具是非常重要的，常用的線上筆記比如說印象筆記，有道雲筆記，當然企業中文件管理或者知識管理的專業版的軟體也是有很多，比如說jira等。再到開源的，比如laverna、Boostnote等等，這兩個開源的都是非常優秀的，都是支援markdown的這種文字方式。GitHub地址如下：

並且這兩個都支援windows mac linux三個平臺的，Boostnote還支援IOS和Android，laverna，Laverna的Android版本也即將推出。

還有一個產品是leanote，這個產品也非常優秀，也是開源的，大家可以瞭解看看。

今天我們來看一個新興的專案，wiki.js，GitHub地址如下：

之所以選擇這個，是看中了它的易部署性，該專案是在2016年12月推出了第一個版本，算是比較新的專案了，現在也正在積極地更新，那麼之所以選擇這個專案作為小組的知識庫管理，有這幾點考慮：
- 可以直接部署在自己本地的伺服器
- 有使用者管理
- web的方式，方便使用
- 當然，markdown的寫作方式也是我看中的

但是由於是新專案，里程碑可以直接在GitHub的專案ReadMe看到，現在有些功能還不夠完善，也在後續的規劃中，有興趣的話，大家可以加入成為contributor哈！

好了廢話不多說，我們來看下如何安裝wiki.js吧！

首先，你需要docker的環境，有docker的話，就不管你是什麼平臺啦，windows、linux、mac通通不在話下，當然windows10可以直接安裝docker，win7以及以前的只能使用toolbox進行安裝，原因是docker是基於linux的，所以需要在linux環境下才可以，windows10是支援ubuntu core的所以可以直接安裝。

這裡我選擇的是在ubuntu 14.04上進行安裝，之前我寫過一篇文章，關於如何在ubuntu上安裝Docker，是直接通過apt-get install進行安裝的，但是這個安裝的版本比較舊，我們需要更新版本，這裡我們選擇安裝官網的方式進行安裝，這樣得到的一定是最新版本的，官網的安裝步驟是比較麻煩的，具體的安裝流程請參考官網的說明：

這裡最好是選擇14.04或者是16.04或者是最新的LTS版本，以防因為系統的原因導致什麼異常。一開始安裝的出現了各種異常，包括Docker官方的SSL證書安裝失敗，無法連線之類的，這個是最好是重啟下系統在進行重試。

然後需要安裝下Docker Compose，這個也只需要參考官方的文件進行安裝就可以了，官網寫的很清楚。

這兩部分大家就直接參考官網的直接進行安裝就可以了，安裝wiki.js的前提條件就是需要安裝好docker和docker compose兩個內容。

然後我們就可以進入安裝wiki.js了，這個其實也比較簡單，主要是說明下配置檔案的使用。

首先我們在安裝wiki.js時，我們需要確保，我們目錄下有這幾個檔案
- config.yml ： wiki的配置檔案
- docker-compose.yml ：docker-compose檔案

這裡說明下這兩個檔案的內容好了，這裡可以選擇直接參考官方的config.yml檔案

這裡僅說明幾個需要注意的點：
1、host引數需要填寫成你的伺服器IP，如果不是預設埠，需要加上埠號
2、db引數需要修改成db: mongodb://localhost:27017/wiki –>> db: mongodb://wikidb:27017/wiki，因為如果localhost的話，docker-compose找不到這個服務，它是根據服務名來確定的訪問的服務的

docker-compose.yml檔案也可以直接參考官方的檔案：

這裡需要注意的是：
1、需要將埠號變更為你在docker-compose服務對應的埠和你實際想要的訪問的埠

這裡給出我在本地搭建的參考檔案：
config.yml:

#######################################################################
# Wiki.js - CONFIGURATION                                             #
#######################################################################
# Full explanation + examples in the documentation:
# https://docs.requarks.io/wiki/install
# You can use an ENV variable by using $(ENV_VAR_NAME) as the value

# ---------------------------------------------------------------------
# Title of this site
# ---------------------------------------------------------------------

title: Wiki

# ---------------------------------------------------------------------
# Full public path to the site, without the trailing slash
# ---------------------------------------------------------------------
# INCLUDE CLIENT PORT IF NOT 80/443!

host: http://192.168.1.6

# ---------------------------------------------------------------------
# Port the main server should listen to (80 by default)
# ---------------------------------------------------------------------
# To use process.env.PORT, comment the line below:

port: 80

# ---------------------------------------------------------------------
# Data Directories
# ---------------------------------------------------------------------

paths:
  repo: ./repo
  data: ./data

# ---------------------------------------------------------------------
# Upload Limits
# ---------------------------------------------------------------------
# In megabytes (MB)

uploads:
  maxImageFileSize: 3
  maxOtherFileSize: 100

# ---------------------------------------------------------------------
# Site Language
# ---------------------------------------------------------------------
# Possible values: en, de, es, fa, fr, ja, ko, nl, pt, ru, sr, sv, tr or zh

lang: en

# Enable for right to left languages (e.g. arabic):
langRtl: false

# ---------------------------------------------------------------------
# Site Authentication
# ---------------------------------------------------------------------

public: false

auth:
  defaultReadAccess: true
  local:
    enabled: true 
  google:
    enabled: false
    clientId: GOOGLE_CLIENT_ID
    clientSecret: GOOGLE_CLIENT_SECRET
  microsoft:
    enabled: false
    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

# ---------------------------------------------------------------------
# Secret key to use when encrypting sessions
# ---------------------------------------------------------------------
# Use a long and unique random string (256-bit keys are perfect!)

sessionSecret: 1234567890abcdefghijklmnopqrstuvxyz

# ---------------------------------------------------------------------
# Database Connection String
# ---------------------------------------------------------------------

db: mongodb://wikidb:27017/wiki

# ---------------------------------------------------------------------
# Git Connection Info
# ---------------------------------------------------------------------


# ---------------------------------------------------------------------
# Features
# ---------------------------------------------------------------------
# You can enable / disable specific features below

features:
  linebreaks: true
  mathjax: false

# ---------------------------------------------------------------------
# External Logging
# ---------------------------------------------------------------------

externalLogging:
  bugsnag: false
  loggly: false
  papertrail: false
  rollbar: false
  sentry: false

# ---------------------------------------------------------------------
# Color Theme
# ---------------------------------------------------------------------

theme:
  primary: indigo
  alt: blue-grey
  viewSource: all # all | write | false
  footer: blue-grey
  code:
    dark: true
    colorize: true

docker-compose.yml

version: '3'

services:
    wikidb:
        image: 'mongo'
        expose:
            - '27017' 
        command: '--smallfiles --bind_ip wikidb'
        environment:
            - 'MONGO_LOG_DIR=/dev/null'
        volumes:
            - ./data/mongo:/data/db
    wikijs:
        image: 'requarks/wiki:latest'
        links:
            - wikidb
        depends_on:
            - wikidb
        ports:
            - 80:80
        environment:
            WIKI_ADMIN_EMAIL: [email protected]
        volumes:
            - ./config.yml:/var/wiki/config.yml

然後執行 sudo docker-compose up，等到相關依賴安裝完成，就可以執行啦！
預設賬號是：[email protected]，密碼是：admin123
趕快試試吧！