侧边栏壁纸
博主头像
★街角晚灯★博主等级

博观而约取 厚积而薄发

  • 累计撰写 450 篇文章
  • 累计创建 183 个标签
  • 累计收到 0 条评论

目 录CONTENT

文章目录

开源免费的Wiki.js搭建漂亮的知识库系统

WinJay
2023-12-01 / 0 评论 / 1 点赞 / 31 阅读 / 7034 字 / 正在检测是否收录...
温馨提示:
文章发布较早,内容可能过时,阅读注意甄别。。。。

开源免费的Wiki.js搭建漂亮的知识库系统

image-20231201151433111

Wiki.js是一款知识共享wiki,有权限管理系统、支持多人协作共同维护、支持markdown格式、支持评论、风格简洁等等。适合作为个人博客,或者小团队的文档知识库。

今天就介绍一下Dokcer下部署Wiki.js的方法。

1.创建postgres数据库容器

Wiki.js官方推荐的数据库是postgresql,我们就选择这个数据库;

#下载postgres13.5镜像
docker pull postgres:13.5

#创建自定义网络
docker network create -d bridge --subnet 172.88.88.0/24 --gateway 172.88.88.1 WiKi

#创建数据持久化目录
mkdir -p /001.DB_Data/PostgreSQL

#启动postgres容器
docker run \
--name postgres \
--ip= 172.88.88.2 \
--net=WiKi \
--restart=unless-stopped \
-e POSTGRES_PASSWORD=P@88W0rd \
-p 5433:5432 \
-v /001.DB_Data/PostgreSQL:/var/lib/postgresql/data \
-d postgres:13.5


$2a$12$DFQvmOF1OyhfvgfGKjTMt.ef/5Kn1TPR3W7HE6yz/sRm2ZMhxTGgG
#命令解释:
- **docker run** #创建容器
- **–name postgres** # 设置容器名为postgres
- **--ip=172.18.0.2** #指定容器的ip地址
- **--net=mynet** #指定容器的网络
- **--restart=always** #设置容器开机启动
- **-e POSTGRES_PASSWORD=P@88W0rd** # 设置密码
- **-p 5433:5432** # 设置访问端口
- **-v `pwd`/001.DB_Data/PostgreSQL:/var/lib/postgresql/data** # 将容器中的数据挂载到本地
- **-d postgres:15-alpine** #选择镜像


#进入postgres容器
docker exec -it postgres bash
#容器内查看系统版本
cat /etc/issue

正常应该是Debian系统;

修改国内软件源,要不然下载软件速度太慢,没有vim和vi命令,可以通过sed修改/etc/apt/sources.list文件增加国内软件源;

sed -i '1i deb-src http://mirrors.aliyun.com/debian/ bullseye-backports main non-free contrib\ndeb http://mirrors.aliyun.com/debian/ bullseye-backports main non-free contrib\ndeb-src http://mirrors.aliyun.com/debian/ bullseye-updates main non-free contrib\ndeb http://mirrors.aliyun.com/debian/ bullseye-updates main non-free contrib\ndeb-src http://mirrors.aliyun.com/debian-security/ bullseye-security main\ndeb http://mirrors.aliyun.com/debian-security/ bullseye-security main\ndeb-src http://mirrors.aliyun.com/debian/ bullseye main non-free contrib\ndeb http://mirrors.aliyun.com/debian/ bullseye main non-free contrib\n' /etc/apt/sources.list

2.安装Zhparser中文分词插件

后面中文分词全文索引会用到,依次执行下面命令;

apt-get update
apt-get install gcc
apt-get install wget
apt-get install make
apt-get install git
apt-get install bzip2
sudo apt-get install libpq-dev
apt install postgresql-server-dev-13

image-20231117084235588

image-20231117084257091

cd /tmp/
wget http://www.xunsearch.com/scws/down/scws-1.2.2.tar.bz2
tar -jxvf scws-1.2.2.tar.bz2 
cd scws-1.2.2
./configure 
make
make install
cd ..
git clone https://github.com/amutu/zhparser.git
cd zhparser/
make
make install

