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

首页 > 博客 > Linux > Linux系统本地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：

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:

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