Wiki.js开源免费wiki程序安装与使用教程-界面简洁美观支持多种编辑器

文章目录

有不少的朋友喜欢玩wiki,这是一种在网络上开放且可供多人协同创作的超文本系统,可以有多人(甚至任何访问者)维护内容,每个人都可以发表自己的意见,或者对共同的主题进行扩展与探讨。简单地说就是有点类似于XX百科,小团队共同维护页面内容。

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

Wiki.js开源免费wiki程序安装与使用教程-界面简洁美观支持多种编辑器

这篇文章就来分享一下利用Docker的方式来安装与部署Wiki.js,如果想要搭建自己的网站首选的一般建议是WordPress,其它的可以满足个性需求的建站服务还有:

  1. 免费开源的网址导航源码收集整理汇总-自建个人导航主页
  2. OneNav安装与使用-自建网址导航和书签管理器-支持私有链接,可批量导入
  3. Tiny Tiny RSS最新安装与使用教程-Awesome TTRSS Docker安装配置方法

一、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
Wiki.js Docker安装

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

Wiki.js打开端口访问

2.2 绑定域名

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

Wiki.js绑定域名

现在打开你的域名的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了。

Wiki.js使用域名访问

2.2 初始化设置

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

Wiki.js初始化设置

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

Wiki.js登录账号

2.3 页面设置

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

Wiki.js新建页面

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

Wiki.js页面模板

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

Wiki.js描述页面

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

Wiki.js自带编辑器

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

Wiki.js图片上传

三、Wiki.js特色功能

3.1 中文

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

Wiki.js设置为中文

3.2 主题

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

Wiki.js主题导航

3.3 评论

Wiki.js支持第三方评论。

Wiki.js评论功能

3.4 存储

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

Wiki.js第三方存储

3.5 多用户

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

Wiki.js多用户注册

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

Wiki.js第三方账号登录

四、总结

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

全部为采集文章,文中的 联系方式 均不是 本人 的!

发表评论