帮酷LOGO
0 0 评论
文章标签:Freebsd  FREE  维基  

使用不同的系统?

Wiki.js是一个免费的开源应用程序,它构建在node.js,MongoDB,git和Markdown之上,Wiki.js源代码公共托管在github ,本指南将向你展示,如何使用Nodejs MongoDB, PM2, nginx, git和Acme.sh在新的FreeBSD 11实例上安装Wiki.js。

要求

运行Wiki.js的要求如下:

  • Node.js版本6.11.1或更高版本
  • 版本3.2或更高版本
  • Git版本2.7.4或更高版本
  • web服务器,如Nginx,apache,IIS,小盒或H2O ,本指南将使用Nginx ,
  • 一个符合git的仓库(公用或私有)这是可选
  • 最小512MB内存,强烈建议使用至少1GB内存的机器,
  • 设置了A/AAAA记录的域名,在本指南中,我们将使用wiki.example.com作为例子域,

开始之前

查看FreeBSD版本。


uname -ro
# FreeBSD 11.2-RELEASE

确保你的FreeBSD系统是最新的。


freebsd-update fetch install
pkg update && pkg upgrade -y

如果系统不存在sudovimunzipwgetgitbashsocat软件包,则安装它们。


pkg install -y sudo vim unzip wget git bash socat

创建一个新的用户帐户,使用你首选的用户名(我们将使用johndoe )。


adduser

# Username: johndoe
# Full name: John Doe
# Uid (Leave empty for default): <Enter>
# Login group [johndoe]: <Enter>
# Login group is johndoe. Invite johndoe into other groups? []: wheel
# Login class [default]: <Enter>
# Shell (sh csh tcsh nologin) [sh]: bash
# Home directory [/home/johndoe]: <Enter>
# Home directory permissions (Leave empty for default): <Enter>
# Use password-based authentication? [yes]: <Enter>
# Use an empty password? (yes/no) [no]: <Enter>
# Use a random password? (yes/no) [no]: <Enter>
# Enter password: your_secure_password
# Enter password again: your_secure_password
# Lock out the account after creation? [no]: <Enter>
# OK? (yes/no): yes
# Add another user? (yes/no): no
# Goodbye!

运行visudo命令,并且取消注释%wheel ALL=(ALL)ALL行,以允许wheel组的成员执行任何命令。


# Uncomment by removing the hash (#) sign
%wheel ALL=(ALL) ALL

现在,切换到新创建的用户。

 
su -johndoe

 

注:将johndoe替换为你的用户名。

设置时区。

 
sudo tzsetup

 

安装Node.js

Wiki.js需要Node.js 6.11.1或更高版本,因此我们首先需要安装适当的node.js版本。

安装Node.js和NPM 。


sudo pkg install -y node8 npm-node8

检查版本。


node -v && npm -v
# v8.12.0
# 6.4.1

安装MongoDB

Wiki.js使用MongoDB作为数据库引擎。

安装MongoDB 。


sudo pkg install -y mongodb36

检查版本。


mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v3.6.6
# db version v3.6.6

启用和启动MongoDB 。


sudo sysrc mongod_enable=yes
sudo service mongod start

安装Acme.sh,并且获取let's Encrypt证书(可选)

不需要使用HTTPS保护你的wiki,但是,保护你的网站流量是一种很好的做法。为了从let's Encrypt获得SSL证书,我们将使用Acme.sh客户端,Acme.sh是一个纯unix shell软件,用于从let's Encrypt获得SSL证书,

下载并安装Acme.sh 。


sudo mkdir /etc/letsencrypt
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh
sudo ./acme.sh --install --home /etc/letsencrypt --accountemail your_email@example.com
cd ~

检查acme.sh版本。


/etc/letsencrypt/acme.sh --version
# v2.8.0

获取wiki.example.com的RSA和ECDSA证书。


# RSA 2048
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d wiki.example.com --ocsp-must-staple --keylength 2048
# ECDSA/ECC P-256
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d wiki.example.com --ocsp-must-staple --keylength ec-256

在运行上述命令后,证书和密钥将位于以下目录中:

  • RSA :/etc/letsencrypt/wiki.example.com
  • ecc/ecdsa :/etc/letsencrypt/wiki.example.com_ecc

注意:不要忘记将wiki.example.com替换为你的域名。

从let's Encrypt获得证书之后,我们需要配置Nginx以使用它们。

安装和配置Nginx

尽管Wiki.js没有任何实际的web服务器,但是强烈建议在它前面放置一个标准的web服务器,这样可以确保你可以使用SSL,多个网站,缓存和其他功能,我们将在本教程中使用Nginx,但是,任何其他服务器都可以,你只需要正确配置它。

