BookStack 是一个开源的文档管理系统,非常适合用来创建和组织文档。
通过 Docker,我们可以轻松地将 BookStack 部署到本地或服务器上。
本文将详细介绍如何使用 Docker 搭建 BookStack。
项目预览
登录页面
首页
书架
图书分类
全局搜索
目录
- 1. 前提条件
- 2. 克隆 BookStack 仓库
- 3. 编写 Docker Compose 文件
- 4. 配置环境变量
- 5. 启动容器
- 6. 访问 BookStack
- 7. 总结
前提条件
在开始之前,请确保您的系统已经安装了以下工具:
- 1. Docker
- 2. Docker Compose
克隆 BookStack 仓库
首先,我们需要克隆 BookStack 的 GitHub 仓库。
git clone https://github.com/BookStackApp/BookStack.git cd BookStack
编写 Docker Compose 文件
在项目根目录中创建一个 docker-compose.yml
文件,用于定义 BookStack 和 MySQL 容器。
version: '3.8' services: bookstack: image: ghcr.io/linuxserver/bookstack:latest container_name: bookstack environment: - PUID=1000 - PGID=1000 - APP_URL=http://localhost:8080 - DB_HOST=db - DB_USER=bookstack - DB_PASS=secret - DB_DATABASE=bookstack volumes: - ./bookstack-data:/config ports: - 8080: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:
配置环境变量
在 docker-compose.yml
文件中,我们已经定义了一些环境变量,用于配置 BookStack 和 MySQL。确保这些变量满足您的需求。如果需要更改,请编辑文件中的对应部分。
启动容器
使用 Docker Compose 启动 BookStack 和 MySQL 容器。
docker-compose up -d
该命令会在后台启动容器。您可以使用以下命令查看容器的状态:
docker-compose ps
访问 BookStack
启动容器后,您可以在浏览器中访问 BookStack。默认情况下,BookStack 运行在 http://localhost:8080
。打开浏览器并访问该地址,您应该会看到 BookStack 的登录页面。
默认登录信息
BookStack 的默认管理员账号信息如下:
- • 用户名:
admin@admin.com
- • 密码:
password
请登录后立即更改默认密码以确保安全。
总结
通过 Docker,我们可以轻松地搭建和管理 BookStack 这种开源文档管理系统。本文介绍了如何克隆 BookStack 仓库,编写 Docker Compose 文件,配置环境变量,启动容器并访问 BookStack。希望通过本文的介绍,您能快速搭建自己的 BookStack 系统。