知识管理跃上云端？BookStack携手Bcpolar，让你的文档库随行无界！

原创于 2025-07-14 15:27:15 发布 · 1.2k 阅读

19 ·

CC 4.0 BY-SA版权

文章标签：

#docker #容器 #运维 #tcp/ip #windows #学习方法 #经验分享

文章目录

前言

在数字化办公浪潮席卷之下，“数据孤岛”现象如影随形，持续困扰着个人与团队的工作流程——公司内网知识库受限于网络边界无法外携，家中笔记文件更新操作繁琐不便，临时出差时急需查阅资料却只能望洋兴叹。而 BookStack 这款开源利器，凭借现代技术架构，为这一难题提供了优雅且高效的解决方案：它基于Laravel+Vue.js的先进框架构建，却以简洁直观的界面实现了强大的文档管理功能——不仅支持Markdown与可视化编辑器双模式切换，满足不同用户的编辑习惯，管理员更可一键导入整套知识体系（确保图片链接等资源完整无损），并通过集成calibre工具，轻松将文档导出为PDF、ePub等格式，实现离线阅读的无缝衔接。

然而，BookStack 的真正价值，在与 cpolar内网穿透技术的巧妙结合中得以彰显：

团队协作场景下，只需将BookStack部署于家用NAS或公司服务器，利用cpolar生成公网可访问的URL，团队成员无论身处会议室、咖啡厅还是其他远程地点，均可实时更新文档，确保信息同步无延迟；
个人用户亦可借此搭建“私人知识库”，在通勤途中通过手机编辑待办事项，深夜灵感闪现时远程补充技术笔记，实现知识的随时随地积累与分享。
这种“本地部署+远程穿透”的创新模式，既确保了数据主权的安全（无需将核心资料上传至第三方云平台，降低数据泄露风险），又实现了跨场景的无缝协作与知识流动——或许，这正是开源工具对“效率革命”最质朴而深刻的诠释。

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

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

sudo docker compose up -d

如需停止可以执行：

sudo docker-compose down

OK，经过以上过程，Docker部署 BookStack 相册就完成了，现在我们可以通过任意浏览器进行访问测试。

在浏览器输入 http://localhost:8282 即可，显示下图即为访问成功！

4. 登录与简单使用

在登录界面，默认Email地址为 admin@admin.com，密码为 password

成功登录后的主界面如下图所示：

点击右上角用户名admin，在下拉框里面点击编辑用户资料链接，进入编辑页面对用户信息进行修改，比如用户名、密码、头像、首选语言等。

修改完中文显示后点击LOGO返回首页

点击右上角图书按钮，即可创建图书：

1725613530317

添加相关书籍信息后，点击保存图书

1725613818105

然后可以点击创建页面或添加章节进入编辑界面：

以此类推，可以添加更多的书籍到你的书架中：

5. 公网远程访问本地BookStack

不过我们目前只能在本地访问刚刚使用docker部署的BookStack书库，如果身在异地，想要远程访问在家中部署的BookStack并上传与管理书籍，应该怎么办呢？我们可以使用cpolar内网穿透工具来实现无公网ip环境下的远程访问需求。

5.1 内网穿透工具安装

下面是安装cpolar步骤：

Cpolar官网地址: https://www.cpolar.com

使用一键脚本安装命令

curl https://get.cpolar.sh | sudo sh

安装完成后，执行下方命令查看cpolar服务状态：（如图所示即为正常启动）

sudo systemctl status cpolar

Cpolar安装和成功启动服务后，在浏览器上输入ubuntu主机IP加9200端口即:【http://localhost:9200】访问Cpolar管理界面，使用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可：