Cloudreve 项目主要由两部分组成:后端主仓库 cloudreve/Cloudreve,以及前端仓库 cloudreve/frontend。编译 Cloudreve 后端前,需要先构建assets
目录下的前端子模块,并使用statik嵌入到后端仓库。
参照 Getting Started - The Go Programming Language 安装并配置Go语言开发环境;
参考 下载 | Node.js 安装 Node.js;
参考 安装 | Yarn 安装Yarn;
执行 go get github.com/rakyll/statik
安装statik 命令行工具;
# 克隆仓库git clone --recurse-submodules https://github.com/cloudreve/Cloudreve.git# 签出您要编译的版本git checkout 3.x.x
# 进入前端子模块cd assets# 安装依赖yarn install# 开始构建yarn run build
完成后,所构建的静态资源文件位于 assets/build
目录下。
你可以将此目录改名为statics
目录,放置在 Cloudreve 主程序同级目录下并重启 Cloudreve,Cloudreve 将会使用此目录下的静态资源文件,而非内置的。
# 回到项目主目录cd ../# 安装 statik, 用于嵌入静态资源go get github.com/rakyll/statik# 开始嵌入statik -src=assets/build/ -include=*.html,*.js,*.json,*.css,*.png,*.svg,*.ico,*.ttf -f
如果在嵌入时找不到statik
命令,请尝试执行:
export PATH=$PATH:$(go env GOPATH)/bin
# 获得当前版本号、Commitexport COMMIT_SHA=$(git rev-parse --short HEAD)export VERSION=$(git describe --tags)# 开始编译go build -a -o cloudreve -ldflags " -X 'github.com/cloudreve/Cloudreve/v3/pkg/conf.BackendVersion=$VERSION' -X 'github.com/cloudreve/Cloudreve/v3/pkg/conf.LastCommit=$COMMIT_SHA'"
首次编译时,Go 会下载相关依赖库,如果您的网络环境不佳,可能会导致这一步速度过慢或者失败。你可以使用 GOPROXY.IO 加快模块下载速度。
编译完成后,会在项目根目录下生成最终的可执行文件cloudreve
。
你可以使用项目根目录下的构建脚本build.sh
快速完成构建、打包等操作,使用方法如下:
./build.sh [-a] [-c] [-b] [-r]a - 构建静态资源c - 编译二进制文件b - 构建前端 + 编译二进制文件r - 交叉编译,构建用于release的版本
交叉编译前,你需要启用CGO
,正确安装目标平台的 GCC 工具链,并将CC
环境变量设定为对应平台的GCC 编译工具。
比如,在 Linux/AMD64 宿主平台上交叉编译 Windows/AMD64:
export GOOS=windowsexport GOARCH=amd64export CC=x86_64-w64-mingw32-gccexport CGO_ENABLED=1go build