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: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: