从源代码到你的服务器

用熟悉的方式 开始工作。

以下步骤从当前源代码副本安装 Sprutio 文件管理器。你需要 Linux 服务器、Docker Engine、Compose 插件和管理员权限。

01 / 准备服务器。

选择操作系统及其版本,以安装 Docker Engine 和 Compose 插件。从项目维护者处获取当前 Sprutio 源代码,并进入其根目录。Docker Desktop 不提供对 macOS 或 Windows 系统账号的访问。

选择操作系统

先选择操作系统,再选择版本,即可查看安装命令。

Ubuntu

amd64 / arm64

选择版本

Ubuntu 26.10 · Stonking

请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。

(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'ubuntu' ] && [ "$sprutio_os_version" = '26.10' ] || {
  printf '%s\n' 'OS/version does not match the selected instructions.' >&2
  exit 1
}
case "$(dpkg --print-architecture)" in
  amd64|arm64) ;;
  *) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac

apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: stonking
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

systemctl enable --now docker
docker version
docker compose version
)

如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。

Docker 官方安装说明

Ubuntu 26.04 LTS · Resolute

请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。

(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'ubuntu' ] && [ "$sprutio_os_version" = '26.04' ] || {
  printf '%s\n' 'OS/version does not match the selected instructions.' >&2
  exit 1
}
case "$(dpkg --print-architecture)" in
  amd64|arm64) ;;
  *) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac

apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: resolute
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

systemctl enable --now docker
docker version
docker compose version
)

如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。

Docker 官方安装说明

Ubuntu 24.04 LTS · Noble

请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。

(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'ubuntu' ] && [ "$sprutio_os_version" = '24.04' ] || {
  printf '%s\n' 'OS/version does not match the selected instructions.' >&2
  exit 1
}
case "$(dpkg --print-architecture)" in
  amd64|arm64) ;;
  *) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac

apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: noble
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

systemctl enable --now docker
docker version
docker compose version
)

如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。

Docker 官方安装说明

Ubuntu 22.04 LTS · Jammy

请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。

(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'ubuntu' ] && [ "$sprutio_os_version" = '22.04' ] || {
  printf '%s\n' 'OS/version does not match the selected instructions.' >&2
  exit 1
}
case "$(dpkg --print-architecture)" in
  amd64|arm64) ;;
  *) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac

apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: jammy
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

systemctl enable --now docker
docker version
docker compose version
)

如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。

Docker 官方安装说明

CentOS

amd64 / arm64

选择版本

CentOS Stream 10

请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。

(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'centos' ] && [ "${sprutio_os_version%%.*}" = '10' ] || {
  printf '%s\n' 'OS/version does not match the selected instructions.' >&2
  exit 1
}
case "$(uname -m)" in
  x86_64|aarch64) ;;
  *) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac

dnf install dnf-plugins-core
dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

systemctl enable --now docker
docker version
docker compose version
)

如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。

Docker 官方安装说明

CentOS Stream 9

请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。

(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'centos' ] && [ "${sprutio_os_version%%.*}" = '9' ] || {
  printf '%s\n' 'OS/version does not match the selected instructions.' >&2
  exit 1
}
case "$(uname -m)" in
  x86_64|aarch64) ;;
  *) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac

dnf install dnf-plugins-core
dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

systemctl enable --now docker
docker version
docker compose version
)

如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。

Docker 官方安装说明

Debian

amd64 / arm64

选择版本

Debian 13 · Trixie

请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。

(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'debian' ] && [ "$sprutio_os_version" = '13' ] || {
  printf '%s\n' 'OS/version does not match the selected instructions.' >&2
  exit 1
}
case "$(dpkg --print-architecture)" in
  amd64|arm64) ;;
  *) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac

apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: trixie
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

systemctl enable --now docker
docker version
docker compose version
)

如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。

Docker 官方安装说明

Debian 12 · Bookworm

请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。

(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'debian' ] && [ "$sprutio_os_version" = '12' ] || {
  printf '%s\n' 'OS/version does not match the selected instructions.' >&2
  exit 1
}
case "$(dpkg --print-architecture)" in
  amd64|arm64) ;;
  *) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac

apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: bookworm
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

systemctl enable --now docker
docker version
docker compose version
)

如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。

Docker 官方安装说明

Raspberry Pi OS

arm64

请使用 64 位 Raspberry Pi OS。这些命令使用适用于 Debian arm64 的 Docker 官方软件源;此处不提供 32 位版本的安装说明。

选择版本

Raspberry Pi OS Trixie · arm64

请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。

(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'debian' ] && [ "$sprutio_os_version" = '13' ] || {
  printf '%s\n' 'OS/version does not match the selected instructions.' >&2
  exit 1
}
case "$(dpkg --print-architecture)" in
  arm64) ;;
  *) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac

apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: trixie
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

systemctl enable --now docker
docker version
docker compose version
)

如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。

Docker 官方安装说明

Raspberry Pi OS Bookworm · arm64

请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。

