使用 Docker 部署 Wiki.js

安装 Docker 端

开始部署之前,我们需要确保已经安装了 Docker。Docker 是一个开源应用容器引擎,可以轻松地为任何应用程序创建一个轻量级的、可移植的、自给自足容器。要安装 Docker,

1
curl -fsSL https://get.docker.com | bash -s docker

本教材使用 Docker Compose 实现 Wiki.js 的一键部署,我们先通过下面的命令测试一下相关组件是否安装成功,显示版本即为成功。

1
docker compose version

获取镜像

在 Docker 中镜像是一个只读模板,可创建 Docker 容器。Wiki.js 官方提供了预构建 Docker 镜像,我们可直接从 Docker Hub 中拉取。为了简化部署过程,我们先创建 docker-compose.yml 文件,复制以下内容:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
version: "3"
services:

db:
image: postgres:15-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: linuxserver/wikijs
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:
- "80:3000"

volumes:
db-data:

编辑好上面内容后,执行下面的命令即可部署 Wiki.js:

1
docker compose up -d

初始配置

通过浏览器打开 Wiki.js 所在的服务器,进行初始配置。需要依次输入管理员的邮箱、密码,访问地址,设置是否匿名反馈使用情况:

管理员用户创建完成后,会自动跳转到登录页面,输入刚刚创建好的管理员账号后,可以看到如下页面,这时我们先点击 ADMINISTRATION 进入后台:

在后台面板中,我们首先汉化一下全站界面。点击左侧的 Locale,进入语言包设置页:

在右侧下载语言包,这里我们以 Chinese Simplified 为例,下载后在中间的 Site Localo 处选择 Chinese Simplified,最后点击右上角 APPLY 即可:

切换至首页后,即可创建主页内容。这里可以选择使用何种编辑器来创建,这里我们以 Markdown 为例:

在编辑内容前,我们还需要先设置页面属性,重点设置标题、路径,填写完成后点击右上角的 OK:

页面分级是通过标题级别实现的。这里我们就以二级标题为例,填写好内容后点击右上方的创建:

返回到主页后,即可看到相关内容。其它功能请伙伴们自行探索:

写在最后

通过 docker-compose.yml 可以看出来,服务已经做了 80 端口的映射,如果服务器中有其它的网站环境,建议修改 docker-compose.yml 中种 80 为其它端口。

另外如无 Nginx 等引擎,但需要 SSL 加密访问,推荐安装 Nginx Proxy Manager 来进行加密反代。

强烈建议先配置好访问环境「即配置好 Nginx Proxy Manager 后」再做 Wiki.js 初始化操作。

如果不会安装及配置 Nginx Proxy Manager,可在评论区中留言,杜老师会考虑编写相关教程。

本文链接:https://my.lmcjl.com/post/15843.html

展开阅读全文

4 评论

留下您的评论.