How to Deploy and Use Cloudreve: An Open‑Source Multi‑Cloud File System

Many users enjoy various cloud storage services; here we introduce Cloudreve, an open‑source public cloud file system that supports multiple storage drivers.

Key features include support for local, Qiniu, Alibaba OSS, Tencent COS, UpYun, OneDrive (including China Telecom version), client direct upload/download with speed limits, Aria2 offline download integration, online compression/uncompression, multi‑file packaging, full‑storage‑strategy WebDAV support, drag‑and‑drop upload, directory upload, stream upload handling, file drag‑and‑drop management, multi‑user and user‑group management, share links with automatic expiration, online preview of video, image, audio, text, Office documents, custom themes, dark mode, PWA, single‑page application, and an all‑in‑one ready‑to‑use package.

Cloudreve offers open‑source, Linux, and Windows versions. Quick deployment can be done with:

# Extract package
tar -zxvf cloudreve_VERSION_OS_ARCH.tar.gz

# Grant execution permission
chmod +x ./cloudreve

# Start Cloudreve
./cloudreve

To build from source:

Clone the repository.

Build static assets:

# Enter assets directory
cd assets
# Install dependencies
yarn install
# Build
yarn run build

Embed static resources:

# Return to project root
cd ../
# Install statik for embedding
go get github.com/rakyll/statik
# Embed
statik -src=assets/build/ -include=*.html,*.js,*.json,*.css,*.png,*.svg,*.ico -f

Compile the project:

# Get version and commit
export COMMIT_SHA=$(git rev-parse --short HEAD)
export VERSION=$(git describe --tags)

# Build
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'"

Give Cloudreve a try and explore its capabilities.