(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'debian' ] && [ "$sprutio_os_version" = '12' ] || {
  printf '%s\n' 'OS/version does not match the selected instructions.' >&2
  exit 1
}
case "$(dpkg --print-architecture)" in
  arm64) ;;
  *) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac

apt-get update
apt-get install ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<DOCKER_REPOSITORY
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: bookworm
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
DOCKER_REPOSITORY
apt-get update
apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

systemctl enable --now docker
docker version
docker compose version
)

如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。

Docker 官方安装说明

Fedora

amd64 / arm64

选择版本

Fedora 44

请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。

(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'fedora' ] && [ "$sprutio_os_version" = '44' ] || {
  printf '%s\n' 'OS/version does not match the selected instructions.' >&2
  exit 1
}
case "$(uname -m)" in
  x86_64|aarch64) ;;
  *) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac

dnf install dnf5-plugins
dnf config-manager addrepo --from-repofile https://download.docker.com/linux/fedora/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

systemctl enable --now docker
docker version
docker compose version
)

如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。

Docker 官方安装说明

Fedora 43

请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。

(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'fedora' ] && [ "$sprutio_os_version" = '43' ] || {
  printf '%s\n' 'OS/version does not match the selected instructions.' >&2
  exit 1
}
case "$(uname -m)" in
  x86_64|aarch64) ;;
  *) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac

dnf install dnf5-plugins
dnf config-manager addrepo --from-repofile https://download.docker.com/linux/fedora/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

systemctl enable --now docker
docker version
docker compose version
)

如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。

Docker 官方安装说明

RHEL

amd64 / arm64

请使用已注册且能够访问标准软件包仓库的 RHEL 系统。

选择版本

RHEL 10

请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。

(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'rhel' ] && [ "${sprutio_os_version%%.*}" = '10' ] || {
  printf '%s\n' 'OS/version does not match the selected instructions.' >&2
  exit 1
}
case "$(uname -m)" in
  x86_64|aarch64) ;;
  *) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac

dnf install dnf-plugins-core
dnf config-manager --add-repo https://download.docker.com/linux/rhel/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

systemctl enable --now docker
docker version
docker compose version
)

如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。

Docker 官方安装说明

RHEL 9

请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。

(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'rhel' ] && [ "${sprutio_os_version%%.*}" = '9' ] || {
  printf '%s\n' 'OS/version does not match the selected instructions.' >&2
  exit 1
}
case "$(uname -m)" in
  x86_64|aarch64) ;;
  *) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac

dnf install dnf-plugins-core
dnf config-manager --add-repo https://download.docker.com/linux/rhel/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

systemctl enable --now docker
docker version
docker compose version
)

如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。

Docker 官方安装说明

RHEL 8

请在尚未安装容器引擎的服务器上以 root 身份执行这些命令。这些命令将安装 Docker Engine、Buildx 和 Docker Compose 插件,启动 Docker 并检查已安装的版本。

(
set -eu
[ "$(id -u)" = 0 ] || { printf '%s\n' 'Run these commands as root.' >&2; exit 1; }
. /etc/os-release
sprutio_os_version=${VERSION_ID:-}
[ "${ID:-}" = 'rhel' ] && [ "${sprutio_os_version%%.*}" = '8' ] || {
  printf '%s\n' 'OS/version does not match the selected instructions.' >&2
  exit 1
}
case "$(uname -m)" in
  x86_64|aarch64) ;;
  *) printf '%s\n' 'Unsupported architecture for these instructions.' >&2; exit 1 ;;
esac

dnf install dnf-plugins-core
dnf config-manager --add-repo https://download.docker.com/linux/rhel/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

systemctl enable --now docker
docker version
docker compose version
)

如果已经安装 Docker、containerd 或 Podman,请先按照官方迁移说明操作,再继续安装。

Docker 官方安装说明

02 / 构建并启动。

在包含 compose.yaml 的 Sprutio 源代码目录中,以 root 身份执行以下命令。应用将从源代码构建,并以 app 服务启动。

docker compose build
docker compose up -d

03 / 检查应用。

查看服务状态和最近的日志。默认访问地址为 http://SERVER_IP:8080。输入登录凭据前,请将访问限制在可信网络内,或建立受保护的连接。

docker compose ps
docker compose logs --tail=100 app

04 / 使用 Linux 账号登录。

输入 Linux 主机上的用户名和密码。账号必须设置密码并启用 Shell;锁定账号和空密码均不被接受。以 root 登录会获得 root 权限。主机文件挂载到 /host,文件操作以已认证用户的权限执行。

保护远程访问。

应用默认使用未加密的 HTTP。密码和会话需要受保护的网络通道。请使用可信网络或 SSH 隧道;公开部署时,在应用前配置并验证 HTTPS。本网站的 HTTPS 不会自动为你的文件管理器配置 HTTPS。

在重启后保留设置。

app_data 数据卷保存用户偏好和连接信息。请将它与配置一起备份;主机文件需要单独备份。以下命令用于停止和启动服务。更新时,获取经审查的源代码版本,重新构建并启动。仅在确实要清空数据时删除数据卷。

docker compose stop
docker compose start