image-20231117084334243

3.创建数据库、用户、授权

#切换到postgres用户
su postgres
#登录数据库
psql
CREATE DATABASE wikijs;
CREATE USER wiki with password 'litsoft@wiki';
GRANT CONNECT ON DATABASE wikijs to wiki;
GRANT USAGE ON SCHEMA public TO wiki;
GRANT SELECT,update,INSERT,delete ON ALL TABLES IN SCHEMA public TO wiki;
ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON TABLES TO wiki;
ALTER USER wiki WITH SUPERUSER;

image-20231117084443804

4.启用数据库中文分词能力

##使用wiki账号进入psql
psql -U wiki -d wikijs

CREATE EXTENSION pg_trgm;
CREATE EXTENSION zhparser;
CREATE TEXT SEARCH CONFIGURATION pg_catalog.chinese_zh (PARSER = zhparser);

## 忽略标点影响
ALTER ROLE wiki SET zhparser.punctuation_ignore = ON;
## 短词复合
ALTER ROLE wiki SET zhparser.multi_short = ON;

##查看chinese_zh
\dF
##返回结果如下,则成功
               List of text search configurations
   Schema   |    Name    |              Description
------------+------------+---------------------------------------
 pg_catalog | arabic     | configuration for arabic language
 pg_catalog | chinese_zh |

image-20231117084804739

退出 session,重新连入 postgres 数据库,关闭 wiki superuser权限

psql -U postgres -d postgres
##取消 wikijs 用户的临时超管权限
ALTER USER wiki WITH NOSUPERUSER;

image-20231117084913463

5.创建Wiki容器

#拉取Wiki.js镜像
docker pull ghcr.io/requarks/wiki:2
#启动容器
docker run -d \
--net=WiKi \
-p 8000:3000 \
--name WiKi.JS \
--ip=172.88.88.3 \
-e TZ=Asia/Shanghai \
--restart=unless-stopped  \
-e "DB_USER=wiki" \
-e "DB_PORT=5433" \
-e "DB_NAME=wikijs" \
-e "DB_TYPE=postgres" \
-e "DB_PASS=litsoft@wiki" \
-e "DB_HOST=172.88.88.2" \
-v `pwd`/002.WiKiData:/wiki/data/content \
requarks/wiki:2.5

#配置搜索引擎
vi server/modules/search/postgres/definition.yml
###enum list 添加一个元素 chinese_zh
- chinese_zh
#重启容器
docker restart wiki

6.初始化Wiki.js

通过http://ip:8000访问wiki;

图片

注册管理账号,点击INSTALL进行安装,完成后自动进入登录页面;

image-20231117090648844

图片

7.配置Wiki.js

7.1设置中文;

图片

下载中文语言包——选择中文语言——点击应用即可;

图片

7.2创建组

创建组的目的主要是进行权限的管理,默认是有Administrators和Guests两个组:

图片

这里用的是最新版的Wiki.js组这里没有翻译过来,不过没关系,咱们有很多翻译软件,网页也可以直接翻译;

7.3设置搜索引擎

图片

7.4离线安装语言包

内网环境无法直接下载语言包,此时需要按照如下步骤手动导入语言包:

修改配置文件

进入wiki容器,修改config.yml文件,告诉wiki.js 当前运行在离线环境中:

offline: true

图片

创建离线资源目录

安装目录下创建一个文件夹 data/sideload 用来存放离线资源,比如我是安装在 /wiki/ 下,配置文件中配置的数据文件夹为 /wiki/data ,那么我就创建一个新的文件夹 /wiki/data/sideload 即可。

获取语言包

官方提供的语言包资源可以在这里下载:https://github.com/Requarks/wiki-localization

务必下载 locales.json ,之后下载您需要的语言包(如 zh.json )。

将下载好的 locales.json , zh.json , en.json 等资源拷入上面创建好的文件夹中。

最后重启服务即可。

1
  1. 支付宝打赏

    qrcode alipay
  2. 微信打赏

    qrcode weixin

评论区