首页 教程 开发工具 高效文档管理利器:Docker轻松部署BookStack并实现远程访问

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

文章目录

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

前言

今天给大家带来一个超级实用的技巧——如何在Linux系统上用Docker快速部署在线文档管理系统BookStack,并结合cpolar内网穿透工具轻松实现异地远程访问。不用公网IP,也不需要折腾路由器设置,非常的简单高效。

BookStack 是一款非常棒的开源知识管理和服务平台,基于 Laravel + Vue.js 构建。它不仅界面友好,还功能强大,支持所见即所得的编辑器和Markdown编辑器,非常适合个人或团队创建和管理文档。管理员可以一键导入Markdown文档,并完美处理文档间的链接和图片链接。此外,通过集成calibre工具,用户还可以将书籍生成并导出为PDF、ePub、Mobi等格式的离线文档。

使用Docker可以让您在几分钟内完成BookStack的本地部署,每个应用都在独立的容器中运行,互不干扰。并且Docker容器比虚拟机占用更少的系统资源,接下来,我们一步步带你轻松搞定BookStack的部署和远程访问。

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

1. 安装Docker

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

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

sudocurl-fsSL https://github.com/tech-shrimp/docker_installer/releases/download/latest/linux.sh|bash-sdocker--mirror Aliyun

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

sudocurl-fsSL https://gitee.com/tech-shrimp/docker_installer/releases/download/latest/linux.sh|bash-sdocker--mirror Aliyun

然后启动Docker即可

sudo systemctl start docker

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

2. Docker镜像源添加方法

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

sudonano /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: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:80depends_on:- db db:image: mysql:5.7container_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:

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

sudodocker compose up -d

如需停止可以执行:

sudodocker-compose down

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

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

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

4. 登录与简单使用

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

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

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

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

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

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

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

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

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

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

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

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

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

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

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

5. 公网远程访问本地BookStack

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

5.1 内网穿透工具安装

下面是安装cpolar步骤:

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

使用一键脚本安装命令

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

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

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

sudo systemctl status cpolar

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

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

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

5.2 创建远程连接公网地址

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

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

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

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

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

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

nano docker-compose.yml

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

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

sudodocker compose down

sudodocker compose up -d

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

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

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

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

小结

为了方便演示,我们在上边的操作过程中使用了cpolar生成的HTTP公网地址隧道,其公网地址是随机生成的。这种随机地址的优势在于建立速度快,可以立即使用。然而,它的缺点是网址是随机生成,这个地址在24小时内会发生随机变化,更适合于临时使用。

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

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

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

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

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

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

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

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

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

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

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

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

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

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

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

高效文档管理利器:Docker轻松部署BookStack并实现远程访问

通过以上步骤,你可以在Linux系统上快速部署BookStack,并使用cpolar内网穿透工具轻松实现异地远程访问。无需复杂的公网IP设置或路由器配置,让文档管理变得更加简单高效。

评论(0)条

提示:请勿发布广告垃圾评论,否则封号处理!!

    猜你喜欢
    【MySQL】用户管理

    【MySQL】用户管理

     服务器/数据库  2个月前  2.15k

    我们推荐使用普通用户对数据的访问。而root作为管理员可以对普通用户对应的权限进行设置和管理。如给张三和李四这样的普通用户权限设定后。就只能操作给你权限的库了。

    Cursor Rules 让开发效率变成10倍速

    Cursor Rules 让开发效率变成10倍速

     服务器/数据库  2个月前  1.21k

    在AI与编程的交汇点上,awesome-cursorrules项目犹如一座灯塔,指引着开发者们驶向更高效、更智能的编程未来。无论你是经验丰富的老手,还是刚入行的新人,这个项目都能为你的编程之旅增添一抹亮色。这些规则文件就像是你私人定制的AI助手,能够根据你的项目需求和个人偏好,精确地调教AI的行为。突然间,你会发现AI不仅能理解Next.js的最佳实践,还能自动应用TypeScript的类型检查,甚至主动提供Tailwind CSS的类名建议。探索新的应用场景,推动AI辅助编程的边界。

    探索Django 5: 从零开始,打造你的第一个Web应用

    探索Django 5: 从零开始,打造你的第一个Web应用

     服务器/数据库  2个月前  1.12k

    Django 是一个开放源代码的 Web 应用程序框架,由 Python 写成。它遵循 MVT(Model-View-Template)的设计模式,旨在帮助开发者高效地构建复杂且功能丰富的 Web 应用程序。随着每个版本的升级,Django 不断演变,提供更多功能和改进,让开发变得更加便捷。《Django 5 Web应用开发实战》集Django架站基础、项目实践、开发经验于一体,是一本从零基础到精通Django Web企业级开发技术的实战指南《Django 5 Web应用开发实战》内容以。

    MySQL 的mysql_secure_installation安全脚本执行过程介绍

    MySQL 的mysql_secure_installation安全脚本执行过程介绍

     服务器/数据库  2个月前  1.08k

    mysql_secure_installation 是 MySQL 提供的一个安全脚本,用于提高数据库服务器的安全性

    【MySQL基础篇】概述及SQL指令:DDL及DML

    【MySQL基础篇】概述及SQL指令:DDL及DML

     服务器/数据库  2个月前  483

    数据库是长期存储在计算机内的、有组织的、可共享的、统一管理的大量数据的集合。数据库不仅仅是数据的简单堆积,而是遵循一定的规则和模式进行组织和管理的。数据库中的数据可以包括文本、数字、图像、音频等各种类型的信息。

    Redis中的哨兵(Sentinel)

    Redis中的哨兵(Sentinel)

     服务器/数据库  2个月前  309

    ​ 上篇文章我们讲述了Redis中的主从复制(Redis分布式系统中的主从复制-CSDN博客),本篇文章针对主从复制中的问题引出Redis中的哨兵,希望本篇文章会对你有所帮助。