BookStack在线文档管理系统本地Docker部署与远程访问详细教程

💝💝💝欢迎来到我的博客，很高兴能够在这里和您见面！希望您在这里可以感受到一份轻松愉快的氛围，不仅可以获得有趣的内容和知识，也可以畅所欲言、分享您的想法和见解。

推荐:kwan 的首页,持续学习,不断总结,共同进步,活到老学到老

导航

檀越剑指大厂系列:全面总结 java 核心技术,jvm,并发编程 redis,kafka,Spring,微服务等

常用开发工具系列:常用的开发工具,IDEA,Mac,Alfred,Git,typora 等

数据库系列:详细总结了常用数据库 mysql 技术点,以及工作中遇到的 mysql 问题等

新空间代码工作室:提供各种软件服务,承接各种毕业设计,毕业论文等

懒人运维系列:总结好用的命令,解放双手不香吗?能用一个命令完成绝不用两个操作

数据结构与算法系列:总结数据结构和算法,不同类型针对性训练,提升编程思维,剑指大厂

非常期待和您一起在这个小小的网络世界里共同探索、学习和成长。💝💝💝 ✨✨ 欢迎订阅本专栏 ✨✨

博客目录

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

前言

本文主要介绍如何在 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：

shell 复制代码

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

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

shell 复制代码

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

然后启动 Docker 即可

shell 复制代码

sudo systemctl start docker

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

2. Docker 镜像源添加方法

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

shell 复制代码

sudo nano /etc/docker/daemon.json

输入：

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：

shell 复制代码

sudo systemctl restart docker

3. 创建并启动 BookStack 容器

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

shell 复制代码

mkdir bookstack

shell 复制代码

nano docker-compose.yml

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

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: