🛠️
BIT101运维手册

飞书用户5487

2月8日修改

服务端部署

从头开始，将 BIT101 服务端部署或迁移到一台全新的计算机！​

系统初始化和代码准备

文档编写时的测试服务器为腾讯云 2C4G，系统镜像为 Ubuntu 24.04 LTS，注意在后续配置中，如果需要从外部访问服务器端口，需要到控制台设置防火墙（如放通8000-8100)。​

首先，分别执行以下命令，安装 Go 语言环境：

代码块

sudo apt update​
sudo apt upgrade​
sudo apt install golang​

使用go version命令可以检查安装是否成功。

接下来准备代码，使用如下命令克隆 BIT101-GO 仓库并进入根目录运行：​

代码块

git clone https://github.com/BIT101-dev/BIT101-GO.git​
cd BIT101-GO​
go run . help​

如果GitHub无法访问可尝试参考https://github.com/521xueweihan/GitHub520更改/etc/hosts。

Go 会自动下载安装所需的依赖包，如果下载卡住可以尝试先切换国内源，如go env -w GOPROXY=https://goproxy.cn,direct。

当看到输出的 BIT101 提示信息就说明 BIT101-GO 的代码和环境已经配置完成了，我们将在完成其他准备工作之后完善配置文件config.yml并启动。​

依赖服务配置

BIT101-GO 主要使用了 PostgreSQL 数据库、Redis 缓存、Meilisearch 搜索系统和 Gorse 推荐系统三大依赖服务，可以选择 Docker 或手动安装的方式，默认情况况下，将在以下几个端口上提供依赖服务：​

•
6379：Redis 的端口。​

•
7700：Meilisearch 的端口，除了提供 API 外，使用浏览器访问还有交互式测试网页。​

•
8086：Gorse 的 gRPC 端口，供程序调用。​

•
8088：Gourse 的 HTTP 端口，浏览器访问显示后台网页。​

•
54320：PostgreSQL 的端口。​

这里仅介绍基于 Docker Compose 的配置方法，也可以自行分别手动部署，但如果改变了服务端口需要在config.yml中对应更改配置。​

首先根据官方文档安装 Docker：https://docs.docker.com/engine/install/ubuntu/，由于墙的原因，调整了部分命令，完整命令如下：

代码块

sudo apt-get update​
sudo apt-get install ca-certificates curl​
sudo install -m 0755 -d /etc/apt/keyrings​
# 以下命令调整为清华源​
sudo curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc​
sudo chmod a+r /etc/apt/keyrings/docker.asc​
# 以下命令调整为清华源​
echo \​
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu \​
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \​
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null​
sudo apt-get update​
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin​

还是因为墙，后面拉取镜像的时候可能会有网络问题，所以这里我们参考腾讯云官方文档配置加速源：https://cloud.tencent.com/document/product/1207/45596。

之后，我们进入env文件夹，如果是正式部署则复制env文件夹到production/env，然后修改docker-compose.yaml，需要修改的地方都有注释。​

然后运行如下代码：

代码块

sudo docker compose up -d

如果不加-d就不会在后台运行，会实时输出调试信息，退出终端后就关闭了。​

这时候访问8088端口（记得放通防火墙），如果能看到 Gorse 的面板就说明配置成功了。​

数据库配置

数据迁移

使用以下命令备份原服务器上的数据库（使用了压缩格式，导出的不是 SQL 文本）：​

代码块

sudo docker exec -t bit101_postgres pg_dump -U bit101 -F c -b -v -f /backup_bit101.dump bit101​
sudo docker cp bit101_postgres:/backup_bit101.dump ./data/backup/bit101_$(date +"%Y%m%d_%H%M%S").dump​
​
sudo docker exec -t bit101_postgres pg_dump -U bit101 -F c -b -v -f /backup_gorse.dump gorse​
sudo docker cp bit101_postgres:/backup_gorse.dump ./data/backup/gorse_$(date +"%Y%m%d_%H%M%S").dump​