手动安装

概要

本系统为前后端分离设计，共分为三个模块：

• server：go语言开发后端接口服务，为系统提供数据支撑
• site：基于Nuxt.js开发的社区前台UI服务
• admin：基于Vue.js、element-ui开发的运营后台

在安装时需要分别安装以上三个模块，接下来我们分别详细介绍下三个模块的安装方法。

server 端

Go语言环境安装

首先确保你已经成功在本地安装好了go语言开发环境，如果环境不会安装的，请参照下面文章：

数据库初始化

bbs-go数据库使用的是MySQL，MySQL最低版本要求为5.7（或者MariaDB 10及以上版本）。数据库的安装这里就不做赘述了，如果不会可自行Google、百度。

数据库成功安装之后，请通过工具（工具自行选择，我喜欢用mysql-cli，也可以用Navicat、TablePlus、MySQLWorkbench...）连接数据库，然后使用以下Sql脚本初始化bbs-go必须需的数据库表：

编译

Go语言是支持交叉编译的，你可以在Windows系统中将他编译成可以在Linux系统上可执行的二进制文件，其他平台同理。

编译时请打开命令行，并cd进入bbs-go/server目录，然后按照下面步骤进行编译。

• 如果只想编译当前机器可执行文件，那么只需要执行以下命令即可:

• 如果想编译其他类型系统可执行二进制文件（例如在Windows系统中编译Linux系统上的可执行文件），可以执行以下命令：

注意在其他类Unix系统（如Linux、MacOS）中设置系统类型和CPU架构的方式和在Windows系统中不太一样，在类Unix系统中实现上面同样效果，命令如下：

编译后会在bbs-go/server目录下生成一个bbs-go文件（Windows下是bbs-go.exe），这个就是我们编译后的可执行文件。

配置

系统提供了配置示例，首先将配置示例文件bbs-go/server/bbs-go.example.yaml复制一份，重命名为：bbs-go/server/bbs-go.yaml。 示例文件中对于每个配置项都做了详细注释说明，请按照注释配置即可。

这里着重讲解一下数据库的配置，数据库为必要配置，成功配置数据库之后即可正常启动bbs-go server端。在上面步骤中我们已经将bbs-go的数据库初始化完成，数据库配置有以下几点：

1. 数据库用户名，这里假设为：root（这里只是假设，请根据自己的实际情况设置）
2. 数据库密码，这里假设为：123456（这里只是假设，请根据自己的实际情况设置）
3. 数据库服务器地址，这里假设为：localhost（这里只是假设，请根据自己的实际情况设置）
4. 数据库名，我们上面脚本创建的数据库名称为：bbsgo_db（这里只是假设，请根据自己的实际情况设置）

那么我们需要将bbs-go.yaml配置文件中MySqlUrl配置修改如下：

运行

bbs-go的运行只需要两个文件，也就是我们上面步骤涉及到的两个文件：

1. 编译好的可执行文件：bbs-go（Windows下是bbs-go.exe）
2. 配置文件：bbs-go.yaml

将这两个文件放到同一个目录下，然后使用使用命令行进入到该目录中，在该目录下执行命令：

即可启动bbs-go-server服务，启动成功后，控制台会输入如下日志：

bbs-go-server默认的端口是：8082（你也可以在bbs-go.yaml配置文件中自行修改），在浏览器中访问：http://localhost:8082 就可以看到效果了，浏览器会显示：Powered by bbs-go 。

site

nodejs环境安装

推荐nodejs 版本：v16.xx

site 模块是基于nodejs开发的，所以编译他首先要安装nodejs环境。

• Windows下安装请参照这篇文章：https://www.cnblogs.com/liuqiyun/p/8133904.html
• Linux/MacOS下安装可以使用nvm：https://github.com/nvm-sh/nvm
• 或参照官网提供的《通过包管理器方式安装 Node.js》教程：https://nodejs.org/zh-cn/download/package-manager/

使用以下命令验证nodejs是否安装成功

安装依赖

在环境安装好后，进入到bbs-go/site目录，然后执行以下命令安装bbs-go-admin模块所需依赖：

npm的软件源是在国外服务器的，安装起来可能比较慢，你也可以使用cnpm来安装依赖。首先要安装cnpm，安装命令如下：

cnpm安装完后，在bbs-go/site目录下执行以下命令安装依赖：

配置

site模块的配置很简单，只需要配置：server端服务地址即可。这里的server端就是指bbs-go-server运行的地址，也就是上面讲到的：http://localhost:8082（这里要根据你的具体情况而定）。配置方式是，打开bbs-go/site/nuxt.config.js，找到proxy配置项，将他修改为下面的配置即可：

运行

确认正确安装依赖，配置修改成功后，在site目录使用以下命令已开发模式启动bbs-go-site项目：

bbs-go-site服务默认端口为3000，启动成功后你就可以在浏览器通过：http://localhost:3000 (opens new window)访问和体验整个bbs-go的功能啦。

打包

我们线上部署是不能使用：npm run dev方式的，该方式为开发者模式启动，系统限制最多只能同时打开三个网页。

线上部署方式如下：

1. 使用npm run build编译site模块，编译成功后会在目录中生成.nuxt目录。
2. 使用npm run start启动服务，服务同样启动在：3000 端口。

admin

nodejs环境安装

admin端和site端都是基于nodejs进行开发的，nodejs环境安装参见site端相关文档描述。

安装依赖

在环境安装好后，进入到bbs-go/admin目录，然后执行以下命令安装bbs-go-admin模块所需依赖：

npm的软件源是在国外服务器的，安装起来可能比较慢，你也可以使用cnpm来安装依赖。首先要安装cnpm，安装命令如下：

cnpm安装完后，在bbs-go/admin目录下执行以下命令安装依赖：

配置

admin 模块的配置文件分为开发环境和生产环境，文件分别为：

在使用开发模式运行服务时使用/admin/.env.development配置文件，在打包时使用/admin/.env.production配置文件。

配置文件中主要有两个配置项：

运行

确保依赖安装成功、配置正确后，可以使用命令：

来启动admin服务，使用该命令启动服务，会使用配置：/admin/.env.development

打包

确保依赖安装成功、配置正确后，可以使用命令：

来打包bbs-go-admin模块，打包时会使用配置：/admin/.env.production

打包的成果为：/admin/dist/文件夹，将该文件夹部署到nginx或者其他web容器中即可正常访问。