Docker新手必看：快速安装和配置BookStack在线文档体系

前言

本文主要先容如安在Linux体系利用Docker本地部署在线文档管理体系BookStack，并团结cpolar内网穿透工具轻松实现异地远程访问本地搭建的BookStack管理书籍文档。无需公网IP，也不用设置路由器那么麻烦。
BookStack是一个开源的、基于 Laravel + Vue.js 构建的知识管理和服务平台。具有简单但功能强大的所见即所得编辑器，也支持Markdown编辑器，允许个人或团队通过分类轻松创建与管理文档。管理员可以一键导入Markdown文档，完善处理文档间的链接和图片链接。而通过集成calibre工具，用户可以将书籍生成并导出为PDF、ePub、Mobi等格式的离线文档。
BookStack支持多种部署方式，包括手动安装和Docker部署等。本例以Docker Compose形式进行本地快速部署，并团结内网穿透技能将本地服务发布到公网，实现远程访问。

1. 安装Docker

本教程操作环境为Linux Ubuntu体系，在开始之前，我们必要先安装Docker。
在终端中执行下方下令安装docker：

1. sudo curl -fsSL https://github.com/tech-shrimp/docker_installer/releases/download/latest/linux.sh| bash -s docker --mirror Aliyun

复制代码

如果上边下令中访问不了Github，可以利用Gitee的链接安装：

1. sudo curl -fsSL https://gitee.com/tech-shrimp/docker_installer/releases/download/latest/linux.sh| bash -s docker --mirror Aliyun

复制代码

然后启动Docker即可

1. sudo systemctl start docker

复制代码

  PS:执行此下令安装Docker后，无需再次安装docker-compose
  2. Docker镜像源添加方法

目前docker镜像拉取已恢复正常，如仍因网络问题拉取不到镜像，可尝试在终端执行

1. sudo nano /etc/docker/daemon.json

复制代码

输入：

1. {
2. "registry-mirrors": [
3. "https://docker.m.daocloud.io",
4. "https://docker.1panel.live"
5. ]
6. }

复制代码

保存退出
重启Docker：

1. sudo systemctl restart docker

复制代码

3. 创建并启动BookStack容器

接下来创建BookStack项目文件夹并编辑docker-compose.yml，内容如下：

1. mkdir bookstack

复制代码

1. nano docker-compose.yml

复制代码

在编辑器中输入下方代码保存退出：

1. services:
2.   bookstack:
3.     image: ghcr.io/linuxserver/bookstack:latest
4.     container_name: bookstack
5.     environment:
6.       - PUID=1000
7.       - PGID=1000
8.       - APP_URL=http://localhost:8282
9.       - DB_HOST=db
10.       - DB_USER=bookstack
11.       - DB_PASS=secret
12.       - DB_DATABASE=bookstack
13.     volumes:
14.       - ./bookstack-data:/config
15.     ports:
16.       - 8282:80
17.     depends_on:
18.       - db
19.   db:
20.     image: mysql:5.7
21.     container_name: bookstack_db
22.     environment:
23.       MYSQL_ROOT_PASSWORD: rootpassword
24.       MYSQL_DATABASE: bookstack
25.       MYSQL_USER: bookstack
26.       MYSQL_PASSWORD: secret
27.     volumes:
28.       - ./mysql-data:/var/lib/mysql
29. volumes:
30.   bookstack-data:
31.   mysql-data:

复制代码

然后执行下方下令启动容器运行：

1. sudo docker compose up -d

复制代码

如需制止可以执行：

1. sudo docker-compose down

复制代码

OK，颠末以上过程，Docker部署 BookStack 相册 就完成了，现在我们可以通过任意欣赏器进行访问测试。
在欣赏器输入 http://localhost:8282 即可，体现下图即为访问乐成！

4. 登录与简单利用

在登录界面，默认Email地址为 admin@admin.com，密码为 password
乐成登录后的主界面如下图所示：

点击右上角用户名admin，在下拉框里面点击编辑用户资料链接，进入编辑页面对用户信息进行修改，好比用户名、密码、头像、首选语言等。

修改完中文体现后点击LOGO返回顾页

点击右上角图书按钮，即可创建图书：

添加相干书籍信息后，点击保存图书

然后可以点击创建页面或添加章节进入编辑界面：

以此类推，可以添加更多的书籍到你的书架中：

5. 公网远程访问本地BookStack

不过我们目前只能在本地访问刚刚利用docker部署的BookStack书库，如果身在异地，想要远程访问在家中部署的BookStack并上传与管理书籍，应该怎么办呢？我们可以利用cpolar内网穿透工具来实现无公网ip环境下的远程访问需求。
5.1 内网穿透工具安装

下面是安装cpolar步调：
   Cpolar官网地址: https://www.cpolar.com
  利用一键脚本安装下令

1. curl https://get.cpolar.sh | sudo sh

复制代码

安装完成后，执行下方下令查察cpolar服务状态：（如图所示即为正常启动）

1. sudo systemctl status cpolar

复制代码

Cpolar安装和乐成启动服务后，在欣赏器上输入ubuntu主机IP加9200端口即:【http://localhost:9200】访问Cpolar管理界面，利用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可：

5.2 创建远程毗连公网地址

登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道：

• 隧道名称：可自界说，本例利用了：BookStack 留意不要与已有的隧道名称重复
  
• 协议：http
  
• 本地地址：8282
  
• 域名范例：随机域名
  
• 地区：选择China VIP
  

创建乐成后,打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了两个公网地址：

接下来，必要将书库的docker-compose文件中的地址 http://localhost:8282 替换为这个http协议的公网地址：

1. nano docker-compose.yml

复制代码

然后保存退出，先制止容器在启动容器

1. sudo docker compose down

复制代码

1. sudo docker compose up -d

复制代码

然后就可以在其他电脑或手机平板（异地）上，利用这个http公网地址在欣赏器中访问即可。
如下图所示，乐成实现利用公网地址异地远程访问本地部署的 BookStack 书库！

小结
为了方便演示，我们在上边的操作过程中利用了cpolar生成的HTTP公网地址隧道，其公网地址是随机生成的。
这种随机地址的优势在于建立速度快，可以立即利用。然而，它的缺点是网址是随机生成，这个地址在24小时内会发生随机变化，更得当于临时利用。
如果有长期远程访问本地 BookStack 书库大概其他本地部署的服务的需求，但又不想每天重新配置公网地址，还想地址好看又好记并体验更多功能与更快的带宽，那我推荐大家选择利用固定的二级子域名方式来远程访问。
5.3 利用固定公网地址远程访问

登录cpolar官网，点击左侧的预留，选择保存二级子域名，地区选择China VIP，设置一个二级子域名名称，点击保存，保存乐成后复制保存的二级子域名名称，这里我填写的是mybooksk，大家也可以自界说喜欢的名称。

保存乐成后复制保存乐成的二级子域名的名称：mybooksk，返回登录Cpolar web UI管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道 BookStack，点击右侧的编辑：

修改隧道信息，将保存乐成的二级子域名配置到隧道中

• 域名范例：选择二级子域名
  
• Sub Domain：填写保存乐成的二级子域名：mybooksk
  
• 地区：选择China VIP
  

点击更新(留意,点击一次更新即可,不必要重复提交)

更新完成后,打开在线隧道列表,此时可以看到公网地址已经发生变化,地址名称也变成了固定的二级子域名名称的域名：

接下来，再次回到终端中将书库的docker-compose文件中的随机公网地址替换为这个固定不变的公网地址并重启docker容器即可：

然后利用这个固定公网地址在欣赏器访问，可以看到访问乐成，如许即使出门在外也可以随时随地利用这个网址来远程访问本地部署的 BookStack 书库来管理本舆图书了！

以上就是如安在Linux Ubuntu体系利用Docker部署BookStack 书库，并团结cpolar内网穿透工具配置固定公网地址，实现随时随地远程访问本地搭建的书库站点的全部流程，感谢您的观看，如果你也有远程访问本地部署服务的需求，不妨下载cpolar体验一下！

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。