Wiki.js开源免费wiki程序安装与使用教程

Wiki.js是一个基于NodeJS技术的开源项目,其界面简洁美观、权限管理灵活,支持多种编辑器、多种用户验证方式、多种备份存储方式、多种搜索引擎,支持国际化、自定义主题(Theme)、流量分析等,特别适合做小团队的知识库,一方面适合管理和阅读,另一方面还能协同创作。

一、Wiki.js安装前准备

网站:

  1. 官网:https://js.wiki
  2. Docker:https://hub.docker.com/r/requarks/wiki
  3. Github:https://github.com/requarks/wiki
  4. 文档:https://docs.requarks.io/install/docker

1.1 主机配置

Wiki.js对于主机的配置要求不高,一般地1GB内存的VPS就可以了。Wiki.js不能安装在虚拟主机上,你需要提前准备好一台VPS主机,选购参考:VPS主机排行榜单。

1.2 Docker环境

有了VPS主机,现在你就可以需要在VPS主机上配置好Docker环境,这里有一个一键安装Docker环境的命令,配置起来非常地简单:Docker 和 Docker Compose 一键安装脚本 可手动选择安装版本和下载源。

1.3 安装Nginx

在VPS主机上配置Nginx,主要我们需要用到Nginx的反向绑定域名的功能。推荐使用Oneinstack一键包或者LNMP一键安装包,不仅支持单独安装Nginx,还可以很方便地绑定域名,并给域名申请免费SSL证书。

二、Wiki.js安装与配置

2.1 一键安装

进入VPS,然后新建一个目录。

cd ~

mkdir wikijs

cd wikijs

然后是新建一个yml。

vim docker-compose.yml

将以下内容复制粘贴到里面,保存(这里用了86端口访问,你可以修改成你自己的)。

version: "3"

services:

db:

image: postgres:11-alpine

environment:

POSTGRES_DB: wiki

POSTGRES_PASSWORD: wikijsrocks

POSTGRES_USER: wikijs

logging:

driver: "none"

restart: unless-stopped

volumes:

- db-data:/var/lib/postgresql/data

wiki:

image: requarks/wiki:2

depends_on:

- db

environment:

DB_TYPE: postgres

DB_HOST: db

DB_PORT: 5432

DB_USER: wikijs

DB_PASS: wikijsrocks

DB_NAME: wiki

restart: unless-stopped

ports:

- "86:3000"

volumes:

db-data:

启动docker-compose。

sudo docker-compose up -d

现在打开你的IP地址+端口号,你就可以成功访问到Wiki.js了。

2.2 绑定域名

首先,使用Oneinstack一键包或者LNMP一键安装包添加绑定域名,同时设置好SSL证书。

现在打开你的域名的Nginx配置文件,参考以下配置将反向绑定域名的代码放在配置里即可。

server {

listen 80;

listen [::]:80;

listen 443 ssl http2;

listen [::]:443 ssl http2;

ssl_certificate /usr/local/nginx/conf/ssl/olink.wzfou.me.crt;

ssl_certificate_key /usr/local/nginx/conf/ssl/olink.wzfou.me.key;

ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3;

ssl_ciphers TLS13-AES-256-GCM-SHA384:TLS13-CHACHA20-POLY1305-SHA256:TLS13-AES-128-GCM-SHA256:TLS13-AES-128-CCM-8-SHA256:TLS13-AES-128-CCM-SHA256:EECDH+CHACHA20:EECDH+AES128:RSA+AES128:EECDH+AES256:RSA+AES256:EECDH+3DES:RSA+3DES:!MD5;

ssl_prefer_server_ciphers on;

ssl_session_timeout 10m;

ssl_session_cache builtin:1000 shared:SSL:10m;

ssl_buffer_size 1400;

add_header Strict-Transport-Security max-age=15768000;

ssl_stapling on;

ssl_stapling_verify on;

server_name olink.wzfou.me;

access_log /data/wwwlogs/olink.wzfou.me_nginx.log combined;

index index.html index.htm index.php;

root /data/wwwroot/olink.wzfou.me;

if ($ssl_protocol = "") { return 301 https://$host$request_uri; }

#主要看这一段

location / {

proxy_set_header HOST $host;

proxy_set_header X-Forwarded-Proto $scheme;

proxy_set_header X-Real-IP $remote_addr;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

proxy_pass http://127.0.0.1:86; # 端口是前面docker-compose.yml里面指定的端口

server_tokens off;

}

include /usr/local/nginx/conf/rewrite/none.conf;

#error_page 404 /404.html;

#error_page 502 /502.html;

}

现在打开域名,你就可以成功访问到Wiki.js了。

2.2 初始化设置

Wiki.js首次安装,需要填写账号、密码等信息。

完成后,接下来就是登录Wiki.js。

2.3 页面设置

首次进入到Wiki.js,点击新建页面。

Wiki.js支持多种编辑器,一般来说我们可以选择最简单的可视化编辑器。

给你的页面添加一个描述。

Wiki.js自带的文本编辑器相当不错,类似于Word,上传图片、格式调整等都可以直接在线完成。

这是Wiki.js的上传图片的界面。

三、Wiki.js特色功能

3.1 中文

Wiki.js支持中文,你可以直接在设置中将Wiki.js调整为中文。

3.2 主题

Wiki.js自带了几个导航和主题,你可以自由调整。

3.3 评论

Wiki.js支持第三方评论。

3.4 存储

Wiki.js支持第三方存储,特别适合大型的Wiki站点。

3.5 多用户

首先,你需要开启Wiki.js的注册模式。

最后,Wiki.js支持多种登录模式,几乎已经集成了市面上各种登录方式。

四、总结

Wiki.js作为一个开源免费的Wiki程序,使用Docker安装的方式是最简单的。新手朋友可能不喜欢Nginx的域名反代,其实你可以直接使用宝塔面板的反向绑定域名,另外其它的一个VPS主机面板也会有这样的功能,所以整个配置安装还是挺简单的。

 

你可能感兴趣的