BrBlog 部署文档

修改自定义内容

在部署前，你需要修改以下几个内容。

• 环境变量

• 统计脚本

• Giscus 留言板

环境变量

新建一份 .env 文件，其中内容参考 .env.example

# 数据库地址
DATABASE_URL="postgresql://username:password@localhost:5432/database"

# 管理员账户
ADMIN_USERNAME=""

# 管理员密码 SHA-256
ADMIN_HASHED_PASSWORD=""

# JWT 校验
JWT_SECRET=""

其中 ADMIN_HASHED_PASSWORD 为 SHA-256 摘要后的全小写文本，登录时请填密码原文。

JWT_SECRET 请自行生成 32 位长度的随机字符串，减小碰撞概率。

统计脚本

位置：

nuxt.config.ts

内容：

script:[
    			// 修改下方内容为你自己的统计脚本，或者删除
                {
                    async: true,
                    src: 'https://analytics.brackrat.com/script.js',
                    'data-website-id': '08fc9e5c-3446-455d-be05-154cd72bc5b6',
                },
    			// 结束
            ],

Giscus 留言板

位置：

components/Comment.vue 

内容：

<MyGiscus
      theme="dark"
      category="Announcements"
      category-id="DIC_kwDOLTSd6M4CdRSq"
      class="py-4 pt-4"
      crossorigin="anonymous"
      emit-metadata="0"
      input-position="top"
      lang="en"
      mapping="pathname"
      reactions-enabled="1"
      repo="BrackRat/giscus"
      repo-id="R_kgDOLTSd6A"
      strict="1"
      term="Welcome to @giscus/vue component!"
  />

详细请自行查阅 Giscus 文档

SEO 和其他杂项

为了 SEO ，你可能还需要到每个页面中修改 useSeoMeta 中的信息。

对于文本定制，请搜索需要修改的内容，直接在源码中修改即可。

推荐部署方法

• Docker 容器化部署

在 Docker 中运行博客程序，连接到 PostgreSQL 数据库即可。

• Vercel、Zeabur 等云平台部署

对于 Vercel 等平台，你必须还拥有一个暴露给博客程序的 PostgreSQL 数据库。

对于 Zeabur 等平台，你可能需要把数据库和博客程序放在一个内网中。

Docker 容器化部署

下方演示将使用 1Panel 部署。

打包博客程序

1. 构建博客镜像。

docker build -t BrBlog-image:0.0.1 .

2. 导出镜像

docker save -o BrBlog-image_0.0.1.tar BrBlog-image:0.0.1

运行镜像

1. 上传镜像

请上传到自己喜欢的路径

2. 导入镜像

1Panel 面板 => 镜像 => 导入镜像

3. 创建容器

创建时，请填入之前写好的.env中的信息。

当然，你还可以配置端口

如

PORT=6969

运行成功，则会提示

Listening on http://0.0.0.0:6969