techthinkerorg/bookstack

Bookstack

镜像概述和主要用途

Bookstack是一个Web应用程序，旨在帮助用户轻松存储、管理和分享文档、图片及其他文件。它提供了直观的界面和便捷的文件管理功能，适用于个人或团队进行文档协作与知识管理。

核心功能和特性

• 文档与文件存储：支持多种类型文件的上传与管理
• 目录结构管理：可创建层级目录组织内容
• 便捷分享：支持文件共享功能，方便团队协作
• Web访问：通过浏览器即可访问和管理存储的内容

使用场景和适用范围

• 个人文档管理：整理和存储个人学习资料、笔记等
• 团队协作：团队内部共享项目文档、技术资料
• 知识库构建：创建和维护组织或项目的知识库
• 小型企业文档管理：管理企业内部文档和资料

使用方法和配置说明

前置准备

1. 创建本地目录

   sh
   sudo mkdir -p /srv/bookstack
   sudo mkdir -p /srv/bookstack/public/uploads
   sudo mkdir -p /srv/bookstack/storage/uploads
   sudo chown -R $USER:$USER /srv/bookstack
   

2. 安装MySQL数据库并创建用户
   需提前安装MySQL数据库，并为Bookstack创建专用数据库和用户。

Docker Compose配置

1. 创建docker-compose.yml文件

   yaml
   version: "3.8"
   services:
     bookstack:
       container_name: bookstack
       image: techthinkerorg/bookstack:22.04
       ports:
         - 8801:8080
       networks:
         - mysql_mynet
       environment:
         - DB_HOST=${DB_HOST}
         - DB_DATABASE=${DB_DATABASE}
         - DB_USERNAME=${DB_USERNAME}
         - DB_PASSWORD=${DB_PASSWORD}
         - APP_URL=http://localhost:8801
       volumes:
         - public_upload:/var/www/bookstack/public/uploads
         - storage_upload:/var/www/bookstack/storage/uploads
   networks:
     mysql_mynet:
       external: true
   volumes:
     public_upload:
       driver: local
       driver_opts:
         type: none
         device: /srv/bookstack/public/uploads
         o: bind
     storage_upload:
       driver: local
       driver_opts:
         type: none
         device: /srv/bookstack/storage/uploads
         o: bind
   

2. 创建.env文件
   在与docker-compose.yml相同目录下创建.env文件，配置数据库连接信息：

   sh
   DB_HOST=mysql
   DB_DATABASE=bookstack
   DB_USERNAME=bookstack
   DB_PASSWORD=secret
   

启动应用

执行以下命令启动Bookstack服务：

sh
docker-compose up

初始登录

服务启动后，通过浏览器访问 http://localhost:8801，使用默认账号登录：

• 默认用户名：admin@admin.com
• 默认密码：password

配置说明

环境变量说明

• DB_HOST: MySQL数据库主机地址
• DB_DATABASE: 数据库名称
• DB_USERNAME: 数据库用户名
• DB_PASSWORD: 数据库密码
• APP_URL: Bookstack应用访问URL

数据持久化

通过卷挂载实现数据持久化，确保容器重启后数据不丢失：

• public_upload: 映射到本地 /srv/bookstack/public/uploads
• storage_upload: 映射到本地 /srv/bookstack/storage/uploads