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

文章目录

    • 前言
    • 1. 安装Docker
    • 2. Docker镜像源添加方法
    • 3. 创建并启动BookStack容器
    • 4. 登录与简单使用
    • 5. 公网远程访问本地BookStack
      • 5.1 内网穿透工具安装
      • 5.2 创建远程连接公网地址
      • 5.3 使用固定公网地址远程访问

前言

本文主要介绍如何在Linux系统使用Docker本地部署在线文档管理系统BookStack,并结合cpolar内网穿透工具轻松实现异地远程访问本地搭建的BookStack管理书籍文档。无需公网IP,也不用设置路由器那么麻烦。

BookStack是一个开源的、基于 Laravel + Vue.js 构建的知识管理和服务平台。具有简单但功能强大的所见即所得编辑器,也支持Markdown编辑器,允许个人或团队通过分类轻松创建与管理文档。管理员可以一键导入Markdown文档,完美处理文档间的链接和图片链接。而通过集成calibre工具,用户可以将书籍生成并导出为PDF、ePub、Mobi等格式的离线文档。

BookStack支持多种部署方式,包括手动安装和Docker部署等。本例以Docker Compose形式进行本地快速部署,并结合内网穿透技术将本地服务发布到公网,实现远程访问。

1725609753645

1. 安装Docker

本教程操作环境为Linux Ubuntu系统,在开始之前,我们需要先安装Docker。

在终端中执行下方命令安装docker:

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

如果上边命令中访问不了Github,可以使用Gitee的链接安装:

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

然后启动Docker即可

sudo systemctl start docker

PS:执行此命令安装Docker后,无需再次安装docker-compose

2. Docker镜像源添加方法

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

sudo nano /etc/docker/daemon.json

输入:

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

保存退出

重启Docker:

sudo systemctl restart docker

3. 创建并启动BookStack容器

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

mkdir bookstack
nano docker-compose.yml

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

services:bookstack:image: ghcr.io/linuxserver/bookstack:latestcontainer_name: bookstackenvironment:- PUID=1000- PGID=1000- APP_URL=http://localhost:8282- DB_HOST=db- DB_USER=bookstack- DB_PASS=secret- DB_DATABASE=bookstackvolumes:- ./bookstack-data:/configports:- 8282:80depends_on:- dbdb:image: mysql:5.7container_name: bookstack_dbenvironment:MYSQL_ROOT_PASSWORD: rootpasswordMYSQL_DATABASE: bookstackMYSQL_USER: bookstackMYSQL_PASSWORD: secretvolumes:- ./mysql-data:/var/lib/mysql
volumes:bookstack-data:mysql-data:

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

sudo docker compose up -d

如需停止可以执行:

sudo docker-compose down

OK,经过以上过程,Docker部署 BookStack 相册 就完成了,现在我们可以通过任意浏览器进行访问测试。

在浏览器输入 http://localhost:8282 即可,显示下图即为访问成功!

image-20240906165151775

4. 登录与简单使用

在登录界面,默认Email地址为 admin@admin.com,密码为 password

成功登录后的主界面如下图所示:

image-20240906170043895

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

image-20240906170315200

修改完中文显示后点击LOGO返回首页

image-20240906170506935

点击右上角图书按钮,即可创建图书:

1725613530317

添加相关书籍信息后,点击保存图书

1725613818105

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

image-20240906171217980

image-20240906172802001

image-20240906172553749

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

image-20240906172857628

5. 公网远程访问本地BookStack

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

5.1 内网穿透工具安装

下面是安装cpolar步骤:

Cpolar官网地址: https://www.cpolar.com

使用一键脚本安装命令

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

image-20240801132238671

安装完成后,执行下方命令查看cpolar服务状态:(如图所示即为正常启动)

sudo systemctl status cpolar

image-20240801132301959

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

image-20240801133735424

5.2 创建远程连接公网地址

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

  • 隧道名称:可自定义,本例使用了:BookStack 注意不要与已有的隧道名称重复
  • 协议:http
  • 本地地址:8282
  • 域名类型:随机域名
  • 地区:选择China VIP

1725615250077

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

1725615283044

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

nano docker-compose.yml

image-20240906180835742

然后保存退出,先停止容器在启动容器

sudo docker compose down
sudo docker compose up -d

image-20240906181208479

然后就可以在其他电脑或手机平板(异地)上,使用这个http公网地址在浏览器中访问即可。

