BookStack知识管理领域的“瑞士军刀”:cpolar内网穿透实验室第606个成功挑战!

206 阅读8分钟

NO.606 BookStack-1.jpg

软件名称:BookStack

操作系统支持:Windows、macOS、Linux

软件介绍:

BookStack是一款开源的知识管理工具,专注于帮助用户高效整理和检索信息。它提供了灵活的文档管理功能、强大的搜索能力,以及适合团队协作的环境。

NO.606 BookStack-2.jpg

BookStack:知识管理领域的“瑞士军刀”

BookStack以其简洁而强大的界面,赢得了无数用户的青睐。它不仅支持Markdown格式,还允许用户自定义分类、添加标签和建立链接,这让你的知识库焕发新生。

  • 灵活性:通过自定义的结构,你可以根据个人需求设计知识库。
  • 协作功能:团队成员可以实时编辑文档,留下评论,记录修改历史。
  • 安全性:支持多种认证方式,确保你的数据只被授权的人访问。

NO.606 BookStack-3.jpg

用户群体:

  • 学生:需要整理笔记、论文资料,追踪学习进度。
  • 研究人员:处理大量文献、数据分析结果,跟踪研究项目。
  • 企业员工:管理内部文档、协作完成项目报告,保持团队知识的连续性。

NO.606 BookStack-4.jpg

cpolar内网穿透带来的便利:

在传统的局域网环境下,BookStack只能供内部使用。但通过cpolar内网穿透技术,你可以将知识库安全地暴露到互联网上。这样,无论你身在何处,都能随时访问和管理你的知识库。

  • 远程办公:团队成员即使不在同一个地点,也能实时协作。
  • 数据备份:通过内网穿透,你可以轻松将数据备份到云端,防止丢失。
  • 跨平台访问:无论是手机、平板还是电脑,都能随时查看和编辑文档。

总结

BookStack不仅是一款知识管理工具,更是一个思维整理的好帮手。通过cpolar内网穿透技术,它的功能被进一步放大,让你在任何地方都能高效工作、学习。无论是个人用户还是团队协作,BookStack都能满足你的需求。

看到这里是不是已经有冲动要去试试了,下面可是有详细的教程呦👇

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 Hub镜像源已可以正常拉取,如因网络问题拉取不到镜像,

可尝试在终端执行

sudo nano /etc/docker/daemon.json

输入:

{
"registry-mirrors": [
"https://do.nark.eu.org",
"https://dc.j8.work",
"https://docker.m.daocloud.io",
"https://dockerproxy.com",
"https://docker.mirrors.ustc.edu.cn",
"https://docker.nju.edu.cn"
]
}

保存退出

重启Docker:

sudo systemctl restart docker

3. 创建并启动BookStack容器

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

mkdir bookstack
nano docker-compose.yml

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

services:
  bookstack:
    image: ghcr.io/linuxserver/bookstack:latest
    container_name: bookstack
    environment:
      - PUID=1000
      - PGID=1000
      - APP_URL=http://localhost:8282
      - DB_HOST=db
      - DB_USER=bookstack
      - DB_PASS=secret
      - DB_DATABASE=bookstack
    volumes:
      - ./bookstack-data:/config
    ports:
      - 8282:80
    depends_on:
      - db
  db:
    image: mysql:5.7
    container_name: bookstack_db
    environment:
      MYSQL_ROOT_PASSWORD: rootpassword
      MYSQL_DATABASE: bookstack
      MYSQL_USER: bookstack
      MYSQL_PASSWORD: secret
    volumes:
      - ./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官网地址: 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体验一下!