Docker 容器部署

BiliNote 默认提供了 Docker 镜像，你可以通过 Docker 容器部署 BiliNote。

什么是 Docker？

Docker 是一个开源的应用容器引擎，它允许开发者将应用及其所有依赖打包到一个“容器”中，从而实现跨平台、一致性部署。使用 Docker，你可以确保 BiliNote 在本地开发环境、测试环境和线上服务器上的运行行为完全一致。

Docker 的优点包括：

1. 一致性：Docker 容器在开发、测试和运行环境中具有相同的行为，从而避免了开发人员因环境差异而导致的错误。
2. 快速部署: 应用打包好后，部署只需一条命令。
3. 资源隔离: 每个容器互不影响，保障系统安全。

Windows/Mac 系统部署

对于 Windows 和 Mac 系统，推荐使用 Docker Desktop 进行安装。 本地教程以 windows 为例（Mac 是一样的）：

安装步骤：

1. 访问官网 https://www.docker.com/products/docker-desktop/
2. 下载并安装对应版本的 Docker Desktop。
3. 启动 Docker Desktop 并确保运行正常（右下角或菜单栏出现 Docker 图标）。

4. 安装完成后，可以通过终端（Terminal / PowerShell）验证是否安装成功：

  docker --version
  docker compose version

拉取 BiliNote 代码构建

这里如果你不知道什么是 Git，可以参考 Git 教程。
也可以直接 下载代码，然后解压到本地目录。

如果你熟悉 Git，也可以直接使用以下命令拉取代码：

git clone https://github.com/JefferyHcool/BiliNote.git
cd BiliNote

本地构建 Docker 镜像

1. 修改.env文件，将 .env.example 文件复制为 .env

TIP

如果这里你对配置文件有疑惑可以查看前面的配置教程

2. 启动命令

docker compose up -d

访问

部署成功后，访问 http://localhost:3015 或 .env 文件中配置的 APP_PORT 所指定的端口，即可访问 BiliNote。 若端口已被占用，可在 .env 文件中修改 APP_PORT 的值并重新部署

注意

如果遇到拉取镜像错误的问题，可能是网络问题，请检查你的网络环境。或自行上网查找配置镜像加速。