如下图所示,成功实现使用公网地址异地远程访问本地部署的 BookStack 书库!

image-20240906181238766

image-20240906181301314

小结

为了方便演示,我们在上边的操作过程中使用了cpolar生成的HTTP公网地址隧道,其公网地址是随机生成的。

这种随机地址的优势在于建立速度快,可以立即使用。然而,它的缺点是网址是随机生成,这个地址在24小时内会发生随机变化,更适合于临时使用。

如果有长期远程访问本地 BookStack 书库或者其他本地部署的服务的需求,但又不想每天重新配置公网地址,还想地址好看又好记并体验更多功能与更快的带宽,那我推荐大家选择使用固定的二级子域名方式来远程访问。

5.3 使用固定公网地址远程访问

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

image-20240906181725712

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

image-20240906181833207

修改隧道信息,将保留成功的二级子域名配置到隧道中

  • 域名类型:选择二级子域名
  • Sub Domain:填写保留成功的二级子域名:mybooksk
  • 地区:选择China VIP

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

image-20240906181928617

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

image-20240906182037855

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

image-20240906182236134

然后使用这个固定公网地址在浏览器访问,可以看到访问成功,这样即使出门在外也可以随时随地使用这个网址来远程访问本地部署的 BookStack 书库来管理本地图书了!

image-20240906182444743

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

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/web/55415.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

SQL自学:怎么创建视图

在 SQL 中,视图是一种虚拟表,它是基于一个或多个表的查询结果集。视图并不实际存储数据,而是在每次查询时动态生成结果。 一、创建视图的语法(以 MySQL 为例) CREATE VIEW view_name AS SELECT column1, column2,...…

leetcode哈希表(二)-两个数组的交集