安装Nginx 。


sudo pkg install -y nginx

检查版本。


nginx -v
# nginx version: nginx/1.14.0

启用和启动Nginx 。


sudo sysrc nginx_enable=yes
sudo service nginx start

将Nginx配置为Wiki.js应用程序的HTTPS (如果你使用SSL )反向代理。

运行sudo vim /usr/local/etc/nginx/wiki.js.conf然后用下面的基本反向代理配置填充它。


server {

 listen [::]:443 ssl http2;
 listen 443 ssl http2;
 listen [::]:80;
 listen 80;

 server_name wiki.example.com;

 charset utf-8;
 client_max_body_size 50M;

 # RSA
 ssl_certificate /etc/letsencrypt/wiki.example.com/fullchain.cer;
 ssl_certificate_key /etc/letsencrypt/wiki.example.com/wiki.example.com.key;
 # ECDSA
 ssl_certificate /etc/letsencrypt/wiki.example.com_ecc/fullchain.cer;
 ssl_certificate_key /etc/letsencrypt/wiki.example.com_ecc/wiki.example.com.key;

 location / {
 proxy_set_header Host $http_host;
 proxy_set_header X-Real-IP $remote_addr;
 proxy_pass http://127.0.0.1:3000;
 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;
 }

}

上面的配置需要更改的惟一东西是server_name指令,如果你决定配置3000以外的其他端口,则可能是proxy_pass指令,Wiki.js默认使用端口3000保存文件并退出:+W+Q

现在我们需要在主nginx.conf文件中包含wiki.js.conf文件。

运行sudo vim /usr/local/etc/nginx/nginx.conf将以下行添加到http {}块中。


include wiki.js.conf;

检查配置。

 
sudo nginx -t

 

重新加载Nginx 。


sudo service nginx reload

安装Wiki.js

创建一个空文档根目录,其中Wiki.js将被安装。


sudo mkdir -p /usr/local/www/wiki.example.com

导航到文档根目录。


cd /usr/local/www/wiki.example.com

/usr/local/www/wiki.example.com文件夹的所有权更改为用户johndoe


sudo chown -R johndoe:johndoe /usr/local/www/wiki.example.com

/usr/local/www/wiki.example.com文件夹中,运行以下命令下载和安装Wiki.js 。


curl -sSo- https://wiki.js.org/install.sh | bash

VERSION=$(curl -L -s -S https://beta.requarks.io/api/version/stable)
curl -L -s -S https://github.com/Requarks/wiki/releases/download/v$VERSION/wiki-js.tar.gz | tar -f - -xz -C .
curl -L -s -S https://github.com/Requarks/wiki/releases/download/v$VERSION/node_modules.tar.gz | tar -f - -xz -C .
cp -n config.sample.yml config.yml

你可以运行以下命令来查看当前安装的Wiki.js版本。


node wiki --version
# 1.0.102

安装完成后,系统会提示你运行配置向导。

运行以下命令启动配置向导。

 
node wiki configure

 

这将通知你导航到http://localhost:3000以配置Wiki.js ,如果你在Wiki.js面前有Nginx,那么,这意味着你可以打开你的域名(例如,http://wiki.example.com ),而不是转到localhost 。

使用浏览器,导航到http://wiki.example.com,并且按照屏幕指示操作,在配置向导中输入的所有设置都保存在config.yml文件中,配置向导将自动为你启动Wiki.js 。

安装和安装PM2进程管理器

默认情况下,在系统重新启动后,wiki不会自动启动,为了使它在开机时启动,我们需要安装和安装PM2流程管理器。

通过npm全局安装PM2.


sudo npm install -g pm2

检查版本。

 
pm2 -v
# 3.2.2

 

如果尚未存在,请导航到文档根文件夹,并且停止Wiki.js。


cd /usr/local/www/wiki.example.com
node wiki stop

通过PM2启动Wiki.js 。


pm2 start server/index.js --name"Wiki.js"

列出由PM2管理的进程。

 
pm2 list

 

告诉PM2通过运行以下命令将自身配置为启动服务:

 
pm2 startup

 

最后,通过运行以下命令保存当前的PM2配置:

 
pm2 save

 

你的Wiki.js实例现在作为后台进程运行,使用PM2作为流程管理器。



文章标签:FREE  维基  Freebsd  

Copyright © 2011 HelpLib All rights reserved.    知识分享协议 京ICP备05059198号-3  |  如果智培  |  酷兔英语