题目 . - 力扣(LeetCode) 给定两个数组 nums1 和 nums2 ,返回 它们的交集。输出结果中的每个元素一定是唯一的。我们可以不考虑输出结果的顺序 。 示例 1: 输入:nums1 [1,2,2,1], nums2 [2,2] 输出:[…

【c++篇】:初识c++--编程新手的快速入门之道(二)

文章目录 前言一.引用1.引用的概念2.引用的特性3.引用的使用场景4.常引用5.引用和指针的区别 二.内联函数1.C语言的宏函数2.内联函数的概念3.内联函数的特性 三.auto关键字1.auto的定义2.auto的使用规则3.auto不能推导的场景 四.基于范围的for循环1.范围for的语法2.范围for的使…

时间序列预测(七)——梯度消失(Vanishing Gradient)与梯度爆炸(Exploding Gradient)

目录 一、定义 二、产生原因 三、解决方法: 梯度消失与梯度爆炸是深度学习中常见的训练问题,它们主要发生在神经网络的反向传播过程中,使得模型难以有效学习。 一、定义 1、梯度消失(Vanishing Gradient)&#xf…

跟着导师学东西,学什么怎么学

获得老师帮助: 自己能有一些见解,让老师明白你是需要帮助的。 尽量让老师的帮助有正反馈。 增强自己表现力,多刷存在感(要和自己能力尽量适配) 不要羞于求助,内心戏不要太多,要多表达&#xff0…

PCL 点云配准-改进的RANSAC算法(粗配准)

目录 一、概述 1.1原理 1.2实现步骤 1.3应用场景 二、代码实现 2.1关键函数 2.1.1 计算FPFH特征 2.1.2 RANSAC配准 2.1.3 可视化点云 2.2完整代码 三、实现效果 PCL点云算法汇总及实战案例汇总的目录地址链接: PCL点云算法与项目实战案例汇总&#xff0…

FlinkCDC 实现 MySQL 数据变更实时同步

文章目录 1、基本介绍2、代码实战2.1、数据源准备2.2、代码实战2.3、数据格式 1、基本介绍 Flink CDC 是 Apache Flink 提供的一个功能强大的组件,用于实时捕获和处理数据库中的数据变更。可以实时地从各种数据库(如MySQL、PostgreSQL、Oracle、MongoDB…

【图论】(一)图论理论基础与岛屿问题

图论理论基础与岛屿问题 图论理论基础深度搜索(dfs)广度搜索(bfs)岛屿问题概述 岛屿数量岛屿数量-深搜版岛屿数量-广搜版 岛屿的最大面积孤岛的总面积沉没孤岛建造最大人工岛水流问题岛屿的周长 图论理论基础 这里仅对图论相关核…

java学习--集合(大写五.5)

5.collection子接口:Set 5.1Set及其实现类特点 java.util.Collection:存储一个一个的数据 子接口:Set:存储无序的、不可重复的数据(高中学习的集合) 1)HashsSet主要实现类 底层使用的是HashMap,即使用数组单向链表红黑树结构进行…

netron安装(windows linux)

目录 netron简介 不同操作系统的安装方式 linux windows mac系统 netron简介 netron可视化工具,是一个可以清晰的看到神经网络模型的每一层的输入输出,网络总体的架构,而且支持各种不同网络框架,简单好用。 效果如下所示 不…

028 elasticsearch索引管理-ElasticsearchRestTemplate

文章目录 pom.xmlapplication.ymlCubemallSearchApplication.javaRestClientTest.java使用ElasticsearchRestTemplate对象Blog.javaRestTemplateTest.java pom.xml <dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-s…

.net core 3.0 与 6.0 有哪些不同

.NET Core 3.0 和 .NET 6.0&#xff08;注意&#xff0c;从 .NET 5.0 开始&#xff0c;微软将 .NET Core 和 .NET Framework 合并为一个统一的 .NET 平台&#xff09;之间有许多重要的区别。这些区别包括性能改进、新功能、API 的变化以及对不同平台的支持。下面是一些主要的区…

【视频笔记】408新增知识点信号——里昂视频

文章目录 **2.信号****3.信号的实现**4.信号的处理**①忽略信号****②执行信号的默认操作****③捕获井处理信号**几个Linux支持的典型信号&#xff1a; **5.信号的产生**① **通过终端按键(键盘)产生信号**例如&#xff0c;CtrlC发送2号信号SIGINT、Ctrl\发送3号信号SIGQUIT② …

大数据面试题整理——HDFS

大数据面试题整理 第一章 HDFS面试题 第二章 MapReduce面试题 文章目录 大数据面试题整理一、请简要介绍一下 HDFS。二、HDFS 的主要特点有哪些&#xff1f;三、说说 HDFS 的架构&#xff0c;以及 NameNode 和 DataNode 的作用。四、什么是心跳机制&#xff1f;五、解释一下 H…

详解SSH和bash

1. SSH&#xff08;Secure Shell&#xff09; SSH 是你在远程登录到Linux服务器时使用的工具。假设你有一台远程服务器&#xff0c;你想从自己的电脑登录到这台服务器进行操作&#xff0c;SSH 就是你使用的工具。 示例&#xff1a; 你在自己的电脑上打开终端&#xff0c;输入…

使用Python爬虫API,轻松获取电商商品SKU信息

在电子商务的复杂世界中&#xff0c;SKU&#xff08;Stock Keeping Unit&#xff0c;库存单位&#xff09;信息是连接供应商、库存、销售和客户服务的桥梁。它不仅包含了商品的规格、价格、库存等关键数据&#xff0c;还直接影响到库存管理、价格策略和市场分析等多个方面。在这…

爬虫逆向-js进阶

1.作用域和闭包 //作用域 // var a 3 // // function test(a){ // var a 1; // console.log(函数内部,a) // } // test(2) // // console.log(a)//闭包 // function jiami(){ // function encrypt(){ // console.log(在这里进行加密了) // } // p…

五个必备的高清无水印视频素材库推荐

做抖音、短视频创作的朋友都知道&#xff0c;优质的素材往往决定了作品能否获得更多关注。如果你还不知道在哪里下载高清无水印的视频素材&#xff0c;不用担心&#xff01;今天为你推荐5个高品质的视频素材库&#xff0c;助你轻松创作出爆款视频。 蛙学网 是国内领先的视频素材…

Mysql常用sql语句与刷题知识点

目录 1. 常用sql2. 刷题知识点 1. 常用sql #查询MySQL中所有的数据库 SHOW DATABASES; #查询当前正在使用的数据库 SELECT DATABASE();#普通创建&#xff08;创建已经存在的数据库会报错&#xff09; CREATE DATABASE 数据库名称; #创建并判断&#xff08;该数据库不存在才创建…

2.html编辑器介绍

html编辑器介绍 HTML 编辑器推荐 理论上我们可以使用记事本进行html编码和开发&#xff0c;但是在实际开发html页面的时候&#xff0c;使用一些专业的开发工具可以使我们更加快速和高效的进行开发&#xff0c;下面介绍几种开发工具&#xff1a; VS Code&#xff1a;https://…